ListControl.Format 이벤트

정의

컨트롤이 데이터 값에 바인딩되면 발생합니다.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 

예제

다음 코드 예제에서는이 멤버를 사용 하는 방법을 보여 줍니다.The following code example demonstrates the use of this member. 예제에서는 이벤트 처리기에서 보고서를 Format 이벤트입니다.In the example, an event handler reports on the occurrence of the Format event. 이 보고서를 통해 이벤트 발생 하 고 도움이 될 수 있습니다 디버깅 하는 경우를 학습할 수 있습니다.This report helps you to learn when the event occurs and can assist you in debugging. 자주 발생 하는 이벤트 또는 여러 이벤트를 보고 하려면 바꾸는 것이 좋습니다 MessageBox.Show 사용 하 여 Console.WriteLine 줄에 메시지를 추가 또는 TextBox합니다.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.

예제 코드를 실행 하려면에서 상속 되는 형식의 인스턴스를 포함 하는 프로젝트에 붙여넣습니다 ListControl와 같은 ComboBox 또는 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. 다음 인스턴스 이름을 ListControl1 이벤트 처리기를 연결 된 확인 된 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

설명

Format 에 표시 되는 각 항목 전에 이벤트가 발생 합니다 ListControl 서식이 지정 됩니다.The Format event is raised before each visible item in the ListControl is formatted. 이 이벤트를 처리 사용을 통해이 목록 항목에 대해 표시할 문자열에 액세스할 수 합니다 Value 의 속성을 ListControlConvertEventArgs입니다.Handling this event gives you access to the string to be displayed for this list item, through the Value property of the ListControlConvertEventArgs.

이벤트 처리에 대한 자세한 내용은 이벤트 처리 및 발생 을 참조하십시오.For more information about handling events, see Handling and Raising Events.

적용 대상