Tema 3.2.2 PDF

Tcnicas de Programacin
3.2.- Programacin C++ con Builder C++
Tema 3.2.2.- Componentes en C++ Builder

Introduccin
Los compiladores C++Builder nos ofrecen definidos una serie de componentes en la paleta de
componentes. Los componentes se agrupan en esta paleta en una serie de pestaas o pginas segn
la funcionalidad de los mismos. Existen tres formas posibles de insertar cualquier componente en un
formulario, que son:
Hacemos clic sobre el componentes y posteriormente en el formulario.
Hacemos un doble click sobre el componente.
Hacemos un click sobre el componente y, manteniendo pulsado el botn izquierdo del ratn,
arrastramos sobre el formulario hasta dar el tamao deseado al componente.
Mediante el inspector de objetos accedemos a las propiedades y eventos asociados a los
componentes. Estos componentes son elementos genricos con una funcionalidad muy concreta, cuya
finalidad es la reutilizacin. Cada uno de ellos est destinado a realizar una tarea tpica en una
aplicacin. Los componentes se organizan en la denominada VCL (Visual Component Library) que es
una jerarqua de clases escritas en Object Pascal y que se asocia al IDE de C++Buider.
Un componente de la VCL es una clase que caracteriza a un control de Windows agregando
propiedades, mtodos y gestores de eventos a cada control.
En este tema vamos a analizar las propiedades, mtodos y eventos de los componentes ms
importante y usuales.
La VCL (Visual Components Library) o biblioteca de componentes visuales

En Windows, no son las aplicaciones quienes manejan los recursos del sistema como pueden ser la
memoria, los ficheros, las ventanas y hasta los controles grficos. Es el sistema operativo quin realiza
todas estas tareas. Y la aplicacin se limita a realizar peticiones de lo que necesita. Estas peticiones se
realizan mediante lo que se denomina la API de Windows.
Por todo esto los entornos de programacin visuales han desarrollado diversos Marcos de Trabajo. Un
marco de trabajo es una fase intermedia que se coloca por encima de la API para aportar mayor
sencillez a las aplicaciones. Normalmente estos marcos de trabajo son orientados a objetos y se
implementan como bibliotecas del lenguaje base, por ello tambin se suelen denominar bibliotecas de
clases. La VCL es un marco de trabajo visual y orientado a objetos.
Tan importantes son los marcos de trabajo, que dominar un
entorno de programacin visual, suele traducirse en conocer el
lenguaje base del entorno, y su marco de trabajo.
Los marcos de trabajo se pueden clasificar en dos categoras:
1. Los marcos de trabajo C++ (OWL y MFC)
2. La VCL.
Aplicacin
OWL (Object Windows Library o Biblioteca de Objetos para
Windows) fue un marco de trabajo desarrollado por Borland e
incorporado a los compiladores Borland C++ (versiones 3 y
VCL
sucesivas) y supuso un importante hito en la programacin
para Windows por su potencia y facilidad de uso.
MFC (Microsoft Foundation Class o Biblioteca Fundamental de
Clases de Microsoft) y lo incorpor a los compiladores
S.O. Windows
Microsoft Visual C++ (actualmente incluso en Borland C++ 6).
MFC es una biblioteca de clases menos abstracta que el OWL y
ms cercana a la API. Tambin resulta ms sencillo que OWL
para los programadores que conocen la API.
Aunque MFC se usa ms que OWL la arquitectura de OWL es,
tcnicamente, mejor que MFC.

En 1995, Borland lanz al mercado Delphi, que supuso la revolucin en la programacin para Windows
e inici el desarrollo rpido y sencillo de aplicaciones visuales (RAD), empleando componentes
(objetos que pueden ubicarse en formularios y manipulados por medio de propiedades, mtodos y
eventos). Delphi se basa en el lenguaje Object Pascal (una ampliacin de Pascal que incorpora
programacin orientada a objetos) y permita la creacin de programas ejecutables independientes que
no requeran intrprete, por lo que se ejecutaban mucho ms rpido.
Lo ms relevante desde el punto de vista tcnico es que Borland cre la VCL (Visual Class Library o
Biblioteca de Componentes Visuales) que es un marco de trabajo para crear aplicaciones Windows
diseada en torno al concepto de componente (propiedades, mtodos y eventos). La VCL desarrollada
para Delphi es la misma que se emplea como ncleo de C++ Builder, de hecho, est escrita en Object
Pascal.
TObject
La VCL hace un uso
TPersistent
extensivo del concepto de
herencia. El objetivo final de
TComponent
la VCL es crear clases que
Componentes
representan a componentes,
visibles
aunque algunas clases no
hagan
referencia
a
TControl
componentes
concretos:
realizan tareas de gestin
interna y se emplean como
Ttimer, Ttable, ...
TGraphicControl
TWinControl
clases bases para derivar
mediante
herencia
otras
Componentes
clases.
En
la
figura
mostramos una pequea
no visibles
TpaintBox ...
Tbutton, Tpanel, ...
parte de la jerarqua de
clases que forman la VCL.

Es posible construir aplicaciones Windows de gran calidad con C++ Builder sin un conocimiento
exhaustivo de la VCL, aunque es conveniente realizar una somera descripcin de la jerarqua de clases
que conforman la VCL.
Las clases que conforman la parte superior (el techo) de la jerarqua de la VCL (Tobject, TPersistent y
TComponent) se denominan clases "abstractas" porque sirven para estructurar, y agrupar
comportamientos comunes de las clases de la VCL. No se suelen crear objetos directamente a partir de
ellas. Rigurosamente hablando, no son clases abstractas, porque no tienen mtodos virtuales puros,
pero las podemos considerar como tales en la prctica.
Tobject
Es el ancestro de todas las clases de la VCL. Encapsula el comportamiento comn de los objetos en C+
+ Builder, como puede ser informacin de la clase, instanciacin... Suele ser una buena idea derivar
nuestras propias clases de TObject, porque aunque no sea normal que el programador haga uso de los
mtodos proporcionados por Tobject, si lo es que lo haga C++ Builder en tiempo de ejecucin.
Directamente de TObject heredan aquellas clases que no son componentes, y no necesitan ser
almacenadas en disco.
TPersistent
Esta clase tiene que ver con la habilidad de un objeto de almacenarse en disco o en memoria,
asignarse a otros objetos, as como otros detalles internos de C++ Builder.
TComponent
sta es una de las clases ms importantes de la VCL, ya que la mayora de los objetos que se manejan
en una aplicacin son componentes. Esta clase proporciona toda la funcionalidad que requiere un
componente bsico. La funcionalidad de TComponent permite que los objetos aparezcan en la paleta
de componentes y que sean manipulados por el diseador de formularios, adems de otras
capacidades comunes a los componentes.
Los componentes no visibles derivan directamente de TComponent mientras que los componentes
visibles derivan de TControl, que a su vez deriva de TComponent. Por esta razn se suelen denominar
controles a los componentes visibles.

TControl
Proporciona la funcionalidad de los componentes visibles (controles). Esta funcionalidad es
principalmente el aspecto visual que deben ofrecer los componentes en tiempo de ejecucin. TControl
proporciona mayor funcionalidad que la que requieren los componentes visibles: los componentes
individuales derivan de TGraphicControl o de TWinControl, clases derivadas de Tcontrol.
TGraphicControl
Generaliza a los controles que tienen una representacin visual, pero no pueden recibir el foco: el
usuario podr verlos pero no interactuar con ellos. Suelen ser controles para visualizar texto (no
editable en tiempo de ejecucin), grficos o dibujos. Poseen una propiedad Canvas que permite
acceder a su rea de dibujo.
TWinControl
Son los controles tpicos de Windows, que pueden recibir el foco, contener otros controles, y adems
poseen un manejador de ventana. Un manejador de ventana es un identificador que proporciona
Windows para el control, por lo que podemos decir que Windows tiene un conocimiento directo de la
existencia del mismo. Dicho identificador es un nmero que Windows incorpora a su base de datos de
controladores y peridicamente comprueba si ha realizado alguna solicitud.
Clases de Formularios y Aplicaciones

Son controles en si mismos, pero no se presentan en la paleta de componentes.
TApplication
La clase TApplication encapsula una aplicacin Windows por lo que caracteriza las operaciones
fundamentales de un programa en Windows. TApplication simplifica el interface entre el programador
y el sistema operativo, ocupndose de tareas como gestionar el paso de mensajes, proporcionar la
ayuda contextual, establecer los textos de sugerencia de los botones y barras de estado,
procesamiento de "teclas rpidas", gestin de excepciones, ejecutar cuadros de mensajes, etc.
Todas las aplicaciones de C++ Builder tienen un puntero a un objeto Tapplication denominado
Application, que se crea automticamente. Cuando un programa empieza a ejecutarse, C++ Builder
invoca a la variable Application, llama a sus mtodos Initialize(), CreateForm() y Run().

TApplication
Por ejemplo, si retomamos el ejemplo 3 podemos abrir el fichero Ejemplo3.cpp o bien abrir el proyecto
y seleccionar Proyect/View Source para observar el contenido del fichero que C++ Builder crea como
fichero principal de la aplicacin.
{
try
{
Application->Initialize();
Application->Title = "Primera aplicacin";
Application->CreateForm(__classid(TFormPrincipal), &FormPrincipal);
Application->Run();
}
catch (Exception &exception)
{
Application->ShowException(&exception);
Mtodos Initialize(), CreateForm() y Run().
}
Adems aparece el mtodo Title por haber
catch (...)
puesto un ttulo a nuestra aplicacin
{
try
{
Como Application se crea automticamente no aparece
throw Exception("");
en la paleta de componentes ni est disponible en el
}
inspector de objetos para manipular "visualmente" sus
catch (Exception &exception)
propiedades.
{
En cualquier caso, algunas propiedades pueden
Application->ShowException(&exception);
}
establecerse en tiempo de diseo seleccionando las
}
pginas Forms o Applicaction en Project/Options.
return 0;
}

Propiedades de TApplication
Propiedad
Descripcin
Active
Especifica si la aplicacin est activa y tiene el foco.
Hint
Hint especifica el texto que debe aparecer en el cuadro de ayuda o texto de sugerencia asociado
a la aplicacin. Este cuadro aparece cuando ocurre el evento OnHint. Por defecto se muestra
nicamente el cuadro asociado al componente sobre el que est el ratn por lo que usualmente
se emplea esta propiedad para mostrar la informacin extensa de este componente en una barra
de estado, por ejemplo.
ShowHint
ShowHint determina si los cuadros de sugerencia estarn activados o desactivados para toda la
aplicacin.
Pueden emplearse las funciones GetShortHint() y GetLongHint() para obtener las dos partes de
la propiedad Hint.
MainForm
MainForm especifica qu formulario acta como ventana principal de la aplicacin.
ShowMainForm
ShowMainForm especifica si la aplicacin debe mostrar la ventana principal al iniciar su

ejecucin. Para ocultarla, establecer esta propiedad a false antes de la llamada a Application>Run y asegurarse de que la propiedad Visible del formulario est tambin a false.
Icon y Title
Especifican el icono y el texto, respectivamente, que aparecen en la barra de tareas de Windows

cuando se minimiza la aplicacin. Pueden establecerse en tiempo de diseo seleccionando
Project/Options/Application.
HelpFile y
CurrentHelpFile
Para especificar el fichero de ayuda asociado a la aplicacin.
Ejemplo 93.- Propiedades de TApplication

Vamos a realizar paso a paso una aplicacin visual que muestra el uso de la propiedad
Application.

Creamos una aplicacin y archivamos el trabajo, no es necesario cambiar el nombre a ningn archivos.
Declaramos el mtodo DisplayHint como un procedimiento pblico del Formulario
Escribimos en el Unit, debajo de lo creado automticamente, el mtodo DisplayHint y lo asignamos a

Application para que lo maneje el evento OnCreate del Form.
void __fastcall TForm1::DisplayHint(TObject *Sender)
{
StatusBar1->SimpleText = GetLongHint(Application->Hint);
}
Situamos sobre el formulario un componente OpenPictureDialog de la pestaa Dialog y un botn al que
modificamos su propiedad Caption a Seleccionar un Icono.

Situamos sobre el formulario un componente StatusBar de la pestaa Win32 y hacemos doble clic
sobre el formulario para crear el gestor de evento y teclear las lneas siguientes.
void __fastcall TForm1::FormCreate(TObject *Sender)
{
Form1->Hint="Mostrar la propiedad Hint";
Application->OnHint = DisplayHint;
Application->Title="Uso de Application";
}
Hacemos doble clic sobre el botn para crear el gestor de evento y teclear las lneas siguientes.
void __fastcall TForm1::Button1Click(TObject *Sender)
{
OpenPictureDialog1->DefaultExt = GraphicExtension(__classid(TIcon));
OpenPictureDialog1->FileName = GraphicFileMask(__classid(TIcon));
OpenPictureDialog1->Filter = GraphicFilter(__classid(TIcon));
OpenPictureDialog1->Options.Clear();
OpenPictureDialog1->Options << ofFileMustExist << ofHideReadOnly << ofNoChangeDir;
while (true) { if (OpenPictureDialog1->Execute())
{ if (!OpenPictureDialog1->Options.Contains(ofExtensionDifferent))
{ Application->Icon->LoadFromFile(OpenPictureDialog1->FileName); break; }
else
{
OpenPictureDialog1->Options.Clear();
OpenPictureDialog1->Options << ofFileMustExist << ofHideReadOnly << ofNoChangeDir;
}
}
else break; }
}

Ejecutando el programa y seleccionando un icono al pulsar el
botn
obtenemos
el
siguiente
resultado.
Observar
minimizando la aplicacin como aparece el ttulo de la misma.
El ejemplo lo hemos realizado a efectos de demostracin de
Application, ya que mostrar una pista en la barra de estado se
puede hacer con su propiedad Autohint sin necesidad de
escribir el evento OnHint.
Mtodos de TApplication
Mtodo
Descripcin
BringToFront()
Establece la ltima ventana activa como la que se muestra por encima de todas las dems.
CreateForm()
Crea un nuevo formulario. Generalmente, el programador no usa este mtodo ya que las lneas de
cdigo para la creacin de formularios las aade automticamente C++ Builder.
HelpCommand()
HelpContext()
HelpJump()
Se emplean para gestionar la ayuda asociada a una aplicacin. Generan un evento OnHelp, y si no
hay un gestor para este evento, se gestiona a travs de WinHelp.
MessageBox()
Muestra un mensaje al usuario en cuadro de dilogo que puede incorporar botones. Devuelve un
valor que depende del botn seleccionado para cerrar el cuadro de dilogo.
Minimize()
Minimiza una aplicacin y la aloja en la barra de tareas de Windows.
Restore()
Reestablece el tamao que tena la aplicacin antes de ser minimizada.
Run()
Ejecuta la aplicacin.
Terminate()
Finaliza laejecucin de una aplicacin.
ShowException()
Muestra un cuadro de dilogo cuando se produce una excepcin que no es gestionada por la
aplicacin. Para especificar qu excepciones pueden gestionarse en la aplicacin, debemos
construir un gestor para el evento OnException.
HandleException() Proporciona una manera de gestionar excepciones por defecto en la aplicacin.

10

Eventos de TApplication
Evento
Descripcin
OnActivate
OnDeactivate
Ocurren respectivamente cuando se activa o desactiva la aplicacin.

Una aplicacin se activa cuando se genera la aplicacin (empieza a ejecutarse) o cuando
estaba activa otra aplicacin y una ventana de la aplicacin a la que se refiere recibe el foco.
Una aplicacin se desactiva cuando el usuario selecciona otra aplicacin.
OnHint
OnHint ocurre cuando el cursor se coloca sobre un control o una opcin de un men que
puede mostrar un cuadro de sugerencia.
Se suele escribir un gestor para este evento cuando se quiere mostrar un texto largo de
sugerencia en una barra de estado.
OnShowHint
OnShowHint ocurre cuando la aplicacin va a mostar un cuadro de sugerencia. Se suele

usar para modificar la apariencia del cuadro.
Pueden emplearse las funciones GetShortHint() y GetLongHint() para obtener las dos partes
de la propiedad Hint
OnMinimize
OnRestore
Ocurren cuando la aplicacin se minimiza o se reestablece al tamao normal,

respectivamente.
OnHelp
Ocurre cuando la aplicacin recibe una peticin de ayuda. Los mtodos HelpContext() y
HelpJump() gestionan de forma automtica este evento.
OnException
Se emplea cuando se desea modificar el comportamiento por defecto de una aplicacin

