nRow, nColNuméricoObligatorio
Fila y columna donde se coloca el componente. Con PIXEL, las coordenadas parten de la esquina superior izquierda del componente padre.
COMANDOPublicado
@ ... CHECKBOX
@ <nRow>, <nCol> CHECKBOX [<oCheckBox> VAR] <lVar> [PROMPT <cCaption>] [OF <oWnd>] [SIZE <nWidth>, <nHeight>] [PIXEL]Crea una casilla vinculada a una variable lógica y, opcionalmente, expone su objeto TCheckBox.
Descripción general
El comando @ ... CHECKBOX permite editar visualmente un valor lógico: marcado representa verdadero (.T.) y desmarcado representa falso (.F.). Durante la compilación se traduce al constructor New() de la clase TCheckBox. Utiliza VAR cuando sea necesario conservar el objeto para configurarlo o manipularlo posteriormente.
Sintaxis
@ <nRow>, <nCol> CHECKBOX [<oCheckBox> VAR] <lVar> [PROMPT <cCaption>] [OF <oWnd>] [SIZE <nWidth>, <nHeight>] [PIXEL]Parámetros
oCheckBox VARObjetoOpcional
Variable que recibe el objeto TCheckBox. Cuando se informa el objeto, VAR es obligatorio antes de la variable lógica.
lVarLógicoObligatorio
Variable lógica editada por el componente: .T. cuando está marcado y .F. cuando está desmarcado.
PROMPT cCaptionCaractereOpcional
Texto mostrado junto a la casilla.
OF oWndObjetoOpcional
Diálogo, panel, folder u otro contenedor visual propietario del componente. OF es recomendado.
SIZE nWidth, nHeightNuméricoOpcional
Ancho y alto reservados para el componente.
ON CHANGE / ON CLICKEventoOpcional
Acción ejecutada cuando el usuario cambia el estado.
VALIDValidaçãoOpcional
Expresión lógica ejecutada al perder el foco; debe devolver .T. para permitir la salida.
WHENHabilitaçãoOpcional
Expresión lógica que determina si el componente puede recibir el foco.
FONT · COLOR · MESSAGE · PIXELCláusulasOpcional
Personalizan fuente, colores, ayuda contextual y sistema de coordenadas.
Casilla de selección simple
#Include "TOTVS.ch"
User Function ExCheckBox()
Local oDlg
Local oCheckBox
Local lActivo := .F.
Define Dialog oDlg Title "Preferencias" ;
From 100, 100 To 300, 440 Pixel
@ 15, 20 CheckBox oCheckBox Var lActivo ;
Prompt "Registro activo" Size 100, 15 ;
Of oDlg Pixel
@ 50, 20 Button "Confirmar" Size 55, 14 ;
Action MsgInfo(IIf(lActivo, "Activo", "Inactivo")) ;
Of oDlg Pixel
Activate Dialog oDlg Centered
ReturnResultado esperado
lActivo comienza falso, el control lo actualiza y el botón lo consulta al confirmar.
Reacción al cambio de estado
#Include "TOTVS.ch"
User Function ExCheckEvento()
Local oDlg
Local lEnviarEmail := .T.
Define Dialog oDlg Title "Notificações" ;
From 0, 0 To 160, 360 Pixel
@ 20, 20 CheckBox lEnviarEmail ;
Prompt "Enviar confirmação por e-mail" ;
On Change AtualizarPreferencia(lEnviarEmail) ;
Size 150, 15 Of oDlg Pixel
Activate Dialog oDlg Centered
Return
Static Function AtualizarPreferencia(lEnviarEmail)
ConOut("Enviar e-mail: " + IIf(lEnviarEmail, "Sim", "Não"))
ReturnResultado esperado
ON CHANGE envía el nuevo valor lógico a una función breve y específica.
- Incluye TOTVS.ch para que el compilador reconozca el comando.
- Inicializa la variable lógica antes de crear el componente para definir su estado inicial.
- Utiliza oCheckBox VAR solo cuando necesites propiedades o métodos después de la creación.
- Utiliza ON CHANGE para reaccionar inmediatamente al marcar o desmarcar.
- Utiliza VALID para controlar la salida y WHEN para controlar la entrada.
- Prefiere OF para identificar explícitamente el contenedor propietario.
- La variable editada debe ser lógica; otro tipo puede causar un comportamiento incorrecto o un error.
- Cuando se informa un objeto, omitir VAR invalida la declaración.
- VALID y WHEN deben devolver valores lógicos.
- Sin OF, el componente se asocia a la ventana o diálogo activo.
- Mezclar coordenadas PIXEL con otra unidad puede colocar o dimensionar mal el control.
- No coloques reglas de negocio extensas en el evento; delega en una función dedicada.