DataGridViewCellFormattingEventHandler Delegar

Definição

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Representa o método que manipulará o evento de CellFormatting de DataGridView.

public delegate void DataGridViewCellFormattingEventHandler(System::Object ^ sender, DataGridViewCellFormattingEventArgs ^ e);

public delegate void DataGridViewCellFormattingEventHandler(object? sender, DataGridViewCellFormattingEventArgs e);

type DataGridViewCellFormattingEventHandler = delegate of obj * DataGridViewCellFormattingEventArgs -> unit

Public Delegate Sub DataGridViewCellFormattingEventHandler(sender As Object, e As DataGridViewCellFormattingEventArgs)

Parâmetros

sender

Object

A fonte do evento.

e

DataGridViewCellFormattingEventArgs

Um DataGridViewCellFormattingEventArgs que contém os dados do evento.

Exemplos

O exemplo de código a seguir demonstra como manipular o CellFormatting evento.

void dataGridView1_CellFormatting( Object^ /*sender*/, DataGridViewCellFormattingEventArgs^ e )
{
   // If the column is the Artist column, check the
   // value.
   if ( this->dataGridView1->Columns[ e->ColumnIndex ]->Name->Equals( "Artist" ) )
   {
      if ( e->Value != nullptr )
      {
         // Check for the string "pink" in the cell.
         String^ stringValue = dynamic_cast<String^>(e->Value);
         stringValue = stringValue->ToLower();
         if ( (stringValue->IndexOf( "pink" ) > -1) )
         {
            DataGridViewCellStyle^ pinkStyle = gcnew DataGridViewCellStyle;

            //Change the style of the cell.
            pinkStyle->BackColor = Color::Pink;
            pinkStyle->ForeColor = Color::Black;
            pinkStyle->Font = gcnew System::Drawing::Font( "Times New Roman",8,FontStyle::Bold );
            e->CellStyle = pinkStyle;
         }
         
      }
   }
   else
   if ( this->dataGridView1->Columns[ e->ColumnIndex ]->Name->Equals( "Release Date" ) )
   {
      ShortFormDateFormat( e );
   }
}


//Even though the date internaly stores the year as YYYY, using formatting, the
//UI can have the format in YY.  
void ShortFormDateFormat( DataGridViewCellFormattingEventArgs^ formatting )
{
   if ( formatting->Value != nullptr )
   {
      try
      {
         System::Text::StringBuilder^ dateString = gcnew System::Text::StringBuilder;
         DateTime theDate = DateTime::Parse( formatting->Value->ToString() );
         dateString->Append( theDate.Month );
         dateString->Append( "/" );
         dateString->Append( theDate.Day );
         dateString->Append( "/" );
         dateString->Append( theDate.Year.ToString()->Substring( 2 ) );
         formatting->Value = dateString->ToString();
         formatting->FormattingApplied = true;
      }
      catch ( Exception^ /*notInDateFormat*/ ) 
      {
         // Set to false in case there are other handlers interested trying to
         // format this DataGridViewCellFormattingEventArgs instance.
         formatting->FormattingApplied = false;
      }

   }
}

private void dataGridView1_CellFormatting(object sender, DataGridViewCellFormattingEventArgs e)
{
    // If the column is the Artist column, check the
    // value.
    if (this.dataGridView1.Columns[e.ColumnIndex].Name == "Artist")
    {
        if (e.Value != null)
        {
            // Check for the string "pink" in the cell.
            string stringValue = (string)e.Value;
            stringValue = stringValue.ToLower();
            if ((stringValue.IndexOf("pink") > -1))
            {
                e.CellStyle.BackColor = Color.Pink;
            }
        }
    }
    else if (this.dataGridView1.Columns[e.ColumnIndex].Name == "Release Date")
    {
        ShortFormDateFormat(e);
    }
}

//Even though the date internaly stores the year as YYYY, using formatting, the
//UI can have the format in YY.  
private static void ShortFormDateFormat(DataGridViewCellFormattingEventArgs formatting)
{
    if (formatting.Value != null)
    {
        try
        {
            System.Text.StringBuilder dateString = new System.Text.StringBuilder();
            DateTime theDate = DateTime.Parse(formatting.Value.ToString());

            dateString.Append(theDate.Month);
            dateString.Append("/");
            dateString.Append(theDate.Day);
            dateString.Append("/");
            dateString.Append(theDate.Year.ToString().Substring(2));
            formatting.Value = dateString.ToString();
            formatting.FormattingApplied = true;
        }
        catch (FormatException)
        {
            // Set to false in case there are other handlers interested trying to
            // format this DataGridViewCellFormattingEventArgs instance.
            formatting.FormattingApplied = false;
        }
    }
}

