ListView.ColumnWidthChanging Evento

Definição

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Origem:

ListView.cs

Ocorre quando a largura de uma coluna está se alterando.

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 

Tipo de evento

ColumnWidthChangingEventHandler

Exemplos

O exemplo de código a seguir demonstra como lidar com o ColumnWidthChanging evento. Ele também demonstra os ColumnWidthChangingEventArgs.NewWidth membros e Cancel . Para executar este exemplo, cole o código em um Windows Form. Chame InitializeListView1 do construtor ou Load manipulador de eventos do formulário.

 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

Comentários

Esse evento permite que você marcar a nova largura da coluna com a ColumnWidthChangingEventArgs.NewWidth propriedade e cancele o evento se você escolher definindo a Cancel propriedade truecomo .

Para obter mais informações sobre como lidar com eventos, consulte Manipulando e gerando eventos.