Está en la página 1de 12

Visual Basic - Guía del Estudiante Cap.

19

REALIZACION DE CONTROLES OCX

A modo de comentario. Hemos llegado a un capítulo que todos los alumnos desean
conocer: el capítulo donde vamos a ver como se crea un control personalizado. A lo largo de
mis años de docencia he observado que los alumnos mas aventajados tienden a realizar
aplicaciones usando controles realizados por ellos mismos, en la creencia que eso protege
sus programas frente a posibles imitaciones, ya que parece que poseen la llave que da
acceso a sus secretos. Incluso hay quien piensa que el uso de este tipo de controles da
cierto prestigio como programador. Y hay también empresas especializadas en software que
comparten esas mismas ideas. En el ámbito empresarial hay quien realizó uno de estos
controles con fecha de caducidad, de forma que pasada una fecha, el control deja de
funcionar y con él la aplicación. Buena forma de asegurarse el contrato de mantenimiento, ya
que el control había que reemplazarlo antes de llegar a esa fecha, pero una hermosa forma a
la vez de perder al cliente y la credibilidad como empresario y como programador. Es una
cuestión de criterios personales o comerciales, pero la creación de controles personalizados
es una práctica que solamente debe llevarse a cabo cuando es estrictamente necesario por
no existir ningún recurso en VB que realice lo deseado. Y es decisión muy prudente no
aceptar ninguna aplicación que llevando un control personalizado, no se entregue con la
aplicación, toda la información relativa al mismo, incluyendo su código fuente.

Para crear un control, lo primero que hay que hacer es pensar, con papel y lápiz, las funciones
que debe realizar ese control, así como sus propiedades y métodos. Hay que pensar durante
este proceso, si el control se va a encapsular dentro de un OCX solo o con otros
controles, ya que un mismo OCX puede contener más de un control. Una vez
realizado este estudio previo, se procede a abrir un nuevo proyecto, eligiendo en
este caso la creación de un Control ActiveX, sobre el icono mostrado en la figura.
Aparecerá algo distinto a lo que nos encontramos cuando creamos un proyecto
EXE Standard.

Lo primero que observamos es que no aparece un formulario, sino algo, que si bien se le
parece, sabemos que no lo es. Esa especie de formulario es el objeto UserControl.

El UserControl es el objeto base del control que estamos creando. Un control ActiveX se
compone siempre de un UserControl y sobre él podremos colocar otros controles. A los
controles que colocamos sobre el UserControl se les denomina Controles Constituyentes.

Un proyecto con un UserControl es similar a un proyecto con un formulario. El proyecto se


guarda en un fichero ASCII con extensión .vbp igual que cualquier proyecto Visual Basic. El
nombre de ese fichero será el nombre con el que se ha guardado el proyecto.
El UserControl se guarda también en un fichero ASCII. De la misma forma que un formulario
se guarda con extensión .frm, un UserContol se guarda con extensión .ctl Y de la misma
forma que un formulario, cuando tenía gráficos éstos se guardaban en un fichero aparte, con
extensión .frx, cuando un UserControl tiene gráficos se guardan en un fichero con extensión
.ctx El nombre de ambos ficheros es el mismo con el que se haya guardado el UserControl.

Al compilar el proyecto, en vez de generar un fichero .EXE, generará un fichero .OCX Y este
OCX es idéntico a los que vemos en Proyecto | Componentes cada vez que queremos
introducir un componente que no está en la barra de herramientas. (Falta registrarlo, pero
veremos más adelante como se registra)

Se pueden introducir varios UserControl en un mismo proyecto. Esto generará igual número de
controles dentro del mismo paquete .OCX. esta práctica es bastante normal. Por ejemplo, el
MSCOMCTL.OCX (Microsoft Windows Common Controls 6.0) contiene 9 controles. Pero
tenga cuidado cuando meta controles dentro del mismo paquete. Piense que cada control va a
ocupar cierto sitio. Suponga que hace un OCX con 9 controles. Ocupará más espacio en disco
que si hubiese metido 1. Cuando meta en un proyecto uno solo de estos controles, deberá
meter en el proyecto la totalidad del espacio que ocupaban los 9 controles. El caso del control

