WPF AvalonDock拖拽布局学习整理

article/2025/9/24 23:25:38

AvalonDock提供了一个系统,允许开发人员使用类似于许多流行的集成开发环境(IDE)中的窗口对接系统来创建可自定义的布局。

AvalonDock遵循MVVM设计。ModelXceed.Wpf.AvalonDock.Layout命名空间中包含的类表示。此命名空间中的类是布局模型中的布局元素(例如LayoutAnchorable / LayoutDocumentLayoutAnchorablePane / LayoutDocumentPaneLayoutAnchorablePaneGroup / LayoutDocumentPaneGroup等),它们直接在DockingManager中的XAML中使用,以描述布局的组成方式。

  • DockingManager
  • 布局模型类

https://github.com/xceedsoftware/wpftoolkit/wiki/AvalonDock_avalondock.jpg

以下示例显示如何在DockingManager中设置各种布局元素。

<local:DemoView x:Class="LiveExplorer.Samples.AvalonDock.Views.AvalonDockView"

                 xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"

                 xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"

                 xmlns:local="clr-namespace:LiveExplorer"

                 xmlns:xctk="http://schemas.xceed.com/wpf/xaml/toolkit"

                 xmlns:xcad="http://schemas.xceed.com/wpf/xaml/avalondock"

                 xmlns:s="clr-namespace:System;assembly=mscorlib">

   <Grid>

      <Grid.RowDefinitions>

         <RowDefinition Height="Auto" />

         <RowDefinition Height="*" />

      </Grid.RowDefinitions>

 

      <StackPanel Orientation="Horizontal" Margin="0,0,0,10">

         <TextBlock Text="Theme:" Margin="0,0,10,0" VerticalAlignment="Center"/>

         <ComboBox x:Name="_themeCombo" SelectedIndex="0" Width="200">

            <ComboBoxItem Content="Generic" />

            <ComboBoxItem Content="Aero">

               <ComboBoxItem.Tag>

                  <xcad:AeroTheme />

               </ComboBoxItem.Tag>

            </ComboBoxItem>

            <ComboBoxItem Content="VS2010">

               <ComboBoxItem.Tag>

                  <xcad:VS2010Theme />

               </ComboBoxItem.Tag>

            </ComboBoxItem>

            <ComboBoxItem Content="Metro">

               <ComboBoxItem.Tag>

                  <xcad:MetroTheme />

               </ComboBoxItem.Tag>

            </ComboBoxItem>

         </ComboBox>

      </StackPanel>

 

      <xcad:DockingManager Grid.Row="1" MaxHeight="425"

                           AllowMixedOrientation="True"

                           BorderBrush="Black"

                           BorderThickness="1"

                           Theme="{Binding ElementName=_themeCombo, Path=SelectedItem.Tag}">

         <xcad:DockingManager.DocumentHeaderTemplate>

            <DataTemplate>

               <StackPanel Orientation="Horizontal">

                  <Image Source="{Binding IconSource}" Margin="0,0,4,0"/>

                  <TextBlock Text="{Binding Title}" />

               </StackPanel>

            </DataTemplate>

         </xcad:DockingManager.DocumentHeaderTemplate>

         <xcad:LayoutRoot x:Name="_layoutRoot">

            <xcad:LayoutPanel Orientation="Horizontal">

               <xcad:LayoutAnchorablePane DockWidth="200">

                  <xcad:LayoutAnchorable ContentId="properties" Title="Properties" CanHide="False" CanClose="False"

                                            AutoHideWidth="240"

                                         IconSource="../Images/property-blue.png">

                     <xctk:PropertyGrid NameColumnWidth="110"

                        SelectedObject="{Binding ElementName=_layoutRoot, Path=LastFocusedDocument.Content}"/>

                  </xcad:LayoutAnchorable>

               </xcad:LayoutAnchorablePane>

               <xcad:LayoutDocumentPaneGroup >

                  <xcad:LayoutDocumentPane>

                     <xcad:LayoutDocument ContentId="document1" Title="Document 1" IconSource="../Images/document.png" >

                           <Button Content="Document 1 Content" HorizontalAlignment="Center" VerticalAlignment="Center"/>

                     </xcad:LayoutDocument>

                     <xcad:LayoutDocument ContentId="document2" Title="Document 2" IconSource="../Images/document.png">

                        <TextBox Text="Document 2 Content" AcceptsReturn="True"/>

                     </xcad:LayoutDocument>

                  </xcad:LayoutDocumentPane>

               </xcad:LayoutDocumentPaneGroup >

               <xcad:LayoutAnchorablePaneGroup DockWidth="125">

                  <xcad:LayoutAnchorablePane>

                     <xcad:LayoutAnchorable ContentId="alarms" Title="Alarms" IconSource="../Images/alarm-clock-blue.png" >

                        <ListBox>

                           <s:String>Alarm 1</s:String>

                           <s:String>Alarm 2</s:String>

                           <s:String>Alarm 3</s:String>

                        </ListBox>

                     </xcad:LayoutAnchorable>

                     <xcad:LayoutAnchorable ContentId="journal" Title="Journal" >

                        <RichTextBox>

                           <FlowDocument>

                              <Paragraph FontSize="14" FontFamily="Segoe">

                                 This is the content of the Journal Pane.

                                 <LineBreak/>

                                 A

                                 <Bold>RichTextBox</Bold> has been added here

                              </Paragraph>

                           </FlowDocument>

                        </RichTextBox>

                     </xcad:LayoutAnchorable>

                  </xcad:LayoutAnchorablePane>

               </xcad:LayoutAnchorablePaneGroup>

            </xcad:LayoutPanel>

 

            <xcad:LayoutRoot.LeftSide>

               <xcad:LayoutAnchorSide>

                  <xcad:LayoutAnchorGroup>

                     <xcad:LayoutAnchorable Title="Agenda" ContentId="agenda" IconSource="../Images/address-book-open.png">

                        <TextBlock Text="Agenda Content" Margin="10" FontSize="18" FontWeight="Black" TextWrapping="Wrap"/>

                     </xcad:LayoutAnchorable>

                     <xcad:LayoutAnchorable Title="Contacts" ContentId="contacts" IconSource="../Images/address-book--pencil.png" >

                        <TextBlock Text="Contacts Content" Margin="10" FontSize="18" FontWeight="Black" TextWrapping="Wrap"/>

                     </xcad:LayoutAnchorable>

                  </xcad:LayoutAnchorGroup>

               </xcad:LayoutAnchorSide>

            </xcad:LayoutRoot.LeftSide>

         </xcad:LayoutRoot>

      </xcad:DockingManager>

   </Grid>

