Saltar para o conteúdo principal
Versão: Próximo

VP Copy to object

História
ReleaseMudanças
19 R4Adicionado

VP Copy to object ( rangeObj : Object {; options : Object} ) : Object

ParâmetroTipoDescrição
rangeObjObject->Objeto intervalo
optionsObject->Opções adicionais
ResultadosObject<-Objecto devolvido. Contém os dados copiados

Descrição

O comando VP Copy to object copia o conteúdo, o estilo e as fórmulas de rangeObj para um objeto.

Em rangeObj, passe o intervalo de células com os valores, a formatação e as fórmulas a serem copiadas. Se rangeObj for um intervalo combinado, somente o primeiro será usado.

Você pode passar um parâmetro options opcional com as seguintes propriedades:

PropriedadeTipoDescrição
copyParâmetrosVerdadeiro (padrão) para manter os valores copiados, a formatação e as fórmulas após a execução do comando. Falso para removê-los.
copyOptionsIntegerEspecifica o que é copiado ou movido. Valores possíveis:

ValorDescrição
vk clipboard options all (padrão)Copia todos os objetos de dados, incluindo valores, formatação e fórmulas.
vk clipboard options formattingCopia somente a formatação.
vk clipboard options formulasCopia somente as fórmulas.
vk clipboard options formulas and formattingCopia as fórmulas e a formatação.
vk clipboard options valuesCopia apenas os valores.
vk clipboard options value and formattingCopia os valores e a formatação.

The paste options defined in the workbook options are taken into account.

O comando retorna um objeto que contém os dados copiados.

Exemplo

Esse exemplo de código primeiro armazena o conteúdo, os valores, a formatação e as fórmulas de um intervalo em um objeto e, em seguida, cola-os em outro intervalo:

var $originRange; $targetRange; $dataObject; $options : Object

$originRange:=VP Cells("ViewProArea"; 0; 0; 2; 5)

$options:=New object
$options.copy:=True
$options.copyOptions:=vk clipboard options all

$dataObject:=VP Copy to object($originRange; $options)

$targetRange:=VP Cell("ViewProArea"; 4; 0)
VP PASTE FROM OBJECT($targetRange; $dataObject; vk clipboard options all)

Veja também

VP PASTE FROM OBJECT
VP MOVE CELLS
VP Get workbook options
VP SET WORKBOOK OPTIONS