GaugeControl.WinForms
1.1.8
dotnet add package GaugeControl.WinForms --version 1.1.8
NuGet\Install-Package GaugeControl.WinForms -Version 1.1.8
<PackageReference Include="GaugeControl.WinForms" Version="1.1.8" />
<PackageVersion Include="GaugeControl.WinForms" Version="1.1.8" />
<PackageReference Include="GaugeControl.WinForms" />
paket add GaugeControl.WinForms --version 1.1.8
#r "nuget: GaugeControl.WinForms, 1.1.8"
#:package GaugeControl.WinForms@1.1.8
#addin nuget:?package=GaugeControl.WinForms&version=1.1.8
#tool nuget:?package=GaugeControl.WinForms&version=1.1.8
GaugeControl - Özelleştirilebilir Gösterge Kontrolü
GaugeControl, Windows Forms uygulamaları için geliştirilmiş, tamamen özelleştirilebilir bir gösterge kontrolüdür. Sıcaklık, basınç, hız gibi sayısal değerleri görsel olarak göstermek için idealdir.
Sürüm 1.1.0 Güncellemesi: Yeni etkileşim özellikleri eklendi! Artık Click ve DoubleClick event'ları ile daha etkileşimli uygulamalar geliştirebilirsiniz.
Özellikler
- Çoklu Durum Desteği: Farklı durumlar için farklı renkler
- Animasyonlu Geçişler: Yumuşak değer değişim animasyonları
- Tam Özelleştirme: Renkler, boyutlar ve yazı tipleri özelleştirilebilir
- Etkileşimli: Fare ve dokunma desteği ile değer değiştirme
- Olay Tabanlı: Click ve DoubleClick event'ları ile kullanıcı etkileşimlerini yakalayın
- Responsive: Farklı boyutlara uyumlu tasarım
- Araç İpuçları: Açıklayıcı araç ipuçları
Kurulum
Yöntem 1: NuGet Paketi (Önerilen)
Install-Package GaugeControl
Yöntem 2: Manuel Kurulum
GaugeControl.dll
dosyasını referans olarak ekleyinusing GaugeControl;
ekleyin
Hızlı Başlangıç
using GaugeControl;
// Form yüklenirken
private void Form1_Load(object sender, EventArgs e)
{
// Yeni bir gauge oluştur
var gauge = new GaugeControl.GaugeControl
{
Location = new Point(20, 20),
Size = new Size(200, 200),
MinValue = 0,
MaxValue = 100,
Value = 25.5f,
Unit = "°C",
Status = TempStatus.Normal
};
// Form'a ekle
this.Controls.Add(gauge);
}
Özellikler
Temel Özellikler
Event'lar
Event | Açıklama |
---|---|
Click |
Kontrole tek tıklandığında tetiklenir |
DoubleClick |
Kontrole çift tıklandığında tetiklenir |
ValueChanged |
Değer değiştiğinde tetiklenir |
StatusChanged |
Durum değiştiğinde tetiklenir |
Event Kullanım Örneği
gauge1.Click += (sender, e) => {
MessageBox.Show("Göstergeye tıklandı!");
};
gauge1.DoubleClick += (sender, e) => {
gauge1.Value = (gauge1.Value > 50) ? 25 : 75; // Değeri değiştir
};
Temel Özellikler
Özellik | Açıklama | Varsayılan Değer |
---|---|---|
Value |
Gösterilecek değer | 0 |
MinValue |
Minimum değer | 0 |
MaxValue |
Maksimum değer | 100 |
Unit |
Birim metni (örn: °C, %) | "" |
Status |
Güncel durum (TempStatus enum'ı) | TempStatus.Normal |
Sürüm Geçmişi
1.1.0 (2025-08-19)
- Yeni Özellikler:
- Click ve DoubleClick event'ları eklendi
- Kullanıcı etkileşimleri için iyileştirmeler yapıldı
- İyileştirmeler:
- Performans iyileştirmeleri
- Dokümantasyon güncellemeleri
1.0.0 (2025-08-18)
- İlk kararlı sürüm
- Temel gösterge özellikleri
- Çoklu durum desteği
- Animasyonlar ve efektler
Görünüm Özelleştirme
Özellik | Açıklama | Varsayılan Değer |
---|---|---|
BorderWidth |
Kenar çizgisi kalınlığı | 3 |
BorderColor |
Kenar çizgisi rengi | DimGray |
ShowValue |
Değeri göster/gizle | true |
ShowUnit |
Birimi göster/gizle | true |
ShowGlow |
Parlaklık efekti | true |
ShowShadow |
Gölge efekti | true |
ShowReflection |
Yansıma efekti | true |
Durum Renkleri
Özellik | Açıklama | Varsayılan Değer |
---|---|---|
ColorOfNormal |
Normal durum rengi | Green |
ColorOfWarning |
Uyarı durumu rengi | Yellow |
ColorOfCritical |
Kritik durum rengi | Red |
ColorOfDisabled |
Devre dışı durum rengi | Gray |
ColorOfVeryLow |
Çok düşük değer rengi | DarkBlue |
ColorOfLow |
Düşük değer rengi | Blue |
ColorOfAboveNormal |
Normalin üstü rengi | LightGreen |
ColorOfWarmingUp |
Isınma durumu rengi | Orange |
ColorOfTheRutHasBegun |
Özel durum rengi | Yellow |
ColorOfEscalated |
Yükseltilmiş durum rengi | OrangeRed |
ColorOfOnFire |
Aşırı yüklenme rengi | Red |
ColorOfBlink |
Yanıp sönme rengi | Red |
Etkileşim Özellikleri
Özellik | Açıklama | Varsayılan Değer |
---|---|---|
EnableDragToChangeValue |
Sürükleme ile değer değiştirme | true |
EnableMouseWheel |
Fare tekerleği ile değer değiştirme | true |
ShowToolTip |
Araç ipucu gösterimi | true |
ToolTipText |
Araç ipucu metni | "Değeri değiştirmek için tıklayın veya sürükleyin" |
Olaylar
Olay | Açıklama |
---|---|
ValueChanged |
Değer değiştiğinde tetiklenir |
StatusChanged |
Durum değiştiğinde tetiklenir |
PropertyChanged |
Herhangi bir özellik değiştiğinde tetiklenir |
Gelişmiş Kullanım
Özel Durum Ekleme
// Özel durum ekleme
gauge1.Status = TempStatus.Custom;
gauge1.CustomStatusColor = Color.Purple;
// Veya doğrudan renk atayarak
if (someCondition)
{
gauge1.Status = TempStatus.Custom;
gauge1.CustomStatusColor = Color.Purple;
}
Animasyonlu Değer Değişimi
// Animasyonlu değer değişimi
gauge1.Value = 75; // Otomatik olarak animasyonlu geçiş yapar
// Animasyonu devre dışı bırakma
gauge1.EnableAnimation = false;
gauge1.Value = 50; // Ani geçiş
Özel Renk Şemaları
// Karanlık tema
gauge1.ColorOfNormal = Color.LightGreen;
gauge1.ColorOfWarning = Color.Yellow;
gauge1.ColorOfCritical = Color.Red;
gauge1.BackColor = Color.FromArgb(45, 45, 48);
gauge1.ForeColor = Color.White;
Örnek Uygulama
GaugeControlDemo
projesi, tüm özelliklerin nasıl kullanılacağını gösteren kapsamlı örnekler içerir.
Lisans
MIT Lisansı altında lisanslanmıştır. Daha fazla bilgi için LICENSE
dosyasına bakınız.
Katkıda Bulunma
Hata bildirimleri ve çekme istekleri memnuniyetle karşılanır. Büyük değişiklikler için lütfen önce bir konu açınız.
Teşekkürler
- Tüm katkıda bulunanlara teşekkürler!
- Özel teşekkürler [katkıda bulunanların isimleri]
Product | Versions Compatible and additional computed target framework versions. |
---|---|
.NET | net9.0-windows7.0 is compatible. net10.0-windows was computed. |
-
net9.0-windows7.0
- System.Drawing.Common (>= 8.0.0)
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.