cuando se manifiesta alguna excepcin que no es tratada por el programa.
OnShortCut
Se emplea este gestor para realizar acciones antes de que el formulario o los controles del
formulario gestionen los eventos oportunos a la pulsacin de teclas.
Cuando se pulsa una tecla se desencadenan los siguientes eventos, por este orden:
OnKeyDown, OnKeyPress, y OnKeyUp.
11

Mtodos y eventos de TApplication
Ejemplo 94.- Mtodos y eventos de TApplication
Muestra de un programa totalmente comentado para ver algunos mtodos y eventos de
Tapplication. Situando en un Form un componente Timer y dos botones para tener algo similar a:

{
/* Hacemos doble clic sobre el botn al que hemos puesto en Caption Mostrar Mensaje. Las siguientes lneas
harn que la ventana con el mensaje se muestre en primer plano y una vez cerrada esta que el formulario desde el
que la hemos llamado se restaure en primer plano. */
Application->NormalizeTopMosts();
Application->MessageBox("Esto se muestra en primer plano", "Observese", MB_OK);
Application->RestoreTopMosts();
}
//--------------------------------------------------------------------------void __fastcall TForm1::AppDeactivate(TObject *Sender)
{
/* El cdigo siguiente minimiza la aplicacin cuando esta se desactiva. Debemos declarar el mtodo como pblico
en el header con lo siguiente: void __fastcall AppDeactivate(TObject *Sender); */
Application->Minimize();
}
//--------------------------------------------------------------------------/* Las siguientes lneas van a provocar el siguiente efecto: cuando minimizamos la aplicacin el Timer comienza a
contar y tras el tiempo especificado la ventana vuelve a su estado anterior debido al evento OnTimer. El
temporizador no estar activo hasta la prxima vez que minimicemos la ventana. */
12

Mtodos y eventos de TApplication
// Creamos el evento
void __fastcall TForm1::IniciarTimer(TObject *Sender)
{
/* Implementamos el mtodo IniciarTimer sin olvidarnos de declararlo como pblico con:
void __fastcall IniciarTimer(TObject *Sender); */
Timer1->Enabled = true;
}
{
Application->OnDeactivate = AppDeactivate;
Application->OnMinimize = IniciarTimer;
Timer1->Interval = 1000;
}
void __fastcall TForm1::Timer1Timer(TObject *Sender)
{
Application->Restore();
Timer1->Enabled = false;
}
{
Application->Terminate();
}
//--------------------------------------------------------------------------Tema 3.2.2.- Componentes en C++ Builder
13

Tform
La clase TForm caracteriza a los formularios en la VCL. Los formularios se emplean como ventanas
principales, cuadros de dilogo, ventanas secundarias o cualquier otro tipo de ventana que se pueda
imaginar. A continuacin veremos las propiedades, mtodos y eventos principales de los formularios
de forma resumida.
Propiedades de los formularios en tiempo de diseo y ejecucin
Propiedad
Descripcin
ActiveControl
Establece qu componente tiene el foco cuando se abre el formulario.
Enabled
Indica si el formulario est activo (si puede recibir el foco).
AutoScroll,
HorzScrollBar
VertScrollBar
Controlan conjuntamente las barras de desplazamiento de un formulario.
BorderIcons
Indica qu iconos aparecen en la barra de ttulo de un formulario.
BorderStyle
Indica qu tipo de borde debe tener el formulario.
Caption
Indica la cadena que aparece en la barra de ttulo del formulario mientras que Name
Name
Indica con qu nombre se refiere al formulario en la aplicacin (en el cdigo).
Color
Color de fondo del formulario.
Cursor
Especifica qu cursor se muestra cuando est sobre el formulario.
Font
Permite especificar las propiedades de la fuente de letra que se usar en el formulario. Se aplica a todos
los componentes ubicados en el formulario o componentes hijo.
Icon
Establece el icono que se ver en la barra de ttulo cuando se muestre el formulario en tiempo de ejecucin
y cuando se minimice.
Height y Width Altura y anchura (en pxels) del formulario.

ClientWidth
ClientHeight
Altura y anchura (en pxels) del rea de cliente del formulario (el rea de cliente es la que queda dentro de
los bordes del formulario y por debajo de la barra de ttulo y de la barra de men). Al modificar estas
propiedades se actualizan Width y Height.
14

Propiedades de los formularios en tiempo de diseo y ejecucin
Propiedad
Descripcin
Left y Top
Coordenadas X e Y del formulario (esquina superior izquierda) en la pantalla.
Position
Determina el tamao y la posicin del formulario.
FormStyle
Para especificar si un formulario es o no parte de una aplicacin multiformulario.
HelpFile
HelpContext
Para especificar el fichero de ayuda asociado a la aplicacin y gestionar la ayuda contextual.
Hint
Especifica el texto que debe aparecer en el cuadro de ayuda o texto de sugerencia asociado al formulario.
Este cuadro aparece cuando ocurre el evento OnHint. Por defecto se muestra nicamente el cuadro asociado
al componente sobre el que est el ratn por lo que usualmente se emplea esta propiedad para mostrar la
informacin extensa de este componente en una barra de estado, por ejemplo.
ShowHint
Determina si los cuadros de sugerencia estarn activados o desactivados para el formulario.
Visible
Indica si el formulario es visible o no. Los mtodos Show() y ShowModal() hacen que un formulario sea
visible y lo colocan por encima de todos.
WindowState Para establecer el estado inicial del formulario (normal, minimizado o maximizado) o consultar su estado.
Propiedades de los formularios en tiempo de ejecucin

Propiedad
Descripcin
Active
Indica si el formulario est activo (si tiene el foco).
Canvas
El lienzo es la superficie del formulario sobre la que se puede dibujar. La propiedad Canvas da acceso a
esta superficie para dibujar lneas, mapas de bits, texto, ... en el rea de cliente. Suele usarse con el gestor
del evento OnPaint
ClientRect
Coordenadas de los cuatro puntos que delimitan el rea de cliente del formulario.
ModalResult
El valor devuelto cuando se cierra un formulario modal (abierto con el mtodo ShowModal()).
FormState
Proporciona informacin acerca del estado en que se encuentra un formulario (si se est creando, si es
visible, si es modal, etc.).
15

Mtodos de los formularios
Mtodo
Descripcin
BringToFront()
SendToBack()
Coloca al formulario en primer plano o en ltimo, respectivamente.
Hide()
Oculta el formulario (establece la propiedad Visible a falso).
Print()
Imprime el contenido del formulario.
Show()
ShowModal()
Para mostrar formularios. ShowModal() ejecuta (abre) el formulario modalmente: debe cerrarse para
que el usuario pueda seguir trabajando con la aplicacin.
Close()
CloseQuery()
Close() cierra el formulario tras llamar a CloseQuery() para asegurarse de que es correcto cerrarlo.
Esta ltima llama al manipulador del evento OnCloseQuery.
SetFocus()
Activa el formulario y lo coloca en primer plano, poniendo a true la propiedad Active. Adems, el
componente especificado en la propiedad ActiveControl recibe el foco.
CanFocus()
Devuelve true si el formulario puede recibir el foco (si las propiedades Visible y Enabled estn a true).
SetBounds()
Establece simultneamente los valores de las propiedades Top, Left, Width y Height.
ClientToScreen()
ScreenToClient()
Convierte las coordenadas del rea de cliente en coordenadas de pantalla y viceversa.
Invalidate()
Refresh()
Repaint()
Update()
Para redibujar un formulario.
Release()
Destruye un formulario y libera toda la memoria asociada.
Eventos de los formularios

Una accin puede desencadenar varios eventos y el orden en que ocurren puede ser muy importante.
Cuando se crea un formulario se generan los siguientes eventos, que enumeramos ordenadamente:
1. OnCreate.
2. OnShow.
3. OnActivate.
4. OnPaint.
16

Eventos de los formularios
De la misma manera, cuando se destruye el formulario se generan los siguientes eventos, que
enumeramos ordenadamente:
1. OnCloseQuery.
2. OnClose.
3. OnDestroy.
4. Destructor del formulario (si existe).
Evento
Descripcin
OnActivate
OnDeactivate
Ocurren cuando se activa o desactiva un formulario, respectivamente. Un formulario se activa cuando

se recibe el foco y se desactiva cuando el foco pasa a otro formulario de la misma aplicacin.
OnCreate
OnDestroy
OnCreate ocurre cuando se crea inicialmente el formulario (slo ocurre un evento de este tipo por
formulario) y OnDestroy cuando se destruye.
OnClose
OnCloseQuery
El evento OnClose ocurre cuando se cierra un formulario. Hace una llamada a OnCloseQuery para
asegurarse de que es correcto cerrarlo.
OnMouseDown
OnMouseMove
Para responder a los eventos que suceden al mover el ratn o cuando se pincha con l sobre el
OnMouseUp
formulario.
OnClick
OnDblClick
OnKeyDown
OnKeyUp
OnKeyPress
Para responder a los eventos que suceden al pulsar alguna tecla sobre el formulario.
OnHelp
Ocurre cuando se recibe una peticin de ayuda en el formulario.
OnHide
OnShow
Ocurren cuando se oculta o se muestra el formulario, respectivamente (cuando su propiedad Visible se

establece a false o true, respectivamente). OnShow ocurre justo antes de que el formulario se haga
visible.
OnPaint
Ocurre cuando el formulario necesita ser redibujado (refrescado). Esto ocurre muy frecuentemente, y
aunque los componentes del formulario se redibujan generalmente por s mismos, a veces es preciso
redibujar "manualmente" el formulario.
OnResize
Ocurre cuando se modifica el tamao del formulario, justo despus de redimensionar el formulario.
17
Resumen sobre la VCL

La VCL (Visual Component Library) la forman un conjunto de componentes u objetos visuales
prefabricados. Cuando incluimos un componente en una aplicacin este pasa a formar parte de su
ejecutable. Podemos decir que un componente es un elemento de nuestro programa que posee
caractersticas (propiedades) y acciones (mtodos) asociadas y que reaccionar o no ante una
situacin producida en el entorno (evento). Un componente, por tanto, est asociado a mtodos
(cdigo de programa correspondiente a un procedimiento al que se puede acceder desde el programa),
y en muchos casos a propiedades y eventos.
Las propiedades representan los datos contenidos en el objeto.
Los mtodos son las acciones que el objeto puede realizar.
Los eventos son condicionantes ante los cuales el objeto puede reaccionar.
Todo componente posee un nombre (Name) que lo
diferencia del resto de componentes de una
aplicacin. Por defecto, C++ Builder asigna un valor
que tiene relacin con el tipo de componente y un
nmero que los diferencie del resto de componentes.
Una propiedad la podemos considerar como una
variable ligada al componente que posee un valor que
condicionar su funcionamiento. Algunas propiedades
estn disponibles en fase de diseo y otras no, es
decir, que podremos modificar su contenido mediante
el Inspector de Objetos o lo deberemos hacer en
tiempo de ejecucin.
Por ejemplo, para modificar el ttulo de un formulario
podemos asignar el valor directamente a la propiedad
Caption desde el Inspector de Objetos o modificarla
desde cdigo cuando ocurra un evento o cuando se
inicie la aplicacin. El cdigo asociado se incluira en
el cdigo del programa como muestra la figura:
18

En la figura anterior aparece la lnea de cdigo Caption = "Modificacin del ttulo o Caption"; que
modificar el contenido de la propiedad en tiempo de ejecucin. Si queremos hacer referencia a una
propiedad de un componente desde un procedimiento no asociado a ese componente debemos
referenciar la propiedad con el operador -> de la siguiente forma:
Form1->Caption = "Modificacin del ttulo o Caption";
Un evento es una situacin que se produce durante la ejecucin de un programa. Los eventos pueden
provenir del sistema, del ratn, desde teclado, etc.... Un componente podr reaccionar ante un evento
si el tipo de componente lo tiene as predefinido, dependiendo del objetivo para el que est diseado.
Por ejemplo, un componente TForm (formulario o ficha) tiene, por supuesto, un evento asociado a la
accin de cerrar (Sistema), en cambio, el componente TButton (botn) no lo tendr. Cuando ocurre un
suceso durante la ejecucin de nuestro programa, los componentes sobre los que se produzca
reaccionarn o no a este suceso si disponen de un evento que lo detecte. Cuando queramos incluir un
conjunto de sentencias que se ejecuten cuando se produzca un determinado suceso deberemos
asociar un conjunto de instrucciones al evento correspondiente del componente. Este grupo de
acciones se expresar en el cdigo del programa. C++ Builder generar automticamente la base
principal del cdigo que se va asociar al evento, pudiendo escribir como bloque de instrucciones las
sentencias que deseemos. Por ejemplo, si pulsamos en el Inspector de Objetos del componente
formulario (Form1) sobre el evento OnClose (que se produce cuando se cierra el formulario) aparecer
el editor de cdigo con las lneas:
void __fastcall TForm1::FormClose(TObject *Sender, TCloseAction &Action)
{
ShowMessage(Cierre de la aplicacin);
}
Crendose una lnea en blanco donde se sita el cursor y donde podemos escribir una lnea de cdigo
como la destacada en rojo. Esto nos mostrar una ventana de dilogo con el mensaje entrecomillado y
un botn OK.
19

Ejemplo 95.- Propiedades, mtodos y eventos sobre un formulario
Se trata de realizar un programa visual que trabaje con propiedades, mtodos y eventos de un
formulario para realizar las operaciones que iremos describiendo paso a paso.
En el inspector de objetos (Object Inspector) hacemos los siguientes cambios de propiedades del
formulario:
1.- Ponemos en false los valores de biMinimize y biMaximize de BorderIcons, lo que eliminar las
opciones de maximizar y minimizar en tiempo de ejecucin.
2.- A la propiedad BorderStyle le damos el valor bsSingle, impidiendo que la ventana sea
dimensionable en la fase de ejecucin.
3.- Asignamos a la propiedad Position el valor psScreenCenter, con lo que la ventana siempre
aparezca centrada en pantalla.
4.- Establecemos la propiedad Cursor con el valor crHandPoint y cuando el puntero del ratn est
situado sobre el formulario aparezca el cursor como una mano.
5.- Establecemos unas dimensiones del formulario de 150x300 pixels.
Accedemos a la ventana de cdigo con F12, o con el botn de acceso rpido Toggle Form/Unit o bien
desde men view y escribimos justo debajo de la lnea Tform *Form1; la sentencia int ncolor; con la
que definiremos una variable global de tipo entero que, en nuestro programa podr tomar los valores 1,
2, 3 4.
Entre las llaves que definen el constructor del formulario (lneas que siguen en gris) tecleamos la lnea
que vemos destacada en negro .
__fastcall TForm1::TForm1(TComponent* Owner)
: TForm(Owner)
{
Caption = "Modificacin del ttulo o Caption";
}
20

Hacemos doble clic sobre el evento OnClose del Inspector de Objetos teniendo seleccionado el
componente Form1 y sobre el gestor de evento que se genera (gris) tecleamos la lnea de cdigo en
negro.
{
ShowMessage("Cierre de la aplicacin");
}
Hacemos doble clic en el evento OnCreate y escribimos el siguiente cdigo:
{
ncolor=1;
Form1->Color=clRed;
}
En este caso no sera necesario anteponer a la propiedad Color el componente al que corresponde
porque la funcin corresponde al propio formulario. Tambin podramos usar el puntero this
escribiendo this->Color=clRed; , aunque tampoco es necesario en este caso.
Generamos el evento OnCloseQuery, que se producir cuando se solicite el cierre del formulario, y
escribimos el siguiente cdigo:
void __fastcall TForm1::FormCloseQuery(TObject *Sender, bool &CanClose)
{
if (Application->MessageBox("Esta seguro?","Va a cerrar la aplicacin",MB_YESNO) == ID_YES)
CanClose=true;
else
CanClose=false;
}
Conseguimos que se pregunte al usuario si quiere o no abandonar el programa, evitndolo si su
respuesta es no.
21

