DataGridViewButtonCell 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
顯示用於 DataGridView 控制項，類似於按鈕的使用者介面 (UI)。
public ref class DataGridViewButtonCell : System::Windows::Forms::DataGridViewCellpublic class DataGridViewButtonCell : System.Windows.Forms.DataGridViewCelltype DataGridViewButtonCell = class
inherit DataGridViewCellPublic Class DataGridViewButtonCell
Inherits DataGridViewCell- 繼承
範例
下列程式碼範例示範如何使用 DataGridViewButtonColumn ，在特定資料列上執行動作。 使用個別 DataGridViewButtonCell 物件時，您可以使用類似的程式碼。 在此範例中 DataGridView.CellClick ，事件處理常式會先判斷按一下是否在按鈕資料格上，然後擷取與資料列相關聯的商務物件。 此範例是How to： Access Objects in a Windows Forms DataGridViewComboBoxCell Drop-Down List中可用的較大範例的一部分。
public class Form1 : Form
{
private List<Employee> employees = new List<Employee>();
private List<Task> tasks = new List<Task>();
private Button reportButton = new Button();
private DataGridView dataGridView1 = new DataGridView();
[STAThread]
public static void Main()
{
Application.Run(new Form1());
}
public Form1()
{
dataGridView1.Dock = DockStyle.Fill;
dataGridView1.AutoSizeColumnsMode =
DataGridViewAutoSizeColumnsMode.AllCells;
reportButton.Text = "Generate Report";
reportButton.Dock = DockStyle.Top;
reportButton.Click += new EventHandler(reportButton_Click);
Controls.Add(dataGridView1);
Controls.Add(reportButton);
Load += new EventHandler(Form1_Load);
Text = "DataGridViewComboBoxColumn Demo";
}
// Initializes the data source and populates the DataGridView control.
private void Form1_Load(object sender, EventArgs e)
{
PopulateLists();
dataGridView1.AutoGenerateColumns = false;
dataGridView1.DataSource = tasks;
AddColumns();
}
// Populates the employees and tasks lists.
private void PopulateLists()
{
employees.Add(new Employee("Harry"));
employees.Add(new Employee("Sally"));
employees.Add(new Employee("Roy"));
employees.Add(new Employee("Pris"));
tasks.Add(new Task(1, employees[1]));
tasks.Add(new Task(2));
tasks.Add(new Task(3, employees[2]));
tasks.Add(new Task(4));
}
// Configures columns for the DataGridView control.
private void AddColumns()
{
DataGridViewTextBoxColumn idColumn =
new DataGridViewTextBoxColumn();
idColumn.Name = "Task";
idColumn.DataPropertyName = "Id";
idColumn.ReadOnly = true;
DataGridViewComboBoxColumn assignedToColumn =
new DataGridViewComboBoxColumn();
// Populate the combo box drop-down list with Employee objects.
foreach (Employee e in employees) assignedToColumn.Items.Add(e);
// Add "unassigned" to the drop-down list and display it for
// empty AssignedTo values or when the user presses CTRL+0.
assignedToColumn.Items.Add("unassigned");
assignedToColumn.DefaultCellStyle.NullValue = "unassigned";
assignedToColumn.Name = "Assigned To";
assignedToColumn.DataPropertyName = "AssignedTo";
assignedToColumn.AutoComplete = true;
assignedToColumn.DisplayMember = "Name";
assignedToColumn.ValueMember = "Self";
// Add a button column.
DataGridViewButtonColumn buttonColumn =
new DataGridViewButtonColumn();
buttonColumn.HeaderText = "";
buttonColumn.Name = "Status Request";
buttonColumn.Text = "Request Status";
buttonColumn.UseColumnTextForButtonValue = true;
dataGridView1.Columns.Add(idColumn);
dataGridView1.Columns.Add(assignedToColumn);
dataGridView1.Columns.Add(buttonColumn);
// Add a CellClick handler to handle clicks in the button column.
dataGridView1.CellClick +=
new DataGridViewCellEventHandler(dataGridView1_CellClick);
}
// Reports on task assignments.
private void reportButton_Click(object sender, EventArgs e)
{
StringBuilder report = new StringBuilder();
foreach (Task t in tasks)
{
String assignment =
t.AssignedTo == null ?
"unassigned" : "assigned to " + t.AssignedTo.Name;
report.AppendFormat("Task {0} is {1}.", t.Id, assignment);
report.Append(Environment.NewLine);
}
MessageBox.Show(report.ToString(), "Task Assignments");
}
// Calls the Employee.RequestStatus method.
void dataGridView1_CellClick(object sender, DataGridViewCellEventArgs e)
{
// Ignore clicks that are not on button cells.
if (e.RowIndex < 0 || e.ColumnIndex !=
dataGridView1.Columns["Status Request"].Index) return;
// Retrieve the task ID.
Int32 taskID = (Int32)dataGridView1[0, e.RowIndex].Value;
// Retrieve the Employee object from the "Assigned To" cell.
Employee assignedTo = dataGridView1.Rows[e.RowIndex]
.Cells["Assigned To"].Value as Employee;
// Request status through the Employee object if present.
if (assignedTo != null)
{
assignedTo.RequestStatus(taskID);
}
else
{
MessageBox.Show(String.Format(
"Task {0} is unassigned.", taskID), "Status Request");
}
}
}
Public Class Form1
Inherits Form
Private employees As New List(Of Employee)
Private tasks As New List(Of Task)
Private WithEvents reportButton As New Button
Private WithEvents dataGridView1 As New DataGridView
<STAThread()> _
Public Sub Main()
Application.Run(New Form1)
End Sub
Sub New()
dataGridView1.Dock = DockStyle.Fill
dataGridView1.AutoSizeColumnsMode = _
DataGridViewAutoSizeColumnsMode.AllCells
reportButton.Text = "Generate Report"
reportButton.Dock = DockStyle.Top
Controls.Add(dataGridView1)
Controls.Add(reportButton)
Text = "DataGridViewComboBoxColumn Demo"
End Sub
' Initializes the data source and populates the DataGridView control.
Private Sub Form1_Load(ByVal sender As Object, _
ByVal e As EventArgs) Handles Me.Load
PopulateLists()
dataGridView1.AutoGenerateColumns = False
dataGridView1.DataSource = tasks
AddColumns()
End Sub
' Populates the employees and tasks lists.
Private Sub PopulateLists()
employees.Add(New Employee("Harry"))
employees.Add(New Employee("Sally"))
employees.Add(New Employee("Roy"))
employees.Add(New Employee("Pris"))
tasks.Add(New Task(1, employees(1)))
tasks.Add(New Task(2))
tasks.Add(New Task(3, employees(2)))
tasks.Add(New Task(4))
End Sub
' Configures columns for the DataGridView control.
Private Sub AddColumns()
Dim idColumn As New DataGridViewTextBoxColumn()
idColumn.Name = "Task"
idColumn.DataPropertyName = "Id"
idColumn.ReadOnly = True
Dim assignedToColumn As New DataGridViewComboBoxColumn()
' Populate the combo box drop-down list with Employee objects.
For Each e As Employee In employees
assignedToColumn.Items.Add(e)
Next
' Add "unassigned" to the drop-down list and display it for
' empty AssignedTo values or when the user presses CTRL+0.
assignedToColumn.Items.Add("unassigned")
assignedToColumn.DefaultCellStyle.NullValue = "unassigned"
assignedToColumn.Name = "Assigned To"
assignedToColumn.DataPropertyName = "AssignedTo"
assignedToColumn.AutoComplete = True
assignedToColumn.DisplayMember = "Name"
assignedToColumn.ValueMember = "Self"
' Add a button column.
Dim buttonColumn As New DataGridViewButtonColumn()
buttonColumn.HeaderText = ""
buttonColumn.Name = "Status Request"
buttonColumn.Text = "Request Status"
buttonColumn.UseColumnTextForButtonValue = True
dataGridView1.Columns.Add(idColumn)
dataGridView1.Columns.Add(assignedToColumn)
dataGridView1.Columns.Add(buttonColumn)
End Sub
' Reports on task assignments.
Private Sub reportButton_Click(ByVal sender As Object, _
ByVal e As EventArgs) Handles reportButton.Click
Dim report As New StringBuilder()
For Each t As Task In tasks
Dim assignment As String
If t.AssignedTo Is Nothing Then
assignment = "unassigned"
Else
assignment = "assigned to " + t.AssignedTo.Name
End If
report.AppendFormat("Task {0} is {1}.", t.Id, assignment)
report.Append(Environment.NewLine)
Next
MessageBox.Show(report.ToString(), "Task Assignments")
End Sub
' Calls the Employee.RequestStatus method.
Private Sub dataGridView1_CellClick(ByVal sender As Object, _
ByVal e As DataGridViewCellEventArgs) _
Handles dataGridView1.CellClick
' Ignore clicks that are not on button cells.
If e.RowIndex < 0 OrElse Not e.ColumnIndex = _
dataGridView1.Columns("Status Request").Index Then Return
' Retrieve the task ID.
Dim taskID As Int32 = CInt(dataGridView1(0, e.RowIndex).Value)
' Retrieve the Employee object from the "Assigned To" cell.
Dim assignedTo As Employee = TryCast(dataGridView1.Rows(e.RowIndex) _
.Cells("Assigned To").Value, Employee)
' Request status through the Employee object if present.
If assignedTo IsNot Nothing Then
assignedTo.RequestStatus(taskID)
Else
MessageBox.Show(String.Format( _
"Task {0} is unassigned.", taskID), "Status Request")
End If
End Sub
End Class
備註
類別 DataGridViewButtonCell 是特殊類型的 ， DataGridViewCell 用來顯示類似按鈕的 UI。
DataGridViewButtonColumn 是特製化用來保存此類型儲存格的資料行類型。 根據預設，會 DataGridViewButtonColumn.CellTemplate 初始化為新的 DataGridViewButtonCell 。 若要在現有 DataGridViewButtonCell 之後建立資料行內儲存格的圖樣，請將資料 CellTemplate 行的 屬性設定為要當做圖樣使用的儲存格。
若要回應使用者按鈕按一下，請處理 DataGridView.CellClick 或 DataGridView.CellContentClick 事件。 在事件處理常式中 DataGridViewCellEventArgs.ColumnIndex ，您可以使用 屬性來判斷按一下是否發生按鈕資料行。 您可以使用 DataGridViewCellEventArgs.RowIndex 屬性來判斷按一下是否發生在特定按鈕儲存格中。
資料行的儲存格相關屬性是樣板儲存格類似名稱屬性的包裝函式。 變更範本儲存格的屬性值只會根據變更之後新增的範本影響儲存格。 不過，變更資料行的資料格相關屬性值將會更新範本儲存格和資料行中的所有其他儲存格，並視需要重新整理資料行顯示。
注意
啟用視覺樣式時，按鈕資料行中的按鈕會使用 ButtonRenderer 繪製，而透過屬性 DefaultCellStyle 指定的儲存格樣式則沒有作用。
給繼承者的注意事項
當您衍生自 DataGridViewButtonCell 並新增屬性至衍生類別時，請務必覆寫 Clone() 方法，以在複製作業期間複製新屬性。 您也應該呼叫基類 Clone() 的 方法，以便基類的屬性複製到新的儲存格。
建構函式
| DataGridViewButtonCell() |
初始化 DataGridViewButtonCell 類別的新執行個體。 |
屬性
| AccessibilityObject |
取得指定給 DataGridViewCell.DataGridViewCellAccessibleObject 的 DataGridViewCell。 (繼承來源 DataGridViewCell) |
| ColumnIndex |
取得這個儲存格的資料行索引。 (繼承來源 DataGridViewCell) |
| ContentBounds |
取得圍住儲存格內容區域的周框。 (繼承來源 DataGridViewCell) |
| ContextMenuStrip |
取得或設定與儲存格相關聯的捷徑功能表。 (繼承來源 DataGridViewCell) |
| DataGridView |
取得與這個項目有關聯的 DataGridView 控制項。 (繼承來源 DataGridViewElement) |
| DefaultNewRowValue |
取得新資料錄之資料列中儲存格的預設值。 (繼承來源 DataGridViewCell) |
| Displayed |
取得值，該值表示儲存格目前是否顯示於螢幕上。 (繼承來源 DataGridViewCell) |
| EditedFormattedValue |
取得目前已格式化的儲存格值，不管儲存格是否處於編輯模式，而值是否尚未認可。 (繼承來源 DataGridViewCell) |
| EditType |
取得儲存格的裝載編輯控制項型別。 |
| ErrorIconBounds |
取得儲存格之錯誤圖示的界限。 (繼承來源 DataGridViewCell) |
| ErrorText |
取得或設定文字，描述與儲存格相關聯的錯誤狀況。 (繼承來源 DataGridViewCell) |
| FlatStyle |
取得或設定可決定按鈕外觀的樣式。 |
| FormattedValue |
取得儲存格的格式化值，以供顯示。 (繼承來源 DataGridViewCell) |
| FormattedValueType |
取得與儲存格相關聯之格式化值的類型。 |
| Frozen |
取得指出是否已凍結此儲存格的值。 (繼承來源 DataGridViewCell) |
| HasStyle |
取得指出是否已經設定 Style 屬性的值。 (繼承來源 DataGridViewCell) |
| InheritedState |
取得儲存格的目前狀態，是繼承其資料列和資料行的狀態。 (繼承來源 DataGridViewCell) |
| InheritedStyle |
取得目前套用至儲存格的樣式。 (繼承來源 DataGridViewCell) |
| IsInEditMode |
取得指出目前是否正在編輯這個儲存格的值。 (繼承來源 DataGridViewCell) |
| OwningColumn |
取得包含這個儲存格的資料行。 (繼承來源 DataGridViewCell) |
| OwningRow |
取得包含這個儲存格的資料列。 (繼承來源 DataGridViewCell) |
| PreferredSize |
取得能夠容納儲存格的矩形區域大小 (以像素為單位)。 (繼承來源 DataGridViewCell) |
| ReadOnly |
取得或設定值，指出是否可以編輯儲存格的資料。 (繼承來源 DataGridViewCell) |
| Resizable |
取得指出儲存格是否可以調整大小的值。 (繼承來源 DataGridViewCell) |
| RowIndex |
取得儲存格的父資料列索引。 (繼承來源 DataGridViewCell) |
| Selected |
取得或設定值，指出是否已選取此儲存格。 (繼承來源 DataGridViewCell) |
| Size |
取得儲存格的大小。 (繼承來源 DataGridViewCell) |
| State |
取得此項目的使用者介面 (UI) 狀態。 (繼承來源 DataGridViewElement) |
| Style |
取得或設定儲存格的樣式。 (繼承來源 DataGridViewCell) |
| Tag |
取得或設定物件，其中包含儲存格的相關補充資料。 (繼承來源 DataGridViewCell) |
| ToolTipText |
取得或設定與這個儲存格相關聯的工具提示文字。 (繼承來源 DataGridViewCell) |
| UseColumnTextForButtonValue |
取得或設定值，指出主控資料行的文字是否會出現在儲存格所顯示的按鈕上。 |
| Value |
取得或設定與這個儲存格相關聯的值。 (繼承來源 DataGridViewCell) |
| ValueType |
取得或設定儲存格中值的資料類型。 |
| Visible |
取得指出儲存格是在已隱藏資料列或是資料行中的值。 (繼承來源 DataGridViewCell) |
