4. PROPIEDADES.

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
LSB
Visual Basic
Guía del Estudiante Cap.19
Pág. 1
proyecto la totalidad del espacio que ocupaban los 9 controles. El caso del control 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
LSB
Visual Basic
Guía del Estudiante Cap.19
Pág. 4
mucho espacio en memoria, y debemos optimizar el programa ajustando las variables. 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
instrucciones
Exit Property
instrucciones
End Property
Friend
Static] Property Let
NombreDelProcedimiento
(argumentos)
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.
LSB
Visual Basic
Guía del Estudiante Cap.19
Pág. 6
Sintaxis
[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
LSB
Visual Basic
Guía del Estudiante Cap.19
Pág. 7
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.
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
conectar
páginas
propiedades
para
de
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.
LSB
Visual Basic
Guía del Estudiante Cap.19
Pág. 8
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.
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.
LSB
Visual Basic
Guía del Estudiante Cap.19
Pág. 9
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
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
Invisible
2
El fondo será opaco
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.
LSB
Visual Basic
Guía del Estudiante Cap.19
Pág. 11
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.
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