4D Doc Center : GET DOCUMENT ICON

4D v14.3

GET DOCUMENT ICON


GET DOCUMENT ICON ( rotaDoc ; icone {; tamanho} )

Parâmetro	Tipo	Descrição
rotaDoc	cadeia	Nome ou rota de acesso do documento para recuperar ícone, ou string vazia para caixa de diálogo Abrir Arquivo
icone	Imagem	Variavel imagem ou campo
tamanho	Inteiro longo	Tamanho da imagem retornada (em pixels)

Descrição

O comando GET DOCUMENT ICON retorna no campo ou a variável imagem 4D ícone, o ícone do documento cujo nome ou rota de acesso se passa em rotaDoc. rotaDoc pode especificar um arquivo de todo tipo (executável, documento, atalho ou alias, etc.) ou uma pasta.

Passe em rotaDoc a rota de acesso absoluta do documento. Igualmente, pode passar unicamente o nome do documento ou rota de acesso relativa, neste caso o documento deve ser encontrado no diretório atual da banco (geralmente, a pasta que contém o arquivo de estrutura da banco).

Se passa uma string vazia em rotaDoc, aparece a caixa de diálogo padrão de abertura de arquivos, permitindo ao usuário selecionar o arquivo a ser lido. Quando tiver validada a caixa de diálogo, a variável sistema Document contém a rota de acesso completa do arquivo selecionado.

Passe em ícone um campo ou uma variável imagem 4D. Depois da execução do comando, este parâmetro contém o ícone do arquivo (formato PICT).

O parâmetro opcional tamanho permite indicar as dimensões em píxels do ícone. Este valor representa o comprimento do quadrado incluindo o ícone. Geralmente, os ícones são definidos de 32x32 píxels (“ícones longos”) ou 16x16 píxels (“ícones pequenos”). Se passa 0 ou omite este parâmetro, o comando retorna o ícone mais grande disponível.