DockStatus Example

Using Programming Languages other than VBA

Sub Example_DockStatus()
	' This example creates a new toolbar called "TestToolbar" and inserts three
	' buttons into it. The toolbar is then displayed as a floating toolbar,
	' and then as a docked toolbar.
	' To remove the toolbar after execution of this macro, use the Customize Menu
	' option from the Tools menu.

	Dim currMenuGroup As acadMenuGroup
	Set currMenuGroup = ThisDrawing.Application.MenuGroups.Item(0)

	' Create the new toolbar
	Dim newToolBar As AcadToolbar
	Set newToolBar = currMenuGroup.Toolbars.Add("TestToolbar")

	' Add three buttons to the new toolbar.
	' All three buttons will have the same macro attached.
	Dim newButton1 As AcadToolbarItem
	Dim newButton2 As AcadToolbarItem
	Dim newButton3 As AcadToolbarItem
	Dim openMacro As String

	' Assign the macro string the VB equivalent of "ESC ESC _open "
	openMacro = Chr(3) & Chr(3) & Chr(95) & "open" & Chr(32)

	Set newButton1 = newToolBar.AddToolbarButton("", "NewButton1", "Open a file.", openMacro)
	Set newButton2 = newToolBar.AddToolbarButton("", "NewButton2", "Open a file.", openMacro)
	Set newButton3 = newToolBar.AddToolbarButton("", "NewButton3", "Open a file.", openMacro)

	' Display the toolbar
	newToolBar.Visible = True

	' Dock the toolbar to the left of the screen.
	newToolBar.Dock acToolbarDockLeft

	' Float the toolbar
	newToolBar.Float 200, 200, 1

	Exit Sub

	' Query the toolbar to see if it is docked.
	If newToolBar.DockStatus = acToolbarFloating Then
		MsgBox "The toolbar is floating."
		MsgBox "The toolbar is docked."
	End If

End Sub