DataGridTableStyle.ColumnHeadersVisible 属性

获取或设置一个值，该值指示列标头是否可见。

**命名空间:**System.Windows.Forms
**程序集:**System.Windows.Forms（在 system.windows.forms.dll 中）

语法

声明
Public Property ColumnHeadersVisible As Boolean
用法
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)

属性值

如果列标头可见，则为 true；否则为 false。默认为 true。

备注

若要设置标头的标题文本，请使用 DataGridColumnStyle 类的 HeaderText 属性。

示例

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

平台

Windows 98、Windows 2000 SP4、Windows CE、Windows Millennium Edition、Windows Mobile for Pocket PC、Windows Mobile for Smartphone、Windows Server 2003、Windows XP Media Center Edition、Windows XP Professional x64 Edition、Windows XP SP2、Windows XP Starter Edition

.NET Framework 并不是对每个平台的所有版本都提供支持。有关受支持版本的列表，请参见系统要求。

版本信息

.NET Framework

受以下版本支持：2.0、1.1、1.0

请参见

参考

DataGridTableStyle 类
DataGridTableStyle 成员
System.Windows.Forms 命名空间
HeaderBackColor
HeaderForeColor
RowHeadersVisible
ColumnHeadersVisibleChanged
HeaderFont
DataGridColumnStyle.HeaderText 属性