# Toolbar

The **Toolbar** object represents a toolbar. **Toolbar** objects can represent a specific instance of a toolbar (open in a specific Lister), and can also represent the toolbar itself, on disk, that doesn't have to currently be open at all.

* When retrieved from the [**Toolbars**](toolbars) object (which in turn comes from the [**DOpus**](dopus)**.Toolbars** method), the object represents a toolbar on disk. You can find out where it is currently in use from its properties.
* When retrieved from the [**Lister**](lister)**.toolbars** property, it represents an instance of a toolbar in that particular Lister.

| Property Name      | Return Type                       | Description                                                                                                                                                                                                                                                                                       |
| ------------------ | --------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| _\<default value>_ | _string_                          | Returns the name of the toolbar.                                                                                                                                                                                                                                                                  |
| deftoolbar         | _bool_                            | <p>Returns <strong>True</strong> if this is a default (factory-provided) toolbar, or <strong>False</strong> if it was user-created.<br>(Old scripts may use "default" instead of "deftoolbar"; this is deprecated because it does not work in JScript where "default" is a reserved keyword.)</p> |
| listers            | _collection:_[**Lister**](lister) | Returns a collection of [**Lister**](lister) objects representing any and all Listers this toolbar is currently open in.                                                                                                                                                                          |
| docks              | _collection:_[**Dock**](dock)     | Returns a collection of [**Dock**](dock) objects representing any currently floating instances of this toolbar.                                                                                                                                                                                   |
| group              | _string_                          | Returns a _string_ indicating the group (position) of a particular instance of this toolbar. The returned string will be one of _top_, _bottom_, _left_, _right_, _center_, _fdright_, _fdbottom_, _tree_.                                                                                        |
| line               | _int_                             | Returns the line number within the toolbar's group that it resides on. For example, the first toolbar at the top of the Lister would have a line of 0.                                                                                                                                            |
| pos                | _int_                             | Returns the pixel position from the left/top of the toolbar's line. If there are two or more toolbars with the same **line** number, the **pos** value determines the order they appear in.                                                                                                       |
