OBJECT GET BEST SIZE

4D v18


OBJECT GET BEST SIZE ( {* ;} objeto ; largIdeal ; alturaIdeal {; larguraMax} )

Parâmetro	Tipo	Descrição
*	Operador	se especificado, objeto é um nome de objeto (string). Se omitido, objeto é uma variável
objeto	Objeto de formulário	Nome de objeto (se* é especificado) ou Campo ou Variável (se * é omitido)
largIdeal	Inteiro longo	Largura ideal do objeto
alturaIdeal	Inteiro longo	Altura ideal do objeto
larguraMax	Inteiro longo	Altura máxima do objeto

Descrição

O comando OBJECT GET BEST SIZE devolve nos parâmetros largOpt e altOpt, a largo e alto “ótimo” do objeto de formulário designado pelos parâmetros * e objeto. Estes valores se expressan em píxeles. Este comando é particularmente útil para a visualização ou impressão de relatórios complexos, associados ao comando OBJECT MOVE.

Se passa o parâmetro opcional *, indica que o parâmetro objeto é um nome de objeto (uma string de caracteres). Se não passa o parâmetro *, indica que objeto é um campo ou uma variável. Neste caso, você não passa uma string mas uma referência de um campo ou de uma variável (de tipo objeto unicamente).

Os valores ótimos devolvidos indicam o tamanho mínimo do objeto de maneira que seu conteúdo atual seja incluído completamente nos limites. Em geral estes valores só são significativos para objetos que contenham texto. Este cálculo considera a fonte, seu tamanho, estilo e conteúdo do objeto. Também considera a incorporação de hífens e de retornos de carro.

Note que no caso dos botões 3D, ele funciona igual se o botão contém unicamente um ícone.

Se o objeto especificado está vazio, ou largOtima devolvido é 0.

O tamanho devolvido não considera bordas de gráficos aplicados ao redor do objeto, nem barras de rolagem. Para obter o tamanho real de um objeto em tela, é necessário adicionar a largura destes elementos.

O parâmetro opcional largMax lhe permite atribuir uma largura máximo ao objeto. Se a largura ótima do objeto é superior a este valor, OBJECT GET BEST SIZE devolve largoMax no parâmetro largOtima e aumenta o alto ótimo em consequência.

Os objetos a seguir são manejados por este comando:

Áreas de texto estáticas
Textos inseridos em forma de referências
Campos variáveis dos seguintes tipos: Alfa, Texto, Real, Inteiro, Inteiro longo, Data, Hora, Booleano (caixas de seleção e botões de opção)
Botões.
Colunas List box em contexto display (só as linhas visíveis são levadas em consideração).

Para todos os outros tipos de objetos de formulário (áreas de grupos, abas, retângulos, linhas retas, círculos/óvais, áreas externas, etc.), o comando OBJECT GET BEST SIZE devolve o tamanho do objeto atual (definido no editor de formulários e eventualmente utilizando o comando OBJECT MOVE).

Exemplo

Consulte o exemplo no comando SET PRINT MARKER.

Ver também

OBJECT MOVE
SET PRINT MARKER