LSB Visual Basic Guía del Estudiante Cap.19 Pág. 1


de Microsoft citado tienen su razón de ser. El OCX contiene 9 controles, que se pueden usar
todos dentro del mismo proyecto (Barra de herramientas, barra de estado, TreeView, ListView,
Barra de Progreso, Slider, TabStrip, Image Combo e ImageList)

Registrar un control. El registro de un control es una operación que Windows debe hacer
para meter los datos de ese control (nombre y ubicación dentro del disco) dentro del registro
de Windows. Esto le facilita la búsqueda del fichero.
Lo normal es colocar los controles OCX dentro de la carpeta C:\Windows\System. Puede
ponerlo en cualquier otra carpeta, pero esa es la usual. Eso sí, una vez puesto en la carpeta
deseada y registrado no lo puede mover, ya que Windows no lo encontraría.

Hay un método muy sencillo para registrar un control cuando tiene el Visual Basic instalado en
su PC. Guarde el fichero OCX en C:\Windows\System. Vaya a Proyecto | Componentes y le
aparecerá el cuadro para elegir un nuevo control. No aparecerá ese nuevo OCX dentro de la
lista de este cuadro, ya que todavía no está registrado.

Fig. 19.1 Cuadro para elegir un nuevo control

Haga clic sobre el botón Examinar… Le aparecerá el cuadro para seleccionar un fichero.
Seleccione el fichero OCX que acaba de introducir y ese OCX ya está registrado.
Cuidado. Esta forma, sencilla y sin complicaciones, puede llevarle en más de una ocasión a
registrar controles que no desea.

Cuando no tenga VB instalado tendrá que recurrir a un programa que trae Windows: el
Regsvr32.Exe Para ello vaya a Inicio | Ejecutar y en el cuadro que le aparece introduzca el
nombre del programa seguido del nombre completo del OCX a registrar. (Fig. 19.2)

Cuando realizamos la instalación de un programa realizado en Visual Basic, ocurre con mayor
frecuencia de la deseada que uno de los controles no se registra. El registro lo hace
automáticamente la instalación, pero a veces, falla. En algunos casos el programa funciona
perfectamente, pero en otros no funciona. Y en estos casos es normal que el OCX no haya
llegado a guardarse en el disco. Solución: copiar ese OCX directamente sobre
C:\Windows\System y realizar el registro de la forma descrita.

LSB Visual Basic Guía del Estudiante Cap.19 Pág. 2


Fig. 19.2 Forma de registrar un control OCX

Sigamos con el UserControl.

Propiedades, métodos y eventos del nuevo control.


El nuevo control que va a crear va a tener propiedades. Unas las va a tener porque son
inherentes a cualquier control (Left, Top, Tag, y aquellas que sean necesarias para la ubicación
del control y sus dimensiones) Otras, porque se han introducido durante la creación del control.
Los métodos y eventos deben introducirse todos durante la creación.

El UserControl tiene sus Propiedades, Métodos y Eventos. También las tienen los controles
constituyentes. Pero las propiedades, métodos y eventos de ninguno de ellos pasa a formar
parte de las propiedades, métodos o eventos del control que estamos creando.

Vamos a ver como se introducen las propiedades del nuevo control. Para ello vamos a estudiar
dos instrucciones de Visual Basic: Property Get y Property Let

Estas instrucciones se introducen igual que cuando se introduce una función o procedimiento
en un formulario. Haciendo clic en Herramientas | Agregar Procedimiento. Nos aparece un
cuadro donde debemos elegir Propiedad Recuerde que el elemento del menú de VB Agregar
Procedimiento solamente está activado cuando está abierta una ventana de código. La
ventana de código abierta debe ser del proyecto del control ActiveX (Del UserControl o de
cualquiera de los controles constituyentes) Se le pone el nombre que desea que tenga la
propiedad. Por ejemplo, si queremos que esa propiedad sea el color de fondo del nuevo
control, pondremos ColorDeFondo (¿Porque habríamos de poner Backcolor si el control se ha
desarrollado en España?)

