# ToolBarItem

通过toolbar通用属性为窗口标题栏添加工具栏项。

*   该组件从API version 20开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。
    
*   本模块接口仅可在Stage模型下使用。
    

该组件一般配合toolbar通用属性进行使用。

#### 子组件

仅可包含单个子组件。

#### 接口

#### ToolBarItem

ToolBarItem(options?: ToolBarItemOptions)

默认在标题栏对应分栏开头位置创建工具栏项，分栏位置由绑定该toolbar属性的组件所在分栏位置而定。

**系统能力：** SystemCapability.ArkUI.ArkUI.Full

**参数：**

| 参数名 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| options | ToolBarItemOptions | 否 | 为ToolBarItem提供可选参数，该对象内含有ToolBarItemPlacement枚举类型的placement参数。 默认值：placement: ToolBarItemPlacement.TOP_BAR_LEADING |

#### 属性

不支持通用属性。

#### ToolBarItemOptions对象说明

用于配置ToolBarItem的可选参数，主要通过placement设置工具栏项在标题栏的放置位置。

**系统能力：** SystemCapability.ArkUI.ArkUI.Full

| 名称 | 类型 | 只读 | 可选 | 说明 |
| --- | --- | --- | --- | --- |
| placement | ToolBarItemPlacement | 否 | 是 | 设置工具栏项的放置位置。 默认值: ToolBarItemPlacement.TOP_BAR_LEADING 设置为ToolBarItemPlacement.TOP_BAR_LEADING时，将工具栏项放置在对应顶部栏的开头位置。 设置为ToolBarItemPlacement.TOP_BAR_TRAILING时，将工具栏项放置在对应顶部栏的末尾位置。 |

#### ToolBarItemPlacement枚举说明

定义工具栏项在标题栏对应分栏的放置位置选项。

**系统能力：** SystemCapability.ArkUI.ArkUI.Full

| 名称 | 值 | 说明 |
| --- | --- | --- |
| TOP_BAR_LEADING | 0 | 表示将工具栏项放置在对应顶部栏的开头位置。 |
| TOP_BAR_TRAILING | 1 | 表示将工具栏项放置在对应顶部栏的末尾位置。 |

#### 示例

示例代码参考toolbar。