Export (0) Print
Expand All
Expand Minimize

ToolBar Control for Visual Basic 6.0 Users 

The ToolBar control in Visual Basic 6.0 is replaced by the ToolStrip control in Visual Basic 2005. The names of some properties, methods, events, and constants are different, and in some cases there are differences in behavior.

Conceptual Differences

The Visual Basic 6.0 ToolBar control is an ActiveX control that is used to create simple toolbars with buttons and combo boxes.

You can use the Visual Basic 2005 ToolStrip control to create customized toolbars and user-interface elements or to create toolbars and user-interface elements that have the appearance and behavior of Microsoft Windows XP, Microsoft Office, or Microsoft Internet Explorer. These user-interface elements support overflow and run-time item reordering. ToolStrip controls offer a rich design-time experience that includes in-place activation and editing, custom layout, and rafting, which is the ability of toolbars to share horizontal or vertical space.

NoteNote

Visual Basic 2005 also has a ToolBar control that is carried over from earlier versions; however the ToolStrip control is the recommended choice because of its advanced capabilities.

AllowCustomize Property, Customize Method, Change Event

In Visual Basic 6.0, the AllowCustomize property of a ToolBar control can be used to display a standard Customize Toolbar dialog box, which allows the user to hide, display, or rearrange toolbar buttons. The Customize method can be used to invoke the dialog box programmatically. The Change event is raised when the user closes the Customize Toolbox dialog box.

The Visual Basic 2005 ToolStrip control has no equivalent property or method; you must create your own dialog box and display it using the ShowDialog method. For more information, see ToolStrip Customizing Sample.

DisabledImageList, HotImageList, ImageList Properties

In Visual Basic 6.0, the DisabledImageList, HotImageList and ImageList properties of a ToolBar control are used to associate the control with ImageList controls. Separate images can be associated for different states: normal (ImageList), disabled (DisabledImageList), and selected (HotImageList).

The Visual Basic 2005 ToolStrip control has no equivalent properties. The ToolStripButton object has a single Image property; setting the Enabled property of the ToolStripButton to False automatically renders the image disabled. To emulate the Visual Basic 6.0 "selected" state behavior, you can either assign a different image or change the BackColor property of the ToolStripButton at run time.

Style Property

In Visual Basic 6.0, the Style property of a ToolBar control determines where images are displayed in relationship to text; setting it to tbrTransparent also enables hot tracking.

The Visual Basic 2005 ToolStrip control has no equivalent property. The relationship between image and text is controlled by setting the TextImageAlign property of the ToolStripItem; unlike Visual Basic 6.0, each item can have a different alignment. Hot tracking is not directly supported, but you can emulate the behavior by changing the Image property in the MouseEnter and MouseLeave events.

Wrappable Property

In Visual Basic 6.0, the Wrappable property of a ToolBar control determines whether the toolbar buttons will automatically wrap when the window is resized.

The Visual Basic 2005 ToolStrip control has no direct equivalent; it supports the use of a dropdown overflow menu instead. When you add ToolStripItem elements that require more space than is allotted to the ToolStrip, given the form's current size, a ToolStripOverflowButton automatically appears on the ToolStrip. The ToolStripOverflowButton appears, and overflow-enabled items are moved into the drop-down overflow menu. You can disable this behavior by setting the CanOverflow property to False.

In addition, you can specify the overflow behavior for an individual ToolStripItem element by setting its Overflow property. For more information, see How to: Manage ToolStrip Overflow in Windows Forms.

RestoreToolBar, SaveToolBar Methods

In Visual Basic 6.0, the RestoreToolBar and SaveToolBar methods are used to manage ToolBar configuration. SaveToolBar saves the configuration to an initialization (.ini) file; RestoreToolBar returns it to its original state after being customized.

The Visual Basic 2005 ToolStrip control has no equivalent methods. You can use the Settings Designer to manage configurations for the ToolStrip control. For more information, see Managing Application Settings.

ToolBar Control Property and Method Equivalencies

The following tables list Visual Basic 6.0 properties and methods, along with their Visual Basic 2005 equivalents. Those properties and methods that have the same name and behavior are not listed. All Visual Basic 2005 enumerations map to the System.Windows.Forms namespace unless otherwise noted.