Fig. 19.3 Cuadro para introducir una propiedad en el nuevo control

Basta con hacer clic en Aceptar y ya nos ha introducido dos nuevas cosas en la ventana de
código, en el desplegable de la derecha (Fig. 19.4)

LSB Visual Basic Guía del Estudiante Cap.19 Pág. 3


Fig. 19.4 Ventana de código mostrando PropertyGet y PropertyLet

Al introducir una nueva propiedad se generan estos dos


procedimientos (los denominaremos Procedimientos
Property) que tienen por nombre el de la propiedad que
acabamos de introducir, y llevan la coletilla de Property
Get y Property Let. Sin perder el tiempo guardamos el
proyecto y vamos a ver las propiedades del nuevo
control. (Veremos un poco más adelante como se pone
el control sobre un formulario dentro del mismo grupo
de proyectos) Vemos que figura una propiedad llamada
ColorDeFondo, tal como habíamos puesto en la Fig.
19.3
Puede ver que hay más propiedades, que no han sido
introducidas. Todas esas propiedades son la que se
introducen automáticamente como inherentes a
cualquier control.
La propiedad ya está en el cuadro de propiedades, pero
todavía no hace nada. Lo que queramos que haga
debemos programarlo justamente en esos dos
procedimientos property que acaban de aparecer.

Aparecen dos procedimientos porque en principio es


una propiedad de lectura y escritura. Mediante el
Property Let escribiremos el valor y con el Property Get
leeremos el valor de la propiedad. (Let pone el valor,
Get lee el valor)

Fig. 19.5 Cuadro de propiedades del nuevo control

Veamos como son esos dos procedimientos antes de introducir código:

Public Property Let ColorDeFondo(ByVal vNewValue As Variant)

End Property

Public Property Get ColorDeFondo() As Variant

End Property

Vea que empieza como todos los procedimientos, con Public (Podría ser Private) seguido de
Property Let (o Property Get) y termina con End Property
Como puede verse, el procedimiento Property Let necesita un valor, vNewValue que ha
declarado como Variant. A ese el procedimiento para poner el valor a la propiedad necesita
que le pasemos el valor de esa propiedad. Lo que no puede saber, es el tipo de dato que debe
usar para ColorDeFondo. Por eso pone As Variant y de esta forma podemos meter cualquier
valor. Sin embargo, sabemos desde el Capítulo 1 que las variables declaradas como Variant
ocupan mucho espacio en memoria, y debemos optimizar el programa ajustando las variables.

LSB Visual Basic Guía del Estudiante Cap.19 Pág. 4


Como sabemos que el color es un número Long, podemos sustituir el tipo Variant por un tipo
Long:

Public Property Let ColorDeFondo(ByVal vNewValue As Long)

Public Property Get ColorDeFondo() As Long

Observe que lo hemos cambiado en los dos procedimientos. Si no se cambia en ambos dará
error.

También podemos cambiar el nombre de la variable interna del procedimiento (vNewValue) y


poner algo que resulte más comprensible:

Public Property Let ColorDeFondo(ByVal NuevoColor As Long)

En el caso del color también puede poner otro tipo de variable: OLE_COLOR, que es lo que
hace VB con el asistente.

Veamos ahora el código a introducir en ese Procedimiento Property

Como lo que queremos hacer con la propiedad ColorDeFondo es poner de un determinado


color el fondo del control, y el fondo del control es precisamente el UserControl, bastará con
poner que la propiedad BackColor del UserControl es precisamente el nuevo control a poner.
Observe que en el UserControl la propiedad se sigue llamando Backcolor.

Public Property Let ColorDeFondo(ByVal NuevoColor As Long)


UserControl.BackColor = NuevoColor
End Property

Es muy útil, no necesario, comunicar al control que ha cambiado una de sus propiedades. Esto
sirve para que pueda guardar el nuevo valor en su página de propiedades. Ya lo veremos.
Para comunicarle que ha cambiado una propiedad se le añade una línea al código anterior

