nRow, nColNuméricoObligatorio
Fila y columna donde se coloca el folder. Con PIXEL, las coordenadas parten de la esquina superior izquierda del componente padre.
COMANDOPublicado
@ ... FOLDER
@ <nRow>, <nCol> FOLDER <oFolder> [OF <oWnd>] [PROMPTS <cItem,...>] [OPTION <nOption>] [SIZE <nWidth>, <nHeight>] [PIXEL]Crea un contenedor TFolder con pestañas para organizar componentes visuales en una interfaz.
Descripción general
El comando @ ... FOLDER crea un componente de agrupación con una o más pestañas. Durante la compilación se traduce al constructor New() de la clase TFolder. Las pestañas pueden declararse con PROMPT, PROMPTS o ITEMS, o agregarse posteriormente con AddItem(). Cada área interna está disponible mediante oFolder:aDialogs para crear controles distintos en cada pestaña.
Sintaxis
@ <nRow>, <nCol> FOLDER <oFolder> [OF <oWnd>] [PROMPTS <cItem,...>] [OPTION <nOption>] [SIZE <nWidth>, <nHeight>] [PIXEL]Parámetros
oFolderObjetoObligatorio
Variable que recibe el objeto TFolder creado.
OF oWndObjetoOpcional
Diálogo, panel u otro contenedor propietario del folder. OF es recomendado.
PROMPT / PROMPTS / ITEMSCaractereOpcional
Títulos de las pestañas. Las expresiones se tratan internamente como una matriz.
OPTION nOptionNuméricoOpcional
Número de la pestaña seleccionada inicialmente.
SIZE nWidth, nHeightNuméricoOpcional
Ancho y alto; deben definirse durante o después de la creación para una visualización correcta.
COLOR nClrTextNuméricoOpcional
Color del texto utilizado por el componente.
MESSAGE cMsgCaractereOpcional
Ayuda contextual mostrada mientras el puntero permanece sobre el componente.
PIXELCláusulaOpcional
Indica que la posición y el tamaño utilizan coordenadas en píxeles.
Pestañas declaradas con PROMPTS
#Include "TOTVS.ch"
User Function ExFolderPrompts()
Local oDlg
Local oFolder
Local cNombre := Space(40)
Local lActivo := .T.
Define Dialog oDlg Title "Registro" ;
From 0, 0 To 360, 620 Pixel
@ 10, 15 Folder oFolder ;
Prompts "General", "Preferencias" ;
Option 1 Size 270, 140 Of oDlg Pixel
@ 15, 15 Say "Nombre:" Of oFolder:aDialogs[1] Pixel
@ 13, 55 Get cNombre Size 150, 10 ;
Of oFolder:aDialogs[1] Pixel
@ 15, 15 CheckBox lActivo Prompt "Registro activo" ;
Size 100, 15 Of oFolder:aDialogs[2] Pixel
Activate Dialog oDlg Centered
ReturnResultado esperado
PROMPTS crea dos pestañas. SAY y GET pertenecen a la primera; CHECKBOX pertenece a la segunda mediante aDialogs.
Pestañas agregadas dinámicamente
#Include "TOTVS.ch"
User Function ExFolderDinamico()
Local oDlg
Local oFolder
Define Dialog oDlg Title "Consulta" ;
From 0, 0 To 320, 560 Pixel
@ 10, 15 Folder oFolder Size 240, 120 ;
Of oDlg Pixel
oFolder:AddItem("Resumo", .T.)
oFolder:AddItem("Detalhes", .T.)
@ 10, 10 Say "Visão resumida" ;
Of oFolder:aDialogs[1] Pixel
@ 10, 10 Say "Informações detalhadas" ;
Of oFolder:aDialogs[2] Pixel
oFolder:SetOption(1)
Activate Dialog oDlg Centered
ReturnResultado esperado
AddItem() crea las pestañas después del componente y SetOption(1) selecciona la primera.
- Incluye TOTVS.ch para que el compilador reconozca el comando.
- Con PROMPTS, las pestañas se crean y nombran en la declaración.
- Sin PROMPTS, utiliza AddItem() para agregar pestañas dinámicamente.
- Crea los controles internos con OF oFolder:aDialogs[nPestaña].
- Utiliza SetOption() para seleccionar una pestaña después de la creación.
- Prefiere OF para identificar explícitamente el componente padre.
- El índice de aDialogs debe corresponder a una pestaña existente; confirma el orden de creación.
- Acceder a aDialogs antes de crear las pestañas produce una referencia inválida.
- Sin SIZE durante la creación o configuración posterior, el folder puede no mostrarse correctamente.
- Sin OF, el folder se asocia a la ventana o diálogo activo.
- Mezclar PIXEL con otra unidad puede colocar o dimensionar mal el componente.
- Demasiadas pestañas o contenido excesivo reducen la claridad; agrupa información relacionada y usa títulos breves.