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.

Tipos de Propiedad

Cada propiedad en el Inspector de Objetos tiene un tipo asociado que determina como se edita y almacena:

TipoDescripcionEjemplo
PT_STRINGCadena de texto"Hola"
PT_NUMBERValor numerico (entero o flotante)120
PT_LOGICALBooleano (.T. / .F.).T.
PT_COLORValor de color RGBCLR_RED o "#FF0000"
PT_FONTDescriptor 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.

PropiedadTipoDescripcionDisponible Para
nBackColorPT_COLORColor de fondo del controlTodos los controles visuales
nFontColorPT_COLORColor del texto (primer plano)Todos los controles con texto
cCaptionPT_STRINGTexto visible en el controlButton, GroupBox, Label, CheckBox, Radio, TabControl, Form
cValuePT_STRINGValor actual / contenido de textoEdit, Memo, MaskEdit, StaticText, LabeledEdit
nBorderStylePT_NUMBEREstilo de borde (0=ninguno, 1=simple, 2=elevado, 3=hundido)Edit, Memo, GroupBox, Panel, Bevel, ScrollBox
lBorderPT_LOGICALMostrar borde visible alrededor del controlForm, Panel, ScrollBox, GroupBox
lFlatPT_LOGICALUsar apariencia plana en lugar de 3DButton, SpeedBtn, BitBtn
nAlignmentPT_NUMBERAlineacion de texto (0=izquierda, 1=centro, 2=derecha)Label, Edit, Memo, Button, StaticText
lTransparentPT_LOGICALFondo del control transparenteLabel, Image, Shape, StaticText, Panel
nShapeTypePT_NUMBERForma a dibujar (0=rectangulo, 1=elipse, 2=rect redondeado, 3=triangulo)Shape
nPenColorPT_COLORColor del contorno/lapiz para formasShape, PaintBox
nBrushColorPT_COLORColor de relleno para formasShape, PaintBox
nPenWidthPT_NUMBERAncho del lapiz/trazo en pixelesShape, PaintBox
cHintPT_STRINGTexto de informacion emergente al pasar el ratonTodos los controles visuales
nProgressPT_NUMBERValor actual de progreso (0 a nMax)ProgressBar
nMinPT_NUMBERValor minimo para controles basados en rangoProgressBar, TrackBar, UpDown, ScrollBar
nMaxPT_NUMBERValor maximo para controles basados en rangoProgressBar, TrackBar, UpDown, ScrollBar
nPositionPT_NUMBERPosicion actual del deslizador/pulgarTrackBar, ScrollBar

Posicion y Tamano

Estas propiedades determinan donde se coloca un control y que tan grande es.

PropiedadTipoDescripcionDisponible Para
nLeftPT_NUMBERCoordenada X del borde izquierdo (pixeles desde la izquierda del padre)Todos los controles visuales
nTopPT_NUMBERCoordenada Y del borde superior (pixeles desde arriba del padre)Todos los controles visuales
nWidthPT_NUMBERAncho del control en pixelesTodos los controles visuales
nHeightPT_NUMBERAlto del control en pixelesTodos los controles visuales
lCenteredPT_LOGICALCentrar el formulario en pantalla al activarForm, Dialog
lResizablePT_LOGICALSi el formulario puede ser redimensionado por el usuarioForm, Dialog
nMinWidthPT_NUMBERAncho minimo permitido al redimensionarForm
nMinHeightPT_NUMBERAlto minimo permitido al redimensionarForm

Propiedades de Comportamiento

Estas propiedades afectan como se comporta un control y responde a la interaccion del usuario.

PropiedadTipoDescripcionDisponible Para
lVisiblePT_LOGICALSi el control es visible en pantallaTodos los controles visuales
lEnabledPT_LOGICALSi el control responde a la entrada del usuarioTodos los controles visuales
lReadOnlyPT_LOGICALEl contenido no puede ser editado por el usuario (solo visualizacion)Edit, Memo, MaskEdit, StringGrid, DBEdit, DBMemo
lWordWrapPT_LOGICALAjustar texto a la siguiente linea cuando excede el ancho del controlLabel, Memo, Edit, StaticText, DBMemo
lPasswordPT_LOGICALEnmascarar caracteres de entrada (campo de contrasena)Edit
lCheckPT_LOGICALEstado de marcado del controlCheckBox, Radio
nTabIndexPT_NUMBERIndice de orden de tabulacion (determina orden de recorrido del foco)Todos los controles enfocables
lTabStopPT_LOGICALSi el control puede recibir foco mediante la tecla TabTodos los controles enfocables
cMaskPT_STRINGPatron de mascara de entrada (p. ej., "99/99/9999" para fechas)MaskEdit
nIntervalPT_NUMBERIntervalo del temporizador en milisegundosTimer
lRunningPT_LOGICALSi el temporizador esta actualmente activoTimer
nScrollBarsPT_NUMBEREstilo de barras de desplazamiento (0=ninguna, 1=horizontal, 2=vertical, 3=ambas)Edit, Memo, ScrollBox, StringGrid, DBGrid, Browse
lAutoSizePT_LOGICALRedimensionar automaticamente el control para ajustar su contenidoLabel, Image, StaticText
lModalPT_LOGICALSi el formulario bloquea la interaccion con otras ventanasForm, Dialog