Public Property Let ColorDeFondo(ByVal NuevoColor As Long)


UserControl.BackColor = NuevoColor
PropertyChanged "ColorDeFondo"
End Property

Ya veremos lo que ocurre con PropertyChanged

Este procedimiento es el que se ejecuta cuando ponemos un valor al color de fondo del nuevo
control cuando ponemos, por ejemplo

TBPV1.ColorDeFondo = 255 (TBPV1 es el nombre del control en el formulario de prueba)

Vamos a ver el código del procedimiento que se ejecuta cuando queremos saber el valor que
tienen esa propiedad.

Public Property Get ColorDeFondo() As Long


ColorDeFondo = UserControl.BackColor
End Property

Observe que el valor devuelto es el número de color de la propiedad BackColor del


UserControl.

LSB Visual Basic Guía del Estudiante Cap.19 Pág. 5


Vamos a ver con más detalle los procedimientos Property Let y Property Get

Instrucción Property Let


Declara el nombre, los argumentos, y el código que forman el cuerpo de un procedimiento
Property Let, y asigna un valor a una propiedad.

Sintaxis

[Public Private Friend Static] Property Let NombreDelProcedimiento (argumentos)


instrucciones
Exit Property
instrucciones
End Property

El ámbito del procedimiento queda determinado por la primera expresión:

Public: El procedimiento Property es accesible desde cualquier parte del proyecto


Private:Es accesible solamente para los procedimientos del mismo módulo
Friend (Solo para Clases)El procedimiento no es visible por el controlador de una instancia
Static Los valores de las variables locales declaradas en el procedimiento mantienen su valor
entre distintas llamadas.

NombreDelProcedimiento es el nombre por el que se va a llamar y es precisamente el nombre


de la propiedad que va a controlar. Aunque en VB no pueden existir dos procedimientos con el
mismo nombre, en este caso sí, y el nombre del procedimiento Property Let puede ser igual
(de hecho siempre es igual) a otro procedimiento Property Get

Argumentos Argumentos que deben pasarse al llamar a ese procedimiento. El tipo de datos
de cada argumento será el mismo que en el procedimiento Property Get

Instrucciones Es el código que hay que escribir en el procedimiento para que realice lo que
desea el programador. Estas instrucciones pueden generar una condición en la que se debe
abandonar el procedimiento. En ese caso, puede salirse del procedimiento con Exit Prperty

Los argumentos pueden pasarse:

Por Valor (ByVal) El valor de la variable fuera del procedimiento mantienen el valor, aunque
ese valor cambie dentro del procedimiento.

Por Referencia (ByRef) El valor de la variable fuera del procedimiento cambia si suse
modifica en el procedimiento.

Opcional (Optional) El parámetro es opcional. Si un parámetro es opcional, todos los que


vengan detrás también deben serlo, y hay que indicarlo así con la expresión Optional para
cada uno de ellos. El parámetro que da valor a la propiedad no puede ser opcional.

Array de parámetros (ParamArray) Indica que es una matriz de parámetros.

No se puede llamar a un procedimiento Property Let dentro de otro procedimiento Property,


Sub o Function.

Property Get (Instrucción)


Declara el nombre, los argumentos y el código que componen el cuerpo de un procedimiento
Property, y obtiene el valor de una propiedad.

Sintaxis

LSB Visual Basic Guía del Estudiante Cap.19 Pág. 6


[Public | Private | Friend] [Static] Property Get NombreDelProcedimiento (argumentos) As
tipo
instrucciones
nombreDelProcedimiento = expresión
Exit Property
instrucciones
nombreDelProcedimiento = expresión
End Property

El ámbito y la forma de pasar los parámetros son idénticas a las de Property Let

Comenzando el ejercicio práctico


