4D Doc Center : GET PASTEBOARD DATA

4D v13.4

GET PASTEBOARD DATA


GET PASTEBOARD DATA ( tipoDados ; dados )

Parâmetro	Tipo	Descrição
tipoDados	cadeia	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 os dados que se encontram na área de transferência e cujo tipo se passa em tipoDados.

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: com este comando não é possível ler os dados de tipo arquivo, para fazê-lo deve utilizar 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";asOpçoes) ` 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.

Gestão de erros

Se não houver suficiente memória para extrair os dados, gera o erro -108.
Se não houver dados do tipo especificado na área de transferência, é gerado o erro -102.