Control ToolBar para usuarios de Visual Basic 6.0

Actualización: noviembre 2007

El control ToolBar de Visual Basic 6.0 se reemplaza por el control ToolStrip en Visual Basic 2008. Los nombres de algunas propiedades, métodos, eventos y constantes son diferentes y, en algunos casos, existen diferencias de comportamiento.

Diferencias conceptuales

El Visual Basic 6.0 el control ToolBar es un control ActiveX que se utiliza para crear barras de herramientas sencillas con botones y cuadros combinados.

Puede utilizar el control ToolStrip de Visual Basic 2008 para crear barras de herramientas y elementos de interfaz de usuario personalizados o bien crear barras de herramientas y elementos de interfaz de usuario con la misma apariencia y comportamiento que en Microsoft Windows XP, Microsoft Office o Microsoft Internet Explorer. Estos elementos de interfaz de usuario admiten el desbordamiento y la reorganización de elementos en tiempo de ejecución. Los controles ToolStrip ofrecen una completa experiencia en tiempo de diseño que incluye la edición y activación in situ, el diseño personalizado y de espacio compartido, que es la posibilidad que ofrecen las barras de herramientas de compartir el espacio vertical y horizontal.

Nota:
Visual Basic 2008 también dispone de un control ToolBar que proviene de versiones anteriores; sin embargo, el control ToolStrip es la opción recomendada debido a sus funciones avanzadas.

AllowCustomize (propiedad), Customize (método), Change (evento)

En Visual Basic 6.0, la propiedad AllowCustomize de un control ToolBar se utiliza para mostrar un cuadro de diálogo Personalizar barra de herramientas estándar, que permite que el usuario oculte, muestre o reorganice los botones de la barra de herramientas. El método Customize se utiliza para invocar mediante programación el cuadro de diálogo. Se provoca el evento Change cuando el usuario cierra el cuadro de diálogo Personalizar cuadro de herramientas.

El control ToolStrip de Visual Basic 2008 no tiene ninguna propiedad ni método equivalente; debe crear un cuadro de diálogo y mostrarlo utilizando el método ShowDialog. Para obtener más información, vea Ejemplo ToolStrip Customizing.

DisabledImageList, HotImageList, ImageList (propiedades)

En Visual Basic 6.0, las propiedades DisabledImageList, HotImageList y ImageList de un control ToolBar se utilizan para asociar el control a controles ImageList. Se pueden asociar imágenes independientes a distintos estados: normal (ImageList), deshabilitado (DisabledImageList) y seleccionado (HotImageList).

El control ToolStrip de Visual Basic 2008 no tiene propiedades equivalentes. El objeto ToolStripButton tiene una propiedad Image única; al establecer la propiedad Enabled de ToolStripButton en False, se representa automáticamente la imagen deshabilitada. Para emular el comportamiento del estado "seleccionado" de Visual Basic 6.0, puede asignar una imagen distinta o cambiar la propiedad BackColor de ToolStripButton en tiempo de ejecución.

Style (propiedad)

En Visual Basic 6.0, la propiedad Style de un control ToolBar determina dónde se muestran las imágenes en relación con el texto; si se establece en tbrTransparent también se habilita el seguimiento activo.

El control ToolStrip de Visual Basic 2008 no tiene una propiedad equivalente. La relación entre la imagen y el texto se controla estableciendo la propiedad TextImageAlign de ToolStripItem; a diferencia de Visual Basic 6.0, cada elemento puede tener una alineación distinta. No se admite el seguimiento activo directamente, pero puede emular el comportamiento cambiando la propiedad Image de los eventos MouseEnter y MouseLeave.

Wrappable (propiedad)

En Visual Basic 6.0, la propiedad Wrappable de un control ToolBar determina si los botones de la barra de herramientas se ajustarán automáticamente cuando se cambie el tamaño de la ventana.

El control ToolStrip de Visual Basic 2008 no tiene ningún equivalente directo; admite en su lugar el uso de un menú desplegable de desbordamiento. Al agregar elementos ToolStripItem que requieren más espacio del asignado al ToolStrip, dado el tamaño actual del formulario, aparece automáticamente un ToolStripOverflowButton en ToolStrip. Aparece el ToolStripOverflowButton y los elementos con desbordamiento habilitado se pasan al menú de desbordamiento desplegable. Este comportamiento se puede deshabilitar estableciendo la propiedad CanOverflow en False.

Además, puede especificar el comportamiento de desbordamiento para un elemento ToolStripItem individual estableciendo su propiedad Overflow. Para obtener más información, vea Cómo: Administrar el desbordamiento de ToolStrip en formularios Windows Forms.

RestoreToolBar, SaveToolBar (métodos)

En Visual Basic 6.0, los métodos RestoreToolBar y SaveToolBar se utilizan para administrar la configuración de ToolBar. SaveToolBar guarda la configuración en un archivo de inicialización (.ini); RestoreToolBar lo devuelve a su estado original después de que se haya personalizado.

El control ToolStrip de Visual Basic 2008 no tiene métodos equivalentes. Puede utilizar el Diseñador de configuración para administrar las configuraciones del control ToolStrip. Para obtener más información, vea Administrar la configuración de la aplicación.