Finalmente, hacemos doble clic sobre el evento OnClick de forma que cada vez que se pulse el ratn
aparezca el fondo del formulario de uno de los 4 colores que escogemos con el cdigo siguiente.
void __fastcall TForm1::FormClick(TObject *Sender)
{
switch (ncolor)
{
case 1:Color=clMaroon; break;
case 2:Color=clPurple; break;
case 3:Color=clGreen; break;
default:Color=clRed;
ncolor=0;
}
ncolor++;
}
Guardamos el programa, depuramos los posibles errores de compilacin, linkado y ejecucin hasta
ejecutar el programa y la ventana tendr la siguiente apariencia al solicitar su cierre:
22
Componentes
Ya hemos visto que los componentes que podemos insertar en nuestros formularios estn organizados
en carpetas (pestaas o pginas) en la Paleta de Componentes del IDE. Los componentes pueden ser
visibles y no visibles.
Pestaa Standar. Estos componentes son los elementos de control ms comunes de Windows.
Componente Visible?
Descripcin breve
MainMenu
No
Diseo de barras de mens junto con sus correspondientes mens desplegables.
PopUpMenu
No
Diseo de mens contextuales o emergentes que se muestras al hacer clic con el botn
derecho del ratn.
Label
Si
Para mostrar texto no accesible por el usuario, como son los ttulos.
Edit
Si
Presenta un rea donde el usuario puede introducir o modificar texto en una sola lnea.
Memo
Si
Presenta un rea donde el usuario puede introducir o modificar varias lneas de texto.
Button
Si
Un botn permite que los usuarios lo seleccionen para realizar una operacin.
CheckBox
Si
Casilla de verificacin, para alternativas tipo S/No, Verdadero/Falso o Activado/Desactivado.

Los CheckBox son independientes entre s, ya que las opciones que representan no son
excluyentes entre ellas.
RadioButton
Si
Para representar opciones donde slo est disponible una de ellas.
ListBox
Si
Lista de opciones para que el usuario seleccione una o varias de ellas.
ComboBox
Si
Conjunta la funcionalidad del Edit y del ListBox para presentar una lista de opciones.
ScrollBar
Si
Barra de desplazamiento para poder desplazar en pantalla la parte visible de una lista o ficha,
o trasladarse por un rango en incrementos.
GroupBox
Si
Agrupar componentes relacionados en una ficha.
RadioGroup
Si
Agrupar RadioButton en una ficha.
Panel
Si
Agrupar componentes y creacin de barras de estado.

23
Componentes
Pestaa Standar
Componente Visible?
Descripcin breve
Frames
Si
Contenedor de componentes que puede anidarse en otros frames o formularios.
ActionList
No
Mantiene una lista de las acciones que pueden ser usadas por componentes y controles,
como opciones de men y botones.
Ejemplo 96.- Modificacin y consulta de propiedades en tiempo de ejecucin

Se trata de retomar el ejemplo 3 donde diseamos un formulario con varios campos y establecer
el cdigo necesario sobre los gestores de eventos para realizar las operaciones que citamos.
Sobre el evento OnCreate:
Modificamos la propiedad Caption para que aparezca Ejemplo 96
Si el color del Form es clBtnFace lo cambiamos a clWhite
Establecemos la propiedad Checked del CheckBox a false
Hacemos que se oculten los dos RadioButtom
Crear y trabajar con otros gestores de eventos que describiremos una vez realizadas las
operaciones anteriores.
En primer lugar creamos un nuevo directorio denominado ejemplo 96 y abrimos el ejemplo 3 tal y como
lo dejamos anteriormente. Clicamos en File/Save As... y guardamos en nuestro nuevo directorio y
tambin File/Save Project As ... para archivar el proyecto cambiando el nombre de Ejemplo3 a
Ejemplo96. Con esto tendremos los archivos necesarios mnimos para el proyecto. El cdigo asociado
al evento OnCreate ser:
FormPrincipal->Caption = "Ejemplo 96";
if (FormPrincipal->Color == clBtnFace) // Lectura
FormPrincipal->Color = clWhite; // Escritura
CheckBoxOpciones->Checked = false; // Escritura
RadioButtonOp1->Hide();
/* Hide() es el mtodo que oculta el componente sobre el que se aplica. */
24
Componentes
Hasta este momento el aspecto de la aplicacin en tiempo de ejecucin ser
Una vez llegados a este punto vamos a dar sentidos
a los botones, a la casilla de seleccin, a las
opciones de seleccin (ahora no visibles) y a la
etiqueta que por ahora no es visible (propiedad
Caption vaca). Procedemos a:
Construir el gestor del evento asociado a modificar
el componente de seleccin CheckBox de forma que
cuando se active (inicialmente est desactivado) se
muestren los dos RadioButtom y se active el botn
de OK. Cuando se desactive, los RadioButtom se
volvern a ocultar y el botn de OK se desactivar.
if (CheckBoxOpciones->Checked == true)
Para ello, escribiremos el gestor asociado al evento
{
OnClick del componente CheckBox:
RadioButtonOp1->Show();
RadioButtonOp2->Show();
RadioButtonOp1->Checked = true;
ButtonOK->Enabled = true;
}
else
{
ButtonOK->Enabled = false;
LabelSalida->Caption = "";
}
25
Componentes
Finalmente, escribiremos el gestor del evento asociado a hacer clic sobre el botn OK, que est
operativo (propiedad Enabled) nicamente cuando el CheckBox est activado, y en consecuencia,
cuando pueden emplearse los RadioButtom. Haremos adems que en la etiqueta vaca se muestre un
texto alusivo al texto introducido (o no) en el Edit y a la opcin elegida. Este evento ser:
if (RadioButtonOp1->Checked)
{
if (EditNombre->Text=="")
LabelSalida->Caption="Ha escogido la Opcin 1, D./D. sin identificar";
else
LabelSalida->Caption="Ha escogido la Opcin 1, D./D. " + EditNombre->Text;
}
else
{
if (EditNombre->Text == "")
LabelSalida->Caption = "Ha escogido la Opcin 2, D./D. sin identificar";
else
LabelSalida->Caption = "Ha escogido la Opcin 2, D./D. " + EditNombre->Text;
}
26
Conversin entre tipos

Cuando estudiamos la clase AnsiString vimos que resultaba especialmente til la conversin entre
tipos, por lo que vamos a analizar algunas de las rutinas de conversin entre tipos.
StrToInt
Convierte un AnsiString que representa un nmero entero (en notacin decimal o hexadecimal) a un
nmero. Su sintaxis es la siguiente: StrToInt(const AnsiString S);. StrToInt convierte la cadena S de
tipo AnsiString, que representa un nmero de tipo entero en notacin decimal o hexadecimal, en un
nmero. Si la S no representa nmero vlido, StrToInt ejecuta una excepcin EconvertError.
Ejemplo 97.- Uso de StrToInt
Situamos en un formulario dos elementos Edit y un elemento Button. Cuando pulsemos el botn,
el cdigo convierte los valores introducidos en los Edit a nmeros enteros, los suma, y muestra un
mensaje que indica la suma. El fichero .cpp quedara en los gestores de eventos de la siguiente forma:
{
int i1, i2; //Declara i1 e i2 como enteros
i1 = StrToInt(Edit1->Text);
//Convierte a entero el Text que introducimos en Edit1, que deber ser
// un nmero entero, y asigna el valor a i1
//Convierte a entero el Text que introducimos en Edit2, que deber ser
// un nmero entero, y asigna el valor a i2
ShowMessage("Suma: " + IntToStr(i1 + i2));
// Suma los valores i1 e i2 (un entero) y convierte el resultado en un
// string que se muestra como mensaje emergente.
}
//--------------------------------------------------------------------------void __fastcall TForm1::FormCreate(TObject *Sender)
{
Edit1->Text="";
Edit2->Text="";
}
27

Recordemos lo que pasaba con la
suma de enteros con nmeros dentro
del rango del tipo int.
En cambio cuando tecleamos un
nmero fuera de rango lo que ocurre
es:
Efectivamente, el nmero introducido no es un valor entero vlido,

por lo que se ejecuta una excepcin EconvertError antes de
efectuar la operacin sealada. Dicho de otra forma, la suma se
realiza en complemento a 1 y, mientras los datos introducidos
sean enteros vlidos, el procesador efectuar la suma dentro de
rango sin lanzar una excepcin EconvertError. De esta forma se
evita que el procesador realice operaciones no vlidas mediante
comandos de programacin, pero en cambio surge un error en la
programacin que debemos tener especialmente presente.
28

El problema lo podemos resolver utilizando el siguiente procedimiento, del que vemos el resultado:
Ejemplo 97b.- Uso de StrToInt
Situamos en un formulario tres elementos Edit, dos label y un elemento Button. Cuando pulsemos
el botn, el cdigo convierte los valores introducidos en los Edit a nmeros enteros de 64 bits, los
suma, y muestra en el tercer Edit la suma. El fichero .cpp quedara en los gestores de eventos de la
siguiente forma:
{
__int64 i1, i2;
i1 = StrToInt64(Edit1->Text);
Edit3->Text = i1+ i2;
}
//--------------------------------------------------------------------------void __fastcall TForm1::FormCreate(TObject *Sender)
{
Edit1->Text="";
Edit2->Text="";
Edit3->Text="";
}
29

StrToIntDef
Convierte un AnsiString que representa un nmero entero a un nmero. Su sintaxis es la siguiente:
StrToIntDef(const System::AnsiString S, int Default);
StrToIntDef convierte la cadena S de tipo AnsiString, que representa un nmero de tipo entero en un
nmero. Si la S no representa nmero vlido, StrToIntDef devuelve el entero introducido por defecto en
int Default, evitando as la excepcin EconvertError que se produce en StrToInt.
Ejemplo 98.- Uso de StrToIntDef
Veamos un ejemplo que utiliza dos elementos Label, dos Edit y un Button de forma que el usuario
introduce en dato de entrada un nmero entero, clica sobre el botn de ejecucin y en el campo
correspondiente a dato de salida aparece el nmero tecleado si es un entero vlido, en caso contrario
aparecer el nmero 0 introducido por defecto. El cdigo para el OnClick del botn ser el siguiente:
{
int Numero = StrToIntDef(Edit1->Text, 0);
Edit2->Text = IntToStr(Numero);
}
Los resultados son:
30
IntToStr
Convierte un nmero entero en un AnsiString. Su sintaxis, cuando trabajamos con tipo int, es la
siguiente:
IntToStr(int Value);
Su sintaxis, cuando trabajamos con tipo __int64, es la siguiente:
IntToStr(__int64 Value);
Es decir puede trabajar con cualquier dato de tipo int.
En el ejemplo de StrToInt hemos puesto la lnea siguiente: Edit3->Text = i1+i2;. El texto del Edit3 era la
suma i1+i2 , que es un nmero entero (tambin es una cadena) puesto que lo son i1 e i2, pero lo ms
correcto es convertir de forma efectiva el nmero entero en un AnsiString que es lo que en realidad
puede mostrar un Edit. Lo ms correcto en el ejemplo citado ser:
Para tipo int:
int i1, i2; // 1
Edit3->Text = IntToStr(i1+i2); //2
// 1: Datos de tipo int
// 2: Como i1 e i2 son tipo int, IntToStr trabajo con tipo int
Para tipo __int64:
__int64 i1, i2; // 1
Edit3->Text = IntToStr(i1+i2); //2
// 1: Datos de tipo int64
// 2: Como i1 e i2 son tipo int64, IntToStr trabajo con tipo int64
31
StrToFloat
Convierte un AnsiString a un valor de coma flotante. Su sintaxis es la siguiente:
StrToFloat(const AnsiString S);
StrToFloat convierte la cadena AnsiString S a un valor de coma flotante. La cadena S puede contener
opcionalmente un signo + o -, una cadena de dgitos con un punto decimal, una E' o e' seguida por un
nmero entero con signo. Los espacios en blanco son ignorados.
La variable global DecimalSeparator define el carcter usado como punto decimal. En la cadena no se
pueden usar separadores de miles ni smbolos de moneda. Si la S no contiene un valor vlido,
StrToFloat lanza una excepcin ECONVERTERROR.
FloatToStr
Convierte un valor en coma flotante a un AnsiString. Su sintaxis es la siguiente:
FloatToStr(Extended Valor);
FloatToStr convierte el valor en coma flotante dado por Valor a una cadena. En general, el formato de
conversin numrica emplea 15 dgitos significativos.
Extended hace referencia a los tipos reales descritos anteriormente.
FloatToStrF
Convierte un valor en coma flotante a un AnsiString usando un formato que debemos especificar en
cuanto a precisin y nmero de dgitos. Su sintaxis es la siguiente:
FloatToStrF(Extended Valor, TfloatFormat Formato, int Precision, int Digitos);
FloatToStrF convierte el valor en coma flotante especificado por Valor a su representacin como
cadena de caracteres (string). El parmetro Valor es el valor a convertir. El parmetro precisin
especifica la precisin de valor. Debera ser inferior o igual a 7 para valores sencillos, menor o igual a
15 para valores de tipo Doble, y menor o igual a 18 para los valores de tipo real descritos. El nmero de
dgitos y los parmetros de formato controlan la forma de conversin en cadena.
Para todos los formatos, los caracteres usados como coma decimal y separador de miles se definen en
las variables globales DecimalSeparator y ThousandSeparator respectivamente.
Si el valor dado es una cadena YO (no un nmero), la cadena resultante es 'YO'. Si el valor dado es el
infinito positivo, la cadena resultante es 'INF'. Si el valor dado es el infinito negativo, la cadena
resultante es '-INF '.
32
StrToCurr
Convierte un AnsiString en un objeto tipo Currency. Su sintaxis es la siguiente:
StrToCurr(const AnsiString S);
CurrToStr y CurrToStrF
Convierte un currency en representacin de tipo cadena sin y con formato respectivamente. Su sintaxis
es la siguiente:
CurrToStr(Currency value);
CurrToStrF(System:: Currency Value, TFloatFormat Format, int Digits);
StrToDate
Convierte una cadena AnsiString a un objeto TdateTime con la siguiente sintaxis:
StrToDate(const AnsiString S);
Llama a StrToDate para analizar una cadena que especifica una fecha. Si la S no contiene una fecha
vlida, StrToDate lanza una excepcin ECONVERTERROR
TDateTime es una clase de C++ basada en el tipo de datos de fecha y hora de Delphi. La clase
TDateTime es un miembro heredado de datos val declarado como double que contiene los valores de
fecha y hora. La parte entera de un TDateTime es el nmero de das que han pasado desde 12/30/1899.
La parte fraccionaria de un valor TDateTime es la hora de ese da.
DateToStr
Convierte un objeto TdateTime a un AnsiString con la siguiente sintaxis:
DateToStr(System::TDateTime Date);
Ejemplo 99.- Que da de la semana es?
Sobre un formulario situamos varios Label, un Edit y un Button. Cuando introduzcamos en el edit
un dato con el formato DD-MM-YY, la cadena ser convertida a un valor TdateTime que ser usado para
calcular el da de la semana que representa, mostrndonos adems la fecha actual.
33

Ejemplo 99.- Que da de la semana es?
{
DateSeparator = '-'; //Cambia el separador / por ShortDateFormat = "d/m/yyyy"; //Cambia el formato de m/d/yyyy a d/m/yyyy
Label2->Caption = DateToStr(Date()); //Fecha actual del sistema
char dias[7][10]={"Domingo","Lunes","Martes","Mircoles","Jueves","Viernes","Sabado" };
TDateTime dia = StrToDate(Edit1->Text); //1
Label4->Caption = dias[dia.DayOfWeek() - 1]; //Mostramos el resultado obtenido
//1 Convertimos de String a Date almacenandolo en dia del tipo TDateTime
}
StrToTime
Convierte una cadena AnsiString a un objeto TdateTime con la siguiente sintaxis:
StrToTime(const AnsiString S);
El parmetro S se forma con dos o tres numeros, separados por un caracter definido en la variable
global TimeSeparator, y seguidos opcionalmente del indicador AM o PM. Los nmeros representan las
horas, minutos y, opcionalmente, los segundos. Si la hora va seguida de AM o PM se asume un formato
de reloj de 12 horas y si no se incluye el indicador el formato es de 24 horas.
TimeToStr
TimeToStr(System::TDateTime Time);
34

DateTimeToStr
DateTimeToStr(const System::TDateTime DateTime);
Ejemplo 100.- Buenos das o buenas tardes
Veamos un programa que salude con buenos das o buenas tardes segn la hora introducida.
Adems vamos a mostrar la fecha y la hora con las conversiones vistas.
El cdigo es:
{
DateSeparator = '-'; //Cambia el separador / por ShortDateFormat = "d/m/yyyy"; //Cambia el formato de m/d/yyyy a d/m/yyyy
TDateTime hora = StrToTime(Edit1->Text); //1
if (hora < (TDateTime) 0.50 ) //2
Edit2->Text="Buenos das";
else
Edit2->Text="Buenas tardes";
// 1 Convertimos el texto de Edit1 (dado en formato HH:MM:SS) a formato Tdate Time
// asignado el valor a la variable hora
//2 Segn sea antes de las 12 o despus de las salude se emite uno u otro saludo
TimeSeparator = '_';
Label3->Caption = TimeToStr(Time());
Label5->Caption = DateToStr(Date()); //Fecha actual del sistema
Label7->Caption = DateTimeToStr(Now());
}
35