Private Sub dataGridView1_CellFormatting(ByVal sender As Object, _
    ByVal e As DataGridViewCellFormattingEventArgs) _
    Handles dataGridView1.CellFormatting
    ' If the column is the Artist column, check the
    ' value.
    If Me.dataGridView1.Columns(e.ColumnIndex).Name _
        = "Artist" Then
        If e.Value IsNot Nothing Then

            ' Check for the string "pink" in the cell.
            Dim stringValue As String = _
            CType(e.Value, String)
            stringValue = stringValue.ToLower()
            If ((stringValue.IndexOf("pink") > -1)) Then
                e.CellStyle.BackColor = Color.Pink
            End If

        End If
    ElseIf Me.dataGridView1.Columns(e.ColumnIndex).Name _
        = "Release Date" Then
        ShortFormDateFormat(e)
    End If
End Sub

'Even though the date internaly stores the year as YYYY, using formatting, the
'UI can have the format in YY.  
Private Shared Sub ShortFormDateFormat(ByVal formatting As DataGridViewCellFormattingEventArgs)
    If formatting.Value IsNot Nothing Then
        Try
            Dim dateString As System.Text.StringBuilder = New System.Text.StringBuilder()
            Dim theDate As Date = DateTime.Parse(formatting.Value.ToString())

            dateString.Append(theDate.Month)
            dateString.Append("/")
            dateString.Append(theDate.Day)
            dateString.Append("/")
            dateString.Append(theDate.Year.ToString().Substring(2))
            formatting.Value = dateString.ToString()
            formatting.FormattingApplied = True
        Catch notInDateFormat As FormatException
            ' Set to false in case there are other handlers interested trying to
            ' format this DataGridViewCellFormattingEventArgs instance.
            formatting.FormattingApplied = False
        End Try
    End If
End Sub

Comentários

Manipule o CellFormatting evento para personalizar a conversão de um valor de célula em um formato adequado para exibição ou personalizar a aparência de uma célula dependendo de seu estado ou valor.

O CellFormatting evento ocorre sempre que cada célula é pintada, portanto, você deve evitar o processamento longo ao manipular esse evento. Esse evento também ocorre quando a célula FormattedValue é recuperada ou seu GetFormattedValue método é chamado.

Quando você manipula o CellFormatting evento, a ConvertEventArgs.Value propriedade é inicializada com o valor da célula. Se você fornecer a conversão personalizada do valor da célula para o valor de exibição, defina a ConvertEventArgs.Value propriedade como o valor convertido, garantindo que o novo valor seja do tipo especificado pela propriedade da célula FormattedValueType . Para indicar que nenhuma formatação de valor adicional é necessária, defina a DataGridViewCellFormattingEventArgs.FormattingApplied propriedade como true.

Quando o manipulador de eventos for concluído, se o ConvertEventArgs.Value for ou não for do tipo correto ou se a DataGridViewCellFormattingEventArgs.FormattingApplied propriedade for false, o Value será formatado usando as Formatpropriedades , NullValue, DataSourceNullValuee FormatProvider do estilo de célula retornado pela DataGridViewCellFormattingEventArgs.CellStyle propriedade , que é inicializada usando a propriedade cell InheritedStylenull.

Independentemente do valor da DataGridViewCellFormattingEventArgs.FormattingApplied propriedade , as propriedades de exibição do objeto retornado pela DataGridViewCellFormattingEventArgs.CellStyle propriedade são usadas para renderizar a célula.

Para obter mais informações sobre a formatação personalizada usando o CellFormatting evento, consulte Como personalizar a formatação de dados no controle Windows Forms DataGridView.

Para evitar penalidades de desempenho ao manipular esse evento, acesse a célula por meio dos parâmetros do manipulador de eventos em vez de acessar a célula diretamente.

Para personalizar a conversão de um valor formatado especificado pelo usuário em um valor de célula real, manipule o CellParsing evento.

Para obter mais informações sobre como lidar com eventos, consulte Manipulando e gerando eventos.

Ao criar um DataGridViewCellFormattingEventHandler delegado, você identifica o método que manipulará o evento. Para associar o evento ao manipulador de eventos, adicione uma instância do delegado ao evento. O manipulador de eventos é chamado sempre que o evento ocorre, a menos que você remova o representante. Para obter mais informações sobre delegados do manipulador de eventos, consulte Manipulando e gerando eventos.

Métodos de Extensão

Confira também

• DataGridView
• CellFormatting
• DataGridViewCellFormattingEventArgs
• DataGridViewCellStyle
• Estilos de célula no controle DataGridView dos Windows Forms
• Como personalizar a formatação de dados no controle DataGridView dos Windows Forms