ListControl.Format 事件

定義

命名空間:

System.Windows.Forms

組件:

System.Windows.Forms.dll

發生於控制項繫結至資料值時。

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 

事件類型

ListControlConvertEventHandler

範例

下列程式碼範例示範此成員的使用。 在此範例中，事件處理常式會報告事件發生次數 Format 。 此報告可協助您瞭解事件發生的時間，並可協助您進行偵錯。 若要報告多個事件或經常發生的事件，請考慮將 取代 MessageBox.ShowConsole.WriteLine 為 或將訊息附加至多行 TextBox 。

若要執行範例程式碼，請將它貼到包含繼承自 ListControl 之型別實例的專案，例如 ComboBox 或 ListBox 。 然後命名 實例 ListControl1 ，並確定事件處理常式與事件相關聯 Format 。

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

備註

事件 Format 會在 中每個可見專案 ListControl 格式化之前引發。 處理此事件可讓您透過 Value 的 ListControlConvertEventArgs 屬性，存取要針對此清單專案顯示的字串。

如需處理事件的詳細資訊，請參閱 處理和引發事件。