Ejemplo 100.- Buenos das o buenas tardes
Algunos resultados.
IntToHex
Convierte a notacin hexadecimal un entero. Su sintaxis es la siguiente:
IntToHex(int Valor, int Digitos);
IntToHex(__int64 Valor, int Digitos);
Antes de ver un ejemplo de conversin a hexadecimal diremos que la conversin se realiza carcter a
carcter dando como resultado un carcter UNICODE. UNICODE es un juego de caracteres que emplea
dos bytes para representar cada carcter.
36
IntToHex
Cdigos UNICODE de los nmeros:
0030 - 0039 -> 0 - 9 ISO - LATIN-1
Cdigos UNICODE de las letras y otros caracteres:
0024
Signo de $
0041 - 005A
Mayusculas A a Z
005F
_(guin bajo)
0061 - 007A
Minusculas a a z
00C0 - 00D6

00D8 - 00F6
00F8 - 00FF
Ejemplo 101.- Conversin a Hexadecimal

Sobre un formulario situaremos, entre otros, un Edit, un Button y un Label de forma que en el
Label aparezca la conversin a hexadecimal de la cadena introducida en el Edit.
{
AnsiString EditText = Edit1->Text;
Label2->Caption = "";
for (int i=1;i<=EditText.Length();i++)
{
Label2->Caption = Label2->Caption + IntToHex(EditText[i],4) + " ";
}
}
37
Componentes
Label
Este componente se utiliza para desplegar textos o mensajes estticos dentro de los formularios,
textos tales como encabezados, solicitud al usuario del programa para que proporcione algn dato o
informacin (edad, sueldo, etc.), en cierta forma hace las funciones de printf, cout, etc., pero solo
cuando se considera el aspecto de mensajes.
Tambin es un objeto en C++Builder y por tanto tiene asociados sus propias propiedades, mtodos y
eventos. Como su uso normal es dentro de un objeto Form, muchas propiedades que se definan para
el objeto Form1, el objeto Label1 las va a heredar.
La propiedad Caption es la que contiene el mensaje a mostrar en la pantalla, que por defecto es su
nombre inicial, pero se puede cambiar haciendo clic en la propiedad Caption del Inspector de Objetos,
teniendo seleccionado Label en el formulario y escribir el texto que deseemos. Tambin podemos
cambiar la propiedad Caption en tiempo de ejecucin mediante una lnea de programa como la
siguiente: Label1->Caption = Hola mundo...;
Su uso se limita a mostrar resultados e informacin al usuario, debido a que este no puede editarlo. No
puede contener el foco en una aplicacin.
Su principales propiedades son:
Name: Es el nombre lgico con el que se referencia al componente.
Caption: Permite modificar el texto que se muestra.
Font: Modifica la fuente, estilo de fuente, tamao, etc. del caption.
Alignment: Especifica la alineacin del texto (derecha, izquierda o centro).
Button, BitBtn y SpeedButton
Button es un botn estndar de Windows, mientras los que los otros dos (pestaa Additional) amplan
sus funcionalidades como permitir incluir un bitmap.
Button es el componente ms empleado, ya que normalmente contiene el cdigo principal del
programa y su activacin por el usuario provoca que se realicen los principales procesos del problema
planteado (aqu es donde se va a capturar datos, realizar operaciones, etc.).
38
Componentes
De este componente manejaremos su propiedad Caption para indicar acciones, etiquetndolo con
palabras como Ok, Aceptar, Exe, ejecutar, etc. , y su evento OnClick para activarlo, siendo en dicho
evento donde se construye el cdigo del programa.
Lo dicho anteriormente no significa que sea un componente necesario en los programas, ya que el
cdigo se puede asociar a cualquier evento de cualquier formulario u otro componente del programa,
pero el manejo de Windows nos tiene acostumbrados al empleo del botn OK o Aceptar.
Este botn puede activar su evento OnClick, cuando el usuario presione la tecla Enter poniendo su
propiedad Default en true. Igualmente puede activar su evento OnClick cuando el usuario, presione la
tecla ESC tan solo con poner la propiedad Cancel en true. Estas opciones no estn disponibles para
SpeedButton. Sus principales propiedades son:
Name: Nombre lgico con el que se referencia al componente.
Caption: Texto del botn.
Font: Modifica la fuente, estilo de fuente, tamao, etc. del caption.
Height y Width: Alto y ancho del botn en pixels.
Left y Top: Posicin superior izquierda del extremo superior izquierdo del botn relativa al del
formulario en pixels.
Enabled: Habilita o deshabilita la respuesta del botn a eventos.
Hint: Texto de ayuda a pista rpida. Para podamos ver el Hint debe colocarse la propiedad
ShowHint en true. Estas propiedades se encuentran en la mayora de los componentes
visuales.
Visible: Determina cuando aparece el botn en el formulario.
Glyph (slo en BitBtn y SpeedButton): permite especificar el bitmap que aparece en el botn.
Kind (slo en BitBtn): determina el tipo de algunos bitmap predefinidos.
Flat (slo en SpeedButton): hace desaparecer el efecto 3D de los botones.
Down (slo en SpeedButton): especifica cuando el botn est presionado. Para quedar
presionado la propiedad GroupIndex debe ser distinta de cero.
TabOrder: especifica el orden en el que los componentes tendrn el foco.
39
Componentes
Sus principales eventos son:
OnClick: ocurre cuando se hace click sobre el botn.
OnMouseMove: ocurre cuando se mueve el mouse sobre el botn.
Un mtodo muy empleado es:
SetFocus: coloca el foco en el botn.
Edit
La funcin principal de este componente visual es manejar todos los procesos de entrada y salida
(input/output) del programa. El componente Edit, es el equivalente a las variables en cualquier lenguaje de
programacin, mas la instruccin de captura o despliegue correspondiente, es decir;
a) En PASCAL: Read (Ciudad) -> Edit1
b) En C: printf("%d", sueldo) -> Edit2
c) En C++, cin.get(nombre,30) -> Edit3
Es decir, que este componente permite capturar datos y tambin, como en el caso del componente Label,
desplegar datos, textos, mensajes o resultados de operaciones, usando su propiedad Text. Esta propiedad,
as como la propiedad Caption en Label, permiten igualarse a muchos procesos bsicos, es decir es fcil
igualar Text o Caption a un dato, una variable, otro Text o Caption, o una expresin algebraica normal, como
en los siguientes ejemplos:
Edit1->Text = 5;
Label2->Caption = "Palabra";
Edit3->Text = 87/ 6.2 ;
Su valor por defecto es Edit1 y es en su propiedad Text donde se modifica, generalmente al principio de un
programa se deja en blanco, y al ejecutarse el programa, el usuario lo llena con los datos solicitados o el
programa lo llena con el resultado de las operaciones. Cuando un usuario lo carga con un dato, este es
almacenado como tipo texto, independientemente de lo que haya escrito el usuario.
Para resolver el problema de usar datos numricos dentro de Text de un componente Edit, en operaciones
matemticas, basta agregarle a la propiedad Text, las funciones de conversin vistas, como .ToInt() o
.ToDouble(), como se muestra en los siguientes ejemplos.
Edit3->Text= Edit2->Text.ToInt() * 5;
Edit5->Text= 3 * pow( Edit2->Text.ToDouble(), double (4) );
40
Componentes
Edit
Si, por ejemplo, se pide resolver el problema de multiplicar dos nmeros cualesquiera, se utilizarn
tres componentes Edit (multiplicando, multiplicador, producto) como si fuesen tres variables simples
directamente.
El problema puede resolver de la siguiente manera:
{
Edit3->Text=Edit1->Text.ToInt()* Edit2->Text.ToInt();
}
Y un posible resultado puede ser:
Observamos como el componente Edit permite capturar datos por parte del usuario del programa.
Si se realizan divisiones con componentes Edit debemos recordar que al menos uno de ellos sea
double, porque de lo contrario se trunca la parte fraccionaria.
Para resolver el problema de conversin de datos o variables numricas a Texto de un componente
Edit, donde se tiene una variable numrica cargada, con un resultado o dato numrico y se pretende
mandarla a un componente Edit o Label para su despliegue, existen dos manera sencillas, que son:
Usando la clase AnsiString, que puede recibir como argumentos o parmetros una variable de
tipo entera o double y convertirla directamente a una string, que es el tipo de dato que espera el
componente Edit o el componente Label para su despliegue, por ejemplo:
41
Componentes
Edit
int a; // rea de declaracin de variables
double b;
a = Edit1->Text.ToInt(); // rea de captura de datos
b = Edit2->Text.ToDouble();
a = a+3; // rea de operaciones
b = b *5.1; // rea de despliegue y conversin de nmeros a strings o Edits
Label3->Caption = AnsiString(a);
Edit4->Text = AnsiString(b);
Como se observa se puede transferir variables numricas tanto a Label como a Edit mediante la clase
AnsiString, sin embargo es mas sencillo usar el mtodo que se usa en el programa dado de ejemplo
para la multiplicacin, es decir considerar los componentes Edit como variables normales.
Para el caso de resultados decimales , la salida incluye todo el conjunto de decimales
asociados a un tipo double (muchos ceros), para resolver este problema se pueden usar
directamente algunos de los mtodos asociados a la clase AnsiString, por ejemplo uno de esos
mtodos es; FormatFloat("string de formato", var double);
La string de formato contiene una serie de smbolos literales que se utilizan para darle el formato de
salida deseado, esto smbolos o constantes literales junto con algunos ejemplos de salida con el
formato que producen son:
0
1234
-1234
1
0
0.00
1234.00
-1234.00
0.50
0.00
#.##
1234
-1234
.5
#,##0.00
1,234.00
-1,234.00
0.50
0.00
#,##0.00;(#,##0.00)
1,234.00
(1,234.00)
0.50
0.00
#,##0.00;;Zero
1,234.00
-1,234.00
0.50
Zero
0.000E+00
1.234E+03
-1.234E+03
5.000E-01
0.000E+00
#.###E-0
1.234E3
-1.234E3
5E-1
0E0
42
Componentes
Edit
Por ejemplo:
double a; // rea de declaracin de variables
a = Edit1->Text.ToDouble(); // captura y conversin de datos
a = a/3.1416 ; // operaciones
Edit2->Text= FormatFloat("###,###.##", a); // conversin y despliegue de datos con formato
Veamos un ejemplo muy similar al de multiplicar asociando a Button1 la siguiente lnea de comandos:
Edit3->Text= FormatFloat("###,###.##",Edit1->Text.ToDouble()/ Edit2->Text.ToDouble());
En la figura vemos algunos posibles resultados:
Ejemplo 102.- Calcular el rea de un tringulo

Vamos a construir un programa que nos facilite el modelo de solucin del rea del tringulo
conocidas la base y la altura. Construimos un formulario similar a:
43
Componentes
Ejemplo 102.- Calcular el rea de un tringulo
El cdigo asociado al evento OnClick del componente Button quedar como sigue:
Edit3->Text=FormatFloat("###.##",Edit1->Text.ToDouble()*Edit2->Text.ToDouble()/2);
MaskEdit
Este componente de la pestaa Adittional es muy similar en su uso al componente Edit, excepto que
proporciona una mascara especializada para el formato de datos, es decir se puede usar para que el
usuario proporcione datos con formatos bien definidos, como son valores numricos que incluyan
puntos y comas por ejemplo 3,345.87, o que incluyan smbolos, o para el caso de fechas que lleven su
propio separador como por ejemplo 16/06/2003.
Tambin se puede usar, para asegurar
que el dato proporcionado por el usuario,
solo incluya nmeros, o solo contenga
letras, etc. Para dar formato al dato que el
usuario debe proporcionar basta con
hacer doble clic en la propiedad EditMask
en (Inspector de Objetos), para desplegar
la ventana que vemos.
Observamos en la parte derecha de la
ventana algunos ejemplos de mascaras
de edicin.
44
Componentes
MaskEdit
En la ventanilla superior izquierda se colocan los caracteres especiales de edicin y en la ventanilla inferior
izquierda se muestra el formato que adquiere y se pueden proporcionar datos para probar el formato
diseado. Los principales caracteres especiales de edicin son:
Carcter
Significado
Los carcteres opcionales aparecen en blanco
>
Todos los caracteres que le siguen se pasan a maysculas hasta el final de la mscara o hasta que se
encuentra el carcter <.
<
Todos los caracteres que le siguen se pasan a minsculas hasta el final de la mscara o hasta que se
encuentra el carcter >.
<>
Los caracteres que siguen aparecen en maysculas o minsculas segn sean tecleados por el usuario.
El carcter siguiente es un carcter literal.
Requiere una letra mayscula o minscula en esta posicin
Permite una letra es esta posicin pero no la requiere
Requiere un carcter alfanumrico (letras y/o nmeros) en esta posicin
Permite un carcter alfanumrico en esta posicin pero no lo requiere
Requiere un carcter arbitrario en esta posicin.
Permite un carcter arbitrario en esta posicin pero no lo requiere
Requiere un numero en esta posicin
Permite un numero pero no lo requiere
Permite un numero y signos mas y menos en esta posicin pero no lo requiere
Separador de horas, minutos y segundos para funciones horarias.
Separador de meses, das y aos para funciones de fecha.
Se utiliza para separar los tres campos o partes de que consta una mascara
Para insertar espacios en blanco en el texto de la mascara

