GaugeControl.WinForms 1.1.8

dotnet add package GaugeControl.WinForms --version 1.1.8
                    
NuGet\Install-Package GaugeControl.WinForms -Version 1.1.8
                    
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="GaugeControl.WinForms" Version="1.1.8" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="GaugeControl.WinForms" Version="1.1.8" />
                    
Directory.Packages.props
<PackageReference Include="GaugeControl.WinForms" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add GaugeControl.WinForms --version 1.1.8
                    
#r "nuget: GaugeControl.WinForms, 1.1.8"
                    
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package GaugeControl.WinForms@1.1.8
                    
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=GaugeControl.WinForms&version=1.1.8
                    
Install as a Cake Addin
#tool nuget:?package=GaugeControl.WinForms&version=1.1.8
                    
Install as a Cake Tool

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.

GaugeControl Önizleme

Ö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

  1. GaugeControl.dll dosyasını referans olarak ekleyin
  2. using 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 Compatible and additional computed target framework versions.
.NET net9.0-windows7.0 is compatible.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
1.1.8 127 8/19/2025
1.1.7 123 8/18/2025
1.1.6 123 8/18/2025
1.1.5 124 8/18/2025
1.1.4 124 8/18/2025
1.1.3 121 8/18/2025
1.1.1 121 8/18/2025
1.1.0 130 8/18/2025