DataGridViewImageColumn.DefaultCellStyle Propriedade
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
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.