DataGridView.RowTemplate 속성

정의

컨트롤에 있는 모든 행의 템플릿을 나타내는 행을 가져오거나 설정합니다.Gets or sets the row that represents the template for all the rows in the control.

public:
 property System::Windows::Forms::DataGridViewRow ^ RowTemplate { System::Windows::Forms::DataGridViewRow ^ get(); void set(System::Windows::Forms::DataGridViewRow ^ value); };
[System.ComponentModel.Browsable(true)]
public System.Windows.Forms.DataGridViewRow RowTemplate { get; set; }
member this.RowTemplate : System.Windows.Forms.DataGridViewRow with get, set
Public Property RowTemplate As DataGridViewRow

속성 값

행 템플릿을 나타내는 DataGridViewRow입니다.A DataGridViewRow representing the row template.

특성

예외

이 속성을 설정할 때 지정된 행이 해당 DataGridView 속성 집합을 가지는 경우The specified row when setting this property has its DataGridView property set.

예제

다음 코드 예제에서는 행 템플릿을 사용 하 여 초기 행 높이 및 최소 행 높이 지정 하는 방법을 보여 줍니다.The following code example illustrates how to use the row template to specify an initial row height and a minimum row height.

DataGridViewRow^ row = this->dataGridView1->RowTemplate;
row->DefaultCellStyle->BackColor = Color::Bisque;
row->Height = 35;
row->MinimumHeight = 20;

DataGridViewRow row = this.dataGridView1.RowTemplate;
row.DefaultCellStyle.BackColor = Color.Bisque;
row.Height = 35;
row.MinimumHeight = 20;
With Me.dataGridView1.RowTemplate
    .DefaultCellStyle.BackColor = Color.Bisque
    .Height = 35
    .MinimumHeight = 20
End With

설명

모양 보다 더 세밀히 제어 하려는 경우에 따라 DataGridView 다양 한에서 제공 하는 것 보다 행 DataGridView 셀 스타일 속성입니다.Sometimes you want greater control over the appearance of DataGridView rows than what is provided by the various DataGridView cell style properties. 합니다 RowTemplate 하면 속성 만들기 및 초기화를 DataGridViewRow 경우 모든 행에 대 한 템플릿으로 사용에 대 한 행을 새 레코드를 포함 AllowUserToAddRowstrue합니다.The RowTemplate property lets you create and initialize a DataGridViewRow for use as a template by all rows, including the row for new records if AllowUserToAddRows is true.

행 높이 같은 속성에 대 한 기본값을 설정 하는 경우에 유용 합니다.This is useful when you are setting default values for properties such as row height. 예를 들어, 다음 여러 열에 걸쳐 있는 콘텐츠를 표시 하는 것에 대 한 일반 셀 내용 아래에 추가 공간을 제공 하기 위해 기본 행 높이 향상 하는 것이 좋습니다.For example, you may want to increase the default row height in order to provide extra room beneath ordinary cell content for displaying content that spans multiple columns.

행 템플릿을 설정은 필요한 외부 데이터에서 파생 된 사용자 지정 형식을 사용 하 여 표시 되 면를 DataGridViewRow 클래스입니다.Setting the row template is necessary when external data is displayed using custom types derived from the DataGridViewRow class. 바인딩되지 않은 DataGridView 컨트롤을 프로그래밍 방식으로 채울 수는 Rows 사용자 지정 행 형식의 인스턴스를 사용 하 여 컬렉션입니다.With unbound DataGridView controls, you can programmatically populate the Rows collection with instances of your custom row type. 그러나 외부 데이터를 표시할 때 행은 자동으로 생성 되지만 해당 템플릿을 기반으로 행을 사용자 지정 행 형식의 인스턴스로 설정할 수 있습니다.When displaying external data, however, the rows are generated automatically, but they are based on the row template, which you can set to an instance of your custom row type.

이 속성이 해당 값을 검색 하면 처음으로 설정 하지 않은 경우 새 DataGridViewRow 가 만들어져 반환 합니다.If this property has not been set the first time you retrieve its value, a new DataGridViewRow is created and returned.

적용 대상

추가 정보