ListControl.Format Událost

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

Zdroj:

ListControl.cs

Nastane, když je ovládací prvek svázán s datovou hodnotou.

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 

Event Type

ListControlConvertEventHandler

Příklady

Následující příklad kódu ukazuje použití tohoto člena. V tomto příkladu obslužná rutina události hlásí výskyt Format události. Tato sestava vám pomůže zjistit, kdy k události dojde, a může vám pomoct při ladění. Chcete-li hlásit více událostí nebo událostí, ke kterým dochází často, zvažte nahrazení MessageBox.ShowConsole.WriteLine nebo připojení zprávy do víceřádkového řetězce TextBox.

Pokud chcete spustit ukázkový kód, vložte ho do projektu, který obsahuje instanci typu, který dědí z ListControlobjektu , například nebo ComboBoxListBox. Potom instanci ListControl1 pojmenujte a ujistěte se, že je obslužná rutina události přidružená k Format události.

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

Poznámky

Událost Format se vyvolá před formátováním každé viditelné položky ListControl . Zpracování této události poskytuje přístup k řetězci, který se má zobrazit pro tuto položku seznamu prostřednictvím Value vlastnosti ListControlConvertEventArgs.

Další informace o zpracování událostí naleznete v tématu Zpracování a vyvolávání událostí.