DataGridTableStyle.RowHeadersVisible Property

Reference

Definition

Namespace:: System.Windows.Forms

Assembly:: System.Windows.Forms.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Gets or sets a value indicating whether row headers are visible.

public:
 property bool RowHeadersVisible { bool get(); void set(bool value); };

public bool RowHeadersVisible { get; set; }

member this.RowHeadersVisible : bool with get, set

Public Property RowHeadersVisible As Boolean

Property Value

Boolean

true if row headers are visible; otherwise, false. The default is true.

Examples

The following code example demonstrates the use of this member.

   // Instantiate the EventHandler.
public:
   void AttachRowHeaderVisibleChanged()
   {
      myDataGridTableStyle->RowHeadersVisibleChanged += gcnew EventHandler( this, &MyDataGridTableStyle_RowHeadersVisibleChanged::MyDelegateRowHeadersVisibleChanged );
   }

   // raise the event when RowHeadersVisible property is changed.
private:
   void MyDelegateRowHeadersVisibleChanged( Object^ /*sender*/, EventArgs^ /*e*/ )
   {
      String^ myString = "'RowHeadersVisibleChanged' event raised, Row Headers are";
      if ( myDataGridTableStyle->RowHeadersVisible )
            myString = String::Concat( myString, " visible" );
      else
            myString = String::Concat( myString, " not visible" );

      MessageBox::Show( myString, "RowHeader information" );
   }

   // raise the event when a button is clicked.
   void myButton_Click( Object^ /*sender*/, System::EventArgs^ /*e*/ )
   {
      if ( myDataGridTableStyle->RowHeadersVisible )
            myDataGridTableStyle->RowHeadersVisible = false;
      else
            myDataGridTableStyle->RowHeadersVisible = true;
   }

// Instantiate the EventHandler.
public void AttachRowHeaderVisibleChanged()
{
   myDataGridTableStyle.RowHeadersVisibleChanged += new EventHandler (MyDelegateRowHeadersVisibleChanged);
}

// raise the event when RowHeadersVisible property is changed.
private void MyDelegateRowHeadersVisibleChanged(object sender, EventArgs e)
{
   string myString = "'RowHeadersVisibleChanged' event raised, Row Headers are";
   if (myDataGridTableStyle.RowHeadersVisible)
      myString += " visible";
   else
      myString += " not visible";

   MessageBox.Show(myString, "RowHeader information");
}

// raise the event when a button is clicked.
private void myButton_Click(object sender, System.EventArgs e)
{
   if (myDataGridTableStyle.RowHeadersVisible)
      myDataGridTableStyle.RowHeadersVisible = false;
   else
      myDataGridTableStyle.RowHeadersVisible = true;
}

' Instantiate the EventHandler.
Public Sub AttachRowHeaderVisibleChanged()
   AddHandler myDataGridTableStyle.RowHeadersVisibleChanged, AddressOf MyDelegateRowHeadersVisibleChanged
End Sub


' raise the event when RowHeadersVisible property is changed.
 Private Sub MyDelegateRowHeadersVisibleChanged(ByVal sender As Object, ByVal e As EventArgs)
     Dim myString As String = "'RowHeadersVisibleChanged' event raised, Row Headers are"
     If myDataGridTableStyle.RowHeadersVisible Then
         myString += " visible"
     Else
         myString += " not visible"
     End If
     MessageBox.Show(myString, "RowHeader information")
 End Sub


' raise the event when a button is clicked.
Private Sub myButton_Click(sender As Object, e As System.EventArgs)
   If myDataGridTableStyle.RowHeadersVisible Then
      myDataGridTableStyle.RowHeadersVisible = False
   Else
      myDataGridTableStyle.RowHeadersVisible = True
   End If
End Sub

Remarks

When row headers are visible, a plus sign is displayed in each row header if the underlying DataTable has a related child table.

This property will not function until you add DataGridTableStyle objects to the GridTableStylesCollection. Until then, setting this property will have no effect.

Applies to

Share via