4D v16.3

OBJECT GET BEST SIZE

Página Inicial

 
4D v16.3
OBJECT GET BEST SIZE

OBJECT GET BEST SIZE 


 

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

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

 
PROPRIEDADES 

Produto: 4D
Tema: Objetos (Formulários)
Número 717

 
HISTÓRIA 

Criado por: 4D 2003
Renomear: 4D v12

 
ARTICLE USAGE

Manual de linguagem 4D ( 4D v16)
Manual de linguagem 4D ( 4D v16.1)
Manual de linguagem 4D ( 4D v16.2)
Manual de linguagem 4D ( 4D v16.3)