Creacin de Componentes con DelphiFernando Adrin Gmez

IntroduccinQu es un componente?Es un objeto con representacin visual que se puede manipular en fase de diseo. Un componente, en su definicin ms simple no es ms que un objeto descendiente del tipo TComponent.TComponent proporciona las caractersticas bsicas que todo componente debe tener: capacidad de ser mostrado en la paleta de componentes as como de operar a nivel de diseo de formulario Todos los componentes forman parte de la jerarqua de objetos denominada Visual Component Library (VCL). Cuando se crea un nuevo componente, este se deriva a partir de un componente existente (bien sea TComponent o algn otro ms especializado) y se aade a la VCL.

Pregunta:Por qu Delphi es mejor que Visual Basic?

Jerarqua de Clases

VCL Visual Component Library

TObjectEs la clase base de todos los objetos Delphi.Provee:

-La posibilidad de crear, mantener y destruir una instancia de un objeto.-Informacin acerca del tipo de clase y la instancia de un determinado objeto.-Soporte para manejo de mensajesEs recomendable usar tobject como clase base cuando se declaran objetos simples que no son componentes.Si no se especifica una clase base cuando se declara un nuevo tipo de objeto, delphi automticamente use tobject como clase base.Tobject no es tcnicamente una clase abstracta, pero generalmente no se crean instancias de esta clase.Metodos:Informacin sobre la clase,create,destroy.Clases Derivadas:Exception,TStream,TPersistent.

TPersistent-Proporciona una forma de asignar valores a las propiedades-Proporciona la forma de asignar el contenido de un objeto a otro.No se crean instancias de tpersistent.Se usa como clase base cuando se declaran objetos que no son componentes, pero que necesitan tener la capacidad de asignacin de valores a propiedades.Mtodos:assign.Clases Derivadas:TClipboard,TCanvas,TPicture,TComponent

TComponentEs el antecesor comn de todos los componentes delphi.-Proporciona la posibilidad de que un objeto aparezca en la paleta de componentes y pueda ser manipulado en fase de diseoNo se crean instancias de tcomponent.Se usa tcomponent como clase base cuando se declaran componentes no visuales que pueden aparecer en la paleta de componentes y pueden ser manipulados en fase de diseo.Mtodos:getchildren,hasparentPropiedades:count,index,name,tagClases Derivadas:TcommonDialog,TTimer,Tcontrol

TControlEs el tipo de componente abstracto que sirve como base de todos los controles delphi.Un control es un componente visual, que permite al usuario poder ver y manipular el componente en tiempo de ejecucin.Todos los controles tienen propiedades, mtodos y eventos en comn que son especficos del aspecto visual de los controles.Propiedades:color,caption,hint,height,width,left,top,name,parent,text,visible,enabledEVENTOS:click,dblclick,drag & drop,mouseClases Derivadas:TWinControl,TGraphicControl

TGraphicControlEs un control abstracto que se usa para derivar los controles personalizados no-windows (controles grficos )Proporciona una propiedad tcanvas ( superficie de dibujo ) y un mtodo paint.-No pueden recibir foco. -No pueden contener otros controles-No necesitan de una ventana-El dibujar un graphic control es mas rpido que un twincontrol ( no necesita HANDLER WINDOW)Clases Derivadas:TLabel,TImage,TSpeedButton

TWinControlEs la clase abstracta base de todos los controles windows.-Pueden recibir el foco cuando la aplicacin esta en ejecucin-Se puede usar el teclado para interactuar con el control-Puede contener otros controles-Tiene un WINDOW HANDLEEventos: tecladoClases Derivadas:TButtonControl,TCustomEdit,TTreeView,TListView.

Ventajas de los componentesPodemos aprovechar todo el cdigo heredado de la jerarqua de clases Una vez creado podr ser utilizado en cualquier aplicacin No es necesario que sea distribuido conjuntamente con el programa pues el cdigo est incluido en el ejecutable que los utiliza.Se pueden conseguir muchos componentes gratuitos ( por ejemplo en internet )

Como crear un componenteSeleccionar el men Component, New component y aparecer un cuadro de dialogo con las siguientes entradas:Antcesor Type: Se debe seleccionar la clase base ( de la cual se derivara el componente )Class Name: Nombre de la clase que se va a crearPalette Page: Se selecciona la paleta desde la cual se podr acceder al componenteUnit File Name: Es el nombre de la unidad en la cual se desarrollara el cdigo del componente.Search Path: Directorio de BsquedaAdd to Package: Permite agregar el componente a un paquete creado previamente.Automticamente se generara un cdigo asociado al componente y un procedimiento que se encarga de registrarlo.

