DataGridTableStyle.ColumnHeadersVisible-Eigenschaft
Ruft einen Wert ab, der angibt, ob die Spaltenköpfe sichtbar sind, oder legt diesen fest.
Namespace: System.Windows.Forms
Assembly: System.Windows.Forms (in system.windows.forms.dll)
Syntax
'Declaration
Public Property ColumnHeadersVisible As Boolean
'Usage
Dim instance As DataGridTableStyle
Dim value As Boolean
value = instance.ColumnHeadersVisible
instance.ColumnHeadersVisible = value
public bool ColumnHeadersVisible { get; set; }
public:
property bool ColumnHeadersVisible {
bool get ();
void set (bool value);
}
/** @property */
public boolean get_ColumnHeadersVisible ()
/** @property */
public void set_ColumnHeadersVisible (boolean value)
public function get ColumnHeadersVisible () : boolean
public function set ColumnHeadersVisible (value : boolean)
Eigenschaftenwert
true, wenn die Spaltenköpfe sichtbar sind, andernfalls false. Der Standardwert ist true.
Hinweise
Zum Festlegen von Text für Kopfzeilenbeschriftungen verwenden Sie die HeaderText-Eigenschaft der DataGridColumnStyle-Klasse.
Beispiel
Private Sub DataGridTableStyle_Sample_Load(ByVal sender As Object, _
ByVal e As EventArgs) Handles MyBase.Load
myDataGridTableStyle1 = New DataGridTableStyle()
myHeaderLabel.Text = "Header Status :" + myDataGridTableStyle1.ColumnHeadersVisible.ToString()
If myDataGridTableStyle1.ColumnHeadersVisible = True Then
btnheader.Text = "Remove Header"
Else
btnheader.Text = "Add Header"
End If
AddCustomDataTableStyle()
End Sub 'DataGridTableStyle_Sample_Load
Private Sub AddCustomDataTableStyle()
AddHandler myDataGridTableStyle1.ColumnHeadersVisibleChanged, AddressOf ColumnHeadersVisibleChanged_Handler
' Set ColumnheaderVisible property.
myDataGridTableStyle1.MappingName = "Customers"
' Add a GridColumnStyle and set its MappingName
Dim myBoolCol = New DataGridBoolColumn()
myBoolCol.MappingName = "Current"
myBoolCol.HeaderText = "IsCurrent Customer"
myBoolCol.Width = 150
myDataGridTableStyle1.GridColumnStyles.Add(myBoolCol)
' Add a second column style.
Dim myTextCol = New DataGridTextBoxColumn()
myTextCol.MappingName = "custName"
myTextCol.HeaderText = "Customer Name"
myTextCol.Width = 250
myDataGridTableStyle1.GridColumnStyles.Add(myTextCol)
' Create new ColumnStyle objects
Dim cOrderDate = New DataGridTextBoxColumn()
cOrderDate.MappingName = "OrderDate"
cOrderDate.HeaderText = "Order Date"
cOrderDate.Width = 100
' PropertyDescriptor to create a formatted column.
Dim myPropertyDescriptorCollection As PropertyDescriptorCollection = _
Me.BindingContext(myDataSet, "Customers.custToOrders").GetItemProperties()
' Create a formatted column using a PropertyDescriptor.
Dim csOrderAmount = New DataGridTextBoxColumn(myPropertyDescriptorCollection("OrderAmount"), "c", True)
csOrderAmount.MappingName = "OrderAmount"
csOrderAmount.HeaderText = "Total"
csOrderAmount.Width = 100
' Add the DataGridTableStyle instances to GridTableStylesCollection.
myDataGrid.TableStyles.Add(myDataGridTableStyle1)
End Sub 'AddCustomDataTableStyle
Private Sub ColumnHeadersVisibleChanged_Handler(ByVal sender As Object, ByVal e As EventArgs)
myHeaderLabel.Text = "Header Status :" + myDataGridTableStyle1.ColumnHeadersVisible.ToString()
End Sub 'ColumnHeadersVisibleChanged_Handler
Private Sub btnheader_Click(ByVal sender As Object, ByVal e As EventArgs) Handles btnheader.Click
If myDataGridTableStyle1.ColumnHeadersVisible = True Then
myDataGridTableStyle1.ColumnHeadersVisible = False
btnheader.Text = "Add Header"
Else
myDataGridTableStyle1.ColumnHeadersVisible = True
btnheader.Text = "Remove Header"
End If
End Sub 'btnheader_Click
private void DataGridTableStyle_Sample_Load(object sender,
EventArgs e)
{
myDataGridTableStyle1 = new DataGridTableStyle();
myHeaderLabel.Text = "Header Status :"
+ myDataGridTableStyle1.ColumnHeadersVisible.ToString();
if(myDataGridTableStyle1.ColumnHeadersVisible == true)
{
btnheader.Text = "Remove Header";
}
else
{
btnheader.Text = "Add Header";
}
AddCustomDataTableStyle();
}
private void AddCustomDataTableStyle()
{
myDataGridTableStyle1.ColumnHeadersVisibleChanged
+= new System.EventHandler(ColumnHeadersVisibleChanged_Handler);
// Set ColumnheaderVisible property.
myDataGridTableStyle1.MappingName = "Customers";
// Add a GridColumnStyle and set its MappingName
DataGridColumnStyle myBoolCol = new DataGridBoolColumn();
myBoolCol.MappingName = "Current";
myBoolCol.HeaderText = "IsCurrent Customer";
myBoolCol.Width = 150;
myDataGridTableStyle1.GridColumnStyles.Add(myBoolCol);
// Add a second column style.
DataGridColumnStyle myTextCol = new DataGridTextBoxColumn();
myTextCol.MappingName = "custName";
myTextCol.HeaderText = "Customer Name";
myTextCol.Width = 250;
myDataGridTableStyle1.GridColumnStyles.Add(myTextCol);
// Create new ColumnStyle objects
DataGridColumnStyle cOrderDate = new DataGridTextBoxColumn();
cOrderDate.MappingName = "OrderDate";
cOrderDate.HeaderText = "Order Date";
cOrderDate.Width = 100;
// PropertyDescriptor to create a formatted column.
PropertyDescriptorCollection myPropertyDescriptorCollection = this.BindingContext
[myDataSet, "Customers.custToOrders"].GetItemProperties();
// Create a formatted column using a PropertyDescriptor.
DataGridColumnStyle csOrderAmount =
new DataGridTextBoxColumn(myPropertyDescriptorCollection["OrderAmount"], "c", true);
csOrderAmount.MappingName = "OrderAmount";
csOrderAmount.HeaderText = "Total";
csOrderAmount.Width = 100;
// Add the DataGridTableStyle instances to GridTableStylesCollection.
myDataGrid.TableStyles.Add(myDataGridTableStyle1);
}
private void ColumnHeadersVisibleChanged_Handler(object sender,
EventArgs e)
{
myHeaderLabel.Text = "Header Status :"
+ myDataGridTableStyle1.ColumnHeadersVisible.ToString();
}
private void btnheader_Click(object sender, EventArgs e)
{
if(myDataGridTableStyle1.ColumnHeadersVisible == true)
{
myDataGridTableStyle1.ColumnHeadersVisible = false;
btnheader.Text = "Add Header";
}
else
{
myDataGridTableStyle1.ColumnHeadersVisible = true;
btnheader.Text = "Remove Header";
}
}
private:
void DataGridTableStyle_Sample_Load( Object^ /*sender*/, EventArgs^ /*e*/ )
{
myDataGridTableStyle1 = gcnew DataGridTableStyle;
myHeaderLabel->Text = String::Concat( "Header Status : ", myDataGridTableStyle1->ColumnHeadersVisible );
if ( myDataGridTableStyle1->ColumnHeadersVisible == true )
{
btnheader->Text = "Remove Header";
}
else
{
btnheader->Text = "Add Header";
}
AddCustomDataTableStyle();
}
void AddCustomDataTableStyle()
{
myDataGridTableStyle1->ColumnHeadersVisibleChanged += gcnew System::EventHandler( this, &DataGridTableStyle_Sample::ColumnHeadersVisibleChanged_Handler );
// Set ColumnheaderVisible property.
myDataGridTableStyle1->MappingName = "Customers";
// Add a GridColumnStyle and set its MappingName
DataGridColumnStyle^ myBoolCol = gcnew DataGridBoolColumn;
myBoolCol->MappingName = "Current";
myBoolCol->HeaderText = "IsCurrent Customer";
myBoolCol->Width = 150;
myDataGridTableStyle1->GridColumnStyles->Add( myBoolCol );
// Add a second column style.
DataGridColumnStyle^ myTextCol = gcnew DataGridTextBoxColumn;
myTextCol->MappingName = "custName";
myTextCol->HeaderText = "Customer Name";
myTextCol->Width = 250;
myDataGridTableStyle1->GridColumnStyles->Add( myTextCol );
// Create new ColumnStyle objects
DataGridColumnStyle^ cOrderDate = gcnew DataGridTextBoxColumn;
cOrderDate->MappingName = "OrderDate";
cOrderDate->HeaderText = "Order Date";
cOrderDate->Width = 100;
// PropertyDescriptor to create a formatted column.
PropertyDescriptorCollection^ myPropertyDescriptorCollection =
this->BindingContext[myDataSet, "Customers::custToOrders"]->GetItemProperties();
// Create a formatted column using a PropertyDescriptor.
DataGridColumnStyle^ csOrderAmount =
gcnew DataGridTextBoxColumn( myPropertyDescriptorCollection[ "OrderAmount" ],"c",true );
csOrderAmount->MappingName = "OrderAmount";
csOrderAmount->HeaderText = "Total";
csOrderAmount->Width = 100;
// Add the DataGridTableStyle instances to GridTableStylesCollection.
myDataGrid->TableStyles->Add( myDataGridTableStyle1 );
}
void ColumnHeadersVisibleChanged_Handler( Object^ /*sender*/, EventArgs^ /*e*/ )
{
myHeaderLabel->Text = String::Concat( "Header Status : ", myDataGridTableStyle1->ColumnHeadersVisible );
}
void btnheader_Click( Object^ /*sender*/, EventArgs^ /*e*/ )
{
if ( myDataGridTableStyle1->ColumnHeadersVisible == true )
{
myDataGridTableStyle1->ColumnHeadersVisible = false;
btnheader->Text = "Add Header";
}
else
{
myDataGridTableStyle1->ColumnHeadersVisible = true;
btnheader->Text = "Remove Header";
}
}
private void DataGridTableStyleSampleLoad(Object sender, EventArgs e)
{
myDataGridTableStyle1 = new DataGridTableStyle();
myHeaderLabel.set_Text("Header Status :"
+ System.Convert.ToString(myDataGridTableStyle1.
get_ColumnHeadersVisible()));
if (myDataGridTableStyle1.get_ColumnHeadersVisible() == true) {
btnheader.set_Text("Remove Header");
}
else {
btnheader.set_Text("Add Header");
}
AddCustomDataTableStyle();
} //DataGridTableStyleSampleLoad
private void AddCustomDataTableStyle()
{
myDataGridTableStyle1.add_ColumnHeadersVisibleChanged(
new System.EventHandler(ColumnHeadersVisibleChanged_Handler));
// Set ColumnheaderVisible property.
myDataGridTableStyle1.set_MappingName("Customers");
// Add a GridColumnStyle and set its MappingName
DataGridColumnStyle myBoolCol = new DataGridBoolColumn();
myBoolCol.set_MappingName("Current");
myBoolCol.set_HeaderText("IsCurrent Customer");
myBoolCol.set_Width(150);
myDataGridTableStyle1.get_GridColumnStyles().Add(myBoolCol);
// Add a second column style.
DataGridColumnStyle myTextCol = new DataGridTextBoxColumn();
myTextCol.set_MappingName("custName");
myTextCol.set_HeaderText("Customer Name");
myTextCol.set_Width(250);
myDataGridTableStyle1.get_GridColumnStyles().Add(myTextCol);
// Create new ColumnStyle objects
DataGridColumnStyle cOrderDate = new DataGridTextBoxColumn();
cOrderDate.set_MappingName("OrderDate");
cOrderDate.set_HeaderText("Order Date");
cOrderDate.set_Width(100);
// PropertyDescriptor to create a formatted column.
PropertyDescriptorCollection myPropertyDescriptorCollection =
this.get_BindingContext().get_Item(myDataSet,
"Customers.custToOrders").GetItemProperties();
// Create a formatted column using a PropertyDescriptor.
DataGridColumnStyle csOrderAmount =
new DataGridTextBoxColumn(myPropertyDescriptorCollection.
get_Item("OrderAmount"), "c", true);
csOrderAmount.set_MappingName("OrderAmount");
csOrderAmount.set_HeaderText("Total");
csOrderAmount.set_Width(100);
// Add the DataGridTableStyle instances to GridTableStylesCollection.
myDataGrid.get_TableStyles().Add(myDataGridTableStyle1);
} //AddCustomDataTableStyle
private void ColumnHeadersVisibleChanged_Handler(Object sender,
EventArgs e)
{
myHeaderLabel.set_Text("Header Status :"
+ ((System.Boolean)myDataGridTableStyle1.
get_ColumnHeadersVisible()).ToString());
} //ColumnHeadersVisibleChanged_Handler
private void btnheader_Click(Object sender, EventArgs e)
{
if (myDataGridTableStyle1.get_ColumnHeadersVisible() == true) {
myDataGridTableStyle1.set_ColumnHeadersVisible(false);
btnheader.set_Text("Add Header");
}
else {
myDataGridTableStyle1.set_ColumnHeadersVisible(true);
btnheader.set_Text("Remove Header");
}
} //btnheader_Click
Plattformen
Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition
.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.
Versionsinformationen
.NET Framework
Unterstützt in: 2.0, 1.1, 1.0
Siehe auch
Referenz
DataGridTableStyle-Klasse
DataGridTableStyle-Member
System.Windows.Forms-Namespace
HeaderBackColor
HeaderForeColor
RowHeadersVisible
ColumnHeadersVisibleChanged
HeaderFont
DataGridColumnStyle.HeaderText-Eigenschaft