Referencia de Propiedades A-Z
Esta pagina documenta cada propiedad disponible en los controles de HarbourBuilder. Las propiedades estan
agrupadas por categoria e incluyen el tipo de propiedad (PT_STRING, PT_NUMBER,
PT_LOGICAL, PT_COLOR, PT_FONT) y los controles que soportan cada una.
Cada propiedad en el Inspector de Objetos tiene un tipo asociado que determina como se edita y almacena:
| Tipo | Descripcion | Ejemplo |
|---|---|---|
PT_STRING | Cadena de texto | "Hola" |
PT_NUMBER | Valor numerico (entero o flotante) | 120 |
PT_LOGICAL | Booleano (.T. / .F.) | .T. |
PT_COLOR | Valor de color RGB | CLR_RED o "#FF0000" |
PT_FONT | Descriptor de fuente (nombre, tamano, estilo) | "Segoe UI", 10 |
Propiedades de Apariencia
Estas propiedades controlan como se ve un control en pantalla — colores, bordes, estilos y estado visual.
| Propiedad | Tipo | Descripcion | Disponible Para |
|---|---|---|---|
nBackColor | PT_COLOR | Color de fondo del control | Todos los controles visuales |
nFontColor | PT_COLOR | Color del texto (primer plano) | Todos los controles con texto |
cCaption | PT_STRING | Texto visible en el control | Button, GroupBox, Label, CheckBox, Radio, TabControl, Form |
cValue | PT_STRING | Valor actual / contenido de texto | Edit, Memo, MaskEdit, StaticText, LabeledEdit |
nBorderStyle | PT_NUMBER | Estilo de borde (0=ninguno, 1=simple, 2=elevado, 3=hundido) | Edit, Memo, GroupBox, Panel, Bevel, ScrollBox |
lBorder | PT_LOGICAL | Mostrar borde visible alrededor del control | Form, Panel, ScrollBox, GroupBox |
lFlat | PT_LOGICAL | Usar apariencia plana en lugar de 3D | Button, SpeedBtn, BitBtn |
nAlignment | PT_NUMBER | Alineacion de texto (0=izquierda, 1=centro, 2=derecha) | Label, Edit, Memo, Button, StaticText |
lTransparent | PT_LOGICAL | Fondo del control transparente | Label, Image, Shape, StaticText, Panel |
nShapeType | PT_NUMBER | Forma a dibujar (0=rectangulo, 1=elipse, 2=rect redondeado, 3=triangulo) | Shape |
nPenColor | PT_COLOR | Color del contorno/lapiz para formas | Shape, PaintBox |
nBrushColor | PT_COLOR | Color de relleno para formas | Shape, PaintBox |
nPenWidth | PT_NUMBER | Ancho del lapiz/trazo en pixeles | Shape, PaintBox |
cHint | PT_STRING | Texto de informacion emergente al pasar el raton | Todos los controles visuales |
nProgress | PT_NUMBER | Valor actual de progreso (0 a nMax) | ProgressBar |
nMin | PT_NUMBER | Valor minimo para controles basados en rango | ProgressBar, TrackBar, UpDown, ScrollBar |
nMax | PT_NUMBER | Valor maximo para controles basados en rango | ProgressBar, TrackBar, UpDown, ScrollBar |
nPosition | PT_NUMBER | Posicion actual del deslizador/pulgar | TrackBar, ScrollBar |
Posicion y Tamano
Estas propiedades determinan donde se coloca un control y que tan grande es.
| Propiedad | Tipo | Descripcion | Disponible Para |
|---|---|---|---|
nLeft | PT_NUMBER | Coordenada X del borde izquierdo (pixeles desde la izquierda del padre) | Todos los controles visuales |
nTop | PT_NUMBER | Coordenada Y del borde superior (pixeles desde arriba del padre) | Todos los controles visuales |
nWidth | PT_NUMBER | Ancho del control en pixeles | Todos los controles visuales |
nHeight | PT_NUMBER | Alto del control en pixeles | Todos los controles visuales |
lCentered | PT_LOGICAL | Centrar el formulario en pantalla al activar | Form, Dialog |
lResizable | PT_LOGICAL | Si el formulario puede ser redimensionado por el usuario | Form, Dialog |
nMinWidth | PT_NUMBER | Ancho minimo permitido al redimensionar | Form |
nMinHeight | PT_NUMBER | Alto minimo permitido al redimensionar | Form |
Propiedades de Comportamiento
Estas propiedades afectan como se comporta un control y responde a la interaccion del usuario.
| Propiedad | Tipo | Descripcion | Disponible Para |
|---|---|---|---|
lVisible | PT_LOGICAL | Si el control es visible en pantalla | Todos los controles visuales |
lEnabled | PT_LOGICAL | Si el control responde a la entrada del usuario | Todos los controles visuales |
lReadOnly | PT_LOGICAL | El contenido no puede ser editado por el usuario (solo visualizacion) | Edit, Memo, MaskEdit, StringGrid, DBEdit, DBMemo |
lWordWrap | PT_LOGICAL | Ajustar texto a la siguiente linea cuando excede el ancho del control | Label, Memo, Edit, StaticText, DBMemo |
lPassword | PT_LOGICAL | Enmascarar caracteres de entrada (campo de contrasena) | Edit |
lCheck | PT_LOGICAL | Estado de marcado del control | CheckBox, Radio |
nTabIndex | PT_NUMBER | Indice de orden de tabulacion (determina orden de recorrido del foco) | Todos los controles enfocables |
lTabStop | PT_LOGICAL | Si el control puede recibir foco mediante la tecla Tab | Todos los controles enfocables |
cMask | PT_STRING | Patron de mascara de entrada (p. ej., "99/99/9999" para fechas) | MaskEdit |
nInterval | PT_NUMBER | Intervalo del temporizador en milisegundos | Timer |
lRunning | PT_LOGICAL | Si el temporizador esta actualmente activo | Timer |
nScrollBars | PT_NUMBER | Estilo de barras de desplazamiento (0=ninguna, 1=horizontal, 2=vertical, 3=ambas) | Edit, Memo, ScrollBox, StringGrid, DBGrid, Browse |
lAutoSize | PT_LOGICAL | Redimensionar automaticamente el control para ajustar su contenido | Label, Image, StaticText |
lModal | PT_LOGICAL | Si el formulario bloquea la interaccion con otras ventanas | Form, Dialog |
Propiedades de Fuente
Propiedades relacionadas con la tipografia del texto mostrado en los controles.
| Propiedad | Tipo | Descripcion | Disponible Para |
|---|---|---|---|
cFontName | PT_FONT | Nombre de la familia de fuentes (p. ej., "Segoe UI", "Arial") | Todos los controles con texto |
nFontSize | PT_NUMBER | Tamano de fuente en puntos | Todos los controles con texto |
lFontBold | PT_LOGICAL | Estilo de texto en negrita | Todos los controles con texto |
lFontItalic | PT_LOGICAL | Estilo de texto en cursiva | Todos los controles con texto |
lFontUnderline | PT_LOGICAL | Estilo de texto subrayado | Todos los controles con texto |
lFontStrikeout | PT_LOGICAL | Estilo de texto tachado | Todos los controles con texto |
oFont | PT_FONT | Objeto de fuente completo (envuelve todas las propiedades de fuente) | Todos los controles con texto |
Los controles heredan la fuente de su padre por defecto. Establece oFont en un formulario para cambiar la
fuente de todos los controles hijos a la vez, a menos que un hijo lo sobrescriba con su propia configuracion de fuente.
Propiedades de Datos
Propiedades relacionadas con enlace de datos, contenido y controles conscientes de datos.
| Propiedad | Tipo | Descripcion | Disponible Para |
|---|---|---|---|
cDataSource | PT_STRING | Nombre o referencia al objeto de fuente de datos | DBEdit, DBMemo, DBComboBox, DBCheckBox, DBText, DBGrid, DBNavigator, Browse |
cDataField | PT_STRING | Nombre del campo en la fuente de datos para vincular | DBEdit, DBMemo, DBComboBox, DBCheckBox, DBText |
cItems | PT_STRING | Arreglo o lista de elementos (para controles basados en lista) | ListBox, ComboBox, StringGrid, TreeView, ListView, TabControl |
nColCount | PT_NUMBER | Numero de columnas en un control de cuadricula o tabla | StringGrid, DBGrid, Browse |
nRowCount | PT_NUMBER | Numero de filas en un control de cuadricula o tabla | StringGrid, DBGrid, Browse |
nItemIndex | PT_NUMBER | Indice del elemento seleccionado actualmente | ListBox, ComboBox, ListView, TreeView, TabControl |
cText | PT_STRING | Contenido de texto del control | Edit, Memo, Label, StaticText, LabeledEdit |
cPrompt | PT_STRING | Texto de etiqueta mostrado en el control | Button, CheckBox, Radio, GroupBox |
cAlias | PT_STRING | Nombre del alias de tabla de base de datos | Todos los componentes de base de datos |
cTableName | PT_STRING | Nombre de la tabla de base de datos | Todos los componentes de base de datos |
Propiedades Especificas del Control
Estas propiedades son unicas para tipos de control especificos y no se comparten ampliamente.
| Propiedad | Tipo | Descripcion | Disponible Para |
|---|---|---|---|
nWindowState | PT_NUMBER | Estado de ventana (0=normal, 1=minimizado, 2=maximizado) | Form |
cIcon | PT_STRING | Ruta al archivo de icono de ventana | Form |
lMaxButton | PT_LOGICAL | Mostrar el boton de maximizar en la barra de titulo | Form |
lMinButton | PT_LOGICAL | Mostrar el boton de minimizar en la barra de titulo | Form |
lCloseButton | PT_LOGICAL | Mostrar el boton de cerrar en la barra de titulo | Form |
nTabPos | PT_NUMBER | Posicion de las etiquetas de pestana (0=arriba, 1=abajo, 2=izquierda, 3=derecha) | TabControl |
lHotTrack | PT_LOGICAL | Resaltar pestanas al pasar el raton | TabControl |
lDoubleBuffered | PT_LOGICAL | Usar doble buffering para reducir parpadeo | PaintBox, StringGrid, ScrollBox |
cFileName | PT_STRING | Ruta del archivo seleccionado (para controles de dialogo) | OpenDialog, SaveDialog |
cFilter | PT_STRING | Filtro de tipo de archivo para dialogos (p. ej., "Archivos de texto|*.txt") | OpenDialog, SaveDialog |
cApiKey | PT_STRING | Clave API para autenticacion del servicio de IA | OpenAI, Gemini, Claude, DeepSeek, Grok |
cModel | PT_STRING | Identificador del modelo de IA (p. ej., "gpt-4", "claude-3") | OpenAI, Gemini, Claude, DeepSeek, Grok |
nTimeout | PT_NUMBER | Tiempo de espera de solicitud en milisegundos | OpenAI, Gemini, Claude, HttpClient, WebSocket |
cHost | PT_STRING | Nombre de host o direccion IP del servidor | MySQL, MariaDB, PostgreSQL, SQLite, HttpClient, FtpClient, WebServer |
nPort | PT_NUMBER | Numero de puerto de red | MySQL, MariaDB, PostgreSQL, HttpClient, FtpClient, WebServer, WebSocket |
cUserName | PT_STRING | Nombre de usuario para autenticacion | MySQL, MariaDB, PostgreSQL, FtpClient, SMTPClient |
cPassword | PT_STRING | Contrasena para autenticacion | MySQL, MariaDB, PostgreSQL, FtpClient, SMTPClient |
cDatabase | PT_STRING | Nombre de la base de datos | MySQL, MariaDB, PostgreSQL, SQLite, Firebird, SQLServer, Oracle, MongoDB |
Configurar Propiedades en Codigo
Las propiedades se pueden establecer en codigo despues de crear un control:
local oForm, oBtn, oLabel DEFINE FORM oForm TITLE "Demo de Propiedades" ; SIZE 500, 350 FONT "Segoe UI", 10 --- Establecer propiedades en el formulario --- oForm:lResizable := .T. oForm:lCentered := .T. oForm:nBackColor := CLR_WHITE oForm:lMaxButton := .T. oForm:lMinButton := .T. @ 30, 40 LABEL oLabel VALUE "Hola Mundo" ; OF oForm SIZE 200, 28 --- Establecer propiedades de la etiqueta --- oLabel:nFontColor := CLR_BLUE oLabel:lFontBold := .T. oLabel:nAlignment := 1 /// centro oLabel:cHint := "Esto es una etiqueta" @ 70, 40 BUTTON oBtn PROMPT "Haz Clic" ; OF oForm SIZE 130, 32 --- Establecer propiedades del boton --- oBtn:nBackColor := CLR_GREEN oBtn:nFontColor := CLR_WHITE oBtn:lFlat := .T. oBtn:lTabStop := .T. oBtn:nTabIndex := 0 ACTIVATE FORM oForm CENTERED
Configurar Propiedades en el Inspector de Objetos
En el IDE de HarbourBuilder, selecciona cualquier control en el Disenador de Formularios y cambia a la pestana Propiedades en el Inspector de Objetos. Las propiedades estan agrupadas por categoria:
- Apariencia — Colores, bordes, titulos, imagenes, pistas
- Posicion — Izquierda, Arriba, Ancho, Alto
- Comportamiento — Visible, Habilitado, SoloLectura, TabStop
- Fuente — FontName, FontSize, Bold, Italic, Underline
- Datos — Items, DataSource, DataField (para controles conscientes de datos)
Haz doble clic en un valor de propiedad para editarlo en linea. Las propiedades de color muestran un selector de color; las propiedades de fuente
abren un dialogo de fuente; las propiedades logicas alternan entre .T. y .F..
Los cambios realizados en el Inspector de Objetos se aplican al lienzo del Disenador de Formularios en tiempo real. Puedes ver el efecto de cada cambio de propiedad inmediatamente sin reconstruir.
Herencia de Propiedades
Los controles heredan ciertas propiedades de su contenedor padre. La cadena de herencia es:
cFontName,nFontSize,lFontBold,lFontItalic— Las propiedades de fuente se propagan hacia abajonBackColor— Si no se establece explicitamente, el control usa el fondo del padrelEnabled— Deshabilitar un contenedor padre deshabilita todos los hijoslVisible— Ocultar un padre oculta todos los hijos
Un control hijo puede sobrescribir cualquier propiedad heredada estableciendola explicitamente.