Como instalar un componente Elegir la opcin Options|Install Components desde el men de Delphi. Pulsar sobre el botn Add para seleccionar la unidad que contiene el cdigo fuente del componente. Una vez seleccionada la unidad, hacer clic sobre OK. Delphi compilar la unidad y reconstruir el archivo COMPLIB.DCL. Si se encuentran errores al compilar, se nos informar de ello. Basta con corregir el error, salvar la unidad y repetir el proceso anterior. Si la compilacin tiene xito, nuestro componente entrar a formar parte de la paleta de componentes.

El punto de partidaCriterios para elegir la clase base:TComponent - El punto de partida para los componentes no visuales. TWinControl - El punto de partida si es necesario que el componente disponga de handles. TGraphicControl - Un buen punto de partida para componentes visuales que no sea necesario que dispongan de handles, es decir, que no reciban el foco. Esta clase dispone del mtodo Paint y de Canvas.

ComponentesPropiedadesEventosMtodos

Donde declararlasPrivateProtectedPublicPublished

Private: La caja negra Declarando una parte de un componente (bien sea un campo, propiedad o mtodo) privado (private) provoca que esa parte del objeto sea invisible al cdigo externo a la unidad en la cul se declara el objeto. Dentro de la unidad que contiene la declaracin, el cdigo puede acceder a esa parte del objeto como si fuera pblico.Permiten ocultar los detalles de implementacin del componente al usuario final del mismo, ya que estos no pueden acceder a la parte privada de un objeto. De este modo se puede cambiar la implementacin interna del objeto sin afectar al cdigo que haya escrito el usuario

Protected: Interfaz del programador La diferencia principal entre declarar una parte de un objeto protegida o hacerla privada es que los descendientes del componente podrn hacer referencia a esa parte.Este comportamiento es especialmente til para la cracin de componentes que vayan a descender de aquel que hemos creado.

Public: Interfaz en tiempo de ejecucin Todo las partes de un objeto que declaremos pblicas (public) podrn ser referenciadas por cualquier cdigo ya sea interno o externo a la propia unidad. En este sentido, la parte pblica identifica la interfase en tiempo de ejecucin de nuestro componente. Los mtodos que el usuario del componente debe llamar deben ser declarados pblicos, as como tambin las propiedades de slo lectura, al ser slo vlidas en tiempo de ejecucin.Las propiedades declaradas pblicas no aparecern en el inspector de objetos.Esta seccin es tal vez la ms importante a considerar al disear un componente. Cuando se disean componentes, se debe considerar cuidadosamente que mtodos y propiedades deben ser pblicas. Si el diseo es correcto, este permitira retocar las estructuras de datos y mtodos internos del componente sin tener que tocar la interface pblica, que seguir siendo la misma para el usuario del componente

Published: Interfaz en tiempo de diseo Las propiedades declaradas publicadas aparecen en el inspector de objetos en tiempo de diseo. Y ya que slo las partes publicadas aparecen en el inspector de objetos, estas partes definen la interfase en tiempo de diseo de nuestro componente. En general slo se deben declarar publicadas propiedades y no funciones o procedimientos (ya que lo nico que logramos con ello es declararlas pblicas).

PropiedadesProporcionan al usuario del componente un fcil acceso al mismo Permite al programador del componente "esconder" la estructura de datos subyacente Estn disponibles en tiempo de diseo. Se puede inicializar los valores de las propiedades sin necesidad de escribir una sla lnea de cdigo Permiten la validacin de los datos al mismo tiempo de ser introducidas. As se pueden prevenir errores causados por valores invlidos Nos aseguran que desde el primer momento nuestras propiedades tendrn un valor vlido, evitando el error comn de hacer referencia a una variable que no ha sido convenientemente inicializada.

Declaracin de propiedadesCuando se accede a una propiedad, en realidad se est accediendo a una variable privada del componente, en la que se almacena el valor de la propiedad.Esta variable interna se asocia a la propiedad en la declaracin de sta (por supuesto ambas deben ser del mismo tipo). La declaracin de una propiedad se realiza anteponiendo a su nombre la palabra reservada "Property", y tras el nombre se especifica el tipo al que pertenece.Formato:Property nombrepropiedad:tipopropiedad read f write g;

