harmony 鸿蒙ToolBarItem

ToolBarItem

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

说明：

该组件从API version 20开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。

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

仅可包含单个子组件。

ToolBarItem(options?: ToolBarItemOptions)

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

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

参数：

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

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

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

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

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

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

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