En el ejercicio que ilustra este capítulo vamos a hacer un control para una caja registradora
(No olviden que es un ejemplo) Ese control va a recibir el código de barras de un producto (se
podrá teclear directamente o leerlo mediante un escáner) y analizará el número de control para
comprobar que es correcto. El control se encargará de buscar en una base de datos la
descripción del producto, el precio y las unidades de oferta. Para ciertos productos aplicará un
incremento de precio en horas nocturnas y para otros un descuento en horas de mañana. Por
lo tanto, debe tomar la hora del sistema y fijar el Incremento / Descuento en razón de la hora.
La interfaz gráfica pensada es la siguiente:
Fig. 19.6 Interfaz gráfica del control a desarrollar

Veamos que propiedades debe tener este control. Aparte de la ya citada, ColorDelFondo,
vamos a ponerle:

In_Cod_Barras. De tipo texto, para poder pasarle por programa el código de barras de un
producto.

In_Unidades. Numérica double para que permita decimales, y permitir así vender productos
“al peso”

In_DeshabilitaIncr_Desc, booleana, que si es true, deshabilitará la operación de incrementar


o rebajar el precio en función de la hora.

Out_Descripcion, que será una cadena de caracteres con el texto de la Descripción.

Out_Precio_Total, numérico double con el precio total de las unidades vendidas de ese
producto

(Hemos tenido el detalle de que las variables que contienen datos que entran en el control
comienzan por In_ y las que salen del control comienzan por Out_ Esto no significa que sean
solo de escritura o de lectura)

Se introducen estas propiedades tal como se explicó más atrás. En la Fig 19.7 puede verse el
cuadro de propiedades del control, con todas estas propiedades ya metidas. Ese cuadro,
como sabemos, aparece pulsando F4 estando seleccionado el control. Ese control está sobre
un formulario de prueba que aun no sabemos como ponerlo, pero se explicará en breve. Este
cuadro es el típico de todos los controles, pero estamos acostumbrados a que, haciendo clic
con el botón derecho del ratón, aparezca un cuadro de diálogo donde podemos introducir las
propiedades. Y eso, no sabemos todavía como hacerlo.

LSB Visual Basic Guía del Estudiante Cap.19 Pág. 7


Eso se hace mediante una página de propiedades.
Reconozco que es complicado, y pese a mi costumbre de
no usar asistentes para ahorrar trabajo, en este caso no
me queda más remedio que recurrir a ellos.

Vayamos al UserControl y seleccionándolo, pulsamos F4


para sacar sus propiedades. Vayamos a su propiedad
PropertyPages (recuerde que estamos en las
propiedades del UserControl) Sitúese en esa propiedad y
haga clic sobre el botón que aparece a la derecha. Le
aparecerá un cuadro como el de la Fig. 19.8. En ese
cuadro se nos pide que señalemos las páginas que
deseamos que tenga el cuadro de propiedades. En el
caso del ejemplo se han seleccionado una página de
propiedades vacía (PaginaPropiedades1, se le ha
cambiado el nombre que aparecía por defecto), la página
donde se elige la fuente (StandardFont) y la página
donde se elige el color (StandarColor) Al pulsar Aceptar
la propiedad PropertyPages del serControl tiene 3 Pages

Vayamos ahora al menú de Visual Basic, en Proyecto,


elegimos Agregar Página de Propiedades. Y es ahí donde
nos invita a poner una página en blanco o a utilizar un
asistente. Posiblemente un programador con mucha
experiencia elegiría hacerla a mano, pero los controles
ActiveX no se hacen todos los días y vamos a recurrir al
asistente para que nos evite tener que trabajar más, y
sobre todo, tener que estudiar mucho más.
Fig. 19.7 Propiedades del control

Fig. 19.8 Cuadro para


conectar páginas de
propiedades

Al elegir el asistente,
aparece un cuadro donde
nos muestra las
propiedades que hemos
metido en nuestro control.
En el caso del ejemplo,
esas propiedades son:

ColorDeFondo
In_Cod_Barras
In_Unidades
In_DeshabilitarIncr_Desc
Out_Descripcion
Out_Precio_Total