</local:DemoView>

该视图由Xceed.Wpf.AvalonDock.Controls命名空间中包含的类表示这些类是一组可显示用户控件的可调节控件。视图控件的名称通常以“Control”结尾,并对应于布局模型类(例如,LayoutAnchorableControl是与LayoutAnchorable对应的视图控件,它是模型元素)。

DockingManager包含在Xceed.Wpf.AvalonDock命名空间中,它使用各种类(例如LayoutItem及其派生类)来执行ViewModel的角色,准备视图使用的模型。

只有一个逻辑树,以DockingManager为根。即使控件放在不同的窗口(即自动隐藏窗口或浮动窗口)中,它也始终属于DockingManager下面的同一逻辑树。

DockingManager

DockingManager类是AvalonDock的核心控制。其Layout属性包含由Xceed.Wpf.AvalonDock.Layout命名空间中的类表示的布局组合。该类安排它包含的窗格,并处理自动隐藏窗口和浮动窗口(窗格又直接或间接包含两种类型的内容元素,即LayoutAnchorableLayoutDocument元素)。DockingManager类还处理保存和恢复布局。

在其他属性中,该类提供了几个模板属性(例如,AnchorableTitleTemplate / DocumentTitleTemplateAnchorableHeaderTemplate / DocumentHeaderTemplate等),允许设计人员和开发人员为布局中包含的元素指定模板。

布局模型类

布局元素类在DockingManagerLayout属性中保存的布局模型中使用。AvalonDock中包含基本内容的类是LayoutAnchorableLayoutDocument ; 这两个类都派生自LayoutContent类,它确定元素是否可以关闭,浮动(被拖动并转换为浮动窗口)等。

可锚定通常是应用程序控件的容器,可以从其容器窗格(LayoutAnchorablePane)拖出并重新定位到另一个窗格中。Anchobles总是包含在窗格中,可以是LayoutAnchorablePaneLayoutDocumentPane而文档(类LayoutDocument)只能包含在LayoutDocumentPane中。Anchobles也可以拖动到父DockingManager的边框,这使它们出现在所有其他anchorables或文档的上方,下方,左侧或右侧(自动隐藏窗口除外;请参阅下面的LayoutAnchorSide / LayoutAnchorGroup部分)详情)。Anchorables也可以保持浮动状态(LayoutAnchorableFloatingWindow)。与文档不同,anchorables可以自动隐藏,其内容会折叠到停靠管理器的一侧,并且仅由选项卡表示(请参阅LayoutAnchorSideLayoutAnchorGroup)。

文档(LayoutDocument类)只能在LayoutDocumentPane中托管。这与LayoutAnchorable的行为形成对比,LayoutAnchorable可以在LayoutDocumentPaneLayoutAnchorablePane中托管。此外,与anchorables不同,文档无法锚定到DockingManager边框,也无法自动隐藏:它们只能放置在LayoutDocumentPane中或浮动在LayoutDocumentFloatingWindow中。

LayoutAnchorableFloatingWindowLayoutDocumentFloatingWindow当最终用户通过拖动DockingManager一个锚固被自动创建。也可以使用Float方法以编程方式创建浮动窗口。

LayoutContent派生元素(LayoutAnchorableLayoutDocument)通常按Tab键控件排列。LayoutAnchorablePane可以设置为自动隐藏,可以作为浮动窗口拖过DockingManagerLayoutAnchorablePane也可以锚定到父DockingManager的边框(有关详细信息,请参阅LayoutAnchorSide)。

LayoutAnchorablePane不同,LayoutDocumentPane不能设置为自动隐藏或作为浮动窗口拖动DockingManager(尽管可以浮动单个LayoutDocument元素)。LayoutDocumentPane也无法锚定到父DockingManager的边框。

LayoutPanel也可以包含窗格基元件(即,LayoutAnchorablePaneGroupLayoutDocumentPaneGroup),哪个组子窗格在一起并允许确定各种特征,例如停靠组占据的初始宽度/高度,从它们拖动的内容创建的浮动窗口的初始宽度/高度,以及窗格中的窗格的方向。组(与LayoutPanel的方向无关)。LayoutAnchorablePaneGroup表示布局模型中的一个元素,它可以包含和排列多个LayoutAnchorablePane元素,而这些元素又包含LayoutAnchorable元素。LayoutDocumentPaneGroup表示布局模型中的一个元素,它可以包含和组织多个LayoutDocumentPane元素,这些元素又包含LayoutDocument元素。窗格组类主要用于确定它们包含的窗格的方向。

LayoutRoot表示布局模型的根。DockingManagerLayout属性设置为此类的实例。

LayoutRoot类的RootPanel属性设置为LayoutPanel类的实例。

LayoutPanel可以直接包含子窗格(即LayoutAnchorablePaneLayoutDocumentPane)。窗格又包含实际内容(即LayoutAnchorableLayoutDocument元素,两者都派生自LayoutContent)。LayoutPanel还可以包含窗格组实例(即LayoutAnchorablePaneGroupLayoutDocumentPaneGroup),它将子窗格组合在一起并允许确定各种特征,例如停靠组占用的初始宽度/高度,浮动的初始宽度/高度从根据它们拖动的内容创建的窗口,以及组中窗格的方向(与LayoutPanel的方向无关)。

LayoutRoot类提供四个“Side”属性(例如,LeftSide),它们与LayoutAnchorSideLayoutAnchorGroup类一起使用,以沿着包含DockingManager的边框设置自动隐藏LayoutAnchorable元素。这些元素最初折叠到它们所锚定的一侧,仅显示一个选项卡,“pin”字形指向左侧。如果单击自动隐藏可固定的图钉字符使得销钉朝下,则可锚定不再保持可见。只能自动隐藏LayoutAnchorable元素。

LayoutAnchorGroup表示一个或多个LayoutAnchorable元素的自动隐藏组,可以将其锚定到DockingManager的四个边之一。要使用LayoutAnchorGroup,请向其添加LayoutAnchorable元素,并将生成的LayoutAnchorGroup添加到LayoutAnchorSide的实例。然后将生成的LayoutAnchorSide分配给DockingManagerLayout属性中保存的LayoutRoot对象的“Side”属性(例如,LeftSideTopSide)。

LayoutAnchorSide表示DockingManager“side”。若要使用LayoutAnchorSide,请将LayoutAnchorable元素添加到LayoutAnchorGroup,并将生成的LayoutAnchorGroup添加到LayoutAnchorSide的实例。然后将生成的LayoutAnchorSide分配给DockingManagerLayout属性中保存的LayoutRoot对象的“Side”属性(例如,LeftSideTopSide)。

注意:您可以在此处找到API的完整文档。见活资源管理器,用于演示这个类的功能和其他源代码的应用在这里

 


http://chatgpt.dhexx.cn/article/8pROVm6A.shtml

相关文章

WPFAvalonDock基本用法

本文简单介绍AvalonDock2.0基本用法&#xff0c;下载AvalonDock 2.0dll及主题http://avalondock.codeplex.com/ AvalonDock基本类介绍 DockingManager:停靠管理类&#xff0c;xaml中AvalonDock的根节点 LayoutRoot:布局根节点&#xff0c;有四个属性LeftSide,RightSide,TopS…

AvalonDock的基本用法

AvalonDock是优秀的开源项目&#xff0c;用于创建可停靠式布局&#xff0c;能够在WPF中方便开发出类似VS2010的软件界面。对于复杂的软件系统&#xff0c;大量控件的使用会使的界面变得难以管理。AvalonDock帮我们解决了这一问题。想要在WPF项目中使用AvalonDock的功能&#xf…

WPF随笔(十)--使用AvalonDock实现可停靠式布局

我们每天使用的许多软件都使用了可停靠式布局&#xff0c;可以方便的打开、关闭、收起、展开、移动选项卡。今天就来说明如何使用AvalonDock实现这种可停靠式布局。 AvalonDock安装 最新版本的AvalonDock类库包含在程序包Extended.Wpf.Toolkit中&#xff0c;属于Xceed旗下的一…

WPF AvalonDock 常用功能使用

AvalonDock是什么&#xff1f; AvalonDock是一个开源项目【GitHub - Dirkster99/AvalonDock: Our own development branch of the well known WPF document docking libraryGitHub - Dirkster99/AvalonDock: Our own development branch of the well known WPF docume…

WPF 第三方控件学习使用——可停靠布局控件(AvalonDock)

需求 近期在做公司上位机产品规划与实验&#xff0c;参考了Blender软件的布局风格&#xff0c;希望能用WPF也做一个类似布局的上位机。于是开始寻找资源&#xff0c;很快就发现了AvalonDock。 AvalonDock简介 AvalonDock是Xceed公司 Wpf.Toolkit 中的一款收费产品&#xff0…

wpf-AvalonDock基础-安装和更换主题

2022/7/29更新&#xff1a;去掉标题行的钉子 在LayoutAnchorable上添加属性&#xff1a; CanAutoHide"False" CanClose"False"如果要去掉X&#xff0c;再添加 CanHide"False"最近对wpf的多窗口排列问题深感头疼&#xff0c;算尺寸、位置太麻烦…

AvalonDock使用(1)-基本用法

AvalonDock的基本用法 介绍AvalonDock库中的基本类DockingManager&#xff1a;停靠管理器类LayoutRoot : 布局根节点类LayoutPanel&#xff1a;布局面板类LayoutAnchorablePane&#xff1a;可停靠窗格类LayoutAnchorable:可停靠内容类 LayoutDocumentPane:文档窗格类LayoutDocu…

十进制-75在计算机中,十进制数75转换成二进制数是多少?

75转换成二进制是&#xff1a;1001011。 75/237......1 37/218......1 18/29.........0 9/24...........1 4/22...........0 2/21...........0 从下往上读余数&#xff0c;就是整数部分的案1001011。拓展资料&#xff1a; 十进制整数转换为二进制整数方法&#xff1a; 十进制整…

二进制数的算术运算

2&#xff0c; 二进制数的算术运算 2.1 二进制数的算术运算 二进制数的算术运算包括加法、减法、乘法和除法。 1)加法运算 加法进位规则:逢二进一。 加法运算法则: 000 01101 1110(向高位进位) 例:(1101)2(1011)2?&#xff0c;解算如下: 从执行加法的过程可知&…

二进制数与十进制数的相互转换、二进制数的乘除运算、移位运算

二进制数与十进制数的转换 聊二进制数的运算前&#xff0c;我们先看看二进制数的值与十进制数的值是如何相互转换的&#xff0c; 十进制转换成二进制 将十进制数除以2&#xff0c;得到的商再除以2&#xff0c;依次类推直到商为1时为止&#xff0c;然后在旁边标出各步的余数&am…

计算机组成原理 二进制数的运算

1、算数运算 &#xff08;1&#xff09;加法运算 二进制加法法则为&#xff1a; 000 10011 110&#xff08;向邻近高位有进位&#xff09; 1111&#xff08;向邻近高位有进位&#xff09; &#xff08;2&#xff09;减法运算 二进制减法法则为&#xff1a; 0-00 1-10 1-01 0-1…

将输入的十进制数转换成二进制数

软件&#xff1a;DEV&#xff0c;语言&#xff1a;C语言。 声明&#xff1a;本案例只考虑了整数&#xff08;即int型&#xff09;&#xff0c;故无法进行小数之间的转换&#xff08;例如float型&#xff0c;double型&#xff09;。 十进制整数转换为二进制整数采用"除2取…

二进制数表示法

二进制数表示法 二进制数是数字电路中应用最广泛的一种数值表示方法&#xff0c;在逻辑代数中也经常使用。 1、十进制数 在这种计数进位制中&#xff0c;每一位用0~9十个数字来表示&#xff0c;所以计数基数是十。超过9的数则需用多位数表示&#xff0c;其中低位数和相邻高位…

c语言程序10进制转2进制,C语言十进制数转换为二进制数

这是一个C语言 do while 循环示例:统计十进制正整数 n 转换为二进制数后,其二进制序列中包含的 1 和 0 的个数。 问题分析 输入:一个正整数。 输出:两个整数:1 的个数和 0 的个数。 将十进制数 n 转换成二进制数,一般采用“除 2 取余,倒序输出”的方法。 本题只是统计转…

二进制转十进制c++语言数组,C++实现读入二进制数并转换为十进制输出

C++实现读入二进制数并转换为十进制输出 题目描述 已知一个只包含0和1的二进制数,长度不大于10,将其转换为十进制并输出。 输入描述 输入一个二进制整数n,其长度不大于10 输出描述 输出转换后的十进制数,占一行 样例输入 110 样例输出 6 solution: 很多学过C初学C++的人可…

二进制数的加法步骤解析

文章目录 位运算二进制数加法步骤例子代码演示 二进制的加法需要用到位运算&#xff0c;所以先来复习下位运算。 位运算 运算符号(java)描述位与&都为1&#xff0c;结果为1&#xff0c;否则为0。位或|有一个为1或两个位都为1&#xff0c;则结果为1&#xff0c;否则为0。换…

二进制数及其运算

计算机的底层都是使用二进制数据进行数据流传输的&#xff0c;那么为什么会使用二进制表示计算机呢&#xff1f;什么是二进制数呢&#xff1f;如何使用二进制进行加减乘除&#xff1f;二进制数如何表示负数呢&#xff1f;本文将为你揭晓。 为什么用二进制表示 计算机内部是由I…

二进制数的运算

文章目录 前言一、加法运算规则二、减法运算规则三、乘法运算规则四、除法运算规则五、逻辑或运算规则六、逻辑与运算规则七、逻辑非运算规则八、逻辑异或运算规则 前言 此篇文章仅介绍二进制数的运算&#xff0c;不涉及其他进制的运算 一、加法运算规则 000 011 101 110 &…

什么是二进制数?二进制数是如何表示计算机信息的?

二进制是什么&#xff1f; 想要了解二进制数是如何表示计算机信息的&#xff1f;先要追本溯源&#xff0c; 二进制&#xff08;binary&#xff09;在数学和数字电路中指以2为基数的记数系统&#xff0c;以2为基数代表系统是二进位制的。这一系统中&#xff0c;通常用两个不同的…

二进制

博客引用处&#xff08;以下内容在原有博客基础上进行补充或更改&#xff0c;谢谢这些大牛的博客指导&#xff09;&#xff1a; 二进制 二进制和十进制间小数怎么转换 二进制进位 前言&#xff1a; 二进制是计算技术中广泛采用的一种数制。二进制数据是用0和1两个数码来表示的…