45
Componentes
MaskEdit
Cualquier carcter que no aparezca en la tabla anterior puede aparecer en una mscara, pero se tomara
como un literal cualquiera, es decir se insertar automticamente y el cursor saltar a una posicin
posterior. El segundo campo de una mascara es un carcter simple que indica que carcter literal debe
ser incluido como parte del texto del componente MaskEdit, por ejemplo (000)_000-000;0;*. Un 0 en el
segundo campo indica que solo deben capturarse los nueve dgitos marcados con 0, en lugar de los 13
que tiene la mascara. El tercer campo de la mascara es el carcter que queremos que aparezca en lugar
de espacios en blancos.
Para procesar MaskEdit deberemos usar solo Text y no Text.ToDouble() y recurdese que este formato
es para capturar datos, no para mostrarlos, puesto que para este caso se usa FormatFloat().
ComboBox
Existen multitud de ocasiones en donde el usuario del programa tiene que proporcionar datos que
provienen de un conjunto finito y muy pequeo de posibles respuestas, lo que significa que cada vez
que se ejecute el programa, el usuario deber proporcionar las mismas respuestas. Por ejemplo
capitales de provincia en Andaluca, donde las posibles respuestas son: Almera, Cdiz, Crdoba,
Granada, Huelva, Jan, Mlaga o Sevilla; o en la situacin de preguntar por el sexo (Hombre, Mujer),
etc. Para situaciones como esta, existen componentes que permiten programar por adelantado las
posibles respuestas, y el usuario solo debe seleccionar la respuesta apropiada, en lugar de tener que
escribirla. Este componente es el ComboBox, que nos permite definir en primera instancia un conjunto
de datos, valores o respuestas asociados a un componente de edicin cualquiera, de forma que el
usuario tendr la oportunidad de seleccionar un dato del conjunto de datos o respuestas ya definido. El
componente ComboBox tiene dos partes:
Una parte de encabezado, para poner el nombre del grupo de respuestas (por ejemplo capitales de
provincia, sexo, etc.), que se carga usando la propiedad Text del componente; y
Una segunda parte que es la lista de opciones o respuestas que se debe cargar cuando se disea la
ventana. Para la inclusin de datos debemos hacer doble clic en la propiedad Items en el Inspector
de objetos y nos saldr el siguiente editor de strings o cadenas:
46
Componentes
ComboBox
En tiempo de ejecucin del programa, toda la lista de respuestas, estar a la vista del usuario, para que
seleccione la deseada. Basta que este pulse sobre la flechita que esta al lado del encabezado. Para
procesar este componente debemos usar su propiedad Text de manera normal, es decir si la respuesta
se desea de tipo string usaremos ComboBox1->Text, y si la respuesta se quiere numrica debemos
convertir Text a ToInt() o ToDouble(). Por ejemplo, ComboBox1->Text.ToDouble().
Panel
Para poder organizar correctamente todos los datos e informacin que aparecen en las aplicaciones
disponemos de dos mtodos, bien trabajar con dos o ms ventanas o bien utilizar alguno de los
componentes de agrupamiento disponibles. El componente Panel es el ms sencillo y comn de los
componentes de agrupamiento y se utiliza para poner un panel, cuadro o marco dentro de una ventana.
El componente Panel puede contener toda una serie lgica de otros componentes. Tan solo se debe
recordar que primero debemos colocar todos los paneles en el formulario y encima de ellos los
componentes que contendrn.
47
Componentes
Panel
Este componente tambin tiene una serie de propiedades que le dan una mejor presentacin usando
las propiedades BevelInner, BevelOuter, BevelWidth, y BorderWidth.
Es decir, podemos dividir una ventana en varias partes, por ejemplo en un panel se ponen los
componentes donde se capturan los datos de un problema y en otro panel se ponen los datos de
salida.
Para modificar programas construidos sin paneles, el procedimiento para agregarlos es:
0. Mover todos los componentes a alguna parte de la ventana en la que no molesten. Si es necesario
se ampla la ventana.
1. Colocar los componentes panel en su posicin.
2. Seleccionamos con un clic el Componente a relocalizar.
3. Seleccionamos del men Edit la entrada Copy o mejor Cut (CTRL+C o CRTL+X)
4. Clic dentro del panel, donde queremos el componente.
5. Seleccionamos del men Edit la entrada Paste (CTRL+V).
6. Readaptamos la ventana al tamao adecuado.
GroupBox
Este componente es muy similar al componente panel, excepto que incluye una pestaa que permite
dejar mas claro el propsito del grupo. El texto que identifica el propsito general del grupo se escribe
dentro de la propiedad Caption en el Inspector de Objetos, teniendo seleccionado este componente
GroupBox.
Adems de sus propiedades, mtodos y eventos propios, como todos los componentes de este tipo,
hereda las propiedades, mtodos y eventos de todos los controles generales de tipo Windows.
Ejemplo 103.- Componentes de agrupamiento
Vamos a reconstruir el ejemplo de clculo del rea de un tringulo utilizando un componente
panel y un groupbox.
48
Componentes
Mltiples ventanas
Un problema muy comn en programacin visual es el de poder crear, controlar y administrar dos o
ms formularios o ventanas desde una misma aplicacin o proyecto.
Lo primero que hay que entender para poder resolver este problema es que en C++Builder, cada
formulario o ventana tiene asociados ciertos recursos especiales, ademas de los componentes que
contiene relacionados todos ellos en un archivo, que por defecto, toma el nombre de Unit1.cpp. Es
decir, si se crea un segundo formulario o ventana, dicho formulario, junto con sus recursos,
componentes, etc., se encontrara contenido en el archivo llamado "Unit2.cpp" y as sucesivamente.
Para crear un segundo formulario (Form2), se puede usar el icono de New Form de la barra de
herramientas, o bien la entrada New Form del men File.
El segundo formulario se construye normalmente, pero queda el problema de donde situar el botn de
ordenes, y la respuesta es que se pone en el primer formulario o ventana principal del programa. El
proceso en este botn es similar al de los programas anteriores, es decir primero se capturan los datos
(pantalla o ventana de captura), luego se resuelve las operaciones y finalmente se traspasan los datos
a los componentes de la segunda ventana. Para poder realizar este proceso la sintaxis general es
ahora:
Nombre_formulario -> Nombre_componente -> Nombre_propiedad
Los siguientes ejemplos aclararn estos conceptos:
Form5->Edit3->Text=Form1->Edit2->Text; //1
int alfa = Form3->Edit4->Text.ToInt(); //2
// 1. El contenido de la propiedad Text del Edit2 de Form1 se pasa a la propiedad Text del Edit3 del Form5.
// 2. La variable tipo int alfa toma como valor el contenido, convertido a tipo int, del Edit4 del formulario Form3.
Observamos que procesar elementos de distintas ventanas, es, inicialmente, sencillo, pero adems
existen ciertas condiciones que debern cuidarse para que estos procesos funcionen, y estas
condiciones son:
49
Componentes
Mltiples ventanas
0. Crear y disear todas las ventanas junto con sus componentes y programas.
1. Cualquier ventana que mencione o contenga una referencia dentro de su cdigo a otra ventana,
deber incluir en su Unit respectiva, la unidad (Unit) de la otra forma o ventana.
2. Para incluir la unidad (Unit) de la otra ventana debemos tener seleccionada la ventana que llama y
usar la orden Include Unit del men File, que mostrar una lista con todas las unidades (Unit) que se
han diseado, y debemos seleccionar la apropiada que se incluir automticamente en la ventana
actual.
3. Si una ventana referencia dos o ms ventanas diferentes debemos usar la orden File/Include Unit,
tantas veces como sea necesario.
Este procedimiento permite construir programas con dos o ms ventanas, pero el problema es que
todas ellas estarn a la vista del usuario, para resolver este problema, el procedimiento ms sencillo es
poner en False la propiedad visible de la ventana que se quiera tener oculta y poner cualquiera de las
siguientes instrucciones en el cdigo del programa para que aparezcan o desaparezcan a voluntad:
Form2->Visible = true;
Form2->Show(); // similar a la anterior, pero mas corta
Form2->ShowModal(); // no permite acceder a la primera ventana hasta que se cierra la segunda ventana
Si tenemos formularios de mas, o que ya no se quieren usar, o que estn mal construidas se pueden
quitar del proyecto usando el icono Remove File from Project de la barra de herramientas, y
seleccionando la unidad que contiene el formulario a eliminar.
Ejemplo 104.- Mltiples ventanas
Vamos a realizar una aplicacin que contenga en la ventana principal los siguientes
componentes: BitBtn, SpeedButton, MaskEdit y ComboBox. Respondiendo a distintos eventos se
deben mostrar ventanas para cada componentes bien con Show o bien con ShowModal que expliquen
de forma visible la principal utilidad de cada componente y sus principales propiedades.
50
Asignacin de memoria
En tiempo de ejecucin de un programa toda la informacin que necesite manipular deber estar, en un
momento u otro, en la memoria RAM del ordenador. Sabemos que la memoria se divide en celdas de 8
bits (1 byte) y que a cada una de las cuales le corresponde una direccin.
Ejemplo 105.- Direcciones de memoria.
Realizar una serie de declaraciones de variables y punteros para posteriormente mostrar el valor
de dichas variables y su correspondiente direccin de memoria utilizando para ello componentes
Label.
Tiempo de ejecucin
Tiempo de diseo
51
Operadores new y delete
Inicialmente, un puntero no apunta a ningn sitio y, para poder usarlo, tendremos que asignarle un
bloque de memoria y obtener su direccin. La cantidad de memoria asignada puede determinarlo el
tipo propio del puntero, que se indica detrs de new, encargndose este de localizar un bloque de
memoria adecuado en tamao, reservarlo para el programa, almacenar la direccin del puntero y
permitirnos el acceso al valor apuntado por l.
A diferencia de la asignacin de memoria esttica, la memoria asignada por new est libre al comienzo
del programa reservndose solamente cuando se llama a este operador. Cuando la memoria asignada
con new no nos sea til tendremos que liberarla, ya que a diferencia de lo que ocurre con una variable,
la liberacin no es automtica. Para liberar la memoria se emplea el operador delete, al que pasaremos
como parmetro el puntero que contiene la direccin de memoria del bloque a liberar y que es
habitualmente el mismo que el de new. Un cdigo cmo el siguiente origina el resultado que vemos.
{
int *Pnumero;
Pnumero = new int;
Edit1->Text= AnsiString(*Pnumero);
*Pnumero = 125;
Edit2->Text = AnsiString(*Pnumero);
delete Pnumero;
}
Cuando asignamos memoria con el operador new es posible especificar un valor inicial dndolo entre
parntesis detrs del tipo, por ejemplo Pnumero = new int(125) asigna memoria e inicializa.
A veces es necesario asignar memoria no solamente para un nmero o un carcter, lo que podemos
hacer es especificar el tamao en el tipo de puntero. Supongamos por ejemplo que queremos reservar
memoria para almacenar 25000 enteros. Es evidente que no vamos a crear 25000 identificadores,
aunque si podramos tener como recurso crear una matriz con 25000 elementos.
52
Operadores new y delete
La solucin de la matriz solamente es valida si se conoce de antemano el nmero exacto de elementos,
porque si dicho nmero se determina externamente, ser difcil crear una matriz del tamao adecuado
sin que resulte, a veces pequea, o a veces grande, desperdiciando memoria.
Para este tipo de casos es posible asignar un bloque de memoria del tamao que nosotros deseemos
mediante los operadores new y delete, indicando dicho tamao entre corchetes. Al utilizar delete
dispondremos detrs del operador unos corchetes vacos, indicando que lo que se libera es una matriz.
Ejemplo 106.- Punteros y matrices
Ejemplo en el que empleamos la asignacin de memoria dinmica mediante matrices,
inicializamos los elementos y mostramos resultados tanto de direcciones de memoria como del
contenido de las mismas. Diseamos un formulario con un aspecto como el de la figura:
53
Ejemplo 106.- Punteros y matrices
El cdigo es:
{
int *PunteroNumero; //Puntero a entero
PunteroNumero = new int[5]; //Asignamos memoria para 5 int
//Inicializamos los 5 elementos
PunteroNumero[0] = 100;
//Mostramos en los Edit el contenido y la direccin de memoria
Edit1->Text = AnsiString(PunteroNumero[0]);
Edit6->Text = AnsiString((unsigned int) &PunteroNumero[0]);
delete [] PunteroNumero; //Liberamos la memoria asignada
}
54
Componentes
Ejemplo 107.- Sentencias if anidadas, Cul es el menor de tres nmeros? Con componentes
Sobre un formulario vamos a situar dos componentes GroupBox de la pestaa Standard, a uno de
ellos le vamos a llamar Entrada de datos y al otro El menor es. Sobre el primero situamos tres
componentes Label y tres Edit (cambiando la propiedad name como A, B y C respectivamente), y sobre
el segundo un componente Edit con la propiedad name establecida a Menor, adems de un BitBtn en el
que seleccionamos bkOK para la propiedad Kind. El aspecto inicial del proyecto lo vemos en la figura
siguiente:
void __fastcall TForm1::BitBtn1Click(TObject *Sender)
{
float datoA, datoB, datoC, Resultado;
datoA = StrToFloat(A->Text);
datoB = StrToFloat(B->Text);
datoC = StrToFloat(C->Text);
if (datoA < datoB)
if (datoA < datoC)
Resultado = datoA;
else
Resultado = datoC;
else
if (datoB < datoC)
Resultado = datoB;
else
Resultado = datoC;
Menor->Text = FloatToStr(Resultado);
}
55
Componentes
CheckBox
Este componente permite al usuario seleccionar una opcin o tomar una decisin directamente en
pantalla, es decir en tiempo de ejecucin. Es en la propiedad Text del componente donde se debe
escribir el sentido que queremos dar a la seleccin.
Ejemplo 108.- Decisiones con CheckBox y componente SpeedButton
Vamos a crear un nuevo proyecto y sobre el formulario principal situamos cuatro componentes
SpeedButton (pestaa Additional) y cuatro componentes CheckBox (pestaa Standard). Distribuimos y
modificamos la propiedad Caption de forma que quede algo similar a la figura siguiente. Hacemos
doble clic sobre cada uno de los botones e incluimos el siguiente cdigo:
SpeedButton1
CheckBox1->Checked=true;
CheckBox2->Checked=false;
SpeedButton2
SpeedButton3
SpeedButton4
Hemos utilizado la propiedad booleana Checked de los componentes CheckBox para hacer que trabaje
con una sola seleccin.
Naturalmente los CheckBox pueden seleccionarse todos, aunque en el programa del ejemplo no
parezca lo ms apropiado.
56
Componentes
RadioButton y RadioGroup
El componente RadioButton se utiliza para presentar al usuario un conjunto de opciones mutuamente
excluyentes entre si, es decir si el usuario selecciona un componente RadioButton todos los dems
componentes RadioButton en el formulario, se desmarcan o deseleccionan solos.
En la propiedad Caption se pone el texto que identifica el propsito del botn y su propiedad Checked
refleja el cambio (True o False). Tambin su evento onclick se activa automticamente cada vez que el
usuario selecciona el RadioButton.
La situacin de que sean excluyentes entre si deber resolverse por parte del programador, es decir si
se supone un programa donde el usuario debe seleccionar uno de entre dos sexos y uno de entre
cinco municipios, en este caso se ocupan ocho RadioButton, pero como todos son mutuamente
excluyentes entre si, cuando el usuario seleccione uno de ellos, todos los dems se desmarcaran
automticamente. Para resolver este problema se debern usar componentes de agrupamiento, como
son el componente Panel y el componente GroupBox. Es decir se debern encerrar en su propio panel
o GroupBox todos los RadioButton lgicos, es decir en un Panel los de sexo, en otro Panel los de
municipios, etc. De esta manera C++Builder los evala por separado y se puede tener seleccionado un
RadioButton en cada Panel. En la figura vemos un ejemplo de lo dicho:
57
Componentes
El componente RadioGroup es un componente especializado en la agrupacin de RadioButton. Un
componente u objeto RadioGroup es una caja especial que solo contiene componentes RadioButton,
tambin cuando el usuario marca o selecciona uno de ellos, todos los dems se desmarcan o
deseleccionan.
Para aadir los RadioButton al componente RadioGroup debemos editar la propiedad Items en el
Inspector de Objetos, que nos muestra el minieditor de strings. Debemos recordar que cada lnea en el
editor corresponder a un RadioButton dentro del RadioGroup.
Para procesar o programar un determinado RadioButton usareremos la propiedad ItemIndex que queda
cargada con el numero de RadioButton seleccionado por el usuario. Por ejemplo:
if(Form1->RadioGroup1->ItemIndex==4)
{
cdigo a ejecutar si el usuario selecciona
el RadioButton4 del RadioGroup1
};
Tambin se pueden desplegar los botones en una o ms columnas, usando la propiedad Columns en el
Inspector de Objetos, para indicarle cuantas columnas de RadioButton se quieren manejar.
El ejemplo anterior resuelto con este componente podra tener un aspecto como el siguiente:
58
Componentes
ListBox
Componente que permite procesar un conjunto de elementos de tipo string. Se puede aadir, eliminar e
insertar tems en la lista usando los mtodos Add, Delete e Insert respectivamente de la propiedad
Items. La propiedad Columns permite que ListBox tenga varias columnas y los items se pueden
clasificar u ordenar usando la propiedad Sorted. Las propiedades MultiSelect y ExtendedSelect
permiten al usuario hacer selecciones mltiples. Para determinar que tem en particular esta
seleccionado debemos validar la propiedad Selected y para conocer cuantos tems se han
seleccionado consultar los valores de la propiedad SelCount. La propiedad ItemIndex se utiliza para
seleccionar la posicin o ndice de un tem o elemento en la lista. La propiedad Style establece los
estilos de ListBox, que son: lbStandard; LbOwnerDrawFixed; LbOwnerDrawVariable; LbVirtual y
LbVirtualOwnerDraw.
Ejemplo 109.- Nmeros, su cuadrado y su raz cuadrada.
Vamos
a
desplegar
los
nmeros
enteros
comprendidos entre 15 y 25, su cuadrado y su raz
cuadrada utilizando componentes ListBox y su
mtodo Add de la propiedad Items. Para este
problema situaremos sobre el formulario principal
Form1, tres componentes label con su font
seleccionado en color rojo, tres componentes ListBox
y un componente Button que en su evento OnClick
contendr los bucles o ciclos for y la carga de los
componentes ListBox.
59
Componentes
Ejemplo 110.- Tablas de multiplicar.
Vamos a implementar un programa que muestre las tablas de multiplicar hasta el 15 de la forma
en que estamos acostumbrados a verlas. Para ello vamos a emplear dos componentes ya conocidos, el
componente RadioGroup y el componente ListBox. Emplearemos el mtodo Add(valor) en la propiedad
Items de ListBox para cargar todos sus elementos o valores en tiempo de ejecucin del programa y la
propiedad ItemIndex del componente RadioGroup; con cdigo asociado al evento OnClick del
elemento RadioGroup y sentencias condicionales y bucles.
Para este problema situaremos sobre el formulario principal Form1 los elementos necesarios para que
el aspecto inicial del formulario en tiempo de diseo es el siguiente:
El cdigo del programa adecuando el resto de ItemIndex podra ser el
siguiente:
void __fastcall TForm1::RadioGroup1Click(TObject *Sender)
{
int x;
if(Form1->RadioGroup1->ItemIndex==0)
{
ListBox1->Items->Clear();
for (x=0 ; x<=15 ; x++)
{ListBox1->Items->Add(AnsiString("1 x ")+(x)+AnsiString(" = ")+(1*x));};
};
...
Sentencias similares para resto de ItemIndex
...
}
60
Componentes
Ejemplo 110.- Tablas de multiplicar.
El programa en ejecucin es:
Ejemplo 111.- Ms tablas de multiplicar.

