Capitulo 19 Visual Basic

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

10

Visual Basic

Guía del Estudiante Cap.19

Pág.

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. mismo que en el Formulario.

La propiedad AutoRedraw (True/False) hace lo

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. 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

12

Visual Basic

Guía del Estudiante Cap.19

Pág.