DataGridViewImageColumn.DefaultCellStyle Propriedade

Definição

Obtém ou define o estilo de célula padrão da coluna.

public:
 virtual property System::Windows::Forms::DataGridViewCellStyle ^ DefaultCellStyle { System::Windows::Forms::DataGridViewCellStyle ^ get(); void set(System::Windows::Forms::DataGridViewCellStyle ^ value); };
[System.ComponentModel.Browsable(true)]
public override System.Windows.Forms.DataGridViewCellStyle DefaultCellStyle { get; set; }
[<System.ComponentModel.Browsable(true)>]
member this.DefaultCellStyle : System.Windows.Forms.DataGridViewCellStyle with get, set
Public Overrides Property DefaultCellStyle As DataGridViewCellStyle

Valor de Propriedade

O DataGridViewCellStyle a ser aplicado como o estilo padrão.

Atributos

Exemplos

O seguinte exemplo de código demonstra a utilização desta propriedade.

private void ChangeColumnAlignment()
{
    songsDataGridView.Columns["Title"].DefaultCellStyle.Alignment = DataGridViewContentAlignment.BottomCenter;
    songsDataGridView.Columns["Title"].Name = DataGridViewContentAlignment.BottomCenter.ToString();

    songsDataGridView.Columns["Artist"].DefaultCellStyle.Alignment = DataGridViewContentAlignment.BottomLeft;
    songsDataGridView.Columns["Artist"].Name = DataGridViewContentAlignment.BottomLeft.ToString();

    songsDataGridView.Columns["Album"].DefaultCellStyle.Alignment = DataGridViewContentAlignment.BottomRight;
    songsDataGridView.Columns["Album"].Name = DataGridViewContentAlignment.BottomRight.ToString();

    songsDataGridView.Columns["Release Date"].DefaultCellStyle.Alignment = DataGridViewContentAlignment.MiddleCenter;
    songsDataGridView.Columns["Release Date"].Name = DataGridViewContentAlignment.MiddleCenter.ToString();

    songsDataGridView.Columns["Track"].DefaultCellStyle.Alignment = DataGridViewContentAlignment.MiddleLeft;
    songsDataGridView.Columns["Track"].Name = DataGridViewContentAlignment.MiddleLeft.ToString();
}
Private Sub ChangeColumnAlignment()
    songsDataGridView.Columns("Title").DefaultCellStyle.Alignment = DataGridViewContentAlignment.BottomCenter
    songsDataGridView.Columns("Title").Name = DataGridViewContentAlignment.BottomCenter.ToString()

    songsDataGridView.Columns("Artist").DefaultCellStyle.Alignment = DataGridViewContentAlignment.BottomLeft
    songsDataGridView.Columns("Artist").Name = DataGridViewContentAlignment.BottomLeft.ToString()

    songsDataGridView.Columns("Album").DefaultCellStyle.Alignment = DataGridViewContentAlignment.BottomRight
    songsDataGridView.Columns("Album").Name = DataGridViewContentAlignment.BottomRight.ToString()

    songsDataGridView.Columns("Release Date").DefaultCellStyle.Alignment = DataGridViewContentAlignment.MiddleCenter
    songsDataGridView.Columns("Release Date").Name = DataGridViewContentAlignment.MiddleCenter.ToString()

    songsDataGridView.Columns("Track").DefaultCellStyle.Alignment = DataGridViewContentAlignment.MiddleLeft
    songsDataGridView.Columns("Track").Name = DataGridViewContentAlignment.MiddleLeft.ToString()
End Sub

Observações

O padrão DataGridViewCellStyle devolvido por esta propriedade tem os seguintes valores iniciais de propriedade:

DataGridViewCellStyle propriedade Valor predefinido
Alignment DataGridViewContentAlignment.MiddleCenter
NullValue Um gráfico de erro padrão do tipo Icon se o valor inicial ValuesAreIcons da propriedade for true; caso contrário, um gráfico de erro padrão do tipo Bitmap.

Estes valores sobrepõem-se ao valor especificado na DefaultCellStyle propriedade do DataGridView controlo, mas podem ser anulados por outras propriedades de estilo de célula. Para mais informações, consulte os estilos de célula no controlo DataGridView do Windows Forms .

Para evitar que o gráfico de erro padrão apareça para null valores de célula de ou DBNull.Value , defina a DataGridViewCellStyle.NullValue propriedade deste objeto de estilo de célula para null ou o seu próprio gráfico de erro antes de adicionar linhas ao controlo. No entanto, isto não afeta a linha para novos registos. Para evitar que o gráfico de erro apareça na linha para novos registos quando o valor da propriedade de controlo AllowUserToAddRows é true, deve também definir explicitamente o valor da célula para null ou o seu próprio gráfico de erro num handler para o evento de controlo RowsAdded , ou definir a propriedade da coluna CellTemplate para uma instância do DataGridViewImageCelltipo derivado de , com uma propriedade sobreposta DefaultNewRowValue que devolve null ou o seu próprio gráfico de erro.

Se a NullValue propriedade do objeto devolvida pela DefaultCellStyle propriedade tiver um valor igual ao gráfico de erro padrão do tipo Bitmap, mudar o ValuesAreIcons valor da propriedade para true define NullValue automaticamente para o gráfico de erro padrão do tipo Icon. Se NullValue tem um valor igual ao gráfico de erro padrão do tipo Icon, mudando o ValuesAreIcons valor da propriedade para false se define NullValue automaticamente para o gráfico de erro padrão do tipo Bitmap.

Aplica-se a

Ver também