Vamos a mejorar el ejemplo anterior permitiendo al usuario entrar el nmero del que desea
obtener la tabla y el nmero de items que quiere obtener de la misma. Para ello vamos a emplear el
componente ListBox y el mtodo Add(valor) en la propiedad Items de ListBox para cargar todos sus
elementos o valores en tiempo de ejecucin del programa.
Para esto situaremos sobre el formulario principal Form1 los elementos necesarios para que el
aspecto inicial del formulario en tiempo de diseo sea similar al siguiente:
61
Componentes
Observese el cambio de nombre y de icono en el

formulario.
A continuacin vemos el cdigo completo del
programa ya comentado.
{
/* Declaramos e inicializamos las variables enteras x, y, z
x ser el nmero del que queremos obtener la tabla
asociado a Edit1 z ser el nmero de items que queramos
obtener asociado a Edit2 y ser la variable empleada en
el bucle */
int x=0, y=0, z=0;
/* Borramos el contenido de ListBox para cada ejecucin
y Cambiamos el contenido de los Edit a entero y
asignamos su valor a la variable correspondiente*/
x = StrToInt(Edit1->Text);
z = StrToInt(Edit2->Text);
// Ejecutamos el bucle hasta alcanzar el nmero de items indicado por z

while(y<=z)
{
// Aadimos contenido a ListBox
{ListBox1->Items->Add(AnsiString(" ")+ (x)+AnsiString(" x ")+(y)+AnsiString(" = ")+(x*y));};
y++;
};
}
62
Componentes
{
/* Asociado al evento OnCreate del Form borramos el contenido de los Edit*/
Edit1->Text="";
Edit2->Text="";
}
//--------------------------------------------------------------------------void __fastcall TForm1::Edit1MouseMove(TObject *Sender, TShiftState Shift,
int X, int Y)
{
/* Establecemos el foco en Edit1 asociado al evento OnMouseMove */
Edit1->SetFocus();
}
//---------------------------------------------------------------------------
63
Componentes
Trabajo con componentes Edit, Buttom y Label
Edit
La principal finalidad de un Edit es permitir la entrada de un texto por parte del usuario que se almacena
en su propiedad Text, a la que podemos dar un valor inicial en tiempo de diseo. Este componente no
cuenta con la propiedad Caption, por lo que se suele disponer una etiqueta de texto adjunta que sirve
como ttulo.
Existe un componente en la pestaa Additional que se compone de un Label y de un Edit, el LabeledEdit,
que resulta sencillo de manejar cuando se conocen los dos componentes de forma individual.
Cuando en tiempo de ejecucin el usuario modifica el contenido de un Edit, su propiedad Modified se
establece como true. Nosotros podemos, mediante cdigo, comprobar el valor de esta propiedad y, en
caso de que proceda, recuperar la entrada realizada por el usuario leyendo la propiedad Text.
Longitud del Texto
Por defecto el control Edit no pone ningn lmite a la cantidad de texto que el usuario puede introducir y,
en caso de que sea necesario, desplazar el contenido actual a medida que se introducen nuevos
caracteres. Si es necesario, podemos limitar el nmero de caracteres que es posible introducir mediante
la propiedad MaxLength. El valor 0 indica que no hay un lmite establecido y cualquier otro nmero entero
fija la longitud mxima de la propiedad Text.
Seleccin de texto
Mientras se edita el contenido de un control Edit, el usuario puede marcar una porcin del texto, mediante
la combinacin de la tecla Shitf y los cursores o bien con el ratn, con el fin de realizar alguna operacin
que le afecte, como puede ser eliminarlo o copiarlo al portapapeles.
En cualquier momento podemos saber qu texto es el que hay seleccionado en el control, para lo que
disponemos de las propiedades SelStart, SelLength y SelText. La primera contiene el carcter a partir del
cual se ha seleccionado, sabiendo que el primero de los existentes es el carcter 0. La segunda propiedad
contiene el nmero de caracteres que hay marcados y la tercera contiene el texto.
El valor de estas propiedades tambin puede ser establecido por el cdigo de nuestro programa,
seleccionando automticamente el texto que nos interese. Si deseamos marcar todo el texto contenido en
el control podemos realizar una simple llamada al mtodo SelectAll().
64
Componentes

Las operaciones de copiar, cortar y pegar con el portapapeles (clipboard), pueden ser tambin
realizadas mediante cdigo usando los mtodos adecuados.
Mtodo ClearSelection() elimina el texto que hay seleccionado.
Mtodo CopyToClipboard() copia el texto al portapapeles.
Mtodo CutToClipboard() copia el texto al portapapeles y lo elimina del campo de edicin.
PasteFromClipboard() permite recuperar el texto que hay en el portapapeles insertndolo en Edit en la
posicin actual del cursor.
Texto de slo lectura y oculto
Si lo que queremos es solamente mostrar un valor en un componente Edit e impedir que el usuario
pueda modificarlo basta con establecer la propiedad ReadOnly a true. Si lo que queremos es que al
solicitar cualquier tipo de dato ste no sea visible por terceras personas (caso tpico de las
contraseas o password) podemos conseguirlo con la propiedad PasswordChar haciendo que el Edit
vaya representando cada uno de los caracteres introducidos mediante un cierto smbolo, como puede
ser un asterisco o el carcter que asignemos a la propiedad.
Controles de entrada
Hay ocasiones en las que es necesario garantizar que todas las letras sean facilitadas en maysculas o
en minsculas con el fin de evitar posteriores fallos de comparacin. Mediante la propiedad CharCase
podemos forzar estas situaciones asignndole los valores ecNormal, ecUpperCase o ecLowerCase.
Buttom
Para dotar a un botn de una tecla de acceso rpido utilizable con la tecla Alt (Alternate) basta con
anteponer el carcter & a la letra que queremos que lo active, que aparecer subrayada.
Es normal que en un formulario existan varios botones pudiendo dos de ellos ser activados pulsando la
tecla Enter o la tecla Esc. Si la propiedad Default tiene el valor true el botn actuar como botn por
defecto, es decir, que se activar cuando se pulse la tecla Enter. Si Cancel est a true, el botn ser el
botn de cancelacin o tecla Esc.
Podemos pulsar el botn utilizando el cursor del ratn, la tecla de acceso rpido, desplazndonos hasta l
con la tecla Tab y pulsando la barra espaciadora, con la tecla Enter si es el botn por defecto, o con la
tecla Esc si es el botn de cancelacin.
65
Componentes

Label
Una etiqueta Label es un componente que presenta un texto en el formulario (propiedad Caption) pero
que no puede tomar el foco de entrada ni podemos acceder a l con la tecla Tab. Slo recibe eventos de
ratn.
Propiedad
AutoSize
Alignment
Uso
Valores
El tamao de la etiqueta se ajusta automticamente al contenido de sta o no.
true o false
Alineacin del texto
Izquierda: taLeftJustify
Derecha: taRightJustify
Centro: taCenter
Tiene sentido cuando la etiqueta se usa como ttulo de otro control. Sirve para
Nombre del control que
FocusControl que la etiqueta de texto sepa a qu control debe pasar el foco de entrada cuando
recibe el foco.
se pulse la tecla de acceso rpido (&).
Ejemplo 112.- Componentes Edit, Buttom y Label

Resolveremos el ejemplo paso a paso
Por un lado vamos a colocar sobre un Form con Caption = Trabajo con componentes Edit, Buttom
y Label un componente Panel del que eliminamos el Caption y establecemos propiedad Color en
clAqua y Width = 480.
Insertamos en el Panel una etiqueta estableciendo a false la propiedad AutoSize y
redimensionamos su tamao de forma que ocupe prcticamente todo el ancho del panel. Asignamos a
la etiqueta el Color clYellow y comprobamos que la propiedad Alignment tiene el valor taLeftJustify. El
valor de Caption va a ser Esto es una etiqueta.
Insertar en panel tres botones de la forma siguiente:
Buttom1: Caption = Izquierda Buttom2 : Caption = Centro y Buttom3: Caption = Derecha
Establecemos a true propiedad Default de Buttom1 (Izquierda) y a la propiedad Cancel de Buttom3
(Derecha).
Generamos el evento OnClick de Buttom1 y asignamos, mediante cdigo, el valor taLeftJustify a la
propiedad Alignment de la etiqueta. Repetimos para los otros botones asignando los valores taCenter y
taRightJustify.
66
Componentes

Modificar lo necesario para permitir el acceso mediante teclas rpidas a cada uno de los botones
y establecer el color de fondo de la etiqueta al que actualmente tenga el panel cuando el ratn est
situado sobre la misma.
Insertamos en el formulario tres Edit, que estarn encabezados por tres Label y tres botones para
que tenga el aspecto siguiente:
El primer Edit, que recibir el foco desde su etiqueta (propiedad FocusControl) lo utilizaremos
para comprobar el funcionamiento de las propiedades MaxLength, a la que asignaremos el valor 10, y
PasswordChar, a la que asignaremos el valor *.
El segundo Edit, que recibir el foco desde su Label lo usaremos para ver cmo podemos
controlar la entrada de caracteres, permitiendo tan slo la introduccin de dgitos numricos. Para ello
vamos a generar el siguiente gestor de eventos OnKeyPress.
67
Componentes
void __fastcall TForm1::Edit2KeyPress(TObject *Sender, char &Key)
{
if ((Key < '0' || Key > '9') && Key != 8) Key=0;
/* Se comprueba que el carcter sea un dgito o la tecla de borrado.
Los caracteres se encierran entre comillas simples porque estamos comparando un carcter tipo char.
Asignar a Key el valor 0 es anular la pulsacin. */
}
El ltimo Edit (recibe el foco de su Label) lo vamos a usar para probar los mtodos de copiar,
borrar y pegar el texto seleccionado. Ser al pulsar cualquiera de los tres botones que hemos
dispuesto debajo cuando se realice la accin de copiado, borrado o pegado, gracias al cdigo que
asociaremos al evento OnClick de cada uno de los botones de la forma que se muestra a continuacin.
{
Edit3->SelectAll();
Edit3->CopyToClipboard();
Edit3->SetFocus();
}
{
Edit3->ClearSelection();
Edit3->SetFocus();
}
{
Edit3->PasteFromClipboard();
Edit3->SetFocus();
}
68
Componentes
Tipos de propiedades
Las
propiedades
de
los
componentes de la VCL tienen
asignado un tipo de dato que
determina los valores que esta
puede tomar. Hay propiedades
de tipo bool (Visible), otras de
tipo string (Caption) y otras de
tipo enumerado (BorderIcons)
que solamente pueden tomar
valores de una lista prefijada.
A continuacin vemos lo que
muestra
la
ayuda
de
BorderIcons.
Indica que la propiedad
BorderIcons de un formulario
es del tipo TborderIcon es de
tipo enumerado, y que, por
tanto, slo puede tomar los
valores preestablecidos.
69
Componentes
Tipos de propiedades
Ejemplo 113.- Propiedad BorderIcons
Realizar una aplicacin para trabajar con esta propiedad en
tiempo de ejecucin.
Partimos de un diseo similar al siguiente, en el que al botn Salir le
hemos establecido su propiedad Visible a false.
Asociamos a los botones de minimizar el cdigo siguiente.

Para botn Desactivar
{
TBorderIcons VarBorderIcon = BorderIcons;
VarBorderIcon >> biMinimize;
BorderIcons = VarBorderIcon;
}
Para botn Activar
{
TBorderIcons VarBorderIcon = BorderIcons;
VarBorderIcon << biMinimize;
BorderIcons = VarBorderIcon;
}
El resto de botones es similar trabajando con el valor enumerado correspondiente.
70
Componentes
Trabajo con componentes Memo, CheckBox, RadioButton y RadioGroup
Memo
Ya hemos visto el uso del componente Edit para solicitar al usuario alguna entrada, pero esta no puede
tener mas que una lnea. Cuando necesitemos una entrada de texto que ocupe varias lneas podemos
usar un componente Memo que posee muchas propiedades de las vistas para el Edit (ReadOnly,
MaxLength, Text, ...), as como con los mtodos relacionados con las operaciones del portapapeles.
Un Memo puede tener barras de desplazamiento o ScrollBars, permitiendo trabajar con lneas ms
largas que el espacio horizontal disponible y con ms lneas de las que es posible mostrar de forma
simultnea. La propiedad de tipo enumerado TScrollBars permite el uso de estas barras de
desplazamiento. Esta propiedad puede tomar los valores:
0 ssNone
//Ninguna
1 ssVertical
//Slo la vertical
2 ssHorizontal //Slo la horizontal
3 ssBoth
//Las dos
El texto que contiene un Memo es accesible mediante la propiedad Text, al igual que en un Edit. Pero
resulta ms til y conveniente acceder a ese texto lnea a lnea, para lo que el componente dispone de
la propiedad Lines que es de tipo Strings.
Sus dos mtodos ms interesantes tienen relacin con guardar o recuperar el texto en un archivo en
disco y son SaveToFile() y LoadFromFile(), que tienen como nico parmetro el nombre del fichero
donde se va a guardar o del que se va a recuperar la informacin del Memo.
Otra propiedad muy interesante es Count con la que podemos averiguar en cada momento cuntas
lneas tiene simplemente haciendo: Memo1->Lines->Count.
Un componente Memo tiene la posibilidad de trabajar con las teclas Enter y Tab como parte de la
edicin del texto siempre que l est activo. Pero, por defecto, estas teclas tienen su funcin propia en
un formulario. Para que al pulsar la tecla Enter el componente Memo la reconozca como salto de lnea y
no como activacin de, por ejemplo, el botn por defecto, debemos asignar el valor true a la propiedad
WantReturns. Lo mismo ocurre con la propiedad WantTabs, que si est activada permitir insertar
tabulaciones en el texto en lugar de pasar el foco de entrada al siguiente componente del formulario.
71
Componentes
CheckBox
Este componente permite mostrar y seleccionar informacin de tipo bool, representndose los dos
estados posibles visualmente mediante una casilla, que puede contener o no en su interior una marca.
La propiedad Checked nos permite saber el estado actual del componente y, como no, modificarlo;
estando a true cuando est marcado y a false en caso contrario.
Podemos poner todos los componentes CheckBox que necesitemos en un formulario, no afecto el
hecho de que alguno de ellos est activo al resto, es decir no son opciones excluyente entre s. Para
que varias opciones sean excluyentes se usan componentes RadioButton.
Lo ms comn es agrupar los componentes CheckBox en un contenedor denominado GroupBox que
tiene la posibilidad de asignar un ttulo comn a los componentes CheckBox que lo componen.
El componente RadioButton tambin cuenta con una propiedad Checked en la que se almacena su
estado. Si tenemos que usar varios RadioButton en un formulario y que se destinen a solicitar datos
diferentes que tengan, a su vez, opciones exclusivas entre s, debemos usar componentes RadioGroup.
Para establecer las opciones de un RadioGroup tendremos que editar el contenido de la propiedad
Items, que es de tipo Strings. En modo diseo haremos doble clic sobre la propiedad Items para abrir el
editor especfico, aadiendo los ttulos de las opciones que deseemos mostrar. En tiempo de ejecucin
podremos usar los mtodos Add(), Append(), Insert() y Clear() para aadir o eliminar elementos. Los
elementos RadioButton existentes en un RadioGroup se numeran con un ndice que comienza en 0.
Este ndice nos servir para saber qu opcin es la que est activa o bien para establecerla, mediante
la propiedad ItemIndex. De esta forma no es necesario comprobar la propiedad Checked de cada uno
de los RadioButton que aparece en el RadioGroup.
72
Componentes
Ejemplo 114.- Trabajo con componentes Memo, CheckBox, RadioButton y RadioGroup
Vamos a realizar una aplicacin para mostrar el uso de estos componentes, sus propiedades y
los mtodos descritos en este apartado.
Comenzamos una nueva aplicacin e incluimos en el Form los siguientes componentes: Tres Label, un
Memo, un GroupBox, dos CheckBox dentro de un GroupBox, un RadioGroup y dos Button, de forma
que inicialmente tengamos un aspecto como el que vemos a continuacin:
Continuamos dando los pasos necesarios para conseguir como cdigo fuente del Unit asociado al
Form el que vemos seguidamente:
73
Componentes
74
Componentes
75
Componentes
76
Componentes
Trabajo con ListBox