El asistente nos pide que elijamos las propiedades que queremos que aparezcan en el cuadro
de dialogo de propiedades. Se las ponemos todas. Vamos aceptando todos los pasos, hasta
que hacemos clic en el botón Finalizar. El cuadro de dialogo de propiedades ya está creado.
Vamos al formulario de prueba y hacemos clic con el botón derecho sobre el control. Aparece
por fin el cuadro de dialogo de propiedades.

LSB Visual Basic Guía del Estudiante Cap.19 Pág. 8


Fig. 19.9 Cuadro de dialogo de propiedades.

Puede ahora incluir en ese cuadro cualquier control, como si se tratase de un formulario.
Queda a merced de su capacidad artística rematarlo de forma adecuada

Fig. 19.10 Cuadro de propiedades rematado

Puede observar ahora que en la ventana de proyecto aparece ahora otro componente: la
página de propiedades.

La página de propiedades (Property Page) tiene las casi todas las propiedades, métodos y
eventos de un formulario. No vamos a extendernos en su estudio exhaustivo, ya que sería
salirse del objetivo del curso.
Solamente falta introducir el código adecuado en los procedimientos del UserControl. Por
ejemplo, para comprobar que el código de barras es correcto, creamos un procedimiento

LSB Visual Basic Guía del Estudiante Cap.19 Pág. 9


llamado CompruebaCodigo. Llamaremos a este procedimiento cuando se introduzca el código
de barras completo. (Emplearemos solamente EAN-13 para no complicar el ejemplo). El
código del procedimiento que comprueba el código de barras puede verlo en el ejemplo, y es
solamente aplicar la definición del dígito de control de EAN-13. A ese procedimiento le hemos
llamado CompruebaCodigo y es un procedimiento creado por nosotros dentro del UserControl.

Prueba del nuevo control


Para comprobar el nuevo control es necesario ponerlo en un proyecto. Mejor dicho, en un
formulario. Basta con introducir un formulario de la forma habitual: Proyecto | Agregar
Formulario. Verá que aparece una nueva carpeta en el proyecto con un formulario. Para
introducir el nuevo control en el formulario basta con que lo coja de la caja de herramientas y
lo lleve al formulario como lo haría con cualquier otro control. Eso sí, debe cerrar
previamente el UserControl porque si no ese icono que presenta el nuevo está
deshabilitado.

Puede probar todas las características del nuevo control. De cualquier forma no se fíe, y
realice la comprobación final en un proyecto completamente independiente, una vez que ya
haya compilado el control.

Icono para presentar al nuevo control


Es posible que no quiera que su control se vea en la caja de herramientas con el icono de la
figura anterior. Este es el icono por defecto. Si desea cambiarlo debe introducir una imagen
BitMap en la propiedad del UserControl ToolBoxBitMap. La imagen deberá estar en un
formato bastante grande (sin pasarse) para que se vea claro, ya que si se pone pequeña, el
icono que aparece en la caja de herramientas queda bastante feo.

Enlazar el nuevo control a una base de datos mediante el control data.


Ya vamos avanzando en lo que podemos hacer sobre un nuevo control. Ahora vamos a
enlazarlo a una base de datos a través del control Data.

Para ver como se hace esto vamos a hacer un ejemplo, siguiéndolo paso a paso.

LSB Visual Basic Guía del Estudiante Cap.19 Pág.


10
Propiedades del UserControl (Se enumeran solamente aquellas que sean específicas del
UserControl o que aconsejen una explicación especial)

Propiedad AccessKeys
Devuelve o establece una cadena que contiene las teclas que funcionarán como teclas de
acceso (o teclas aceleradoras) del control. La propiedad AccessKeys es una cadena que
contiene todas las teclas de acceso del control. Por ejemplo, para establecer las letras S e Y
como teclas de acceso, la propiedad AccessKeys se establecería a "sy". Cuando un usuario
presiona una de las teclas de acceso junto con la tecla ALT, el control recibirá el enfoque
(según el valor de la propiedad ForwardFocus). Las teclas de acceso de los controles
componentes se incluyen implícitamente como teclas de acceso, aunque no aparezcan en la
propiedad AccessKeys.