Tipos de propiedadesSOLO LECTURA : En este caso solo se debe poner la clusula READ en la declaracin. Las propiedades de solo lectura no aparecen en fase de diseo.SOLO ESCRITURA : Es un tipo de propiedad muy poco usado, pero esta permitido por DelphiLECTURA-ESCRITURA: En la declaracin deben figurar tanto la clusula READ como la WRITE

Como se utilizan READ y WRITE ? READ: Luego de la clusula read debe especificarse de donde se leera el valor de la propiedad.Para tal fin se puede especificar una variable del mismo tipo de la propiedad o una funcin que devuelve un valor del mismo tipo y no toma ningn parmetro.El valor obtenido es el que se puede visualizar en fase de diseo para cualquier propiedad.WRITE: Luego de la clusula WRITE debe especificarse hacia donde se escribir el valor modificado de la propiedad.Es posible utilizar variables del mismo tipo de la propiedad o bien un procedimiento que reciba un parmetro del mismo tipo de la propiedad.El uso de un procedimiento puede ser til para tener un mayor control de los valores asignados a la propiedad.

Convenciones de nombresLos tipos que definamos comenzarn con la letra T (de tipo). P.e. TtipoLos campos que almacenan los valores de propiedades comienzan con la letra F seguida del nombre de la propiedad que almacenan. As el campo Fnombre queda claro que almacena el valor de la propiedad nombre. Los nombres de los mtodos de lectura y escritura de los valores de una propiedad se denominarn mediente el prefijo Get (para lectura) o Set (para escritura) seguidos del nombre de la propiedad. P.e. el mtodo Getnombre

EventosUn evento no es ms que un procedimiento que se dispara automticamente, o por acciones efectuadas por el usuario (onClick, onMouseMove...), o directamente por el sistema (onPaint, onCalcFields...).Para el programador un evento no es otra cosa que una propiedad, aunque con algunas caractersticas particulares.Al cdigo que se ejecuta cuando se produce un determinado evento se le denomina manejador de eventos (event handler) y normalmente es el propio usuario del componente quin lo escribe Los eventos ms comunes ya forman parte de los propios componentes de Delphi (acciones del ratn, pulsaciones de teclado...), pero es tambin posible definir nuevos eventos.

Definicion de eventosPrimero debe declararse la variable que almacenar la direccin del mtodo. Esta variable debe ser del mismo tipo que el evento, y entre todas los tipos de eventos, el ms genrico es TNotifyEvent. En otras palabras, TNotifyEvent, es el manejador que crea el tpico esqueleto donde nosotros vamos a introducir el cdigo. Es el ms sencillo por lo que no proporcionar ms parmetros que el imprescindible (Sender: Tobject).Formato: El nombre de todo evento empieza con OnProperty Onevento:Tnotifyevent read fevento write fevento;

Disparar eventosSlo debe dispararse el evento si el programador codific cdigo para l; es decir si est asignado.El componente debe estar activadoAl disparar el evento se le pasa el parmetro (Self), lo que cargar correctamente el objeto Sender.Ej: if assigned(fevento) then fevento(self)

MtodosSon los procedimientos y/o funciones que forman parte del componente El usuario del componente los utiliza para realizar una determinada accin o para obtener un valor determinado al que no se puede acceder por medio de una propiedadYa que requieren ejecucin de cdigo, los mtodos slo estn disponibles en tiempo de ejecucin

EjemplosTarchivos ( derivado de Tcomponent )Twincontrol1 ( derivado de Twincontrol )Tdibujo ( derivado de Tgrapchicontrol )

TarchivosPropiedad nombrearchivo: admite un nombre de archivo existente, si no existe el archivo tiene un valor predeterminado para indicarloEvento Onnombreincorrecto: se dispara cuando se trata de ingresar el nombre de un archivo que no existe en la propiedad nombrearchivo Propiedades Directorio_Windows y Directorio_Sistema: son de solo lectura. Indican el directorio de windows y el del sistema

Tarchivosproperty nombrearchivo:string read fnombre write ponernombre; property OnNombreIncorrecto : TNombreIncorrecto read Fni write Fni; property Directorio_Windows:string read obtenerwindir; property Directorio_Sistema:string read obtenersysdir;

Propiedad nombrearchivoprocedure tarchivos.ponernombre(n:string);beginif existe(n) then fnombre:=nelsebeginfnombre:='nono';if assigned(fni) then fni(self,n);end;end;

