Compatibilidad de la información sobre herramientas para usuarios de Visual Basic 6.0

Actualización: noviembre 2007

Los métodos para mostrar información sobre herramientas difieren considerablemente entre Visual Basic 6.0 y Visual Basic 2008.

Diferencias conceptuales

En Visual Basic 6.0, la propiedad ToolTipText de un control se usa para mostrar información sobre herramientas en tiempo de ejecución.

En Visual Basic 2008, se puede utilizar un único componente ToolTip para controlar la información sobre herramientas de todos los controles de un formulario; el componente ToolTip se puede agregar al formulario desde el Cuadro de herramientas. El método SetToolTip se utiliza para establecer el texto de cada información sobre herramientas en función del nombre del control.

Ocultar la información sobre herramientas

En Visual Basic 6.0, si la propiedad ToolTipText contiene texto, se muestra la información sobre herramientas; si está vacía, no se muestra. Para borrar el texto de varios objetos de información sobre herramientas, debe recorrer la colección Controls y establecer la propiedad ToolTipText en una cadena vacía.

En Visual Basic 2008, puede impedir que aparezca la información sobre herramientas transfiriendo una cadena vacía al método SetToolTip. Puede borrar el texto de todos los objetos de información sobre herramientas asociados a un componente ToolTip; para ello, establezca la propiedad Active en false.

Personalizar la información sobre herramientas

En Visual Basic 6.0, no se puede personalizar una información sobre herramientas sin recurrir a llamadas a la API de Windows.

En Visual Basic 2008, se han incluido una serie de propiedades nuevas que permiten personalizar la apariencia o el comportamiento de la información sobre herramientas (por ejemplo, cambiar los colores, definir un tiempo de espera antes de mostrar información de este tipo o crear informaciones sobre herramientas de varias líneas).

Cambios de código para la información sobre herramientas

En los siguientes ejemplos de código se muestran las diferencias entre las técnicas de codificación de Visual Basic 6.0 y Visual Basic 2008.

El código se modifica para mostrar una información sobre herramientas

En el ejemplo siguiente se muestra cómo configurar una información sobre herramientas de un control Button en Visual Basic 6.0 y en Visual Basic 2008. En el ejemplo de Visual Basic 2008 se supone que se ha agregado un componente ToolTip al formulario en tiempo de diseño.

' Visual Basic 6.0
Button1.ToolTipText = "Save changes"
' Visual Basic
ToolTip1.SetToolTip(Button1, "Save changes")

El código se modifica para ocultar una información sobre herramientas

En el ejemplo siguiente se muestra cómo ocultar una información sobre herramientas de un control Button en Visual Basic 6.0 y en Visual Basic 2008. En el ejemplo de Visual Basic 2008 se supone que se ha agregado un componente ToolTip al formulario en tiempo de diseño.

Nota:

El componente ToolTip de Visual Basic 2008 tiene también una propiedad Active; si esta propiedad se establece en false, se ocultará la información sobre herramientas de todos los controles asociados a dicho componente ToolTip.

' Visual Basic 6.0
' Hide a single ToolTip.
Button1.ToolTipText = ""
' Hide all ToolTips.
For Each Control in Me.Controls
    Control.ToolTipText = ""
Next
' Visual Basic
' Hide a single ToolTip.
ToolTip1.SetToolTip(Button1, "")
' Hide all ToolTips.
ToolTip1.Active = False

Notas de actualización

Cuando una aplicación de Visual Basic 6.0 se actualiza a Visual Basic 2008, no se actualiza ninguna referencia a la propiedad ToolTipText en tiempo de diseño ni en tiempo de ejecución y se insertan comentarios en el código. Se agrega un componente ToolTip denominado ToolTip1 al formulario, y deberá enlazar las informaciones sobre herramientas definiendo la propiedad ToolTip on ToolTip1 en tiempo de diseño o llamando al método SetToolTip en tiempo de ejecución.

Si la aplicación de Visual Basic 6.0 utiliza llamadas a la API de Windows para personalizar las informaciones sobre herramientas, deberá modificar el código para aprovechar las características de personalización del componente ToolTip.

Vea también

Referencia

Información general sobre el componente ToolTip (formularios Windows Forms)

Otros recursos

Controles de formularios Windows Forms para usuarios de Visual Basic 6.0