OBJECT GET BEST SIZE
OBJECT GET BEST SIZE ( {* ;} objeto ; largOpt ; altOpt {; anchoMax} )
| Parámetro | Tipo | Descripción | |
|---|---|---|---|
| * | Operador | → | Si se especifica, objeto es un nombre del objeto (cadena) Si se omite, objeto es una variable |
| objeto | any | → | Nombre de objeto (si se especifica *), o Campo o variable (si se omite *) |
| largOpt | Integer | ← | Largo óptimo del objeto |
| altOpt | Integer | ← | Alto óptimo del objeto |
| anchoMax | Integer | → | Largo máximo del objeto |
Este comando no es hilo seguro, no puede ser utilizado en código apropiativo.
Descripción
El comando OBJECT GET BEST SIZE devuelve en los parámetros largOpt y altOpt, el largo y alto “óptimo” del objeto de formulario designado por los parámetros * y objeto. Estos valores se expresan en píxeles. Este comando es particularmente útil para la visualización o impresión de informes complejos, asociados al comando OBJECT MOVE.
Si pasa el parámetro opcional *, indica que el parámetro objeto es un nombre de objeto (una cadena de caracteres). Si no pasa el parámetro *, indica que objeto es un campo o una variable. En este caso, usted no pasa una cadena sino una referencia de un campo o de una variable (de tipo objeto únicamente).
Los valores óptimos devueltos indican el tamaño mínimo del objeto de manera que su contenido actual sea incluido completamente en los límites. Por o general estos valores sólo son significativos para objetos que contengan texto. Este cálculo tiene en cuenta la fuente, su tamaño, estilo y contenido del objeto. También tiene en cuenta la incorporación de guiones y de retornos de carro.
Note que en el caso de los botones 3D, el funciona igual si el botón contiene únicamente un ícono.
Si el objeto especificado está vacío, el largOpt devuelto es 0.
El tamaño devuelto no tiene en cuenta marcos de gráficos aplicados alrededor del objeto, ni barras de desplazamiento. Para obtener el tamaño real de un objeto en pantalla, es necesario añadir el largo de estos elementos.
El parámetro opcional largoMax le permite atribuir un largo máximo al objeto. Si el largo óptimo del objeto es superior a este valor, OBJECT GET BEST SIZE devuelve largoMax en el parámetro largoOpt y aumenta el alto óptimo en consecuencia.
Los siguientes objetos son manejados por este comando:
- Áreas de texto estáticas
- Textos insertados en forma de referencias
- Campos y variables de los siguientes tipos: Alfa, Texto, Real, Entero, Entero largo, Fecha, Hora, Booleano (casillas de selección y botones de radio)
- Botones
- Columnas de list box en contexto de visualización (sólo las líneas visibles se tienen en cuenta).
Para todos los otros tipos de objetos de formulario (áreas de grupos, pestañas, rectángulos, líneas rectas, círculos/óvalos, áreas externas, etc.), el comando OBJECT GET BEST SIZE devuelve el tamaño del objeto actual (definido en el editor de formularios y eventualmente utilizando el comando OBJECT MOVE).
Ejemplo
Consulte el ejemplo en el comando SET PRINT MARKER.