Propiedades de Fuente

Propiedades relacionadas con la tipografia del texto mostrado en los controles.

PropiedadTipoDescripcionDisponible Para
cFontNamePT_FONTNombre de la familia de fuentes (p. ej., "Segoe UI", "Arial")Todos los controles con texto
nFontSizePT_NUMBERTamano de fuente en puntosTodos los controles con texto
lFontBoldPT_LOGICALEstilo de texto en negritaTodos los controles con texto
lFontItalicPT_LOGICALEstilo de texto en cursivaTodos los controles con texto
lFontUnderlinePT_LOGICALEstilo de texto subrayadoTodos los controles con texto
lFontStrikeoutPT_LOGICALEstilo de texto tachadoTodos los controles con texto
oFontPT_FONTObjeto de fuente completo (envuelve todas las propiedades de fuente)Todos los controles con texto
Fuentes heredadas

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.

PropiedadTipoDescripcionDisponible Para
cDataSourcePT_STRINGNombre o referencia al objeto de fuente de datosDBEdit, DBMemo, DBComboBox, DBCheckBox, DBText, DBGrid, DBNavigator, Browse
cDataFieldPT_STRINGNombre del campo en la fuente de datos para vincularDBEdit, DBMemo, DBComboBox, DBCheckBox, DBText
cItemsPT_STRINGArreglo o lista de elementos (para controles basados en lista)ListBox, ComboBox, StringGrid, TreeView, ListView, TabControl
nColCountPT_NUMBERNumero de columnas en un control de cuadricula o tablaStringGrid, DBGrid, Browse
nRowCountPT_NUMBERNumero de filas en un control de cuadricula o tablaStringGrid, DBGrid, Browse
nItemIndexPT_NUMBERIndice del elemento seleccionado actualmenteListBox, ComboBox, ListView, TreeView, TabControl
cTextPT_STRINGContenido de texto del controlEdit, Memo, Label, StaticText, LabeledEdit
cPromptPT_STRINGTexto de etiqueta mostrado en el controlButton, CheckBox, Radio, GroupBox
cAliasPT_STRINGNombre del alias de tabla de base de datosTodos los componentes de base de datos
cTableNamePT_STRINGNombre de la tabla de base de datosTodos los componentes de base de datos

Propiedades Especificas del Control

Estas propiedades son unicas para tipos de control especificos y no se comparten ampliamente.

PropiedadTipoDescripcionDisponible Para
nWindowStatePT_NUMBEREstado de ventana (0=normal, 1=minimizado, 2=maximizado)Form
cIconPT_STRINGRuta al archivo de icono de ventanaForm
lMaxButtonPT_LOGICALMostrar el boton de maximizar en la barra de tituloForm
lMinButtonPT_LOGICALMostrar el boton de minimizar en la barra de tituloForm
lCloseButtonPT_LOGICALMostrar el boton de cerrar en la barra de tituloForm
nTabPosPT_NUMBERPosicion de las etiquetas de pestana (0=arriba, 1=abajo, 2=izquierda, 3=derecha)TabControl
lHotTrackPT_LOGICALResaltar pestanas al pasar el ratonTabControl
lDoubleBufferedPT_LOGICALUsar doble buffering para reducir parpadeoPaintBox, StringGrid, ScrollBox
cFileNamePT_STRINGRuta del archivo seleccionado (para controles de dialogo)OpenDialog, SaveDialog
cFilterPT_STRINGFiltro de tipo de archivo para dialogos (p. ej., "Archivos de texto|*.txt")OpenDialog, SaveDialog
cApiKeyPT_STRINGClave API para autenticacion del servicio de IAOpenAI, Gemini, Claude, DeepSeek, Grok
cModelPT_STRINGIdentificador del modelo de IA (p. ej., "gpt-4", "claude-3")OpenAI, Gemini, Claude, DeepSeek, Grok
nTimeoutPT_NUMBERTiempo de espera de solicitud en milisegundosOpenAI, Gemini, Claude, HttpClient, WebSocket
cHostPT_STRINGNombre de host o direccion IP del servidorMySQL, MariaDB, PostgreSQL, SQLite, HttpClient, FtpClient, WebServer
nPortPT_NUMBERNumero de puerto de redMySQL, MariaDB, PostgreSQL, HttpClient, FtpClient, WebServer, WebSocket
cUserNamePT_STRINGNombre de usuario para autenticacionMySQL, MariaDB, PostgreSQL, FtpClient, SMTPClient
cPasswordPT_STRINGContrasena para autenticacionMySQL, MariaDB, PostgreSQL, FtpClient, SMTPClient
cDatabasePT_STRINGNombre de la base de datosMySQL, 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:

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..

Vista previa en vivo

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:

Un control hijo puede sobrescribir cualquier propiedad heredada estableciendola explicitamente.

En Esta Página

Primeros pasos Paleta de componentes Funciones del IDE Tutoriales Referencia Plataformas Propiedades de Apariencia Posicion y Tamano Propiedades de Comportamiento Propiedades de Fuente Propiedades de Datos Propiedades Especificas del Control Configurar Propiedades en Codigo Configurar Propiedades en el Inspector de Objetos Herencia de Propiedades