Esta documentación está archivada y no tiene mantenimiento.

Control ToolBar para usuarios de Visual Basic 6.0

Visual Studio 2005

En Visual Basic 2005, el control ToolStrip reemplaza el control ToolBar de Visual Basic 6.0. 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 2005 para crear barras de herramientas personalizadas y elementos de interfaz de usuario o para crear barras de herramientas y elementos de interfaz de usuario con el aspecto y el comportamiento de 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.

NoteNota

Visual Basic 2005 también dispone de un control ToolBar que proviene de versiones anteriores; no obstante, el control ToolStrip es la opción recomendada por sus características 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 2005 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 2005 no tiene ninguna propiedad equivalente. 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 2005 no tiene ninguna 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 2005 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 2005 no tiene ningún método equivalente. 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 2005. 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 2005 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 2005, se proporcionan vínculos a temas en los que se incluyen alternativas.

Propiedades

Visual Basic 6.0 Equivalente en Visual Basic 2005

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

NoteNota

Las coordenadas se controlan de forma diferente en Visual Basic 2005. 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 controlan de forma diferente en Visual Basic 2005. 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

NoteNota

En Visual Basic 6.0, cuando se cambia Value, se produce el evento Change. En Visual Basic 2005, no se produce el evento Change, utilice en su lugar el evento ValueChanged.

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 controlan de forma diferente en Visual Basic 2005. 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 2005

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

NoteNota

Las coordenadas se controlan de forma diferente en Visual Basic 2005. 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

Visual Basic 6.0 Equivalente en Visual Basic 2005

Change

Nueva implementación. Ya no existe el cuadro de diálogo Personalizar cuadro de herramientas.

DblClick

DoubleClick

DragDrop

DragOver

Nueva implementación. Para obtener más información, vea Arrastrar y colocar para usuarios de Visual Basic 6.0.

OLECompleteDrag

OLEDragDrop

OLEDragOver

OLEGiveFeedback

OLESetData

OLEStartDrag

Nueva implementación. Para obtener más información, vea Arrastrar y colocar para usuarios de Visual Basic 6.0.

Notas de actualización

Cuando se actualiza un proyecto de Visual Basic 6.0 a Visual Basic 2005, 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

Mostrar: