LISTBOX Get property
LISTBOX Get property ( * ; object : Text ; property : Integer ) : any
LISTBOX Get property ( object : Variable ; property : Integer ) : any
| Parámetros | Tipo | Descripción | |
|---|---|---|---|
| * | Operador | → | Si se especifica, object es un nombre de objeto (cadena). Si se omite, object es una variable |
| object | Text, Variable | → | Nombre del objeto del formulario (si se especifica *) o Variable (si se omite *) |
| property | Integer | → | Propiedad cuyo valor desea obtener |
| Resultado | any | ← | Valor actual (Integer, Text) |
Historia
| Lanzamiento | Modificaciones |
|---|---|
| 19 R6 | Modificado |
| 16 R2 | Renombrado (Get Listbox information) |
| <6 | Created |
Descripción
El comando LISTBOX Get property devuelve el valor de property del list box o columna especificado mediante los parámetros object y *.
Si pasa el parámetro opcional *, indica que el parámetro object es un nombre de objeto (cadena). Si no pasa este parámetro, indica que el parámetro object es una variable. En este caso, se pasa una referencia a una variable en lugar de una cadena. Para más información sobre los nombres de los objetos, consulte la sección Propiedades de los objetos.
Nota: si el list box o columna especificado utilizando los parámetros object y * no existe, el comando LISTBOX Get property devuelve -1 para propiedades numéricas, o una cadena vacía.
En el parámetro property, pase una constante que indique la propiedad cuyo valor desea obtener. Puede utilizar una de las siguientes constantes del tema "List Box":
| Constante | Valor | Comentario |
|---|---|---|
| lk allow wordwrap | 14 | Propiedad Ajustar palabra Se aplica a: columna * Valores posibles: lk no (0) lk yes (1) |
| lk auto row height | 31 | Propiedad Alto de línea automático para list box de tipo array Se aplica a: List box o columna Valores posibles: lk no (0) lk yes (1) |
| lk background color expression | 22 | Propiedad Expresión color de fondo para los list box de tipo selección de registros, colección o selección de entidades Se aplica a: list box o columna |
| lk cell horizontal padding | 36 | Propiedad Margen horizontal Margen horizontal de celda en píxeles (mismo valor para las márgenes izquierda y derecha) Se aplica a: list box, columna, encabezado, pie de página |
| lk cell vertical padding | 37 | Propiedad Margen vertical Margen vertical de celda en píxeles (mismo valor para las márgenes superior e inferior) Se aplica a: list box, columna, encabezado, pie de página |
| lk column max width | 26 | Propiedad Ancho Máximo Se aplica a: Columna * |
| lk column min width | 25 | Propiedad Ancho mínimo Se aplica a: Columna * |
| lk column resizable | 15 | Propiedad Redimensionable Se aplica a: columna * Valores posibles: lk no (0) lk yes (1) |
| lk current item expression | 38 | Propiedad Elemento actual Se aplica a: List box (Collection / Entity selection) |
| lk current item pos expression | 39 | Propiedad Posición elemento actual Se aplica a: List box (Collection / Entity selection) |
| lk detail form name | 19 | Propiedad Nombre formulario detallado para list box de tipo selección Se aplica a: List box |
| lk display footer | 8 | Propiedad Mostrar pies de página Se aplica a: list box Valores posibles: lk no (0): oculto lk yes (1): mostrado |
| lk display header | 0 | Propiedad Mostrar encabezados Se aplica a: list box Valores posibles: lk no (0): oculto lk yes (1): mostrado |
| lk display type | 21 | Propiedad Tipo de visualización para las columnas numéricas Se aplica a: Columna * Valores posibles: lk numeric format (0): muestra los valores en formato numérico lk three states checkbox (1): muestra los valores como casillas de selección de tres estados |
| lk double click on row | 18 | Propiedad Doble clic en línea para list box de tipo selección Se aplica a: List box Valores posibles: lk do nothing (0): no desencadena ninguna acción automática lk edit record (1): muestra el registro correspondiente en modo lectura-escritura lk display record (2): muestra el registro correspondiente en modo sólo lectura |
| lk extra rows | 13 | Propiedad Ocultar líneas vacías extra Se aplica a: List box Valores posibles: lk display (0) lk hide (1) |
| lk font color expression | 23 | Propiedad Expresión color de fuente para los list box de tipo selección de registros, colección o selección de entidades Se aplica a: list box o columna |
| lk font style expression | 24 | Propiedad Expresión estilo para los list box de tipo selección de registros, colección o selección de entidades Se aplica a: list box o columna |
| lk hide selection highlight | 16 | Propiedad Ocultar resaltado de selección Se aplica a: List box Valores posibles: lk no (0) lk yes (1) |
| lk highlight set | 27 | Propiedad Conjunto resaltado para el list box de tipo selección Se aplica a: List box |
| lk hor scrollbar height | 3 | Altura en píxeles (solo se puede leer) Aplica a: List box |
| lk meta expression | 34 | Propiedad Meta Info Expression para los list box de tipo colección o entity selection Se aplica a: List box |
| lk movable rows | 35 | Propiedad Líneas desplazables para los list box de tipo array Se aplica a: List box (excluyendo el modo jerárquico) Valores posibles: lk no (0): las líneas no se pueden mover en tiempo de ejecución lk yes (1): las línes se pueden mover en tiempo de ejecución (por defecto) |
| lk multi style | 30 | Propiedad Multi-estilo Se aplica a: columna * Valores posibles: lk no (0) lk yes (1) |
| lk named selection | 28 | Propiedad Named Selection para list box de tipo selección Se aplica a: List box |
| lk resizing mode | 11 | Propiedad Redimensionamiento automático de columnas propiedad Se aplica a: list box Valores posibles: lk manual (0) lk automatic (2) |
| lk row height unit | 17 | Unidad de la propiedad Alto de líneas Se aplica a: List box Valores posibles: lk líneas (1) lk píxeles (0) |
| lk selection mode | 10 | Propiedad Modo de selección Se aplica a: List box Valores posibles: lk none (0) lk single (1) lk multiple (2) |
| lk single click edit | 29 | Propiedad Edición con un solo clic Se aplica a: List box Valores posibles: lk no (0) lk yes (1) |
| lk sortable | 20 | Propiedad Ordenable Se aplica a: List box Valores posibles: lk no (0) lk yes (1) |
| lk truncate | 12 | Propiedad Truncar con elipsis Se aplica a: List box o columna Valores posibles: lk without ellipsis (0) lk with ellipsis (1) |
| lk ver scrollbar width | 5 | Ancho en píxeles (solo se puede leer) Aplica a: List box |
* Estas propiedades sólo se aplican a columnas de list box; si pasa un list box como parámetro con una de estas propiedades, LISTBOX Get property devuelve -1, o una cadena vacía, dependiendo de la property pasada.
En general, para señalar un resultado inválido LISTBOX Get property devuelve -1 cuando recupera propiedades que tienen valores numéricos, o una cadena vacía; sin embargo, no se genera ningún error. Más específicamente, esto ocurre en los siguientes casos:
- Si pasa una property que no existe
- Si pasa una property que no está disponible para el list box o la columna especificados, por ejemplo, si pasa la propiedad lk font color expression con un list box de tipo array
- Si pasa una columna como parámetro con una property que se aplica a un list box, y viceversa, si pasa un list box como parámetro con una property que se aplica a una columna (ver * más arriba)
Además, no es posible devolver valores de más de una columna a la vez; si intenta utilizar el símbolo "@" como parte de un nombre de columna para indicar varias columnas con nombres similares, LISTBOX Get property devuelve el primer valor coincidente que encuentra; como resultado, el valor devuelto no tiene significado real.
Note:
- Las constantes lk display footer y lk display header son útiles para calcular el tamaño real del área de un list box en un formulario.
Ejemplo 1
Dado un list box "MyListbox", si ejecuta la siguiente instrucción:
$Value:=LISTBOX Get property(*; "MyListbox";lk selection mode) // el valor devuelto indica el modo de selección
En este caso, el resultado devuelto indica si varios registros pueden ser seleccionados.
Ejemplo 2
Dado un list box "MyListbox", si ejecuta la siguiente instrucción:
$resizable:=LISTBOX Get property(*;"MyListbox";lk column resizable)
LISTBOX Get property devuelve -1 porque la propiedad lk column resizable se aplica a columnas y se ha pasado un list box como parámetro.
Ver también
LISTBOX SET GRID
LISTBOX SET PROPERTY
OBJECT SET SCROLLBAR
Propiedades
| Número de comando | 917 |
| Hilo seguro | no |