Referencia de Metodos A-Z
Esta pagina documenta los metodos mas comunmente usados en los controles de HarbourBuilder. Los metodos son
funciones llamadas en objetos de control para realizar acciones, consultar estado o desencadenar comportamiento.
Complementan las asignaciones de propiedades y manejadores de eventos en el modelo de programacion de HarbourBuilder.
Metodos vs. Propiedades
Usa propiedades para leer o establecer el estado de un control (p. ej., oBtn:nWidth := 200).
Usa metodos para desencadenar acciones (p. ej., oBtn:Show()) o para consultar valores calculados
que no se almacenan como propiedades simples.
Construccion y Destruccion
| Metodo | Parametros | Retorna | Descripcion | Disponible Para |
|---|
New() | oParent | Objeto de control | Crea una nueva instancia de control dentro del padre especificado. Es el metodo constructor usado por el preprocesador xBase para expandir comandos DEFINE y @. | Todos los controles |
Create() | ninguno | Self (el control) | Realiza el control en la plataforma nativa llamando a la API del backend (CreateWindowEx, NSView alloc, gtk_widget_new). Se llama automaticamente durante la activacion del formulario. | Todos los controles visuales |
Release() | ninguno | nil | Destruye el control y libera sus recursos nativos. Despues de Release(), la referencia al objeto se vuelve invalida. | Todos los controles |
Close() | ninguno | nil | Cierra el formulario. Dispara OnCloseQuery (que puede cancelar el cierre), luego OnClose, luego OnDestroy. | Form |
Visibilidad y Foco
| Metodo | Parametros | Retorna | Descripcion | Disponible Para |
|---|
Show() | ninguno | nil | Hace visible el control. Para formularios, tambien activa el formulario y lo muestra en pantalla. Dispara el evento OnShow. | Todos los controles visuales |
Hide() | ninguno | nil | Oculta el control sin destruirlo. El control sigue existiendo y puede mostrarse de nuevo. Dispara el evento OnHide en formularios. | Todos los controles visuales |
SetFocus() | ninguno | nil | Da foco de entrada al control. El control debe ser visible, habilitado y tener lTabStop en .T. Dispara el evento OnEnter. | Todos los controles enfocables |
Metodos de Valor
| Metodo | Parametros | Retorna | Descripcion | Disponible Para |
|---|
GetValue() | ninguno | Valor actual | Retorna el valor actual del control. Para Edit/Memo, retorna la cadena de texto. Para CheckBox, retorna .T./.F. Para ListBox/ComboBox, retorna el elemento seleccionado. | Edit, Memo, MaskEdit, CheckBox, Radio, ListBox, ComboBox, TrackBar, UpDown |
SetValue( xValue ) | xValue (cualquiera) | nil | Establece el valor del control. Para Edit/Memo, establece el texto. Para CheckBox, establece el estado de marcado. Dispara el evento OnChange. | Edit, Memo, MaskEdit, CheckBox, Radio, ListBox, ComboBox, TrackBar, UpDown |
SetText( cText ) | cText (cadena) | nil | Establece el texto mostrado del control. Equivalente a SetValue() para controles de texto, pero tambien funciona para Label, StaticText, titulo de Button, etc. No dispara OnChange. | Label, StaticText, Button, Edit, Memo, LabeledEdit, StatusBar, GroupBox |
GetText() | ninguno | Cadena | Retorna el texto mostrado. Para Edit/Memo, es el contenido de texto. Para Label/StaticText, la etiqueta. Para Button, el prompt. | Label, StaticText, Button, Edit, Memo, LabeledEdit |
Metodos de Posicion y Tamano
| Metodo | Parametros | Retorna | Descripcion | Disponible Para |
|---|
SetBounds( nLeft, nTop, nWidth, nHeight ) | Cuatro numeros | nil | Establece la posicion y el tamano del control en una sola llamada. Mas eficiente que establecer cada propiedad por separado porque solo dispara un redibujado nativo. | Todos los controles visuales |
SetPosition( nLeft, nTop ) | Dos numeros | nil | Establece solo la posicion (izquierda, arriba) sin cambiar el tamano. Alias: MoveTo(). | Todos los controles visuales |
SetSize( nWidth, nHeight ) | Dos numeros | nil | Establece solo el tamano (ancho, alto) sin cambiar la posicion. | Todos los controles visuales |
GetSize() | ninguno | Arreglo { nWidth, nHeight } | Retorna el ancho y alto actuales como un arreglo de dos elementos. | Todos los controles visuales |
GetPosition() | ninguno | Arreglo { nLeft, nTop } | Retorna la posicion izquierda y arriba actuales como un arreglo de dos elementos. | Todos los controles visuales |
Metodos de Fuente
| Metodo | Parametros | Retorna | Descripcion | Disponible Para |
|---|
SetFont( cName, nSize, [lBold], [lItalic], [lUnderline] ) | Nombre de fuente, tamano, banderas de estilo opcionales | nil | Establece la fuente del control en una sola llamada. Los parametros de estilo son opcionales y por defecto son .F. | Todos los controles con texto |
GetFont() | ninguno | Objeto de fuente (o arreglo) | Retorna el descriptor de fuente actual. | Todos los controles con texto |
Metodos de Visualizacion y Refresco
| Metodo | Parametros | Retorna | Descripcion | Disponible Para |
|---|
Refresh() | ninguno | nil | Fuerza un redibujado inmediato del control. Invalida el area de visualizacion del control y dispara el evento OnPaint. | Todos los controles visuales |
Update() | ninguno | nil | Procesa los mensajes de dibujo pendientes inmediatamente. A diferencia de Refresh() que fuerza un redibujado, Update() solo repinta areas que ya estan marcadas como necesitadas de redibujo. | Todos los controles visuales |
Invalidate() | ninguno | nil | Marca el area completa del control como necesitada de redibujado, pero no fuerza un redibujado inmediato. El pintado real ocurre durante el siguiente ciclo de pintado. | Todos los controles visuales |
Resumen Completo de Metodos
| Metodo | Retorna | Categoria | Controles Principales |
|---|
New( oParent ) | Objeto de control | Construccion | Todos los controles |
Create() | Self | Construccion | Todos los controles visuales |
Release() | nil | Destruccion | Todos los controles |
Close() | nil | Ciclo de vida | Form |
Show() | nil | Visibilidad | Todos los controles visuales |
Hide() | nil | Visibilidad | Todos los controles visuales |
SetText( cText ) | nil | Valor | Label, Edit, Button, Memo, StatusBar |
GetText() | Cadena | Valor | Label, Edit, Button, Memo |
GetValue() | Cualquiera | Valor | Edit, Memo, CheckBox, ListBox, ComboBox |
SetValue( xVal ) | nil | Valor | Edit, Memo, CheckBox, ListBox, ComboBox |
SetBounds() | nil | Posicion | Todos los controles visuales |
SetPosition() | nil | Posicion | Todos los controles visuales |
SetSize() | nil | Posicion | Todos los controles visuales |
GetSize() | Arreglo | Posicion | Todos los controles visuales |
GetPosition() | Arreglo | Posicion | Todos los controles visuales |
SetFont() | nil | Fuente | Todos los controles con texto |
GetFont() | Objeto de fuente | Fuente | Todos los controles con texto |
Refresh() | nil | Visualizacion | Todos los controles visuales |
Update() | nil | Visualizacion | Todos los controles visuales |
Invalidate() | nil | Visualizacion | Todos los controles visuales |
SetFocus() | nil | Foco | Todos los controles enfocables |
Encadenamiento de metodos
Algunos metodos retornan self, permitiendo un estilo fluido:
oBtn:New( oForm ):SetBounds( 50, 30, 120, 32 ):SetText( "OK" ):Show().
Sin embargo, el enfoque tradicional de establecer propiedades individualmente es mas legible y
es el estilo usado por el generador de codigo de HarbourBuilder.