Se trata de un componente que nos permite mostrar listas de elementos de las que es posible
seleccionar uno o varios. Tiene un funcionamiento parecido al del RadioGroup, aunque visualmente su
aspecto es diferente. Los elementos del ListBox estn contenidos en la propiedad Items, que, como
sabemos, es un objeto de tipo Strings. En tiempo de diseo podemos usar el editor de cdigo asociado
para incluir los elementos que queramos en la lista simplemente haciendo doble clic sobre la propiedad
Items. En cambio, en tiempo de ejecucin, podemos usar los mtodos siguientes:
Mtodo
Descripcin
Add()
Una cadena de texto es el parmetro que la aade como un nuevo elemento al final de la lista, salvo que
la propiedad Sorted del ListBox est a true, en cuyo caso se insertar en la posicin que le corresponda.
Insert()
Toma dos parmetros, de los que el primero es la posicin en la que se desea insertar el elemento y el
segundo el texto a aadir.
Delete()
Mtodo que nos permite eliminar el elemento de la lista del que facilitamos su ndice.
Clear()
Elimina todas las cadenas existentes sin necesidad de suministrarle parmetros.
IndexOf()
Move()
Devuelve el ndice de la cadena dada como parmetro. Si retorna -1 la cadena no se encuentra.

Damos el ndice en que se encuentra actualmente y el ndice correspondiente al punto al que se desea
mover.
Exchange()
Similar a Move() lo que hace es intercambiar las posiciones de los elementos correspondientes.
SaveToFile()
Guarda el contenido en un archivo en disco, debiendo facilitar el nombre.
LoadFromFile() Recupera la lista de elementos de un archivo cuyo nombre se facilita como parmetro.
La propiedad ItemIndex del ListBox indica en cada momento qu elemento hay seleccionado. Un valor 1 indica que no hay ninguno seleccionado. Cuando contiene ms elementos de los que puede mostrar
de forma simultnea aparece una barra de desplazamiento vertical.
77
Componentes
Trabajo con ListBox

Ejemplo 115.- Trabajo con ListBox
Realizar un programa que nos permitir aadir elementos a un ListBox en tiempo de ejecucin
con el texto que se facilite en un Edit. Tambin se podr aadir antes y despus de la seleccin,
eliminar el elemento seleccionado o eliminar todos los elementos del ListBox. Mediante un
componente CheckBox habilitaremos la ordenacin de los elementos.
Comenzamos por disear un formulario como el siguiente:
Al botn Aadir le establecemos la propiedad Default a true para permitir la insercin mediante la tecla
Enter del texto introducido en el Edit y al botn Borrar le establecemos la propiedad Enabled a false
para que este no est activo si no tenemos ningn elemento seleccionado.
El resto del proceso es ir creando los gestores de eventos que vemos seguidamente con el cdigo que
debemos insertar en los mismos.
78
Componentes
Trabajo con ListBox

{
ListBox1->Items->Add(Edit1->Text);
Edit1->SelectAll(); // Selecciona el contenido del Edit
}
//--------------------------------------------------------------------------void __fastcall TForm1::ListBox1Click(TObject *Sender)
{
/* Activacin o desactivacin del botn borrar segn haya o no
seleccionado algn elemento del ListBox */
Button6->Enabled=ListBox1->ItemIndex != -1;
}
//--------------------------------------------------------------------------void __fastcall TForm1::Button6Click(TObject *Sender)
{
// Eliminamos el texto seleccionado
ListBox1->Items->Delete(ListBox1->ItemIndex);
// Desactivamos el botn de Eliminar
Button6->Enabled=false;
}
{
// Borramos todo
}
79
Componentes
Trabajo con ListBox

void __fastcall TForm1::CheckBox1Click(TObject *Sender)
{
// Activamos o desactivamos la ordenacin
ListBox1->Sorted=CheckBox1->Checked;
}
{
// Insertamos delante del elemento seleccionado
ListBox1->Items->Insert(ListBox1->ItemIndex,Edit1->Text);
}
{
// Insertamos detrs del elemento seleccionado
ListBox1->Items->Insert(ListBox1->ItemIndex+1,Edit1->Text);
}
{
// Movemos arriba la seleccin
if (ListBox1->ItemIndex != -1)
ListBox1->Items->Move(ListBox1->ItemIndex,ListBox1->ItemIndex-1);
else
ShowMessage("No hay nada seleccionado");
}
80
Componentes
Trabajo con ListBox

{
// Cambiamos la seleccin con el primer elemento de la lista
if (ListBox1->ItemIndex != -1)
ListBox1->Items->Exchange(ListBox1->ItemIndex,0);
else
ShowMessage("No hay nada seleccionado");
}
Trabajo con ComboBox o listas combinadas
En el apartado anterior hemos usado un ListBox para guardar una lista de elementos procedentes de
un Edit. El componente ComboBox es la unin de un Edit y un ListBox incorporando las funciones de
ambos componentes y, por tanto, las propiedades Text, MaxLenggth, Items, ItemIndex, etc. El
funcionamiento y aspecto de un ComboBox dependen de su propiedad Style que es de tipo
TComboBoxStyle, pudiendo tomar, entre otros, los valores siguientes:
Valor
Descripcin
csDropDown
Se trata del estilo establecido por defecto y presenta un Edit en el que es posible introducir texto. El
botn del extremos derecho despliega una lista con los elementos que contiene.
csSimple
El ComboBox aparece como un Edit sin botn ni lista desplegable adjunta. Para recorrer los elementos
de sta debemos usar las teclas de cursor arriba y abajo.
csDropDownList
Con este valor se permite al usuario seleccionar uno de los valores de la lista pero no puede introducir
texto alguno.
Ejemplo 116.- Trabajo con ComboBox

Realizar un programa para controlar la propiedad Style de un ComboBox mediante las tres
opciones suministradas por un componente RadioGroup.
81
Componentes
Trabajo con ListBox

Antes de comenzar con el ejemplo vamos a describir el operador static_cast que se usa en las
propiedades tipo enumerado para referirse a los valores con su nombre mediante una conversin de la
posicin que ocupa el valor dentro de los posibles (comenzando por la posicin 0). EstSu sintaxis
bsica es:
static_cast <tipo_enumerado> (posicin del valor)
Diseamos un formulario similar al siguiente:
Situamos un ComboBox al que establecemos como valor csDropDown para la propiedad Style y
eliminamos el contenido de su propiedad Text.
Tambin situamos un RadioGroup con las tres opciones que vemos y que nos van a permitir cambiar el
estilo del ComboBox en tiempo de ejecucin.
Veamos en dos fases el cdigo necesario para nuestros propsitos:
Por un lado deberemos controlar cada pulsacin de tecla sobre el ComboBox, mediante el evento
OnKeyPress, para que en el momento en que se detecte la pulsacin de la tecla Enter se almacene el
texto en el ComboBox pero ignorando la pulsacin de dicha tecla. El cdigo que deberemos escribir es
el siguiente:
82
Componentes
Trabajo con ListBox

void __fastcall TForm1::ComboBox1KeyPress(TObject *Sender, char &Key)
{
if (Key == 13) // Tecla Enter
{
ComboBox1->Items->Add(ComboBox1->Text);
ComboBox1->SelectAll();
Key=0;
}
}
Por otro lado debemos hacer la propiedad ItemIndex=0 para el componente RadioGroup y controlar su
evento OnClick para establecer el estilo adecuado para el ComboBox segn la opcin que
seleccionemos. Esta asignacin se realizar de forma directa llevando a cabo una conversin de tipo
de la forma siguiente:
void __fastcall TForm1::RadioGroup1Click(TObject *Sender)
{
ComboBox1->Style= static_cast <TcomboBoxStyle> (RadioGroup1->ItemIndex);
}
Ejemplo 117.- Races con funciones
Vamos a establecer una funcin con asignacin de un valor por defecto a uno de sus parmetros
con el fin de que, por defecto, calcule la raz cuadrada del nmero especificado.
Recordemos que si en la declaracin de una funcin asignamos valores por defecto a los parmetros
no ser indispensable facilitar el valor en la llamada a la funcin en aquel o aquellos que hayamos
especificado por defecto. Para asignar un valor por defecto a un parmetro basta con utilizar el
operador de asignacin detrs del nombre del parmetro facilitando a continuacin el valor, todo ello
naturalmente en la cabecera de la funcin, entre los parntesis, y estando de acuerdo el valor con el
tipo especificado.
83
Componentes
Comenzamos por situar un formulario con las siguientes propiedades:
Height = 150 y Width = 350
Caption = Races
BorderIcon: biMinimize = false, biMaximize = false y biSystemMenu = false. Esto har que la
ventana no presente los iconos ni de maximizar, ni de minimizar ni de cerrar. Tampoco presentar el
icono ni el men contextual asociado.
BorderStyle = bsSingle. Har que se presente un borde de una lnea sencilla y el tamao de la
ventana no ser escalable.
Position = poScreenCenter. La ventana de la aplicacin aparecer centrada en la pantalla.
Sobre el formulario situamos:
Un componente ListBox con Height = 70 y Width = 330
Un botn con Caption = &Salir.
Ambos componentes los alineamos Center in windows.
El aspecto en tiempo de diseo ser:
84
Componentes
El cdigo completo del programa es:
#include <vcl.h>
#pragma hdrstop
#include <math.h> //Para usar pow()
#include "Codigo.h"
//--------------------------------------------------------------------------#pragma package(smart_init)
#pragma resource "*.dfm"
TForm1 *Form1;
//--------------------------------------------------------------------------__fastcall TForm1::TForm1(TComponent* Owner)
: TForm(Owner)
{
}
//--------------------------------------------------------------------------AnsiString AlmacenDatos; /*Declaracion global de un AnsiString para ir guardando los resultados obtenidos con
los datos que se pasen */
//--------------------------------------------------------------------------/* Declaramos la funcin Raiz con los parmetros:
Argumento de tipo __int64 para trabajo con nmeros grandes
Indice de tipo int con valor por defecto 2 */
void Raiz(__int64 Argumento, int Indice=2)
{
/* En Almacen de Datos vamos guardando las cadenas y los valores pasados o por defecto de los parmetros. El
clcula de la raiz lo realizamos con la funcin pow() */
85
Componentes
Ejemplo 117.- Raices con funciones
AlmacenDatos = "La raiz de Indice " + AnsiString(Indice) + " del nmero " + AnsiString(Argumento)+
" es: " + AnsiString(pow(Argumento,1.0/Indice));
}
//MOSTRMOS LOS RESULTADOS ASOCIADOS A: TForm1::FormCreate
{
Raiz(16); //Pasamos un parmetro (se calcula la raiz cuadrada)
ListBox1->Items->Add(AlmacenDatos); //Aadimos los resultados
Raiz(27,3); //Pasamos los dos argumentos (se calcula la raiz cbica)
Raiz(30517578125,5); //Pasamos los dos argumentos (se calcula la raiz quinta)
Raiz(999,15); //Pasamos los dos argumentos (se calcula la raiz 15)
Raiz(3); //Pasamos un parmetro (se calcula de nuevo la raiz cuadrada)
}
//--------------------------------------------------------------------------//NECESITAMOS UN BOTON PORQUE HEMOS DESABILITADO LOS ICONOS PARA CERRAR
{
Application->Terminate();
}
86
Componentes
Trabajo con FormStyle

Las opciones de FormStyle son: fsNormal, fsMDIChild, fsMDIForm y fsStayOnTop y se emplea si
queremos que en una aplicacin un formulario contenga a otros. Este tratamiento de formularios se
denomina Multiple Document Interface (Interface de Documento Mltiple) y hace muy fcil este tipo de
aplicaciones.
Valor
fsNormal
Significado
El formulario no es ni ventana MDI padre ni ventana MDI hijo.
fsMDIChild
El formulario es una ventana MDI hijo.
fsMDIForm
El formulario es una ventana MDI padre.
El formulario permanece sobre todo en el escritorio y sobre otros formularios del proyecto, excepto sobre los que
fsStayOnTop tambin tiene la propiedad FormStyle a fsStayOnTop. Si un formulario fsStayOnTop lanza otro del mismo tipo,
ninguno permanecer coherentemente sobre el otro.
Si el formulario es el principal su propiedad FormStyle debe ser fsMDIForm. No es aconsejable cambiar

FormStyle en tiempo de ejecucin.
Ejemplo 118.- Uso de FormStyle
0.- Se trata de realizar un programa multiventana para trabajar con esta propiedad y aprender su
comportamiento en tiempo de ejecucin. Seguimos el siguiente proceso:
1.- Creamos una nueva aplicacin con File/New Application y, con el inspector de objetos, cambiamos,
la propiedad FormStyle a fsMDIForm, el Caption a Formulario Principal, Height = 200, Widht = 430 y
fijamos Position a poScreenCenter.
2.- Aadimos un segundo formulario al proyecto con File/New Form. A este formulario le cambiamos la
propiedad Caption a Formulario secundario Hijo (podemos tener varias ventanas secundarias), la
propiedad FormStyle la cambiamos a la opcin fsMDIChild, Height = 100, Widht = 400 y fijamos Position
a poScreenCenter.
3.- Aadimos un tercer formulario al proyecto con File/New Form. A este formulario le cambiamos la
propiedad Caption a Formulario secundario StayOnTop, la propiedad FormStyle la cambiamos a la
opcin fsStayOnTop, Height = 95, Widht = 360 y fijamos Position a poScreenCenter.
4.- Aadimos un botn y obtenemos una situacin similar a:
87
Componentes
Trabajo con FormStyle
El formulario hijo solo se puede mover, minimizar

o maximizar dentro del principal en cambio el
StayOnTop se mueve independientemente.
88
Componentes
Propiedad Icon
Por defecto, si no se selecciona ninguno, Builder presenta el icono propio de las aplicaciones C++
Builder. Se puede cambiar haciendo doble clic en el botn Load, para seleccionar el archivo del icono
deseado. Esta propiedad busca archivos con extensin .ico. C++ Builder tiene una biblioteca de
archivos .ico en la carpeta:
\\Archivos de programa\Archivos comunes\Borland Shared\Images\Icons\
El compilador dispone de un editor de iconos que se puede seleccionar en el men principal:
Tools/Image Editor para experimentar con l. En la figura vemos su aspecto con el icono chip cargado.
89
Componentes
Propiedad Position
Determina donde se desplegar el formulario en la pantalla del PC en el momento de la ejecucin.
Valor
Efecto en tiempo de ejecucin
poDesigned
El formulario aparece en tiempo de ejecucin con el tamao y la posicin que tena de

diseo
poDefault
El formulario aparece en una posicin de la pantalla con una altura y una anchura
determinadas por Windows. Cada vez que ejecutemos la aplicacin, el formulario se
mover levemente abajo y a la derecha.
El formulario se muestra con el tamao con que se cre en tiempo del diseo, pero
poDefaultPosOnly Windows elige su posicin respecto a la pantalla. Cada vez que ejecutemos la aplicacin,
el formulario se mover levemente abajo y a la derecha.
poDefaultSizeOnly
El formulario aparece en el lugar donde estaba en tiempo de diseo, pero Windows elige
su tamao.
poScreenCenter
El formulario aparece en el lugar donde estaba en tiempo de diseo, pero posicionado en

el centro de la pantalla.
Propiedad WindowState
Esta propiedad muestra las caractersticas del formulario en tiempo de ejecucin.
Valor
Efecto en tiempo de ejecucin
wsNormal
El formulario aparece de la manera en que se defini en el momento de crearse

(dimensiones y posicin).
wsMinimized
El formulario aparece minimizado en pantalla en tiempo de ejecucin.
wsMaximized
El formulario aparece maximizado en pantalla en tiempo de ejecucin.
Ejemplo 119.- Propiedades y eventos

