ListControl.Format Ereignis

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Tritt ein, wenn das Steuerelement an einen Datenwert gebunden ist.

public:
 event System::Windows::Forms::ListControlConvertEventHandler ^ Format;

public event System.Windows.Forms.ListControlConvertEventHandler? Format;

member this.Format : System.Windows.Forms.ListControlConvertEventHandler 

Public Custom Event Format As ListControlConvertEventHandler 

Ereignistyp

ListControlConvertEventHandler

Beispiele

Im folgenden Codebeispiel wird die Verwendung dieses Members veranschaulicht. Im Beispiel meldet ein Ereignishandler das Auftreten des Ereignisses Format . Dieser Bericht hilft Ihnen, zu erfahren, wann das Ereignis eintritt, und kann Sie beim Debuggen unterstützen. Um über mehrere Ereignisse oder ereignisse zu berichten, die häufig auftreten, sollten Sie die Nachricht durch Console.WriteLine ein mehrlineiges TextBoxersetzen MessageBox.Show oder anfügen.

Um den Beispielcode auszuführen, fügen Sie ihn in ein Projekt ein, das eine instance eines Typs enthält, der von ListControlerbt, z. B. ein ComboBox oder ListBox. Benennen Sie dann den instanceListControl1, und stellen Sie sicher, dass der Ereignishandler dem Format Ereignis zugeordnet ist.

private void ListControl1_Format(Object sender, ListControlConvertEventArgs e) {

System.Text.StringBuilder messageBoxCS = new System.Text.StringBuilder();
messageBoxCS.AppendFormat("{0} = {1}", "ListItem", e.ListItem );
messageBoxCS.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "Value", e.Value );
messageBoxCS.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "DesiredType", e.DesiredType );
messageBoxCS.AppendLine();
MessageBox.Show(messageBoxCS.ToString(), "Format Event" );
}

Private Sub ListControl1_Format(sender as Object, e as ListControlConvertEventArgs) _ 
     Handles ListControl1.Format

    Dim messageBoxVB as New System.Text.StringBuilder()
    messageBoxVB.AppendFormat("{0} = {1}", "ListItem", e.ListItem)
    messageBoxVB.AppendLine()
    messageBoxVB.AppendFormat("{0} = {1}", "Value", e.Value)
    messageBoxVB.AppendLine()
    messageBoxVB.AppendFormat("{0} = {1}", "DesiredType", e.DesiredType)
    messageBoxVB.AppendLine()
    MessageBox.Show(messageBoxVB.ToString(),"Format Event")

End Sub

Hinweise

Das Format Ereignis wird ausgelöst, bevor jedes sichtbare Element in formatiert ListControl wird. Wenn Sie dieses Ereignis behandeln, erhalten Sie Zugriff auf die Zeichenfolge, die für dieses Listenelement angezeigt werden soll, über die Value -Eigenschaft von ListControlConvertEventArgs.

Weitere Informationen zur Behandlung von Ereignissen finden Sie unter behandeln und Auslösen von Ereignissen.