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 에서 이벤트 처리기는 먼저 클릭이 단추 셀에 있는지 여부를 확인한 다음 행과 연결된 비즈니스 개체를 검색합니다. 이 예제는 방법: Windows Forms DataGridViewComboBoxCell Drop-Down 목록에서 개체 액세스에서 사용할 수 있는 더 큰 예제의 일부입니다.
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 단추와 유사한 UI를 표시하는 데 사용되는 특수 형식 DataGridViewCell 입니다.
DataGridViewButtonColumn 는 이 형식의 셀을 보유하도록 특수화된 열 형식입니다. 기본적으로 DataGridViewButtonColumn.CellTemplate 새 인스턴스화될 DataGridViewButtonCell합니다. 기존 열 내의 셀 패턴 DataGridViewButtonCell, 열 설정 CellTemplate 속성 패턴으로 사용 하 여 셀을 합니다.
사용자 단추 클릭에 응답하려면 또는 DataGridView.CellContentClick 이벤트를 처리 DataGridView.CellClick 합니다. 이벤트 처리기에서 사용할 수 있습니다는 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) |
메서드
적용 대상
추가 정보
.NET