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 está na ú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 copiado 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 DataGridView da célula é null.

- ou -

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

Exception

Falha ao formatar e não há nenhum manipulador para o evento DataError do controle DataGridView ou o manipulador definiu a propriedade ThrowException como true. Normalmente, o objeto de exceção pode ser convertido para o 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 primeiro em seu formato de exibição do GetEditedFormattedValue método . Isso poderá 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 junto com o valor da célula formatada em 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.UnicodeText, DataFormats.Htmle DataFormats.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.

Confira também

• DataGridView
• DataFormats
• ClipboardCopyMode
• DataGridViewClipboardCopyMode