Se trata de un ejemplo de uso de algunas de las propiedades de las citadas y de algunos eventos
tanto de teclado como de ratn.
Debemos disponer un formulario similar a:
90
Componentes
Los efectos de los botones Maximizar, Minimizar y Salir los vamos a asociar a los eventos OnClick para
efectuar esas operaciones.
Para botn Maximizar: WindowState=wsMaximized;
Para botn Maximizar: WindowState=wsMinimized;
Para botn Maximizar: Application->Terminate();
El efecto del botn Normal va a ser devolver la ventana a su estado normal asocindolo al evento
OnMouseMove del ratn.
Para botn Normal: WindowState=wsNormal;
Para el botn Mantenemos pulsada una tecla del ratn? y la etiequeta que tiene a la derecha vamos a
trabajar con los eventos OnMouseDown y OnMouseUp de forma que mientras tengamos pulsada la tecla
izquierda del ratn sobre el botn la etiqueta muestre SI y en caso contrario NO.
void __fastcall TForm1::Button5MouseDown(TObject *Sender,

TMouseButton Button, TShiftState Shift, int X, int Y)
{
Label1->Caption="SI";
}
//--------------------------------------------------------------------------void __fastcall TForm1::Button5MouseUp(TObject *Sender,
TMouseButton Button, TShiftState Shift, int X, int Y)
{
Label1->Caption="NO";
}
91
Componentes
Para el botn Tecla pulsada y su etiqueta de la derecha vamos a generar un evento OnKeyPress de forma que
cuando el botn tenga el foco la etiqueta nos muestre la tecla que hemos pulsado.
void __fastcall TForm1::Button6KeyPress(TObject *Sender, char &Key)
{
char keyString[2];
keyString[0] = Key;
strcpy(&keyString[1], "");
Label2->Caption= keyString;
}
Ahora aadimos un nuevo formulario con un Label y hacemos que tenga algo parecido a:
No debemos olvidar File/Include Unit ... para tener en Unit1 #include "Unit2.h". Para este Form vamos a
generar un evento OnResize al que asociamos el cdigo:
void __fastcall TForm2::FormResize(TObject *Sender)
{
Label1->Left = (ClientWidth/2) - (Label1->Width/2);
Label1->Top = (ClientHeight/2) - (Label1->Height/2);
}
Finalmente para el botn Otro Form generamos su evento OnClick y hacemos que muestre el segundo
formulario de forma modal.
{
Form2->ShowModal();
}
92
Componentes
Ejemplo 120.- Eventos DragOver y DragDrop
Creamos una aplicacin para trabajar con estos eventos y el formulario tendr un componente
ListBox y tres Label, cada uno con la fuente que se especifica.
Label 1: Britannic Bold - Negrita - Cursiva - 10 Puntos Azul
Label 2: Arial - Normal - 12 Puntos - Rojo
Label 3: Courier New - Negrita - Subrayado - 8 Puntos - Verde
Para probar el funcionamiento seleccionamos un Label, arrastramos hasta el ListBox y soltamos,
cambiando el texto del mismo al aspecto del Label seleccionado.
El formulario debe tener un aspecto similar a:
La propiedad DragMode de los Label debe ser dmAutomatic de lo que nos aseguramos asociando la
propiedad al evento OnCreate del formulario.
El cdigo del programa es:
{
Label1->DragMode = dmAutomatic;
}
93
Componentes
Ejemplo 120.- Eventos DragOver y DragDrop
void __fastcall TForm1::ListBox1DragOver(TObject *Sender, TObject *Source,
int X, int Y, TDragState State, bool &Accept)
{
Accept = Source->ClassNameIs("TLabel");
}
//--------------------------------------------------------------------------void __fastcall TForm1::ListBox1DragDrop(TObject *Sender, TObject *Source,
int X, int Y)
{
if (Sender->ClassNameIs("TListBox") && Source->ClassNameIs("TLabel"))
{
TListBox *Puntero = (TListBox *)Sender;
Puntero->Font = ((TLabel *)Source)->Font;
Puntero->Color = ((TLabel *)Source)->Color;
}
}
Eventos OnHide y OnPaint. Trabajo con la propiedad Canvas del Form
La propiedad TCanvas de un formulario permite dibujar en su rea de cliente. Canvas se usa en el
evento OnPaint del formulario. El mtodo Draw de Canvas tienen una sintaxis como:
Draw(int X, int Y, TGraphic* Grafico);
Dibujndo el grfico especificado por el parmetro Grafico en el canvas y la localizacin que indican
las coordenadas X e Y. Tendremos por tanto que facilitar un mbito global de acceso del tipo:
Graphics::TBitmap *Grafico;
El evento OnHide ocurre cuando el formulario se oculta, es decir cuando su propiedad Visible se pone
en false.
94
Componentes
Ejemplo 121.- Eventos OnHide y OnPaint. Trabajo con la propiedad Canvas del Form
Vamos a implementar una aplicacin con dos formularios que permita mediante la pulsacin de
un botn mostrar el otro formulario dibujando en cada uno de ellos una imagen diferente mediante la
propiedad Canvas del formulario. Debemos tambin permitir que la aplicacin se cierre desde
cualquiera de los formularios.
Comenzamos por construir dos formularios con un Label y un Button con el aspecto que mostramos,
estando los Label con su propiedad Caption vaca y situados a la izquierda de los botones. Ambos
formularios tienen su propiedad Height = 250 y Width a 190 y 240 respectivamente.
El cdigo del primer Form es:

//--------------------------------------------------------------------------#include <vcl.h>
#pragma hdrstop
#include "Unit1.h"
#include "Unit2.h" //File/Incude Unit ...
//--------------------------------------------------------------------------#pragma package(smart_init)
95
Componentes
TForm1 *Form1;
Graphics::TBitmap *Grafico; //Ambito global de acceso
: TForm(Owner)
{
}
{
Form2->Show();
this->Hide();
}
void __fastcall TForm1::FormHide(TObject *Sender)
{
Form2->Label1->Caption = "Athenea oculta";
}
void __fastcall TForm1::FormPaint(TObject *Sender)
{
Form1->Canvas->Draw(0, 0, Grafico); //Dibuja el grafico en Canvas
}
{
Grafico = new Graphics::TBitmap(); //Crea objeto bitmap
//Carga bitmap
Grafico->LoadFromFile("C:\\ARCHIVOS DE PROGRAMA\\ARCHIVOS COMUNES\\BORLAND
SHARED\\IMAGES\\SPLASH\\16COLOR\\ATHENA.BMP");
}
96
Componentes
El cdigo del segundo Form es:
#include <vcl.h>
#pragma hdrstop
#include "Unit2.h"
#include "Unit1.h" //File/Incude Unit ...
#pragma package(smart_init)
TForm2 *Form2;
Graphics::TBitmap *Grafico1; //Ambito global de acceso
: Tform(Owner) { }
{ Form1->Show();
this->Hide(); }
void __fastcall TForm2::FormHide(TObject *Sender)
{ Form1->Label1->Caption = "Tierra oculta"; }
void __fastcall TForm2::FormPaint(TObject *Sender)
{ Form2->Canvas->Draw(0, 0, ElGrafico1); //Dibuja el grafico en Canvas }
{ Grafico1 = new Graphics::TBitmap(); //Crea objeto bitmap
//Carga bitmap
Grafico1->LoadFromFile("C:\\ARCHIVOS DE PROGRAMA\\ARCHIVOS COMUNES\\BORLAND SHARED\\
IMAGES\\SPLASH\\16COLOR\\EARTH.BMP");
}
{
Form1->Close(); //Cerramos el Form principal
}
97
Componentes
Trabajo con ficheros: la clase ofstream
En el fichero Fstream.h se define la clase ofstream que permite trabajar con ficheros. Para esto
debemos declarar una variable debiendo ser el tipo de dicha variable cualquiera de las tres clases
siguientes:
Clase de objeto
Especializacin
ifstream
Entrada de datos desde un archivo
ofstream
Salida de datos a un archivo
fstream
Lectura y escritura en un archivo abierto
Para declarar el fichero de salida lo haremos con algo similar a:
ofstream Fichero("Archivo de Prueba.txt",ios::trunc).
El constructor de la clase toma como primer parmetro el nombre del archivo a asociar al objeto y
como segundo el modo de apertura, que est formado por uno o ms de los indicadores definidos en la
clase ios siguientes:
Indicador
Modo
Ejemplos de cdigo
in
Apertura para entrada
out
Apertura para salida
app
Apertura para aadir
ate
Puntero final archivo tras apertura
trunc
Eliminar contenido actual del archivo
noreplace Fallo en apertura si el archivo existe

nocreate
Fallo en apertura si el archivo no existe
binary
Apertura en modo binario, no de texto
//Trabajar con archivos de salida sin ninguna asociacin

ofstream F;
//Abrir fichero existente para lectura
ifstream F(Fichero);
//Abrir fichero para escritura creandolo
ofstream F(Fichero);
//Abrir fichero para lectura y escritura
fstream F(Fichero,ios::int |ios::out);
//Abrir fichero para escritura y generar error si existe
ofstream F(Fichero,ios::noreplace);
//Abrir fichero existente y si no existe no lo crea.
fstream F(Fichero,ios::nocreate);
//Abrir fichero en modo binario truncando el contenido actual. fstream
F(Fichero,ios::trunc|ios::binary);
El constructor de la clase ifstream tiene como valor por defecto para el segundo parmetro ios::in y el
constructor de ofstream ios::out.
98
Componentes
ProgressBar, StaticText y Animate
Vamos a usar el ejemplo para describir estos componentes.
Ejemplo 122.- Uso de ProgressBar, StaticText y Animate
Se trata de realizar un ejercicio que almacene los 15000 primeros nmeros en un fichero txt, que
una barra de progreso nos muestre el avance que se produce, nos aparezca un nmero indicativo del
progreso sobre la barra y que se muestre un objeto animado tipo folio volando entre carpetas.
Vamos a disear un formulario con altura 165, anchura 315 y centrado en pantalla sobre el que
situamos un objeto ProgressBar (Pestaa Win32) con alineacin alBotton, Max=15000 y Step=1; un
objeto Animate (Pestaa Win32) con Active = false, CommonAVI = aviCopyFile, Repetitions = 1,
StarFrame = 1, StopFrame = 20 y Visible = false.; un objeto StaticText con su Caption vaco y centrado
sobre ProgressBar en vertical y en horizontal estableciendoles una fuente color rojo de 10 puntos y en
negrita; y finalmente colocamos un botn y un CheckBox para tener un diseo similar a:
Seguidamente vemos el cdigo comentado completo de esta aplicacin.
99
Componentes
#include <vcl.h>
#pragma hdrstop
#include "Unit1.h"
#include <FStream.h> // la clase ofstream est definida en este fichero
#pragma package(smart_init)
TForm1 *Form1;
: TForm(Owner)
{
}
{
/* Con el CheckBox vamos a conmutar la propiedad Smooth de la barra de progreso
Smooth=false hace que la barra sea segmentada y Smooth=true que sea continua */
if(CheckBox1->Checked==false)
ProgressBar1->Smooth=false;
else
ProgressBar1->Smooth=true;
// Creamos el fichero borrando su contenido cuando se crea si ya existe
ofstream Fichero("Archivo de Prueba.txt",ios::trunc);
Cursor = crHourGlass;
Button1->Enabled = false;
100
Componentes
// Recorremos un bucle para los 15000 valores
for (int N=0; N<15000; N++)
{
Animate1->Active=true;
Animate1->Visible=true;
Animate1->Repetitions = 3;
Animate1->Timers=ProgressBar1->Position;
// Texto a mostrar en la etiqueta StaticText
StaticText1->Caption=AnsiString(ProgressBar1->Position*100/15000+1) + " %";
// Mtodo de Application que interrumpe la ejecucin de una solicitud a fin
// de que pueda procesar la cola de mensajes
Application->ProcessMessages();
// Desplazamiento a la izquierda de forma que Fichero se va completando sin dejar espacios en blanco.
Fichero << N;
// Mtodo StepIt para avanzar (actualizar) segn lo establecido en la propiedad Step de ProgressBar.
ProgressBar1->StepIt();
}
Fichero.close(); // Mtodo para cerrar el archivo
// Establecimiento de las condiciones iniciales
ProgressBar1->Position=0;
Button1->Enabled = true;
Cursor = crDefault;
StaticText1->Caption="";
Animate1->Visible=false;
}
101
a
l
e
d
Fin
s
e
r
p
i
c
a
t
en
102

Tema 3.2.2 PDF

Cargado por

Información del documento

Título original

Derechos de autor

Formatos disponibles

Compartir este documento

Compartir o incrustar documentos

Opciones para compartir

¿Le pareció útil este documento?

¿Este contenido es inapropiado?

Copyright:

Formatos disponibles

Tema 3.2.2 PDF

Cargado por

Copyright:

Formatos disponibles

Tcnicas de Programacin

3.2.- Programacin C++ con Builder C++

Tema 3.2.2.- Componentes en C++ Builder

La VCL (Visual Components Library) o biblioteca de componentes visuales

La VCL (Visual Components Library) o biblioteca de componentes visuales

La VCL (Visual Components Library) o biblioteca de componentes visuales

La VCL (Visual Components Library) o biblioteca de componentes visuales

Clases de Formularios y Aplicaciones

Clases de Formularios y Aplicaciones

Clases de Formularios y Aplicaciones

Especifica si la aplicacin est activa y tiene el foco.

MainForm especifica qu formulario acta como ventana principal de la aplicacin.

ShowMainForm especifica si la aplicacin debe mostrar la ventana principal al iniciar su

Especifican el icono y el texto, respectivamente, que aparecen en la barra de tareas de Windows

Para especificar el fichero de ayuda asociado a la aplicacin.

Ejemplo 93.- Propiedades de TApplication

Clases de Formularios y Aplicaciones

Escribimos en el Unit, debajo de lo creado automticamente, el mtodo DisplayHint y lo asignamos a

Clases de Formularios y Aplicaciones

Clases de Formularios y Aplicaciones

Minimiza una aplicacin y la aloja en la barra de tareas de Windows.

Reestablece el tamao que tena la aplicacin antes de ser minimizada.

Finaliza laejecucin de una aplicacin.

HandleException() Proporciona una manera de gestionar excepciones por defecto en la aplicacin.

Clases de Formularios y Aplicaciones

Ocurren respectivamente cuando se activa o desactiva la aplicacin.

OnShowHint ocurre cuando la aplicacin va a mostar un cuadro de sugerencia. Se suele

Ocurren cuando la aplicacin se minimiza o se reestablece al tamao normal,

Se emplea cuando se desea modificar el comportamiento por defecto de una aplicacin

Tema 3.2.2.- Componentes en C++ Builder

Clases de Formularios y Aplicaciones

void __fastcall TForm1::Button1Click(TObject *Sender)

Clases de Formularios y Aplicaciones

Clases de Formularios y Aplicaciones

Establece qu componente tiene el foco cuando se abre el formulario.

Indica si el formulario est activo (si puede recibir el foco).

Controlan conjuntamente las barras de desplazamiento de un formulario.

Indica qu iconos aparecen en la barra de ttulo de un formulario.

Indica qu tipo de borde debe tener el formulario.

Indica con qu nombre se refiere al formulario en la aplicacin (en el cdigo).

Color de fondo del formulario.

Especifica qu cursor se muestra cuando est sobre el formulario.

Height y Width Altura y anchura (en pxels) del formulario.

Tema 3.2.2.- Componentes en C++ Builder

Clases de Formularios y Aplicaciones

Coordenadas X e Y del formulario (esquina superior izquierda) en la pantalla.

Determina el tamao y la posicin del formulario.

Para especificar si un formulario es o no parte de una aplicacin multiformulario.

Para especificar el fichero de ayuda asociado a la aplicacin y gestionar la ayuda contextual.

Determina si los cuadros de sugerencia estarn activados o desactivados para el formulario.

Propiedades de los formularios en tiempo de ejecucin

Indica si el formulario est activo (si tiene el foco).

Tema 3.2.2.- Componentes en C++ Builder

Clases de Formularios y Aplicaciones

Coloca al formulario en primer plano o en ltimo, respectivamente.

Oculta el formulario (establece la propiedad Visible a falso).

Imprime el contenido del formulario.

Convierte las coordenadas del rea de cliente en coordenadas de pantalla y viceversa.

Para redibujar un formulario.

Destruye un formulario y libera toda la memoria asociada.

Eventos de los formularios

Clases de Formularios y Aplicaciones

Ocurren cuando se activa o desactiva un formulario, respectivamente. Un formulario se activa cuando