ListControl.Format Evento

Definizione

Spazio dei nomi:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Si verifica quando il controllo viene associato a un valore di dati.

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 

Tipo evento

ListControlConvertEventHandler

Esempio

Nell'esempio di codice seguente viene illustrato l'uso di questo membro. Nell'esempio un gestore eventi segnala l'occorrenza dell'evento Format . Questo report consente di apprendere quando si verifica l'evento e può essere utile per il debug. Per segnalare più eventi o eventi che si verificano di frequente, provare a sostituire MessageBox.Show o Console.WriteLine accodare il messaggio a un oggetto multilinea TextBox.

Per eseguire il codice di esempio, incollarlo in un progetto contenente un'istanza di un tipo che eredita da ListControl, ad esempio un ComboBox oggetto o ListBox. Assegnare quindi un nome all'istanza ListControl1 e verificare che il gestore eventi sia associato all'evento Format .

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

Commenti

L'evento Format viene generato prima che ogni elemento visibile nell'oggetto ListControl sia formattato. La gestione di questo evento consente di accedere alla stringa da visualizzare per questa voce di elenco, tramite la Value proprietà di ListControlConvertEventArgs.

Per ulteriori informazioni sulla gestione degli eventi, consultare gestione e generazione di eventi.