Toolbar_Duplicate

int Toolbar_Duplicate (int destParentPanel, ToolbarType originalToolbar, const char *title, int top, int left, ToolbarType *newToolbar);

Purpose

Duplicates a toolbar.

Parameters

Input
Name Type Description
destParentPanel integer The handle of the panel on which to place the new toolbar.

Obtain this handle from the LoadPanel, NewPanel, or DuplicatePanel functions.

If you pass 0, the toolbar is created as a floating toolbar. To attach the toolbar programmatically, call Toolbar_Attach. A user also can attach the toolbar to any panel that you have specified as a dock point with Toolbar_AddDockPoint.
originalToolbar ToolbarType The specifier for the toolbar to duplicate.

Obtain this handle from the Toolbar_New or Toolbar_Duplicate functions.
title const char * The title for the new toolbar. The title appears in the toolbar title bar when the toolbar is undocked.

LabWindows/CVI also uses the title to identify the toolbar when you call the Toolbar_SaveStates and Toolbar_LoadStates functions.
top integer The vertical coordinate at which the upper left corner of the toolbar is placed. The coordinate must be an integer value from –32768 to 32767.

top applies to all toolbars on the panel if destParentPanel is nonzero. If destParentPanel is zero, this parameter is a global coordinate.

Pass 0 to allow LabWindows/CVI to place the toolbar in an appropriate location.
left integer The horizontal coordinate at which the upper left corner of the toolbar is placed. The coordinate must be an integer value from –32768 to 32767.

left applies to all toolbars on the panel if destParentPanel is nonzero. If destParentPanel is zero, this parameter is a global coordinate.

Pass 0 to allow LabWindows/CVI to place the toolbar in an appropriate location.
Output
Name Type Description
newToolbar ToolbarType * Returns the new toolbar.

Return Value

Name Type Description
status integer Return value indicating whether the function was successful. A negative number indicates that an error occurred.