ListView.ColumnWidthChanging Ereignis

Referenz

Definition

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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

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

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.

Gilt für:

Freigeben über