ListControl.Format Événement

Définition

Se produit lorsqu'un contrôle est lié à une valeur de données.Occurs when the control is bound to a data value.

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 

Exemples

L’exemple de code suivant illustre l’utilisation de ce membre.The following code example demonstrates the use of this member. Dans l’exemple, un gestionnaire d’événements signale l’occurrence de l’événement Format.In the example, an event handler reports on the occurrence of the Format event. Ce rapport vous aide à savoir quand l’événement se produit et peut vous aider à effectuer un débogage.This report helps you to learn when the event occurs and can assist you in debugging. Pour signaler plusieurs événements ou sur des événements qui se produisent fréquemment, envisagez de remplacer MessageBox.Show par Console.WriteLine ou d’ajouter le message à un TextBox multiligne.To report on multiple events or on events that occur frequently, consider replacing MessageBox.Show with Console.WriteLine or appending the message to a multiline TextBox.

Pour exécuter l’exemple de code, collez-le dans un projet qui contient une instance d’un type qui hérite de ListControl, tel qu’un ComboBox ou ListBox.To run the example code, paste it into a project that contains an instance of a type that inherits from ListControl, such as a ComboBox or ListBox. Nommez ensuite l’instance ListControl1 et assurez-vous que le gestionnaire d’événements est associé à l’événement Format.Then name the instance ListControl1 and ensure that the event handler is associated with the Format event.

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 la ListControl soit mis en forme.The Format event is raised before each visible item in the ListControl is formatted. La gestion de cet événement vous permet d’accéder à la chaîne à afficher pour cet élément de liste, par le biais de la propriété Value de la ListControlConvertEventArgs.Handling this event gives you access to the string to be displayed for this list item, through the Value property of the ListControlConvertEventArgs.

Pour plus d'informations sur la gestion des événements, voir gestion et déclenchement d’événements.For more information about handling events, see Handling and Raising Events.

S’applique à