ActiveControl (Propiedad)
Devuelve el control que tiene el enfoque.

Propiedad AutoRedraw
El UserControl acepta métodos gráficos. La propiedad AutoRedraw (True/False) hace lo
mismo que en el Formulario.

Propiedad BackStyle
Establece el tipo de fondo del UserControl (Opaco / Invisible)

Los valores aceptados son:


Opaque 1 El fondo será opaco
Invisible 2 El fondo es transparente, pero solamente si la propiedad
Windowless esta a True

Propiedad ClipBehavior
Sirve para determinar la zona donde se verán los métodos gráficos, cuando está transparente.
Véase en la ayuda.

Propiedad ContainedControls
Devuelve la colección de controles constituyentes y los que se hayan podido añadir en tiempo
de ejecución. Funciona de forma similar a la propiedad Controls de un formulario.

Propiedad ContainerHWnd
Devuelve el controlador de la ventana (hWnd) del contenedor de un UserControl. Se usa para
programar con APIS.

Propiedad DataMembers
Devuelve una referencia a la colección DataMembers.
Un proveedor de datos puede proporcionar múltiples conjuntos de datos a los que un receptor
puede enlazar. Cada conjunto de datos se llama "miembro de datos" y está identificado
mediante una cadena única.
La colección DataMembers contiene los nombres de todos los miembros de datos disponibles
para el receptor de datos.

Propiedad EditAtDesignTime
Establece si un control puede activarse en el tiempo de diseño del programador. Si es True el
control puede activarse en tiempo de diseño y se comportará como lo haría en tiempo de
ejecución.

LSB Visual Basic Guía del Estudiante Cap.19 Pág. 11


EventsFrozen (Propiedad)
Devuelve un valor que indica si el contenedor está pasando por alto los eventos
desencadenados por el control. La propiedad EventsFrozen no está disponible en tiempo de
diseño del control y es de sólo lectura en tiempo de ejecución.
Cuando la propiedad EventsFrozen es True, el contenedor pasa por alto todos los eventos
desencadenados por el control. Si el control necesita producir un evento que no se puede
perder, tiene que dejarlo en la cola hasta que EventsFrozen sea False.

Extender (Propiedad)
Devuelve, para este control, el objeto Extender que almacena las propiedades del control
mantenidas por el contenedor. La propiedad Extender no está disponible en tiempo de diseño
del control y es de sólo lectura en tiempo de ejecución.

Propiedad MaskColor
Devuelve o establece el color que determina la región transparente del mapa de bits asignado
a la propiedad MaskPicture de un objeto UserControl cuya propiedad BackStyle está
establecida a 0 (Transparente).

Sintaxis MiUserControl.MaskColor = color

Cuando se asigna a un mapa de bits la propiedad MaskPicture de un UserControl cuya


propiedad BackStyle está establecida a 0 (Transparente), el control se vuelve transparente en
cualquier lugar en que esté cubierto por áreas del mapa de bits que cumplan la propiedad
MaskColor.
Los eventos del mouse que ocurren sobre áreas transparentes las reciben el contenedor o los
controles que, de otro modo, estarían cubiertos por el UserControl.

MaskPicture (Propiedad, Objeto UserControl)


Devuelve o establece el mapa de bits que, combinado con la propiedad MaskColor, determina
las regiones transparentes y visibles de un objeto UserControl cuya propiedad BackStyle está
establecida a 0 (Transparente).

Sintaxis MiUserControl.MaskPicture = imagen

Importante Esta característica sólo es soportada con mapas de bits de tipo imagen, como GIF,
JPEG y DIB. No es soportada con iconos, cursores o metaarchivos de Windows.

Propiedad ToolBoxBitMap

Establece la imagen con la que se va a representar el nuevo control en la caja de


herramientas. Debe ser una imagen BitMap que habremos guardado previamente en el disco.

LSB Visual Basic Guía del Estudiante Cap.19 Pág.


12