GET PASTEBOARD DATA
GET PASTEBOARD DATA* ( tipoDados ; dados )
| Parâmetro | Tipo | Descrição | |
|---|---|---|---|
| tipoDados | Text | → | Tipo de dados a adicionar |
| dados | Blob | ← | Dados extraídos da área de transferência |
Descriçã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 (macOS), 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
Propriedades
| Número do comando | 401 |
| Thread-seguro | ✗ |
| Modificar variáveis | OK |