wComboBox

wComboBox nos permite incluir en nuestras web un control Select de Materialize https://materializecss.com/select.html.

Con el podemos darle al usuario la opción de seleccionar un item dentro de una lista de items que le ofrecemos.

Los items los alimentamos mediante la propiedad aItems que puede ser utilizada de tres maneras.

con un array de elementos (cadenas y/o numeros) {“Elemento1”,“Elemento2”,“ElementoX”}, en este caso nos devuelve el elemento seleccionado (“ElementoX”).

con un array de parejas {Indice,Valor} ({ {cIndex1,cText1},{cIndex2,cText2},{cIndexX,cTextX} }), en este caso devuelve el cIndex del elemento seleccionado (cIndexX). En este caso cIndex con valor -1 serán utilizadas como Grupos y no se pueden seleccionar.

con un array de wItemComboBox, se utiliza para poder añadir imágenes y grupos a los ComboBox.

Hay que recordar que el CGI siempre nos devuelve cadenas, sean los Elementos y cIndex del tipo que sean.

Ejemplo de uso

Modo 1

Nos retornara el nombre del mes seleccionado

Y para recuperar la selección ...

Modo 2

Nos presentara los meses separados por trimestres y retornara el número del mes seleccionado

Y para recuperar la selección ...

Modo 3

Utilizando AddItem podemos añadir Imágenes a nuestro wComboBox

Y para recuperar la selección ...

Modo 4

Selección Múltiple

Y para recuperar la selección ...

Propiedades

Nombre	Init	Descripción	Versión
cText	Texto que aparece cuando no hay nada seleccionado	0.1
cTitle	Titulo encima del ComboBox	0.1
cIcon	Icono que aparecerá a la izquierda del control	0.1
aItems	Elementos del ComboBox, se puede utilizar de 3 maneras	0.1
lMultiple	Se permite la selección múltiple	0.1
cSelected	cIndex seleccionado por defecto	0.1
cOnChange	Función del CGI a llamar cuando cambie la selección, si empieza por # llama a funcion JS	0.1
aParams	Parámetros extras a enviar cuando se llame a cOnChange	0.1
cAjaxBevel	wBevel donde se incrusta el resultado de la llamada al Ajax	0.1
lAjaxWaitON	.T.	Incluye un indicador de actividad mientras se ejecuta la función Ajax	0.1
cAjaxText	Mensaje a poner debajo del Reloj de Actividad	0.1
lReLoad	.F.	Cuando se envía por Ajax ha de activarse la Recarga para que materialize lo inicialice	0.1

Métodos

Nombre	Retorna	Descripción	Versión
AddItem(cIndex, cText, lGroup, cImage)	Nuevo Item	Añadir wItemComboBox a aItems.	0.1

Hereda de...

wControl

Propiedades

Nombre	Init	Descripción	Versión
cClassId	Identificador del control para generar el Id	0.1
cId	Nil	Identificador único para cada Control	0.1
oParent	Control contenedor	0.1
oHtml	Objeto de la clase wHtml con el código para su renderizado	0.1
oStyle	Objeto de la clase wStyle con las variantes de estilo	0.1
lEnabled	.t.	El control aparece Habilitado o Inhabilitado	0.1
lHide	.f.	El control aparece Oculto o Visible	0.1
aWidth	{12,,,}	Ancho del control según el tamaño de la pantalla	0.1
aOffset	{,,,}	Margen izquierdo según el tamaño de la pantalla	0.1
cClrText	black	Color de Texto	0.1
cClrPane	white	Color del Fondo	0.1

Métodos

Nombre	Descripción	Versión
Create	Este es el método que crea cada uno de los controles, esta desarrollado en cada Control	0.1
FullHtml	Nos devuelve una cadena con todo el código HTML y JS necesario para crear el control	0.1
LogDebug	Nos Añade un mensaje a la consola del navegador cuando estamos en modo Debugger	0.1
Assert	Nos Añade un comentario en el HTML cuando estamos en modo Debugger	0.1
AddHTML	Nos Añade código HTML dentro del control	0.1
AddParam	Añade un parámetro a la propiedad aParams, hay que pasarle un array {“nombre”,“valor”}	0.2