This table provides links to topics explaining behavior differences. Where there is no direct equivalent in Visual Basic 2005, links are provided to topics that present alternatives.

Properties

Visual Basic 6.0 Visual Basic 2005 Equivalent

Align

Dock

AllowCustomize

New implementation. You must provide your own dialog box.

Appearance

BorderStyle

New implementation. For more information, see Appearance and BorderStyle Properties for Visual Basic 6.0 Users.

ButtonHeight

Height, Size (ToolStripButton)

Buttons

ToolStripItemCollection

ButtonWidth

Height, Size (ToolStripButton)

Container

Parent

Controls

ToolStripItemCollection

DataBindings

New implementation. For more information, see Data Access for Visual Basic 6.0 Users.

DisabledImageList

New implementation. Use the Image property of the ToolStripButton object.

DragIcon

DragMode

New implementation. For more information, see Drag and Drop for Visual Basic 6.0 Users.

Height

Height

NoteNote

Coordinates are handled differently in Visual Basic 2005. For more information, see Coordinate System for Visual Basic 6.0 Users.

HelpContextID

HelpFile

New implementation. For more information, see Help Support for Visual Basic 6.0 Users.

HotImageList

New implementation. Use the Image property of the ToolStripButton object.

HWnd

Handle

ImageList

New implementation. Use the Image property of the ToolStripButton object.

Index

New implementation. For more information, see Control Arrays for Visual Basic 6.0 Users.

Left

Left

Note   Coordinates are handled differently in Visual Basic 2005. For more information, see Coordinate System for Visual Basic 6.0 Users

MouseIcon

New implementation. For more information, see Cannot set a custom MousePointer.

MousePointer

Cursor

For a list of constants, see MousePointer for Visual Basic 6.0 Users.

OLEDropMode

New implementation. For more information, see Drag and Drop for Visual Basic 6.0 Users.

Parent

FindForm

ShowTips

ShowItemToolTips

Style

New implementation. Use the TextImageAlign property of the ToolStripItem.

TextAlignment

TextAlign (ToolStripItem)

ToolTipText

ToolTip component

For more information, see ToolTip Support for Visual Basic 6.0 Users.

Value

Value

NoteNote

In Visual Basic 6.0, when the Value is changed, the Change event is raised. In Visual Basic 2005, the Change event is not raised; use the ValueChanged event instead.

WhatsThisHelpID

New implementation. For more information, see Help Support for Visual Basic 6.0 Users.

Width

Width, Size

Note   Coordinates are handled differently in Visual Basic 2005. For more information, see Coordinate System for Visual Basic 6.0 Users.

Wrappable

CanOverflow, Overflow

Methods

Visual Basic 6.0 Visual Basic 2005 Equivalent

Customize

New implementation. You must provide your own dialog box.

Drag

New implementation. For more information, see Drag and Drop for Visual Basic 6.0 Users.

Move

SetBounds

NoteNote

Coordinates are handled differently in Visual Basic 2005. For more information, see Coordinate System for Visual Basic 6.0 Users.

OLEDrag

New implementation. For more information, see Drag and Drop for Visual Basic 6.0 Users.

RestoreToolbar

SaveToolbar

New implementation. Use the Application Settings feature.

ShowWhatsThis

New implementation. For more information, see Help Support for Visual Basic 6.0 Users.

ZOrder:

BringToFront or SendToBack function.

Events

Visual Basic 6.0 Visual Basic 2005 Equivalent

Change

New implementation. The Customize ToolBox dialog box no longer exists.

DblClick

DoubleClick

DragDrop

DragOver

New implementation. For more information, see Drag and Drop for Visual Basic 6.0 Users.

OLECompleteDrag

OLEDragDrop

OLEDragOver

OLEGiveFeedback

OLESetData

OLEStartDrag

New implementation. For more information, see Drag and Drop for Visual Basic 6.0 Users.

Upgrade Notes

When a Visual Basic 6.0 project is upgraded to Visual Basic 2005, any ToolBar controls are upgraded to Windows Forms ToolStrip controls. Where properties, methods, and events have no equivalent or have differences in behavior, upgrade notes or warnings will be added to your code.

See Also

Community Additions

ADD
Show:
© 2014 Microsoft