Saltar para o conteúdo principal
Versão: 20 R10 BETA

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. Possible values:

ValueDescription
vk clipboard options all (default)Copies all data objects, including values, formatting, and formulas.
vk clipboard options formattingCopies only the formatting.
vk clipboard options formulasCopies only the formulas.
vk clipboard options formulas and formattingCopies the formulas and formatting.
vk clipboard options valuesCopies only the values.
vk clipboard options value and formattingCopies the values and formatting.

As opções de colagem definidas nas opções de workbook são tomadas em conta.

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