DataGridViewCell.GetClipboardContent Método
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.
Recupera o valor formatado da célula para copiar 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 -> objProtected Overridable Function GetClipboardContent (rowIndex As Integer, firstCell As Boolean, lastCell As Boolean, inFirstRow As Boolean, inLastRow As Boolean, format As String) As ObjectParâmetros
- rowIndex
- Int32
O índice baseado em zero da linha que contém a célula.
- firstCell
- Boolean
true indicar que a célula está na primeira coluna da região definida pelas células selecionadas; caso contrário, false.
- lastCell
- Boolean
true indicar que a célula é a última coluna da região definida pelas células selecionadas; caso contrário, false.
- inFirstRow
- Boolean
true indicar que a célula está na primeira linha da região definida pelas células selecionadas; caso contrário, false.
- inLastRow
- Boolean
true 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 formato atual da célula.
Devoluções
An Object que representa o valor da célula a copiar para o Clipboard.
Exceções
rowIndex é inferior a 0 ou maior ou igual ao número de linhas no controlo.
O valor da propriedade da DataGridView célula é null.
-ou-
ColumnIndex é inferior a 0, indicando que a célula é uma célula de cabeçalho de linha.
A formatação falhou e ou não existe um handler para o DataError evento do DataGridView controlo ou o handler define a ThrowException propriedade para true. O objeto exceção pode tipicamente ser lançado para o tipo FormatException.
Observações
Este método é chamado pelo DataGridView.GetClipboardContent método para recuperar um valor formatado em Clipboard que representa o valor da célula.
O valor da célula é primeiro recuperado no seu formato de visualização a partir do GetEditedFormattedValue método. Isto pode elevar 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 com a posição deste método indicam onde esta célula está localizada na tabela de dados que representa a região definida pelas células selecionadas no DataGridView controlo. Dependendo da posição da célula, pode ser devolvida informação adicional de formatação por este método juntamente com o valor da célula formatada no ecrã. Por exemplo, o formato HTML de uma célula na primeira coluna de uma linha incluirá a etiqueta que indica o início de uma linha.
Os formatos de Transferência suportados incluem DataFormats.Text, DataFormats.UnicodeText, DataFormats.Html, e DataFormats.CommaSeparatedValue.
Para obter mais informações, consulte a classe Clipboard.
Notas para Herdeiros
Substitua este método para fornecer valores personalizados do Clipboard. Por exemplo, poderia sobrescrever este método para suportar a cópia de valores de tipos de células personalizados.