DevExpress10.1中文教程：1

在使用Dev的过程中发现，Dev的资料好少，为此，在此过程中将其官方文档进行翻译，一是增强对Dev的理解，提升运用技巧，二是为了给大家提供一些参考。

                             欢迎指出翻译中存在的错误。有则改之无则加勉。

一、XtraBars

1、Bars Library

1.1 Fundamentals

1.1.1、Bar Manager

     如果想在窗体或用户控件（user control)上添加工具条（bars）或弹出菜单（popup menus），我们需要把一个不可见的组件（component）BarManager拖放到这个窗体或用户控件上。这个组件维护工具条在窗体上的布局，处理用户的行为（processes an end-user's actions），提供一些定制功能等等。这个组件维护工具条、工具条项、工具条项目录这三者的集合（It maintains the collections of bars,bar items and bar item categories.)。所以我们可以使用bar manager的一些方法去添加、删除、访问这些工具条元素。

     注意：1）一个窗体上只能放置一个bar manager组件。

               2）由于BarManager组件与RibbonControl组件可能会彼此冲突，所以不推荐在同一个窗体或用户 

                      控件上同时使用工具条和Ribbon控件。

       当把BarManager添加到一个窗体或用户控件上后，我们就可以使用上下文菜单（context menus)、bar manager的定制窗口或它的设计器来创建工具条和工具条命令（bar commands)了。

1.1.2、Toolbars

       工具条是一个可视的组件，它用来显示各个项目链接（item links)。工具条可以停靠在容器的任意边缘，也可以浮动停靠。当工具条停靠在容器的边缘时，它实际上是停靠在一个bar dock control上,而这个bar dock control停靠在这个边缘。当没有工具条停靠在bar dock control上时，bar dock control会隐藏起来。

        我们可以在工具条内显示由XtraBars库提供的任意项目链接，比如：按钮（buttons),静态文本（static text)，子菜单（submenu)、编辑器（editors)等等。

1.1.3、Items and Links

1.1.3.1 Bar Items

    为了把多种元素（比如按钮，子菜单，标签，编辑器等）添加到工具条和菜单，我们需要创建合适的bar items。一个bar item是一个实现了特定功能的非可见对象。它定义了一个相应的元素如何显示在屏幕上，并决定了对鼠标单击事件的相应。

    我们可以使用bar manager的Customization窗体上的Commands页来创建bar items。为了在逻辑上组织这些item，我们经常将它们分类。该窗体的左侧面板里显示了有效的（available）目录，右侧面板显示了属于当前选中目录的各个bar item。选中一个bar item可以在属性窗口看到其属性。

1.1.3.2Bar Item Links

一个bar item是一个不可见的元素，因此我们需要为这个item创建一个link，以让它显示在屏幕上。一个item link仅仅定义了一个item的外观，而bar item定义了它的所有处理过程。我们可以为一个item创建多个link，但是这些link只是会激发同样的功能。例如，当创建一个可以调用open file dialog的“openfile“item 后，我们可以将它分别link到主菜单和工具栏。

如果Customization窗口是开着的，我们可以将bar items从这个窗体移动到一个工具条或一个子菜单。放下（dropping）这个item就会为它在这个bar或submenu里创建一个link。

bar item提供了控制它的link的默认外观的一些设置。它提供了一些指定默认标题、图形等的一些属性。

1.1.4、Popup Menus

    使用弹出菜单（popup menus),我们可以在控件上显示上下文选项或命令。弹出菜单是一个显示了特定项的窗体，用户可以选择这些项以执行相应的操作。使用PopupMenu组件就可以在我们的应用程序中使用弹出菜单。

   注意：

   在定制和使用popup menu之前，向窗体上添加一个bar manager并确保这个popup menu绑定了这个bar manager。默认情况下，在设计时（at design time)添加到窗体的弹出菜单会自动地寻找窗体内的bar manager,

如果找到的话，会通过PopupMenu.Manager属性将其绑定到bar manager。如果没有自动绑定到bar manager，那就通过PopupMenu.Manager属性手动绑定。

1.1.5、Categories

    XtraBars允许我们将bar items在逻辑上划分为不同的类别（categories）。每个类别都是一组item，并且每个item都只属于一个类别（category）。类别不会对该类的item附加任何约束，分类只是为了对item进行有组织的访问。

用BarManagerCategory类表示一个类别。我们通过BarManager.Categories集合来添加、移除、存取类别。使用BarItem.Category属性，我们可以为每个item分配一个类别。

1.1.6、Bar Dock Controls

   工具条停放控件（bar dock controls）是工具条（toolbar）的容器，它们位于窗体或用户控件内用以容纳工具条对象。有regular和standalone两种工具条停放控件。

       regular bar dock controls是由BarManager自动维护的，我们不用手动去创建它们。它们停靠在容器（比如窗体）的任意一边，以显示工具条。

       standalone bar dock control用来在窗体内的任何位置显示工具条。我们需要手动创建和放置它们。

1.1.6.1 Regular Bar Dock Controls

       当工具条停靠于容器（比如form)的任意一边时，regular bar dock controls将工具条的停靠位置显示出来。当创建 Bar Manager时，它会自动创建4个regular dock controls,并将它们停靠在窗体的相应边缘。

       只有当一个工具条停放在一个dock control上时，这个dock  control才是可见的。其他情况下，dock  control的宽度都是0。当将工具条拖动到窗体的任意一边时，相应的dock controls会容纳并显示这个工具条。Bar.CanDockStyle属性可以指定工具条的可能停放位置。

       一般情况下，在应用程序中是没有必要去改变regular dock controls的属性的。除非我们想要为停靠的工具条提供背景设置。Bar Manager会自动创建名为barDockControl1...barDockControl4的4个dock controls。每个dock control都是一个BarDockControl类。在设计时，我们通过在属性窗口选择相应的对象来访问dock control。此外，如果dock control是可见的，并且没有完全被工具条覆盖，我们可以单击选中它，以在属性窗口中显示它。

1.1.6.2 Standalone Bar Dock Controls

    Standalone bar dock controls允许工具条停靠在窗体或用户控件上的任意位置，而不仅仅是窗体的边缘。创建一个StandaloneBarDockControl对象并且将工具条添加到其上就能做到这种效果。

   像regular control一样，standalone bar dock controls可以在窗体或用户控件中随意放置。它们的Dock、Location和Size属性用来指定布局设置。StandaloneBarDockControl.AutoSize属性用来启用自动调整大小模式。在这种模式下，当向该控件添加或删除工具条时，该控件的大小是自动变化的。

    使用Standalone bar dock controls的前提是该窗体或用户控件上已添加了BarManager组件。如果我们以编码的方式创建了StandaloneBarDockControl对象，那么我们就需要手动将其添加到BarManager的BarManager.DockControls集合中。

1.1.6.3Appearance Settings

dock control的Appearance属性提供了风格设置（style setting）用来绘制dock control。默认情况下，dock  control风格属性是未初始化的，它的外观设置（appearance setting）来自BarAndDockingController。如果你设置了dock control的Appearance对象的style属性，那么这个值就用来绘制这个dock control。

    为了使窗体中的dock controls风格一致，我们就可以不初始化dock control的appearance属性而是使用BarAndDockingController来为dock controls提供默认的风格设置。