Equivalencias de propiedades y métodos del control ToolBar

En las siguientes tablas se enumeran propiedades y métodos de Visual Basic 6.0, junto con sus equivalentes en Visual Basic 2008. No se enumeran aquellas propiedades y métodos que tienen el mismo nombre y comportamiento. Salvo que se indique lo contrario, todas las enumeraciones de Visual Basic 2008 se asignan al espacio de nombres System.Windows.Forms.

Esta tabla proporciona vínculos a temas en los que se explican las diferencias de comportamiento. Cuando no existe un equivalente directo en Visual Basic 2008, se proporcionan vínculos a temas en los que se incluyen alternativas.

Propiedades

Visual Basic 6.0	Equivalente en Visual Basic 2008
Align	Dock
AllowCustomize	Nueva implementación. Debe proporcionar un cuadro de diálogo.
Appearance BorderStyle	Nueva implementación. Para obtener más información, vea Propiedades Appearance y BorderStyle para usuarios de Visual Basic 6.0.
ButtonHeight	Height, Size (ToolStripButton)
Buttons	ToolStripItemCollection
ButtonWidth	Height, Size (ToolStripButton)
Container	Parent
Controls	ToolStripItemCollection
DataBindings	Nueva implementación. Para obtener más información, vea Acceso a datos para usuarios de Visual Basic 6.0.
DisabledImageList	Nueva implementación. Utilice la propiedad Image del objeto ToolStripButton.
DragIcon DragMode	Nueva implementación. Para obtener más información, vea Arrastrar y colocar para usuarios de Visual Basic 6.0.
Height	Height Nota: Las coordenadas se administran de forma diferente en Visual Basic 2008. Para obtener más información, vea Sistema de coordenadas para usuarios de Visual Basic 6.0.
HelpContextID HelpFile	Nueva implementación. Para obtener más información, vea Compatibilidad con la Ayuda para usuarios de Visual Basic 6.0.
HotImageList	Nueva implementación. Utilice la propiedad Image del objeto ToolStripButton.
HWnd	Handle
ImageList	Nueva implementación. Utilice la propiedad Image del objeto ToolStripButton.
Index	Nueva implementación. Para obtener más información, vea Matrices de controles para usuarios de Visual Basic 6.0.
Left	Left Nota   Las coordenadas se administran de forma diferente en Visual Basic 2008. Para obtener más información, vea Sistema de coordenadas para usuarios de Visual Basic 6.0
MouseIcon	Nueva implementación. Para obtener más información, vea No se puede personalizar la propiedad MousePointer.
MousePointer	Cursor Para obtener una lista de constantes, vea MousePointer para usuarios de Visual Basic 6.0.
OLEDropMode	Nueva implementación. Para obtener más información, vea Arrastrar y colocar para usuarios de Visual Basic 6.0.
Parent	FindForm
ShowTips	ShowItemToolTips
Style	Nueva implementación. Utilice la propiedad TextImageAlign de ToolStripItem.
TextAlignment	TextAlign (ToolStripItem)
ToolTipText	Componente ToolTip Para obtener más información, vea Compatibilidad de la información sobre herramientas para usuarios de Visual Basic 6.0.
Value	Value Nota: En Visual Basic 6.0, cuando se cambia Value, se produce el evento Change. En Visual Basic 2008, no se provoca el evento Change; utilice el evento ValueChanged en su lugar.
WhatsThisHelpID	Nueva implementación. Para obtener más información, vea Compatibilidad con la Ayuda para usuarios de Visual Basic 6.0.
Width	Width, Size Nota   Las coordenadas se administran de forma diferente en Visual Basic 2008. Para obtener más información, vea Sistema de coordenadas para usuarios de Visual Basic 6.0.
Wrappable	CanOverflow, Overflow

Métodos

Visual Basic 6.0	Equivalente en Visual Basic 2008
Customize	Nueva implementación. Debe proporcionar un cuadro de diálogo.
Drag	Nueva implementación. Para obtener más información, vea Arrastrar y colocar para usuarios de Visual Basic 6.0.
Move	SetBounds Nota: Las coordenadas se administran de forma diferente en Visual Basic 2008. Para obtener más información, vea Sistema de coordenadas para usuarios de Visual Basic 6.0.
OLEDrag	Nueva implementación. Para obtener más información, vea Arrastrar y colocar para usuarios de Visual Basic 6.0.
RestoreToolbar SaveToolbar	Nueva implementación. Utilice la característica Configuración de la aplicación.
ShowWhatsThis	Nueva implementación. Para obtener más información, vea Compatibilidad con la Ayuda para usuarios de Visual Basic 6.0.
ZOrder:	Función BringToFront o SendToBack.

Eventos

Notas de actualización

Cuando se actualiza un proyecto de Visual Basic 6.0 a Visual Basic 2008, se actualizan todos los controles ToolBar a controles ToolStrip de formularios Windows Forms. Cuando las propiedades, métodos y eventos no tienen ningún equivalente o presentan diferente comportamiento, se agregan notas o advertencias de actualización al código.

Vea también

Referencia

Información sobre el control ToolStrip (formularios Windows Forms)

Otros recursos

ToolStrip (Control de formularios Windows Forms)