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 viene 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 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.
