MATLAB Function Reference

uitoolbar

Create toolbar on a figure

Syntax

• ht = uitoolbar('PropertyName1',value1,'PropertyName2',value2,...)
  

ht = uitoolbar(h,...)

Description

ht = uitoolbar('PropertyName1',value1,'PropertyName2',value2,...) creates an empty toolbar at the top of the current figure window, and returns a handle to it. uitoolbar assigns the specified property values, and assigns default values to the remaining properties. You can change the property values at a later time using the set function.

Type get(ht) to see a list of uitoolbar object properties and their current values. Type set(ht) to see a list of uitoolbar object properties that you can set and legal property values. See the Uitoolbar Properties reference page for more information.

ht = uitoolbar(h,...) creates a toolbar with h as a parent. h must be a figure handle.

Remarks

uitoolbar accepts property name/property value pairs, as well as structures and cell arrays of properties as input arguments.

Uitoolbars appear in figures whose WindowStyle is normal or docked. They do not appear in figures whose WindowStyle is modal. If a figure containing a uitoolbar is changed to WindowStyle modal, the uitoolbar still exists and is contained in the Children list of the figure, but is not displayed until the WindowStyle is changed to normal or docked.

Properties

This table lists all properties useful to uitoolbar objects, grouping them by function. Each property name acts as a link to a more detailed description of the property.

Property Name	Property Description	Property Value
Controlling Style and Appearance
Visible	Uitoolbar visibility	Value: on, off Default: on
General Information About the Object
BeingDeleted	This object is being deleted	Value: on, off (read-only) Default: off
Children	Uitoolbar object's uipushtool and uitoggletool children	Value: vector of handles
Parent	Uitoolbar object's parent figure.	Value: handle
Tag	User-specified object identifier	Value: string
Type	Class of graphics object	Value: string (read-only) Default: uitoolbar
UserData	User-specified data	Value: array
Controlling Callback Routine Execution
BusyAction	Interruption of other callback routines	Value: cancel, queue Default: queue
CreateFcn	Callback routine executed during object creation	Value: string or function handle
DeleteFcn	Callback routine executed during object deletion	Value: string or function handle
Interruptible	Callback routine interruption mode	Value: on, off Default: on
Controlling Access to Objects
HandleVisibility	Handle accessibility from command line and code associated with the GUIs.	Value: on, callback, off Default: on

Example

This example creates a figure with no toolbar, then adds a toolbar to it.

• h = figure('ToolBar','none')
  ht = uitoolbar(h)
  
  
  

See Also

set, get, uicontrol, uipushtool, uitoggletool

Uitoggletool Properties

Uitoolbar Properties

© 1994-2005 The MathWorks, Inc.