ListControl.Format Evento

Definição

Ocorre quando o controle é associado a um valor de dados.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 

Exemplos

O exemplo de código a seguir demonstra o uso desse membro.The following code example demonstrates the use of this member. No exemplo, um manipulador de eventos relata a ocorrência do evento Format.In the example, an event handler reports on the occurrence of the Format event. Este relatório ajuda você a aprender quando o evento ocorre e pode ajudá-lo na depuração.This report helps you to learn when the event occurs and can assist you in debugging. Para relatar vários eventos ou eventos que ocorrem com frequência, considere substituir MessageBox.Show por Console.WriteLine ou anexar a mensagem a uma TextBoxde várias linhas.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.

Para executar o código de exemplo, Cole-o em um projeto que contém uma instância de um tipo que herda de ListControl, como um 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. Em seguida, nomeie a instância ListControl1 e verifique se o manipulador de eventos está associado ao evento 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

Comentários

O evento Format é gerado antes de cada item visível na ListControl ser formatado.The Format event is raised before each visible item in the ListControl is formatted. A manipulação desse evento fornece acesso à cadeia de caracteres a ser exibida para esse item de lista, por meio da propriedade Value da ListControlConvertEventArgs.Handling this event gives you access to the string to be displayed for this list item, through the Value property of the ListControlConvertEventArgs.

Para obter mais informações sobre como manipular eventos, consulte manipulando e gerando eventos.For more information about handling events, see Handling and Raising Events.

Aplica-se a