winforms stylable controls

Winforms-stylierbare Kontrolle

Dieses Projekt enthält benutzerdefinierte WinForms -Steuerelemente, die mehr Stylingoptionen als die Standards unterstützen. Wir verwenden dieses Projekt für einen besseren dunklen Modus und Themenunterstützung.
(Schauen Sie sich bei Themen unsere anderen Projekte WinForms-Themen an).

Lizenz

Toc

• Winforms stilable Steuerelemente
  • Lizenz
  • Verwendung
  • Kontrollen
  • Beiträge

Verwendung

Um dieses Projekt zu verwenden, fügen Sie einfach eine Referenz auf unser Nuget -Paket hinzu ( dotnet add package AssortedDevelopment.StylableWinFormsControls . Alle Steuerelemente finden Sie im Namespace StylableWinFormsControls .

Kontrollen

Dies ist die derzeit verfügbare Liste der benutzerdefinierten Steuerelemente und deren erweiterten Merkmale und bekannten Merkmale im Vergleich zu den ursprünglichen Winforms -Steuerelementen.

Button => StylableButton

Enthält die folgenden zusätzlichen Eigenschaften:

• Color EnabledHoverColor : Ruft die Hintergrundfarbe ab, während sich die Maus über die aktivierte Taste befindet.
• Color EnabledBackColor : Ruft/legt die Hintergrundfarbe einer aktivierten Taste ab.
• Color DisabledBackColor : Ruft die Hintergrundfarbe einer deaktivierten Taste ab.
• Color EnabledForeColor : Ruft die Vordergrundfarbe einer aktivierten Taste ab.
• Color DisabledForeColor : Ruft die Vordergrundfarbe einer deaktivierten Schaltfläche ab.
• Color BorderColor : Erholt/setzt die Randfarbe in einem der oben beschriebenen Szenarien.

CheckBox => StylablChockbox

Enthält die folgenden zusätzlichen Eigenschaften:

• Color DisabledForeColor : Ruft die Vordergrundfarbe ab, wenn das Kontrollkästchen deaktiviert ist.

Hat die folgenden zusätzlichen Eigenschaften:

• Unterstützt momentan keine Autosize

Combobox => stylableCombobox

Enthält die folgenden zusätzlichen Eigenschaften:

• Color BorderColor : Legt die Farbe des Randes um den Combobox (nicht das Elementlistenfeld) fest
• Color ItemHoverColor : Legt die Hintergrundfarbe des Elements in der derzeit schwebenden/ausgewählten Liste fest.

DataGridView => stylabledatagridView

Enthält die folgenden zusätzlichen Eigenschaften:

• bool DoubleBuffered : Enthält die DataGridView liegende Control.DoubleBuffered .
• bool EnableFirstColumnGrouping : Ruft/legt einen Wert fest, der angibt, ob mehrere Voraussetzungen desselben Textes in mehreren Zeilen der ersten Spalte mit Ausnahme des ersten versteckt sein sollten.

DateTimePicker => StylableDateTimePicker

Enthält die folgenden zusätzlichen Eigenschaften:

• Color EnabledBackColor : Ruft die Hintergrundfarbe eines aktivierten DateTimePicker ab.
• Color DisabledBackColor : Ruft die Hintergrundfarbe eines deaktivierten DateTimePicker ab.
• Color EnabledForeColor : Ruft die Vordergrundfarbe eines aktivierten DateTimePicker ab.
• Color DisabledForeColor : Erhält/legt die Vordergrundfarbe eines deaktivierten DateTimePicker ab.

Hat die folgenden zusätzlichen Eigenschaften:

• Das Steuerverhalten über die Tastatur ist derzeit unzuverlässig (siehe #24)
• Die BackColor -Eigenschaft ist zusätzlich über Designer zugänglich zugänglich

Gruppebox => stylableGroupBox

Enthält die folgenden zusätzlichen Eigenschaften:

• Color BorderColor : Steckt/setzt die Farbe des Randes, der den Inhalt der Groupbox umgibt.
• Color EnabledForeColor : Erhält/legt die Vordergrundfarbe des Textes/Titels in den Grenze ab, wenn die Groupbox aktiviert ist.
• Color DisabledForeColor : Erhält/legt die Vordergrundfarbe des Textes/Titels in den Grenze ab, wenn die Groupbox deaktiviert ist.

Hat die folgenden zusätzlichen Eigenschaften:

• Die ForeColor ist über Designer nicht zugänglich (um die Verwendung der spezifischeren Farbeigenschaften zu fördern)

Label => stylablelabel

Enthält die folgenden zusätzlichen Eigenschaften:

• Color DisabledForeColor : Erhält/legt die Vordergrundfarbe eines behinderten Etiketts ab.

Hat die folgenden zusätzlichen Eigenschaften:

• Unterstützt derzeit keine Autoellipsis auf behinderten Etiketten

ListView => stylablelistView

Enthält die folgenden zusätzlichen Eigenschaften:

• Color GroupHeaderBackColor : Legt die Farbe fest, die den Hintergrund einer Gruppenkopfzeile erstellt.
• Color GroupHeaderForeColor : Setzt die Vordergrundfarbe einer Gruppenkopfzeile.
• Color SelectedItemBackColor : Legt die Farbe fest, die den Hintergrund ausgewählter Elementzeilen erstellt.
• Color SelectedItemForeColor : Legt die Vordergrundfarbe jeder ausgewählten Elementzeile fest.

Hat die folgenden zusätzlichen Eigenschaften:

• DoubleBuffering ist aus technischen Gründen zu aktiviert, um aktiviert zu werden

Tabcontrol => stylabletabControl

Enthält die folgenden zusätzlichen Eigenschaften:

• Color BackgroundColor : Legt die Hintergrundfarbe der gesamten Tabcontrol fest.
• Color ActiveTabBackgroundColor : Ruft die Hintergrundfarbe des aktuell aktiven Registerkarte Rechtecks ​​ab.
• Color ActiveTabForegroundColor : Erhält/setzt die Vordergrundfarbe des aktuell aktiven Registerkarte Rechteck.
• Color BorderColor : Legt die Farbe des Randes in der Tabcontrol selbst und um die Registerkarten fest
• bool UseRoundedCorners : Holt oder legt einen Wert fest, der angibt, ob Registerkarten -Seitensteuerungen einen Eckradius haben oder nicht.
• Bitmap[] UpDownImages : Holt oder legt die aktuell verwendeten Bilder für die Updown -Steuerung ab oder legt oder legt sie fest. [0] = links, [1] = rechts, [2] = links (deaktiviert), [3] = rechts (deaktiviert)

Hat die folgenden zusätzlichen Eigenschaften:

• Unterstützt nur Alignment Top und Bottom
• Multiline wird derzeit nicht unterstützt

Textbox => stylableTextbox

Enthält die folgenden zusätzlichen Eigenschaften:

• Color BorderColor : Holt/setzt die Farbe des Randes um die Textbox
• Color PlaceholderForeColor : Erhält/setzt die Vordergrundfarbe des Hinweistextes
• Color ForeColor : Erhält/legt die Vordergrundfarbe des Nicht-Hinweis-Textes ab
• string PlaceholderText : Erhält/legt den zu angezeigten Wert fest, wenn kein von Benutzer bereitgestellter Text oder Standardtext angezeigt wird
• bool IsDelayActive : Ruft/legt einen Wert fest, der angibt, ob das TextChanged Ereignis erst nach einer bestimmten Zeitspanne ausgelöst werden soll.
• DelayedTextChangedTimeout : Ruft die Verzögerungszeit für das Auslösen des TextChanged -Ereignisses nach der letzten Benutzereingabe ab.

Hat die folgenden zusätzlichen Eigenschaften:

• Unterstützt, dass Hinweise angezeigt werden, die gezeigt werden sollen, wenn die Steuerung keinen Fokus hat und der Wert leer ist.
• Unterstützt die Verzögerung TextChanged Ereignissen

MessageBox => StylablemessageBox

Mit der StylableMessageBox können Sie Formulare wie MessageBox erstellen, aber das Handling ist etwas anders, da Sie das Formular vor der Anzeige stylen können.

Erstellen wir zuerst ein Nachrichtenfeld:

 StylableMessageBox mBox = StylableMessageBox . BUILDER
                . WithTitle ( "This is a text" , MessageBoxIcon . Information )
                . WithText ( "This is an example of a stylable MessageBox" )
                . Build ( ) ;

Dadurch wird ein Nachrichtenfeld mit einem Titel und einer Nachricht erstellt und - wie wir keine anderen Informationen angegeben haben - einen OK -Button. Stylen wir nun die Form, wie wir möchten: mBox.StylableControls.Text.ForeColor = Color.Red; Endlich können Sie den Dialog mit mBox.ShowDialog() anzeigen

Hinweis: Wenn Sie die Größe der Steuerelemente ändern (z. B. erhöhen Sie die Schriftgröße), rufen Sie bitte UpdateSize() an, um die Benutzeroberfläche auf die neuen Einstellungen zu aktualisieren. Ansonsten kann die Benutzeroberfläche komisch aussehen.

Interaction.inputbox => StylableInputbox

Mit der StylableInputBox können Sie Formulare erstellen, die wie VB.NETS Interaction.InputBox ähneln, aber das Handling ist etwas anders (da es sich praktisch eine etwas andere StylableMessageBox handelt). Daher erlauben wir Ihnen, das Formular zu stylen und anzupassen, bevor Sie es zeigen.

Erstellen wir zuerst ein Eingabefeld:

 StylableNumericInputBox iBox = StylableNumericInputBox . BUILDER
                . WithTitle ( "Numeric Test" , MessageBoxIcon . Information )
                . WithText ( "Please enter a random number between -100 and 100" )
                . WithHelpButton ( new Uri ( "https://github.com/Assorted-Development/winforms-stylable-controls" ) )
                . WithTimeout ( TimeSpan . FromSeconds ( 30 ) , DialogResult . Cancel )
                . ForNumericValue ( 0 , - 100 , 100 ) ;

Dadurch wird ein Eingabefeld für numerische Werte erstellt (derzeit unterstützen wir Text über TextBox und numerische Eingabe über NumericUpDown ). Stylen wir nun die Form, wie wir wollen: iBox.StylableControls.Text.ForeColor = Color.Red; Endlich können Sie das Dialog mit iBox.ShowDialog() anzeigen und entweder seinen DialogResult oder iBox.Value verwenden, um die vom Benutzer eingegebene Eingabe zu erhalten.

Hinweis: Wenn Sie die Größe der Steuerelemente ändern (z. B. erhöhen Sie die Schriftgröße), rufen Sie bitte UpdateSize() an, um die Benutzeroberfläche auf die neuen Einstellungen zu aktualisieren. Ansonsten kann die Benutzeroberfläche komisch aussehen.

Beiträge

Bitte sehen Sie den Beitrag zur beitragenden Anleitung für weitere Informationen.