Questa documentazione è stata archiviata e non viene gestita.

Proprietà DataGridView.ColumnHeadersBorderStyle

Nota: questa proprietà è stata introdotta con .NET Framework versione 2.0.

Ottiene lo stile del bordo applicato alle intestazioni di colonna.

Spazio dei nomi: System.Windows.Forms
Assembly: System.Windows.Forms (in system.windows.forms.dll)

public DataGridViewHeaderBorderStyle ColumnHeadersBorderStyle { get; set; }
/** @property */
public DataGridViewHeaderBorderStyle get_ColumnHeadersBorderStyle ()

/** @property */
public void set_ColumnHeadersBorderStyle (DataGridViewHeaderBorderStyle value)

public function get ColumnHeadersBorderStyle () : DataGridViewHeaderBorderStyle

public function set ColumnHeadersBorderStyle (value : DataGridViewHeaderBorderStyle)

Valore proprietà

Uno dei valori di DataGridViewHeaderBorderStyle.

Tipo di eccezioneCondizione

InvalidEnumArgumentException

Il valore specificato al momento dell'impostazione della proprietà non è un valore di DataGridViewHeaderBorderStyle valido.

ArgumentException

Il valore specificato al momento dell'impostazione della proprietà è Custom.

Se la proprietà ColumnHeadersBorderStyle è impostata su un qualsiasi valore diverso da Single, il valore della proprietà GridColor deve corrispondere a un colore di sistema.

Non è possibile impostare questa proprietà sul valore Custom, che corrisponde a un valore di sola lettura indicante che lo stile del bordo è stato personalizzato utilizzando la proprietà AdvancedColumnHeadersBorderStyle.

NotaNota

Se gli stili di visualizzazione sono attivati per l'applicazione tramite il metodo Application.EnableVisualStyles e la proprietà EnableHeadersVisualStyles è true, le intestazioni di colonna verranno disegnate utilizzando il tema corrente. In questo caso, il valore della proprietà ColumnHeadersBorderStyle verrà ignorato per tutte le intestazioni di colonna tranne TopLeftHeaderCell, a cui il tema non viene applicato.

Nell'esempio di codice riportato di seguito viene illustrato come impostare le proprietà ColumnHeadersDefaultCellStyle, AutoSizeRowsMode, ColumnHeadersBorderStyle, CellBorderStyle, GridColor, BackgroundColor, RowHeadersVisible, SelectionMode, ColumnCount e MultiSelect. Viene inoltre illustrato come impostare le proprietà DataGridViewColumn.Name e DataGridViewColumn.DefaultCellStyle. Per eseguire l'esempio, incollare il codice in un form contenente un oggetto DataGridView denominato dataGridView1, quindi chiamare il metodo SetUpDataGridView dal costruttore del form o dal gestore eventi Load. Accertarsi che tutti gli eventi siano associati ai relativi gestori eventi.

private void SetUpDataGridView()
{
    this.Controls.Add(dataGridView1);
    dataGridView1.ColumnCount = 5;
    DataGridViewCellStyle style = 
        dataGridView1.ColumnHeadersDefaultCellStyle;
    style.BackColor = Color.Navy;
    style.ForeColor = Color.White;
    style.Font = new Font(dataGridView1.Font, FontStyle.Bold);

    dataGridView1.EditMode = DataGridViewEditMode.EditOnEnter;
    dataGridView1.Name = "dataGridView1";
    dataGridView1.Location = new Point(8, 8);
    dataGridView1.Size = new Size(500, 300);
    dataGridView1.AutoSizeRowsMode = 
        DataGridViewAutoSizeRowsMode.DisplayedCellsExceptHeaders;
    dataGridView1.ColumnHeadersBorderStyle = 
        DataGridViewHeaderBorderStyle.Raised;
    dataGridView1.CellBorderStyle = DataGridViewCellBorderStyle.Single;
    dataGridView1.GridColor = SystemColors.ActiveBorder;
    dataGridView1.RowHeadersVisible = false;

    dataGridView1.Columns[0].Name = "Release Date";
    dataGridView1.Columns[1].Name = "Track";
    dataGridView1.Columns[1].DefaultCellStyle.Alignment = 
        DataGridViewContentAlignment.MiddleCenter;
    dataGridView1.Columns[2].Name = "Title";
    dataGridView1.Columns[3].Name = "Artist";
    dataGridView1.Columns[4].Name = "Album";

    // Make the font italic for row four.
    dataGridView1.Columns[4].DefaultCellStyle.Font = new Font(DataGridView.DefaultFont, FontStyle.Italic);

    dataGridView1.SelectionMode = DataGridViewSelectionMode.FullRowSelect;
    dataGridView1.MultiSelect = false;

    dataGridView1.BackgroundColor = Color.Honeydew;

    dataGridView1.Dock = DockStyle.Fill;

    dataGridView1.CellFormatting += new DataGridViewCellFormattingEventHandler(dataGridView1_CellFormatting);
    dataGridView1.CellParsing += new DataGridViewCellParsingEventHandler(dataGridView1_CellParsing);
    addNewRowButton.Click += new EventHandler(addNewRowButton_Click);
    deleteRowButton.Click += new EventHandler(deleteRowButton_Click);
    ledgerStyleButton.Click += new EventHandler(ledgerStyleButton_Click);
    dataGridView1.CellValidating += new DataGridViewCellValidatingEventHandler(dataGridView1_CellValidating);

}

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework non supporta tutte le versioni di ciascuna piattaforma. Per un elenco delle versioni supportate, vedere Requisiti di sistema.

.NET Framework

Supportato in: 2.0
Mostra: