WPF ToolBarTray控件的详细使用教程

ToolBarTray 是 WPF（Windows Presentation Foundation）中的一个控件，允许将多个 ToolBar 放置在一个可停靠的容器中。它能够帮助用户实现工具栏的灵活布局和管理。

下面是一份关于 ToolBarTray 控件的详细使用教程。

1. 基本介绍

ToolBarTray 是一个容器控件，主要用于包含和管理多个 ToolBar。它支持工具栏的自由停靠和排列，用户可以通过拖动工具栏在不同位置之间进行调整。

基本语法：

<ToolBarTray>
    <ToolBar>
        <!-- ToolBar中的内容 -->
    </ToolBar>
</ToolBarTray>

2. 示例演示

2.1 创建简单的 ToolBarTray 和 ToolBar

我们可以将多个 ToolBar 放置在 ToolBarTray 中，每个 ToolBar 可以包含按钮、文本框、菜单等常见的控件。

<Window x:Class="WpfApp.MainWindow"
        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        Title="ToolBarTray Example" Height="200" Width="400">
    <DockPanel>
        <!-- ToolBarTray -->
        <ToolBarTray DockPanel.Dock="Top">
            <!-- 第一个 ToolBar -->
            <ToolBar Header="File">
                <Button Content="New"/>
                <Button Content="Open"/>
                <Button Content="Save"/>
            </ToolBar>

            <!-- 第二个 ToolBar -->
            <ToolBar Header="Edit">
                <Button Content="Cut"/>
                <Button Content="Copy"/>
                <Button Content="Paste"/>
            </ToolBar>
        </ToolBarTray>

        <!-- 主内容区 -->
        <TextBox VerticalScrollBarVisibility="Auto" TextWrapping="Wrap"/>
    </DockPanel>
</Window>

解释：

• ToolBarTray 中包含了两个 ToolBar，第一个 ToolBar 处理文件相关操作，第二个处理编辑操作。
• 每个 ToolBar 中可以添加按钮、下拉菜单或其他控件。

2.2 在 ToolBar 中使用其他控件

除了按钮，ToolBar 还支持放置其他控件，比如文本框、下拉列表等。

<ToolBar Header="Search">
    <Label Content="Search:"/>
    <TextBox Width="100"/>
    <Button Content="Go"/>
</ToolBar>

这里我们添加了一个 Label、一个 TextBox 和一个按钮，组合成了一个简单的搜索框。

2.3 ToolBarTray 的属性和布局

ToolBar 提供了许多属性来控制布局和行为。常用属性包括：

• IsLocked：是否锁定工具栏，防止用户拖动。
• Orientation：控制工具栏的方向，水平或垂直。

<ToolBarTray IsLocked="True" Orientation="Vertical">
    <ToolBar>
        <Button Content="Vertical Toolbar"/>
    </ToolBar>
</ToolBarTray>

2.4 ToolBarTray 的停靠功能

ToolBarTray 默认支持将工具栏拖动到不同的位置，用户可以自由拖动工具栏到顶部、底部、左侧或右侧。使用 DockPanel 可以控制 ToolBarTray 在窗口中的停靠位置。

<Window x:Class="WpfApp.MainWindow"
        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        Title="ToolBarTray Example" Height="200" Width="400">
    <DockPanel>
        <!-- ToolBarTray 在窗口顶部停靠 -->
        <ToolBarTray DockPanel.Dock="Top">
            <ToolBar Header="File">
                <Button Content="New"/>
                <Button Content="Open"/>
            </ToolBar>
        </ToolBarTray>

        <!-- ToolBarTray 在窗口底部停靠 -->
        <ToolBarTray DockPanel.Dock="Bottom">
            <ToolBar Header="Status">
                <Label Content="Ready"/>
            </ToolBar>
        </ToolBarTray>

        <!-- 主内容区 -->
        <TextBox VerticalScrollBarVisibility="Auto" TextWrapping="Wrap"/>
    </DockPanel>
</Window>

3. 常见属性和事件

3.1 ToolBarTray 的属性

• Background：设置背景颜色。
• Orientation：设置工具栏的排列方向（水平或垂直）。
• IsLocked：如果为 True，则工具栏将无法拖动。

3.2 ToolBar 的属性

• BandIndex：设置工具栏在哪一行显示。
• Band：设置工具栏在其所在行中的顺序。

3.3 事件

• ToolBarTray.Loaded：当 ToolBarTray 完全加载到界面时触发。
• ToolBar.Loaded：当 ToolBar 加载完成时触发。

4. 实际应用场景

ToolBarTray 通常用于包含多个工具栏的应用程序，如：

• 文本编辑器（如 Microsoft Word）
• 图像编辑器
• 开发工具（如 Visual Studio）

通过结合 ToolBar 与 ToolBarTray，可以创建复杂而灵活的用户界面，并支持工具栏的自定义和扩展。

5. 小结

• ToolBarTray 是一个容器，用于管理多个 ToolBar。
• ToolBar 可以包含按钮、菜单、文本框等控件，用户可以自由设计其布局。
• ToolBarTray 提供了用户友好的拖放体验，支持工具栏的动态布局调整。

通过使用 ToolBarTray 和 ToolBar，你可以创建出更加专业、功能齐全的 WPF 应用程序。