ListView.ColumnWidthChanging Ereignis

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Tritt ein, wenn sich die Breite einer Spalte ändert.

public:
 event System::Windows::Forms::ColumnWidthChangingEventHandler ^ ColumnWidthChanging;

public event System.Windows.Forms.ColumnWidthChangingEventHandler? ColumnWidthChanging;

member this.ColumnWidthChanging : System.Windows.Forms.ColumnWidthChangingEventHandler 

Public Custom Event ColumnWidthChanging As ColumnWidthChangingEventHandler 

Ereignistyp

ColumnWidthChangingEventHandler

Beispiele

Im folgenden Codebeispiel wird die Behandlung des Ereignisses ColumnWidthChanging veranschaulicht. Außerdem werden die ColumnWidthChangingEventArgs.NewWidth Member und Cancel veranschaulicht. Um dieses Beispiel auszuführen, fügen Sie den Code in ein Windows Form-Formular ein. Rufen Sie InitializeListView1 aus dem Konstruktor oder Load Ereignishandler des Formulars auf.

 ListView listView1 = new ListView();
 private void InitializeListView1()
 {
     // Initialize a ListView in detail view and add some columns.
     listView1.View = View.Details;
     listView1.Width = 200;
     listView1.Columns.Add("Column1");
     listView1.Columns.Add("Column2");

     // Associate a method with the ColumnWidthChangingEvent.
     listView1.ColumnWidthChanging += 
         new ColumnWidthChangingEventHandler(listView1_ColumnWidthChanging);
     this.Controls.Add(listView1);
 }

 // Handle the ColumnWidthChangingEvent.
 private void listView1_ColumnWidthChanging(object sender,  
     ColumnWidthChangingEventArgs e)
 {
     // Check if the new width is too big or too small.
     if (e.NewWidth > 100 || e.NewWidth < 5)
     {
         // Cancel the event and inform the user if the new
         // width does not meet the criteria.
         MessageBox.Show("Column width is too large or too small");
         e.Cancel = true;
     }
 }

Private WithEvents listView1 As New ListView()

Private Sub InitializeListView1()

    ' Initialize a ListView in detail view and add some columns.
    listView1.View = View.Details
    listView1.Width = 200
    listView1.Columns.Add("Column1")
    listView1.Columns.Add("Column2")
    Me.Controls.Add(listView1)

End Sub


' Handle the ColumnWidthChangingEvent.
Private Sub listView1_ColumnWidthChanging(ByVal sender As Object, _
    ByVal e As ColumnWidthChangingEventArgs) _
    Handles listView1.ColumnWidthChanging

    ' Check if the new width is too big or too small.
    If e.NewWidth > 100 OrElse e.NewWidth < 5 Then

        ' Cancel the event and inform the user if the new
        ' width does not meet the criteria.
        MessageBox.Show("Column width is too large or too small")
        e.Cancel = True
    End If

End Sub

Hinweise

Mit diesem Ereignis können Sie die neue Spaltenbreite mit der ColumnWidthChangingEventArgs.NewWidth -Eigenschaft überprüfen und das Ereignis abbrechen, wenn Sie dies auswählen, indem Sie die Cancel -Eigenschaft auf truefestlegen.

Weitere Informationen zur Behandlung von Ereignissen finden Sie unter behandeln und Auslösen von Ereignissen.