ListControl.Format Événement

Définition

Se produit lorsqu'un contrôle est lié à une valeur de données.

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 

Type d'événement

Exemples

L’exemple de code suivant illustre l’utilisation de ce membre. Dans l’exemple, un gestionnaire d’événements signale l’occurrence de l’événement Format . Ce rapport vous aide à savoir quand l’événement se produit et peut vous aider dans le débogage. Pour signaler plusieurs événements ou événements qui se produisent fréquemment, envisagez de MessageBox.ShowConsole.WriteLine remplacer par ou d’ajouter le message à un message multiligne TextBox.

Pour exécuter l’exemple de code, collez-le dans un projet qui contient un instance d’un type qui hérite de ListControl, tel qu’un ComboBox ou ListBox. Nommez ensuite le instance ListControl1 et vérifiez que le gestionnaire d’événements est associé à l’événementFormat.

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

Remarques

L’événement Format est déclenché avant que chaque élément visible dans le ListControl soit mis en forme. La gestion de cet événement vous donne accès à la chaîne à afficher pour cet élément de liste, via la Value propriété de .ListControlConvertEventArgs

Pour plus d'informations sur la gestion des événements, voir gestion et déclenchement d’événements.

S’applique à