Evento Onnombreicorrectotype TNombreIncorrecto=procedure(Sender: TObject; nombre:string) of object;

Tarchivos = class(TComponent).............. Fni : TNombreIncorrecto;

Propiedad directorio_windowsfunction tarchivos.obtenerwindir:string;{devuelve el directorio de windows}varnombre:pchar;begingetmem(nombre,250);getwindowsdirectory(nombre,MAX_PATH);obtenerwindir:=string(nombre);freemem(nombre,250);end;

Twincontrol1 El nuevo control va a contener un richedit y un botn que se crean dinmicamente y forman parte del nuevo componente.Propiedad Titulo_boton: permite asignarle un texto al botonPropiedades Largo_boton y Alto_boton : Permiten asignar largo y alto del botnSe hacen visibles muchas otras propiedades heredadas.

Twincontrol1 public

constructor create(aowner:tcomponent);override; destructor destroy;override;

publishedproperty Visible;..........................property Titulo_boton:string read va write ponervalor;property Largo_boton:integer read largo write ponerlargo;property Alto_boton:integer read alto write poneralto;

Constructorconstructor twincontrol1.create(aowner:tcomponent);begininherited create(aowner);a:=trichedit.create(self);a.parent:=self as twincontrol;a.top:=30;a.left:=30;c:=tbitbtn.create(self);c.parent:=self as twincontrol;c.top:=10;c.left:=10;largo:=c.width;alto:=c.height;End;

Destructordestructor twincontrol1.destroy;begina.destroy;c.destroy;inherited destroy;

end;

Propiedades

procedure twincontrol1.ponerlargo(b:integer);beginc.width:=b;{cambio en el aspecto}largo:=b;{cambio en el valor de la propiedad}end;

procedure twincontrol1.poneralto(b:integer);beginc.height:=b;alto:=b;end;

Tgraphiccontrol1Es solo una superficie rectangular que se pinta de un color determinado

Propiedad Color: permite elegir el color del que se pinta la superficiePropiedad MenuAsociado: permite asignar un men popup al componente. Se abre el men al apretar el botn izquierdo del mouse

Adems al hacer doble click sobre el componente se abre un cuadro de dialogo que permite elegir el color de fondo

Tgraphiccontrol1protectedprocedure paint;override;

public constructor create(aowner:tcomponent);override; procedure MouseDown(Button: TMouseButton; Shift: TShiftState; X, Y: Integer);override; procedure dblclick;override;

publishedproperty Color:tcolor read fcolor write ponercolor; property MenuAsociado:tpopupmenu read fmenuasociado write ponermenu;

El metodo paintSe dispara cada vez que es necesario dibujar el control.procedure dibujo.paint;varx,y:integer;beginfor x:=self.left -left to self.width dobeginfor y:=self.top-top to self.height dobegincanvas.pixels[x,y]:=fcolor;end;end;end;

Constructorconstructor dibujo.create(aowner:tcomponent);begininherited create(aowner);fcolor:=clblack;fmenuasociado:=nil;colordialog:=tcolordialog.create(self);End;

Propiedad colorprocedure dibujo.ponercolor(a:tcolor);varx,y:integer;

beginfor x:=self.left -left to self.width dobeginfor y:=self.top-top to self.height dobegincanvas.pixels[x,y]:=a;end;end;fcolor:=a;end;

Propiedad MenuAsociadoprocedure dibujo.ponermenu(a:tpopupmenu);beginfmenuasociado:=a;end;

procedure dibujo.MouseDown(Button: TMouseButton; Shift: TShiftState; X, Y: Integer);beginif button=mbright thenbeginif fmenuasociadonil then fmenuasociado.popup(left+x+self.left,self.top+ top+y);end;inherited mousedown(button,shift,x,y);end;

Eleccin del colorAl hacer doble click sobre el componente se abrir un cuadro de dialogo que permita elegir el color

procedure dibujo.dblclick;beginif colordialog.execute thenponercolor(colordialog.color);inherited dblclick;end;

BibliografaProgramacion con Delphi 4 Francisco Charte Pag. 755-801El Gran Libro de Delphi Burda Pag 211-265, 315-354Delphi 4 Osier Pag 539-553http://personal.redestb.es/revueltarochehttp://www.clubdelphi.com/articulo/jmr/Chorradas.htmhttp://personales.mundivia.es/oscar/compo.htmhttp://www.hispan.com/eltaller/ControlDelphi.html

E-Mail

fagomez@fi.uba.ar

THE ENDPosibilidades