ErrorIconAlignment-Enumeration
Aktualisiert: November 2007
Gibt Konstanten an, die die Positionen angeben, an denen ein Fehlersymbol relativ zum fehlerhaften Steuerelement angezeigt werden kann.
Assembly: System.Windows.Forms (in System.Windows.Forms.dll)
| Membername | Beschreibung | |
|---|---|---|
| TopLeft | Das Symbol wird am oberen und am linken Rand des Steuerelements ausgerichtet. | |
| TopRight | Das Symbol wird am oberen und am rechten Rand des Steuerelements ausgerichtet. | |
| MiddleLeft | Das Symbol wird an der Mitte und am linken Rand des Steuerelements ausgerichtet. | |
| MiddleRight | Das Symbol wird an der Mitte und am rechten Rand des Steuerelements ausgerichtet. | |
| BottomLeft | Das Symbol wird am unteren und am linken Rand des Steuerelements ausgerichtet. | |
| BottomRight | Das Symbol wird am unteren und am rechten Rand des Steuerelements ausgerichtet. |
Diese Enumeration wird von ErrorProvider verwendet.
Im folgenden Beispiel wird die Verwendung der ErrorProvider-Klasse veranschaulicht, um die Benutzer über einen Dateneingabefehler zu benachrichtigen. Im Beispiel wird ein Form erstellt, das ein TextBox-Steuerelement, ein NumericUpDown-Steuerelement und ein ComboBox-Steuerelement enthält, die jeweils ihren eigenen Inhalt validieren. Außerdem wird ein ErrorProvider für jedes Steuerelement erstellt. Im Beispiel werden Optionen für Fehlersymbole mithilfe der BlinkRate-Eigenschaft und der BlinkStyle-Eigenschaft sowie der SetIconAlignment-Methode und der SetIconPadding-Methode festgelegt. Die SetError-Methode wird je nach Inhalt des Steuerelements mit oder ohne entsprechenden Fehlertext während des Validated-Ereignisses eines Steuerelements aufgerufen.
using System; using System.Drawing; using System.Windows.Forms; namespace ErrorProvider { public class Form1 : System.Windows.Forms.Form { private System.Windows.Forms.Label label1; private System.Windows.Forms.Label label2; private System.Windows.Forms.Label label4; private System.Windows.Forms.Label label5; private System.Windows.Forms.Label label6; private System.Windows.Forms.Label label3; private System.Windows.Forms.TextBox nameTextBox1; private System.Windows.Forms.NumericUpDown ageUpDownPicker; private System.Windows.Forms.ComboBox favoriteColorComboBox; private System.Windows.Forms.ErrorProvider ageErrorProvider; private System.Windows.Forms.ErrorProvider nameErrorProvider; private System.Windows.Forms.ErrorProvider favoriteColorErrorProvider; [STAThread] static void Main() { Application.Run(new Form1()); } public Form1() { this.nameTextBox1 = new System.Windows.Forms.TextBox(); this.label1 = new System.Windows.Forms.Label(); this.label2 = new System.Windows.Forms.Label(); this.ageUpDownPicker = new System.Windows.Forms.NumericUpDown(); this.favoriteColorComboBox = new System.Windows.Forms.ComboBox(); this.label3 = new System.Windows.Forms.Label(); this.label4 = new System.Windows.Forms.Label(); this.label5 = new System.Windows.Forms.Label(); this.label6 = new System.Windows.Forms.Label(); // Name Label this.label1.Location = new System.Drawing.Point(56, 32); this.label1.Size = new System.Drawing.Size(40, 23); this.label1.Text = "Name:"; // Age Label this.label2.Location = new System.Drawing.Point(40, 64); this.label2.Size = new System.Drawing.Size(56, 23); this.label2.Text = "Age (3-5)"; // Favorite Color Label this.label3.Location = new System.Drawing.Point(24, 96); this.label3.Size = new System.Drawing.Size(80, 24); this.label3.Text = "Favorite color"; // ErrorBlinkStyle.AlwaysBlink Label this.label4.Location = new System.Drawing.Point(264, 32); this.label4.Size = new System.Drawing.Size(160, 23); this.label4.Text = "ErrorBlinkStyle.AlwaysBlink"; // ErrorBlinkStyle.BlinkIfDifferentError Label this.label5.Location = new System.Drawing.Point(264, 64); this.label5.Size = new System.Drawing.Size(200, 23); this.label5.Text = "ErrorBlinkStyle.BlinkIfDifferentError"; // ErrorBlinkStyle.NeverBlink Label this.label6.Location = new System.Drawing.Point(264, 96); this.label6.Size = new System.Drawing.Size(200, 23); this.label6.Text = "ErrorBlinkStyle.NeverBlink"; // Name TextBox this.nameTextBox1.Location = new System.Drawing.Point(112, 32); this.nameTextBox1.Size = new System.Drawing.Size(120, 20); this.nameTextBox1.TabIndex = 0; this.nameTextBox1.Validated += new System.EventHandler(this.nameTextBox1_Validated); // Age NumericUpDown this.ageUpDownPicker.Location = new System.Drawing.Point(112, 64); this.ageUpDownPicker.Maximum = new System.Decimal(new int[] {150,0,0,0}); this.ageUpDownPicker.TabIndex = 4; this.ageUpDownPicker.Validated += new System.EventHandler(this.ageUpDownPicker_Validated); // Favorite Color ComboBox this.favoriteColorComboBox.Items.AddRange(new object[] {"None","Red","Yellow", "Green","Blue","Purple"}); this.favoriteColorComboBox.Location = new System.Drawing.Point(112, 96); this.favoriteColorComboBox.Size = new System.Drawing.Size(120, 21); this.favoriteColorComboBox.TabIndex = 5; this.favoriteColorComboBox.Validated += new System.EventHandler(this.favoriteColorComboBox_Validated); // Set up how the form should be displayed and add the controls to the form. this.ClientSize = new System.Drawing.Size(464, 150); this.Controls.AddRange(new System.Windows.Forms.Control[] { this.label6,this.label5,this.label4,this.label3, this.favoriteColorComboBox,this.ageUpDownPicker, this.label2,this.label1,this.nameTextBox1}); this.Text = "Error Provider Example"; // Create and set the ErrorProvider for each data entry control. nameErrorProvider = new System.Windows.Forms.ErrorProvider(); nameErrorProvider.SetIconAlignment (this.nameTextBox1, ErrorIconAlignment.MiddleRight); nameErrorProvider.SetIconPadding (this.nameTextBox1, 2); nameErrorProvider.BlinkRate = 1000; nameErrorProvider.BlinkStyle = System.Windows.Forms.ErrorBlinkStyle.AlwaysBlink; ageErrorProvider = new System.Windows.Forms.ErrorProvider(); ageErrorProvider.SetIconAlignment (this.ageUpDownPicker, ErrorIconAlignment.MiddleRight); ageErrorProvider.SetIconPadding (this.ageUpDownPicker, 2); ageErrorProvider.BlinkStyle = System.Windows.Forms.ErrorBlinkStyle.BlinkIfDifferentError; favoriteColorErrorProvider = new System.Windows.Forms.ErrorProvider(); favoriteColorErrorProvider.SetIconAlignment (this.favoriteColorComboBox, ErrorIconAlignment.MiddleRight); favoriteColorErrorProvider.SetIconPadding (this.favoriteColorComboBox, 2); favoriteColorErrorProvider.BlinkRate = 1000; favoriteColorErrorProvider.BlinkStyle = System.Windows.Forms.ErrorBlinkStyle.NeverBlink; } private void nameTextBox1_Validated(object sender, System.EventArgs e) { if(IsNameValid()) { // Clear the error, if any, in the error provider. nameErrorProvider.SetError(this.nameTextBox1, ""); } else { // Set the error if the name is not valid. nameErrorProvider.SetError(this.nameTextBox1, "Name is required."); } } private void ageUpDownPicker_Validated(object sender, System.EventArgs e) { if (IsAgeTooYoung()) { // Set the error if the age is too young. ageErrorProvider.SetError(this.ageUpDownPicker, "Age not old enough"); } else if (IsAgeTooOld()) { // Set the error if the age is too old. ageErrorProvider.SetError(this.ageUpDownPicker, "Age is too old"); } else { // Clear the error, if any, in the error provider. ageErrorProvider.SetError(this.ageUpDownPicker, ""); } } private void favoriteColorComboBox_Validated(object sender, System.EventArgs e) { if (!IsColorValid()) { // Set the error if the favorite color is not valid. favoriteColorErrorProvider.SetError(this.favoriteColorComboBox, "Must select a color."); } else { // Clear the error, if any, in the error provider. favoriteColorErrorProvider.SetError(this.favoriteColorComboBox, ""); } } // Functions to verify data. private bool IsNameValid() { // Determine whether the text box contains a zero-length string. return (nameTextBox1.Text.Length > 0); } private bool IsAgeTooYoung() { // Determine whether the age value is less than three. return (ageUpDownPicker.Value < 3); } private bool IsAgeTooOld() { // Determine whether the age value is greater than five. return (ageUpDownPicker.Value > 5 ); } private bool IsColorValid() { // Determine whether the favorite color has a valid value. return ((favoriteColorComboBox.SelectedItem != null) && (!favoriteColorComboBox.SelectedItem.ToString().Equals("None"))); } } }
package ErrorProvider;
import System.*;
import System.Drawing.*;
import System.Windows.Forms.*;
public class Form1 extends System.Windows.Forms.Form
{
private System.Windows.Forms.Label label1;
private System.Windows.Forms.Label label2;
private System.Windows.Forms.Label label4;
private System.Windows.Forms.Label label5;
private System.Windows.Forms.Label label6;
private System.Windows.Forms.Label label3;
private System.Windows.Forms.TextBox nameTextBox1;
private System.Windows.Forms.NumericUpDown ageUpDownPicker;
private System.Windows.Forms.ComboBox favoriteColorComboBox;
private System.Windows.Forms.ErrorProvider ageErrorProvider;
private System.Windows.Forms.ErrorProvider nameErrorProvider;
private System.Windows.Forms.ErrorProvider favoriteColorErrorProvider;
/** @attribute STAThread()
*/
public static void main(String[] args)
{
Application.Run(new Form1());
} //main
public Form1()
{
this.nameTextBox1 = new System.Windows.Forms.TextBox();
this.label1 = new System.Windows.Forms.Label();
this.label2 = new System.Windows.Forms.Label();
this.ageUpDownPicker = new System.Windows.Forms.NumericUpDown();
this.favoriteColorComboBox = new System.Windows.Forms.ComboBox();
this.label3 = new System.Windows.Forms.Label();
this.label4 = new System.Windows.Forms.Label();
this.label5 = new System.Windows.Forms.Label();
this.label6 = new System.Windows.Forms.Label();
// Name Label
this.label1.set_Location(new System.Drawing.Point(56, 32));
this.label1.set_Size(new System.Drawing.Size(40, 23));
this.label1.set_Text("Name:");
// Age Label
this.label2.set_Location(new System.Drawing.Point(40, 64));
this.label2.set_Size(new System.Drawing.Size(56, 23));
this.label2.set_Text("Age (3-5)");
// Favorite Color Label
this.label3.set_Location(new System.Drawing.Point(24, 96));
this.label3.set_Size(new System.Drawing.Size(80, 24));
this.label3.set_Text("Favorite color");
// ErrorBlinkStyle.AlwaysBlink Label
this.label4.set_Location(new System.Drawing.Point(264, 32));
this.label4.set_Size(new System.Drawing.Size(160, 23));
this.label4.set_Text("ErrorBlinkStyle.AlwaysBlink");
// ErrorBlinkStyle.BlinkIfDifferentError Label
this.label5.set_Location(new System.Drawing.Point(264, 64));
this.label5.set_Size(new System.Drawing.Size(200, 23));
this.label5.set_Text("ErrorBlinkStyle.BlinkIfDifferentError");
// ErrorBlinkStyle.NeverBlink Label
this.label6.set_Location(new System.Drawing.Point(264, 96));
this.label6.set_Size(new System.Drawing.Size(200, 23));
this.label6.set_Text("ErrorBlinkStyle.NeverBlink");
// Name TextBox
this.nameTextBox1.set_Location(new System.Drawing.Point(112, 32));
this.nameTextBox1.set_Size(new System.Drawing.Size(120, 20));
this.nameTextBox1.set_TabIndex(0);
this.nameTextBox1.add_Validated(new System.EventHandler(
this.nameTextBox1_Validated));
// Age NumericUpDown
this.ageUpDownPicker.set_Location(new System.Drawing.Point(112, 64));
this.ageUpDownPicker.set_Maximum(new System.Decimal(new int[] {
150, 0, 0, 0 }));
this.ageUpDownPicker.set_TabIndex(4);
this.ageUpDownPicker.add_Validated(new System.EventHandler(
this.ageUpDownPicker_Validated));
// Favorite Color ComboBox
this.favoriteColorComboBox.get_Items().AddRange(new Object[] {
"None", "Red", "Yellow", "Green", "Blue", "Purple" });
this.favoriteColorComboBox.set_Location(
new System.Drawing.Point(112, 96));
this.favoriteColorComboBox.set_Size(new System.Drawing.Size(120, 21));
this.favoriteColorComboBox.set_TabIndex(5);
this.favoriteColorComboBox.add_Validated(new System.EventHandler(
this.favoriteColorComboBox_Validated));
// Set up how the form should be displayed and add the controls to
// the form.
this.set_ClientSize(new System.Drawing.Size(464, 150));
this.get_Controls().AddRange(new System.Windows.Forms.Control[] {
this.label6, this.label5, this.label4, this.label3,
this.favoriteColorComboBox, this.ageUpDownPicker, this.label2,
this.label1, this.nameTextBox1 });
this.set_Text("Error Provider Example");
// Create and set the ErrorProvider for each data entry control.
nameErrorProvider = new System.Windows.Forms.ErrorProvider();
nameErrorProvider.SetIconAlignment(this.nameTextBox1,
ErrorIconAlignment.MiddleRight);
nameErrorProvider.SetIconPadding(this.nameTextBox1, 2);
nameErrorProvider.set_BlinkRate(1000);
nameErrorProvider.set_BlinkStyle(
System.Windows.Forms.ErrorBlinkStyle.AlwaysBlink);
nameErrorProvider.set_ContainerControl(this);
ageErrorProvider = new System.Windows.Forms.ErrorProvider();
ageErrorProvider.SetIconAlignment(this.ageUpDownPicker,
ErrorIconAlignment.MiddleRight);
ageErrorProvider.SetIconPadding(this.ageUpDownPicker, 2);
ageErrorProvider.set_BlinkStyle(
System.Windows.Forms.ErrorBlinkStyle.BlinkIfDifferentError);
ageErrorProvider.set_ContainerControl(this);
favoriteColorErrorProvider = new System.Windows.Forms.ErrorProvider();
favoriteColorErrorProvider.SetIconAlignment(this.favoriteColorComboBox,
ErrorIconAlignment.MiddleRight);
favoriteColorErrorProvider.SetIconPadding(this.favoriteColorComboBox, 2);
favoriteColorErrorProvider.set_BlinkRate(1000);
favoriteColorErrorProvider.set_BlinkStyle(
System.Windows.Forms.ErrorBlinkStyle.NeverBlink);
favoriteColorErrorProvider.set_ContainerControl(this);
} //Form1
private void nameTextBox1_Validated(Object sender, System.EventArgs e)
{
if (IsNameValid()) {
// Clear the error, if any, in the error provider.
nameErrorProvider.SetError(this.nameTextBox1, "");
}
else {
// Set the error if the name is not valid.
nameErrorProvider.SetError(this.nameTextBox1, "Name is required.");
}
} //nameTextBox1_Validated
private void ageUpDownPicker_Validated(Object sender, System.EventArgs e)
{
if (IsAgeTooYoung()) {
// Set the error if the age is too young.
ageErrorProvider.SetError(this.ageUpDownPicker,
"Age not old enough");
}
else {
if (IsAgeTooOld()) {
// Set the error if the age is too old.
ageErrorProvider.SetError(this.ageUpDownPicker,
"Age is too old");
}
else {
// Clear the error, if any, in the error provider.
ageErrorProvider.SetError(this.ageUpDownPicker, "");
}
}
} //ageUpDownPicker_Validated
private void favoriteColorComboBox_Validated(Object sender,
System.EventArgs e)
{
if (!(IsColorValid())) {
// Set the error if the favorite color is not valid.
favoriteColorErrorProvider.SetError(this.favoriteColorComboBox,
"Must select a color.");
}
else {
// Clear the error, if any, in the error provider.
favoriteColorErrorProvider.SetError(
this.favoriteColorComboBox, "");
}
} //favoriteColorComboBox_Validated
// Functions to verify data.
private boolean IsNameValid()
{
// Determine whether the text box contains a zero-length string.
return ((nameTextBox1.get_Text().get_Length()) > 0);
} //IsNameValid
private boolean IsAgeTooYoung()
{
// Determine whether the age value is less than three.
return (System.Convert.ToInt32(ageUpDownPicker.get_Value()) < 3);
} //IsAgeTooYoung
private boolean IsAgeTooOld()
{
// Determine whether the age value is greater than five.
return (System.Convert.ToInt32(ageUpDownPicker.get_Value()) > 5);
} //IsAgeTooOld
private boolean IsColorValid()
{
// Determine whether the favorite color has a valid value.
return (favoriteColorComboBox.get_SelectedItem() != null)
&& (!(favoriteColorComboBox.get_SelectedItem().
ToString().Equals("None")));
} //IsColorValid
} //Form1
Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98
.NET Framework und .NET Compact Framework unterstützen nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET Framework.