ListControl.Format Evento
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Si verifica quando il controllo è associato a un valore di dati.
public:
event System::Windows::Forms::ListControlConvertEventHandler ^ Format;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
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 di facilitare il debug. Per segnalare più eventi o eventi che si verificano frequentemente, è consigliabile sostituire MessageBox.Show con Console.WriteLine o 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 assicurarsi 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 in ListControl sia formattato. La gestione di questo evento consente di accedere alla stringa da visualizzare per questa voce di elenco, tramite la Value proprietà dell'oggetto ListControlConvertEventArgs.
Per ulteriori informazioni sulla gestione degli eventi, consultare gestione e generazione di eventi.
