GET PASTEBOARD DATA

4D v20.6

GET PASTEBOARD DATA


GET PASTEBOARD DATA ( tipoDados ; dados )

Parâmetro	Tipo	Descrição
tipoDados	String	Tipo de dados a adicionar
dados	BLOB	Dados extraídos da área de transferência

Descrição

O comando GET PASTEBOARD DATA devolve no campo ou variável de tipo BLOB ou na variável dados, os dados que se encontram na área de transferência e cujo tipo se passa em tipoDados.(Se a cópia contiver texto copiado dentro de 4D, então o conjunto de caracteres do BLOB é provavelmente UTF-16)

Nota: No contexto de operações copiar/colar, o espaço de copiar corresponde ao clipboard.

Passe em tipoDados um valor que defina o tipo de dados a extrair. Pode passar uma assinatura 4D, um tipo UTI (Mac OS), um nome/número de formato (Windows), ou um tipo de 4 caracteres (compatibilidade). Para maior informação sobre estes tipos, consulte a seção Gerenciar área de transferência.

Nota: Não pode ler arquivos de tipo dados com este comando, para fazer isso deve usar o comando Get file from pasteboard.

Exemplo

Os métodos de objeto a seguir são os dos botões que copiam e colam dados no array asOpçoes (menu pop-up, lista pop up,...) localizado num formulário:

  ` Método de objeto bCopiar_asOpçoes

 If(Size of array(asOpçoes)>0) ` Há algo para copiar?

    VARIABLE TO BLOB(asOpçoes;$vxClipData) ` Acumular os elementos do array em um BLOB

    CLEAR PASTEBOARD ` Esvaziar a área de transferência

    APPEND DATA TO PASTEBOARD("artx";$vxClipData) ` Note que o tipo de dados é escolhido arbitrariamente

 End if

 

  ` Método de objeto bColarOpçoes

 If(Pasteboard data size("artx")>0) ` Há dados de tipo "artx" na área de transferência?

    GET PASTEBOARD DATA("artx";$vxClipData) ` Extrair os dados da área de transferência

    BLOB TO VARIABLE($vxClipData;asOpçoes) ` Preencher o array com os dados do BLOB

    asOpçoes:=0 ` Reiniciar o elemento selecionado do array

 End if

Variáveis e conjuntos do sistema

Se os dados são extraídos corretamente, a variável OK toma o valor 1; do contrário OK toma o valor 0 e é gerado um erro.

Ver também

APPEND DATA TO PASTEBOARD
GET PICTURE FROM PASTEBOARD
Get text from pasteboard