ListControl.Format Evento
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Ocorre quando o controlo está ligado a um valor de dados.
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 de Evento
Exemplos
O seguinte exemplo de código demonstra a utilização deste elemento. No exemplo, um gestor de eventos reporta a ocorrência do Format evento. Este relatório ajuda-o a saber quando o evento ocorre e pode ajudá-lo na depuração. Para reportar múltiplos eventos ou eventos que ocorrem frequentemente, considere substituir MessageBox.Show ou Console.WriteLine anexar a mensagem a uma multilinha TextBox.
Para executar o código de exemplo, cole-o num projeto que contenha uma instância de um tipo que herda de ListControl, como um ComboBox ou ListBox. Depois, nomeie a instância ListControl1 e assegure que o gestor de eventos está associado ao Format evento.
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
Observações
O Format evento é ativado antes de cada item visível no ListControl é formatado. Gerir este evento dá-lhe acesso à string a ser apresentada para este item da lista, através da Value propriedade do ListControlConvertEventArgs.
Para obter mais informações sobre como manipular eventos, consulte Manipulando e gerando eventos.
