ListView.ColumnWidthChanging 事件
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
發生於資料行的寬度變更時。
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
事件類型
範例
下列程式碼範例示範如何處理 ColumnWidthChanging 事件。 它也示範 ColumnWidthChangingEventArgs.NewWidth 和 Cancel 成員。 若要執行此範例,請將程式碼貼到 Windows Form 中。 從表單的建構函式或 Load 事件處理常式呼叫 InitializeListView1
。
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
備註
此事件可讓您使用 ColumnWidthChangingEventArgs.NewWidth 屬性檢查新的資料行寬度,如果您選擇將 屬性設定 Cancel 為 true
,請取消事件。
如需處理事件的詳細資訊,請參閱 處理和引發事件。