Download Safari Books Online apps: Apple iOS | Android

Entire Site

Safari Books Online

    Free Trial

    Safari Books Online is a digital library providing on-demand subscription access to thousands of learning resources.


    • Create BookmarkCreate Bookmark
    • Create Note or TagCreate Note or Tag
    • PrintPrint
    Share this Page URL
    Help

    Steuerelemente zur Benutzerunterstützung > Das ErrorProvider-Steuerelement

    Das ErrorProvider-Steuerelement

    Das ErrorProvider-Steuerelement ermöglicht in Dialogfeldern die Einblendung von Fehlerhinweisen für den Benutzer. Die Optik des Steuerelements gestaltet sich standardmäßig als kleines Symbol am Rand eines anderen Steuerelements. Beim Überstreichen mit der Maus wird dem Benutzer zusätzlich ein Fehlertext angezeigt.

    Wie beim ToolTip-Steuerelement reicht eine Instanz pro Dialogfeld für die Verwaltung von beliebig vielen Fehleranzeigen. Das ErrorProvider-Steuerelement generiert wie das ToolTip-Steuerelement ebenfalls für jedes Steuerelement neue Eigenschaften.

    Tabelle 4.46 Wichtige Elemente der Klasse ErrorProvider

    Member

    Name

    Beschreibung

    BlinkRate

    Liefert oder definiert die Blinkgeschwindigkeit des Fehlersymbols in Millisekunden

    BlinkStyle

    Liefert oder definiert die Art des Blinkens in Bezug auf die Situation (AlwaysBlink, BlinkIfDifferentError oder NeverBlink)

    Icon

    Liefert oder definiert das Symbol, das angezeigt wird. Wir diese Eigenschaft nicht definiert, verwendet die Klasse ein Standardsymbol.

    Clear()

    Löscht sämtliche Fehler auf allen registrierten Elementen

    GetError(), SetError()

    Liefert oder definiert den aktuellen Fehlertext in Bezug auf ein bestimmtes Element

    GetIconAlignment(), SetIconAlignment()

    Liefert oder definiert die Anordnung des Symbols in Bezug auf ein bestimmtes Steuerelement. Folgende Positionen sind möglich: BottomLeft, BottomRight, MiddleLeft, MiddleRight, TopLeft und TopRight.

    GetIconPadding(), SetIconPadding()

    Liefert oder definiert den Abstand des ErrorProvider-Steuerelements zum betroffenen Steuerelement. Ein negativer Wert verschiebt das Element nach rechts, ein positiver Wert nach links. Die Angabe erfolgt in Pixel.

    Abbildung 4.49 zeigt die Optik eines ErrorProvider-Steuerelements. Das Symbol wird in diesem Beispiel entgegen dem Standardwert auf der linken Seite des betroffenen Steuerelements positioniert. Die für dieses Beispiel notwendige Codierung können Sie Listing 4.26 entnehmen.

    Optik des ErrorProvider-Steuerelements beim Überstreichen mit der Maus

    Abbildung 4.49 Optik des ErrorProvider-Steuerelements beim Überstreichen mit der Maus

    // Ereignisbehandlung beim Laden des Formulars
private void CpnlErrorProvider_Load(object sender, EventArgs e) {
   _errorProvider.SetIconAlignment(_tbData, ErrorIconAlignment.MiddleLeft);
}

// Ereignisbehandlung, wenn die Eingabe verändert wurde
private void Data_TextChanged(object sender, EventArgs e) {
    int iValue;
    if (!int.TryParse(_tbData.Text, out iValue) || iValue < 1000 || iValue >= 2000) {
        _errorProvider.SetError(_tbData, "Bitte einen Wert zwischen 1000 und 2000 eingeben");
    } else {
        _errorProvider.SetError(_tbData, string.Empty);
    }
}

    Listing 4.26 Band_2\Kapitel_04\LearningForms_04\LearningForms_04\50_UserSupport\ CpnlErrorProvider.cs