DataGridViewCell.GetClipboardContent Método

Definição

Namespace:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Recupera o valor formatado da célula a ser copiado para o Clipboard.

protected:
 virtual System::Object ^ GetClipboardContent(int rowIndex, bool firstCell, bool lastCell, bool inFirstRow, bool inLastRow, System::String ^ format);
protected virtual object GetClipboardContent(int rowIndex, bool firstCell, bool lastCell, bool inFirstRow, bool inLastRow, string format);
abstract member GetClipboardContent : int * bool * bool * bool * bool * string -> obj
override this.GetClipboardContent : int * bool * bool * bool * bool * string -> obj
Protected Overridable Function GetClipboardContent (rowIndex As Integer, firstCell As Boolean, lastCell As Boolean, inFirstRow As Boolean, inLastRow As Boolean, format As String) As Object

Parâmetros

rowIndex
Int32

O índice baseado em zero da linha que contém a célula.

firstCell
Boolean

true para indicar que a célula está na primeira coluna da região definida pelas células selecionadas; caso contrário, false.

lastCell
Boolean

true para indicar que a célula é a última coluna da região definida pelas células selecionadas; caso contrário, false.

inFirstRow
Boolean

true para indicar que a célula está na primeira linha da região definida pelas células selecionadas; caso contrário, false.

inLastRow
Boolean

true para indicar que a célula está na última linha da região definida pelas células selecionadas; caso contrário, false.

format
String

A cadeia de caracteres de formato atual da célula.

Retornos

Object

Um Object que representa o valor da célula a ser copiada para o Clipboard.

Exceções

ArgumentOutOfRangeException

rowIndex é menor que 0 ou maior ou igual ao número de linhas no controle.

InvalidOperationException

O valor da propriedade da DataGridView célula é null.

-ou-

ColumnIndex é menor que 0, indicando que a célula é uma célula de cabeçalho de linha.

Exception

Falha na formatação e não há nenhum manipulador para o DataError evento do DataGridView controle ou o manipulador definiu a ThrowException propriedade como true. Normalmente, o objeto de exceção pode ser convertido em tipo FormatException.

Comentários

Esse método é chamado pelo DataGridView.GetClipboardContent método para recuperar um valor formatado pela área de transferência que representa o valor da célula.

O valor da célula é recuperado pela primeira vez em seu formato de exibição do GetEditedFormattedValue método. Isso pode gerar o DataGridView.CellFormatting evento para formatar o valor e o DataGridView.DataError evento se a formatação não for bem-sucedida.

Os parâmetros relacionados à posição desse método indicam onde essa célula está localizada na tabela de dados que representa a região definida pelas células selecionadas no DataGridView controle. Dependendo da posição da célula, informações adicionais de formatação podem ser retornadas por esse método juntamente com o valor da célula formatada para exibição. Por exemplo, o formato HTML de uma célula na primeira coluna de uma linha incluirá a marca que indica o início de uma linha.

Os formatos de área de transferência com suporte incluem DataFormats.Text, DataFormats.UnicodeTexte DataFormats.HtmlDataFormats.CommaSeparatedValue.

Para obter mais informações, consulte a classe Clipboard.

Notas aos Herdeiros

Substitua esse método para fornecer valores personalizados da Área de Transferência. Por exemplo, você pode substituir esse método para dar suporte à cópia de valores de tipos de célula personalizados.

Aplica-se a

Confira também