DevExpress_Winform_使用汇总
Navigation & Layout
Bar Manager 控件
如果想在窗体或用户控件（user control)上添加工具条（bars）或弹出菜单（popup menus），我们 需要把一个不可见的控件（component）BarManager（Navigation&Layout）拖放到这个窗体或用户控件上。这个控 件维护工具条在窗体上的布局，处理用户的行为（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)了。
相关控件属性
Toolbars控件
工具条是一个可视的控件，它用来显示各个项目链接。我们可以在工具条内显示由XtraBars库提供的任意项目链接，比如：按钮（buttons),静态文本（static text)，子菜单（submenu)、编辑器（editors)等等。
Bar Items控件
为了把多种元素（比如按钮，子菜单，标签，编辑器等）添加到工具条和菜单，我们需要创建合适的bar items。一个bar item是一个实现了特定功能的非可见对象。它定义了一个相应的元素如何显示在屏幕上，并决定了对鼠标单击事件的相应。
我们可以使用bar manager的Customize窗体上的Commands页来创建bar items。为 了在逻辑上组织这些item，我们经常将它们分类。该窗体的左侧面板里显示了有效的目录，右侧面板显示了属于当前选中目录的各个bar item。选中一 个bar item可以在属性窗口看到其属性。
Popup Menus控件
使用弹出菜单（popup menus),我们可以在控件上显示上下文选项或命令。弹出菜单是一个显示了特定项的窗体，用户可以选择这些项以执行相应的操作。使用PopupMenu控件就可以在我们的应用程序中使用弹出菜单。
通过BarManager的“名称”+“上的PopupContenxtMenu”属性绑定PopuMenus控件
注意：
在定制和使用popup menu之前，向窗体上添加一个bar manager并确保这个popup menu绑定 了这个bar manager。默认情况下，在设计时（at design time)添加到窗体的弹出菜单会自动地寻找窗体内的 bar manager,
如果找到的话，会通过PopupMenu.Manager属性将其绑定到bar manager。如果没有自动绑定到bar manager，那就通过PopupMenu.Manager属性手动绑定。
Categories控件
XtraBars允许我们将bar items在逻辑上划分为不同的类别（categories）。每个类别都是一 组item，并且每个item都只属于一个类别（category）。类别不会对该类的item附加任何约束，分类只是为了对item进行有组织的访问。
用BarManagerCategory类表示一个类别。我们通过BarManager.Categories集合来添加、移除、存取类别。使用BarItem.Category属性，我们可以为每个item分配一个类别。
Bar Dock Controls控件
工具条停放控件（bar dock controls）是工具条（toolbar）的容器，它们位于窗体或用户控件内用以容纳工具条对象。有regular和standalone两种工具条停放控件。
regular bar dock controls是由BarManager自动维护的，我们不用手动去创建它们。它们停靠在容器（比如窗体）的任意一边，以显示工具条。
BarManager中的StandaloneBarDockControl属性用来在窗体内的任何位置显示工具条。我们需要手动绑定StandaloneBarDockControl控件
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是可见的，并且没有完全被工具条覆盖，我们可以单击选中它，以在属性窗口中显示它。
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集合中。
Toolbars Customization
为了在窗体上创建bar和bar items，我们需要往窗体上添加一个BarManager控件。
creating bars and bar items on the form at design time
在设计时（at design time），当把BarManager添加到窗体上后，会自动创建三个空工具条，分别是：窗体顶部的主菜单栏、工具栏和窗体底部的状态栏。
主菜单栏通常是一个位于窗体顶部的工具条，其他的工具条不能和主菜单栏位于同一行。终端用户也不能关闭主菜单栏。默 认情况下，用户可以拖拽主菜单栏，将其停靠至窗体的任意边缘。主菜单栏被赋予至BarManager.MainMenu属性。状态栏通常是一个位于窗体底 部的工具条。用户不能拖动该工具条。BarManager.StatusBar属性赋值为该状态栏。在一个窗体上只有一个主菜单和一个状态栏。
默认情况下，工具条上有[Add]上下文链接（context links)。通过该链接，我们可以将bar items添加到工具条上。我们可以单击[Add]链接来激活bar item列表，然后从中选择需要的bar item。 选择一个item后，它即被添加到工具条上，同时文本编辑器也被激活。在此文本编辑器里我们可以编辑新添加项的名字。 按Enter键来结束编辑和该项的添加。 如果我们要添加一个子菜单（submenu），那么先选择sub-menu以添加菜单项，然后再次单击它，并通过[Add]添加新的bar item。 若想在设计时隐藏[Add]上下文链接，右击BarManager控件，然后勾去“show design time enhancements"选项即可。勾选这个选项，[Add]链接又会出现。
creating bars and bar items using the customization window
右击鼠标，使用BarManager的Customization窗口是向窗体添加工具条和bar items的另一种方式。
Manipulate Bars
切换到Customization窗口的Toolbars页，单击new，即可添加工具条。选择工具条列表中的一个，点击delete，即可删除该工具条。只有在运行时，Rename和Reset按钮才处于激活状态。
Adding Bar Items
切换到Commands页，点击modify按钮，然后选择Add菜单项，Add New BarItem对话框就会出现。在该对话框里，我们可以指定该项的分类、名字、标题（caption）等。当新的item创建后，我们就可以把它拖放到工具条上。
creating bars using the barmanager's designer
BarManager的设计器也是用来添加、删除、自定义设置工具条的一种方式。切换到Toolbars页，单击Add New Toolbar和Delete Toolbar按钮即可创建或删除工具条。
customizing items and links at design time
在设计时，当你选择一个链接（link),它就会在属性窗口中显示相应item的设置；
如果改变这个item的外观设置（appearance setting）就会影响到该item的所有属性没有显性设置的链接。为了避免对这些链接造成影响，我们可以这样做：
在设计时，右击这个链接，通过弹出的菜单来改变设置。
选项 描述
Reset 重置该链接的所有自定义设置。选中该选项后，这个链接的外观就会由相应item的外观设置控制。也可在代码中，调用BarItemLink.Reset方法以
将其恢复到默认值。
Delete 删除该链接。调用BarItemLink.Dispose方法也可达到该目的。
Change Caption 改变item 的标题。该值会应用于所有User caption没有设置的link。这个选项对应于BarItemLink.Caption属性。
change user 为某一link赋自定义标题，这样就覆盖了默认的item的标题。User caption只赋值于当前的link。该选项对应于BarItemLink.UserCaption。
caption
Default style 为某link设置默认的样式。每个link的的默认样式都可以是不同的。使用BarItemLink.PaintStyle属性来在代码里设置paint style.
Text only 项目链接（item link)被绘制为文本。
(always)
Text only item link 在菜单里被绘制为文本，在工具条里被绘制为图片。
(in menus)
Image and Text item link被绘制为图片和文本。
Begin a Group 在选中的link钱插入一分隔符，以将item links逻辑分组。该选项对应于BarItemLink.BeginGroup属性。
Visible 决定一个item link是否可见。该选项对应于BarItemLink.Visible属性。
Most recently 决定一个item是否指向最经常使用的link。勾选掉这个选项后，就会使该link位于最近使用项列表的底部。该选项对应用
used BarItemLink.MostRecentlyUsed属性。
How to obtain a value of the BarEditItem during editing
Object value=(barManager1.ActiveEditor as DevExpress.XtraEditors.ButtonEdit).EditValue;
RibbonControl
How to: Create a RibbonControl in Code
例1、
using DevExpress.XtraBars.Ribbon;
using DevExpress.XtraBars;
// Create a RibbonControl
RibbonControl RibbonControl = new RibbonControl();
this.Controls.Add(RibbonControl);
// Assign the image collection that will provide images for bar items.
RibbonControl.Images = imageCollection1;
// Create a Ribbon page.
RibbonPage page1 = new RibbonPage("Home");
// Create a Ribbon page group.
RibbonPageGroup group1 = new RibbonPageGroup("File");
// Create another Ribbon page group.
RibbonPageGroup group2 = new RibbonPageGroup("File 2");
// Create a button item using the CreateButton method.
// The created item is automatically added to the item collection of the RibbonControl.
BarButtonItem itemOpen = RibbonControl.Items.CreateButton("Open...");
itemOpen.ImageIndex = 7;
itemOpen.ItemClick += new ItemClickEventHandler(itemOpen_ItemClick);
// Create a button item using its constructor.
// The constructor automatically adds the created item to the RibbonControl's item collection.
BarButtonItem itemClose = new BarButtonItem(RibbonControl.Manager, "Close");
itemClose.ImageIndex = 12;
itemClose.ItemClick += new ItemClickEventHandler(itemClose_ItemClick);
// Create a button item using the default constructor.
BarButtonItem itemPrint = new BarButtonItem();
// Manually add the created item to the item collection of the RibbonControl.
RibbonControl.Items.Add(itemPrint);
itemPrint.Caption = "Print";
itemPrint.ImageIndex = 9;
itemPrint.ItemClick += new ItemClickEventHandler(itemPrint_ItemClick);
// Add the created items to the group using the AddRange method.
// This method will create bar item links for the items and then add the links to the group.
group1.ItemLinks.AddRange(new BarItem[] { itemOpen, itemClose, itemPrint});
// Add the Open bar item to the second group.
group2.ItemLinks.Add(itemOpen);
// Add the created groups to the page.
page1.Groups.Add(group1);
page1.Groups.Add(group2);
// Add the page to the RibbonControl.
RibbonControl.Pages.Add(page1); void itemPrint_ItemClick(object sender, ItemClickEventArgs e) {
//...
}
void itemClose_ItemClick(object sender, ItemClickEventArgs e) {
//...
}
void itemOpen_ItemClick(object sender, ItemClickEventArgs e) {
}
SplitContainerControl控件
1.切换Panel的Dock为Fill
属性FixedPanel
XtraTabControl控件
DevExpress.XtraTab.XtraTabControl
1.如何显示选中的页
ribbonControl1.SelectedPage = ribbonPage2;
2.动态添加page面板
首先是动态添加page面，并且在page页面上添加一个form窗体
DevExpress.XtraTab.XtraTabPage page = new DevExpress.XtraTab.XtraTabPage();//实例化一个XtraTabPage的页面
page.Name = "tab3";//定义name
page.Text = "新建标签";//定义要显示的text
Form2 fr = new Form2();//新窗体
fr.TopLevel = false;//这个挺重要的，没设置这个属性的话form窗体在就直接跳到在上层去了
fr.Show();//显示form插窗体
page.Controls.Add(fr);//在page页面添加一个控件，这里就是form窗体
this.xtraTabControl1.TabPages.Add(page);//最后把我们新建的page页面加到xtraTabControl控件中去
然后，有无意中在网上看到一个很简单的双击page页面，关闭page页面的方法，请看：
private void xtraTabControl1_DoubleClick(object sender, EventArgs e)
{//双击之后关闭选项页
xtraTabControl1.TabPages.Remove(this.xtraTabControl1.SelectedTabPage);
}
如何绑定ApplicationMenus和PopupMenu
通过ribbonControl上的PopuContextMenu进行绑定；
GalleryContral控件
控件可显示图像，同时让你将它们分类。
效果图：
例1：
using DevExpress.XtraBars.Ribbon;
using DevExpress.Utils;
using DevExpress.Utils.Drawing;
GalleryControl gc = new GalleryControl();
gc.Dock = DockStyle.Fill;
this.Controls.Add(gc);
Image im1 = Image.FromFile("c:\\Images\\BMW.jpg");
Image im2 = Image.FromFile("c:\\Images\\Ford.jpg");
Image im3 = Image.FromFile("c:\\Images\\MercedecBenz.jpg");
Image im4 = Image.FromFile("c:\\Images\\AnneDodsworth.jpg");
Image im5 = Image.FromFile("c:\\Images\\HannaMoos.jpg");
Image im6 = Image.FromFile("c:\\Images\\JanetLeverling.jpg");
gc.Gallery.ItemImageLayout = ImageLayoutMode.ZoomInside;
gc.Gallery.ImageSize = new Size(120, 90);
gc.Gallery.ShowItemText = true;
GalleryItemGroup group1 = new GalleryItemGroup();
group1.Caption = "Cars";
gc.Gallery.Groups.Add(group1);
GalleryItemGroup group2 = new GalleryItemGroup();
group2.Caption = "People";
gc.Gallery.Groups.Add(group2);
group1.Items.Add(new GalleryItem(im1, "BMW", ""));
group1.Items.Add(new GalleryItem(im2, "Ford", ""));
group1.Items.Add(new GalleryItem(im3, "Mercedec-Benz", ""));
group2.Items.Add(new GalleryItem(im4, "Anne Dodsworth", ""));
group2.Items.Add(new GalleryItem(im5, "Hanna Moos", ""));
group2.Items.Add(new GalleryItem(im6, "Janet Leverling", ""));
GroupControl控件
实现效果如图：
该控件的ShowCaption属性，是bool类型，当其值为false时，表示不显示标题；
该控件的CaptionImage属性可以设置标题前的图片显示，例如：
this.groupControl1.CaptionImage=global::WindowsDev.Properties.Resources.additem_32x32;
该控件的LookAndFeel属性下的UseDefaultLookAndFeel属性控制是否可以对党情的皮肤进行设置，为bool类型；
该控件的BorderStyle属性控制控件的边框样式：
如第一个图的效果代码如下：
groupControl1.BackColor = Color.LightGray;
groupControl1.LookAndFeel.UseDefaultLookAndFeel =false ;
groupControl1.ShowCaption = true;
groupControl1.BorderStyle= DevExpress.XtraEditors.Controls.BorderStyles.Simple;
SplitContainerControl控件
实现效果如图：
该控件的PanelVisibility属性控制面板Panel1和面板Panel2的可见性，
代码如下：
splitContainerControl2.PanelVisibility=
DevExpress.XtraEditors.SplitPanelVisibility.Panel1;//仅Panel1可见
splitContainerControl2.PanelVisibility=
DevExpress.XtraEditors.SplitPanelVisibility.Both;//Panel1、Panel2都可见
该控件的Horizontal属性控制面板是成左右分割还是上下分割，其值为true表示成左右分割布局；
该控件的LookAndFeel属性提供了改变控件外观的权限，该属性下的UseDefaultLookAndFeel为false时，可以通过该控件的Appearance属性对外观进行设置；
AlertControl控件
AlertControl控件能改在应用程序中显示警告窗口，通常该警告窗口显示为一个短的事件并自动关闭可以在该窗口中指定标题、文本、图像，并定义相应的处理事件。
实现效果如图：
实现代码如下：
using DevExpress.XtraBars.Alerter;
// Create a regular custom button.
AlertButton btn1 = new AlertButton(Image.FromFile(@"c:\folder-16x16.png"));
btn1.Hint = "Open file";
btn1.Name = "buttonOpen";
// Create a check custom button.
AlertButton btn2 = new AlertButton(Image.FromFile(@"c:\clock-16x16.png"));
btn2.Style = AlertButtonStyle.CheckButton;
btn2.Down = true;
btn2.Hint = "Alert On";
btn2.Name = "buttonAlert";
// Add buttons to the AlertControl and subscribe to the events to process button clicks
alertControl1.Buttons.Add(btn1);
alertControl1.Buttons.Add(btn2);
alertControl1.ButtonClick+=new AlertButtonClickEventHandler(alertControl1_ButtonClick);
alertControl1.ButtonDownChanged +=
new AlertButtonDownChangedEventHandler(alertControl1_ButtonDownChanged);
// Show a sample alert window.
AlertInfo info = new AlertInfo("New Window", "Text");
alertControl1.Show(this, info);
void alertControl1_ButtonDownChanged(object sender,
AlertButtonDownChangedEventArgs e) {
if (e.ButtonName == "buttonOpen") {
//...
}
}
void alertControl1_ButtonClick(object sender, AlertButtonClickEventArgs e) {
if (e.ButtonName == "buttonAlert") {
//...
}
}
XtraTabControl控件
1、该控件的TabPage属性：以集合的形式存储page页；
使用代码添加页：using DevExpress.XtraTab;
XtraTabPage page = new XtraTabPage();
page.Text = "aa";
xtraTabControl1.TabPages.Add(page);
2、该控件的MultiLine属性：把其值设为true;当可用空间不适应显示的页标题的长度时，允许页头进行多行显示.
3、SelectedTabPage属性：设定默认情况下显示的页；
4、ClosePageButttonShowMode属性：该属性控制那一页上显示关闭按钮，示例代码如下：
this.xtraTabControl1.ClosePageButtonShowMode = DevExpress.XtraTab.ClosePageButtonShowMode.InActiveTabPageAndTabControlHeader;
效果如图：
5、HeaderButton属性：可以通过该属性设置该控件右上角显示的按钮，可以添加 Close, Next 和Prev buttons.
TitleControl控件
该控件是根据Windows 8的用户界面设计的，可以轻松地把各个控制块集成到窗体上。
1.IndertBetweenGroups属性：控制两个Group之间的间距；
2.该控件通过TileGroup和TileItems添加Group和Item；
3、该控件通过TileControl.ItemClick事件执行选中的Item后执行的操作；
示例代码1：
using DevExpress.XtraEditors;
TileItem newTile = new TileItem();
tileControl1.Groups.Add(new TileGroup());
tileControl1.Groups[0].Items.Add(newTile);
示例代码2：
TileItem newTile = new TileItem();
//First Frame - Image only
TileItemFrame logoDXFrame = new TileItemFrame();
TileItemElement logoEl = new TileItemElement();
logoEl.Image = global::WindowsDev.Properties.Resources.additem_32x32; logoEl.ImageAlignment = TileItemContentAlignment.MiddleCenter;
logoDXFrame.Elements.Add(logoEl);
logoDXFrame.Elements[0].AnimateTransition= DevExpress.Utils.DefaultBoolean.True;
//Second Frame - Text only
TileItemFrame mottoDXFrame = new TileItemFrame();
TileItemElement mottoEl = new TileItemElement();
mottoEl.Text = "<Size=+2><Color=Sienna><b>Let's see what develops.</b></Color></Size>";
mottoEl.TextAlignment = TileItemContentAlignment.MiddleCenter;
mottoDXFrame.Elements.Add(mottoEl);
mottoDXFrame.Elements[0].AnimateTransition= DevExpress.Utils.DefaultBoolean.True;
//Global Tile Item Settings
newTile.Frames.Add(logoDXFrame);
newTile.Frames.Add(mottoDXFrame);
newTile.Appearance.BackColor = System.Drawing.Color.Bisque;
newTile.Appearance.BackColor2 = System.Drawing.Color.SandyBrown;
newTile.Appearance.GradientMode= System.Drawing.Drawing2D.LinearGradientMode.BackwardDiagonal;
newTile.Appearance.BorderColor = System.Drawing.Color.Bisque;
newTile.AllowHtmlText = DevExpress.Utils.DefaultBoolean.True;
newTile.FrameAnimationInterval = 2500;
newTile.IsLarge = true;
tileControl1.Groups.Add(new TileGroup());
tileControl1.Groups[0].Items.Add(newTile);
newTile.StartAnimation();
效果图如下：
RadialMenu控件
该控件是圆形菜单，可以以菜单的形式添加菜单项；
该控件的ShowPopup(Point point)方法用于显示圆形菜单；
2.0 PopupControlContainer控件
PopupControlContainer控件可以以面板的形式包含其他控件，可以DropDownButton控件的下拉框的格式出现，具体形式如图：
PopupControlContainer控件通过DropDownButton控件的DropDownControl属性进行绑定，在绑定后PopupControlContainer控件的AllowDrop属性要设成True;
HScrollBar控件和VScrollBar控件
许多控件需要滚动条，像ListBoxControl、CheckedListControl控件中已经集成啦滚动条，所以 就不需要另加滚动条，但有些控件没有集成，像PictureEdit控件，当显示的图片过长时，不能在其已有的区域显示，就需要HScrollbar控件 和VScrollBar控件；
示例代码：
using DevExpress.XtraEditors;
private void Form1_Load(object sender, System.EventArgs e) {
hScrollBar1.Width = pictureBox1.Width;
hScrollBar1.Left = pictureBox1.Left;
hScrollBar1.Top = pictureBox1.Bottom;
hScrollBar1.Maximum = pictureBox1.Image.Width - pictureBox1.Width;
vScrollBar1.Height = pictureBox1.Height;
vScrollBar1.Left = pictureBox1.Left + pictureBox1.Width;
vScrollBar1.Top = pictureBox1.Top;
vScrollBar1.Maximum = pictureBox1.Image.Height - pictureBox1.Height;
}
int x = 0;
private void hScrollBar1_Scroll(object sender, System.Windows.Forms.ScrollEventArgs e) {
x = hScrollBar1.Value;
pictureBox1.Refresh();
}
int y = 0;
private void vScrollBar1_Scroll(object sender, System.Windows.Forms.ScrollEventArgs e) {
y = vScrollBar1.Value;
pictureBox1.Refresh();
}
private void pictureBox1_Paint(object sender, System.Windows.Forms.PaintEventArgs e) {
e.Graphics.DrawImage(pictureBox1.Image, e.ClipRectangle, x, y, e.ClipRectangle.Width,
e.ClipRectangle.Height, GraphicsUnit.Pixel);
}
显示效果：
DocumenManger控件
MDI子窗体可以通过DocumentManger控件以nativemdiview对象或tabbedview对象的形式展现出来；
通过其ViewCollection属性添加View视图（子窗体），可以添加TabbedView、WindowsUIView、WidgetView、NativeMdiView四种视图；
通过Run Designer中Main下的Document给视图添加Document文档（显示的面板）；
（NativeMdiView视图）通过代码实现如下：
using System;
using System.Collections.Generic;
using System.ComponentModel;
using System.Data;
using System.Drawing;
using System.Text;
using System.Windows.Forms;
using DevExpress.XtraBars.Docking2010;
using DevExpress.XtraBars.Docking2010.Views.NativeMdi;
using DevExpress.XtraEditors;
namespace DocumentManager_NativeMDI {
public partial class Form1 : Form {
public Form1() {
InitializeComponent();
}
int childCount = 0;
private void Form1_Load(object sender, EventArgs e) {
CreateDocumentManager();
for(int i = 0; i < 3; i++) {
AddChild();
}
}
void CreateDocumentManager() {
DocumentManager dm = new DocumentManager();
dm.MdiParent = this;
dm.View = new NativeMdiView();
}
void AddChild() {
Form childForm = null;
childForm = new Form();
childForm.Text = "Child Form " + (++childCount);
SimpleButton btn = new SimpleButton();
btn.Text = "Button " + childCount;
btn.Parent = childForm;
childForm.MdiParent = this;
childForm.Show();
}
}
}
实现效果如图：
（TabbedView视图）通过代码实现如下：
using System;
using System.Windows.Forms;
using DevExpress.XtraBars.Docking2010;
using DevExpress.XtraBars.Docking2010.Views.Tabbed;
using DevExpress.XtraEditors;
namespace DocumentManager_TabbedUI {
public partial class Form1 : Form {
public Form1() {
InitializeComponent();
}
void Form1_Load(object sender, EventArgs e) {
AddDocumentManager();
for(int i = 0; i < 3; i++) {
AddChildForm();
}
}
void AddDocumentManager() {
DocumentManager manager = new DocumentManager();
manager.MdiParent = this;
manager.View = new TabbedView();
}
int count;
void AddChildForm() {
Form childForm = new Form();
childForm.Text = "Child Form " + (++count).ToString();
SimpleButton btn = new SimpleButton();
btn.Text = "Button " + count.ToString();
btn.Parent = childForm;
childForm.MdiParent = this;
childForm.Show();
}
}
}
实现效果如图：
Data & Analytics
DataNavigator
绑定数据源：
例：List<int> datasource = new List<int>();
datasource.AddRange(new int[] { 0, 1, 2, 3, 4 });
myDataNavigator1.DataSource = datasource;
GridLookUpEdit
示例代码：
using DevExpress.XtraEditors;
using DevExpress.XtraGrid.Columns;
using System.Data.OleDb;
// A lookup editor created at runtime.
GridLookUpEdit gridLookup;
// A navigator control to navigate the "Order Details" table.
DataNavigator dataNav;
// DataView for the "Order Details" table.
DataView dvMain;
// DataView for the "Products" table.
DataView dvDropDown;
//...
private void Form1_Load(object sender, System.EventArgs e) {
gridLookup = new GridLookUpEdit();
gridLookup.Bounds = new Rectangle(10, 40, 200, 20);
this.Controls.Add(gridLookup);
dataNav = new DataNavigator();
dataNav.Bounds = new Rectangle(10, 10, 250, 20);
this.Controls.Add(dataNav);
InitData();
InitLookUp();
dataNav.DataSource = dvMain;
}
private void InitData() {
// Dataset to provide data from the database
DataSet ds = new DataSet();
string connestionString =
"Provider=Microsoft.Jet.OLEDB.4.0;Data Source=C:\\DB\\nwind.mdb";
// Connect to the "Order Details" table
System.Data.OleDb.OleDbDataAdapter dbAdapter =
new OleDbDataAdapter("SELECT * FROM [Order Details]", connestionString);
// Load data from the "Order Details" table to the dataset
dbAdapter.Fill(ds, "Order Details");
// Connect to the "Products" table
dbAdapter = new OleDbDataAdapter("SELECT * FROM Products", connestionString);
// Load data from the "Products" table into the dataset
dbAdapter.Fill(ds, "Products");
DataViewManager dvm = new DataViewManager(ds);
dvMain = dvm.CreateDataView(ds.Tables["Order Details"]);
dvDropDown = dvm.CreateDataView(ds.Tables["Products"]);
}
private void InitLookUp() {
// Bind the edit value to the ProductID field of the "Order Details" table;
// the edit value matches the value of the ValueMember field.
gridLookup.DataBindings.Add("EditValue", dvMain, "ProductID");
// Prevent columns from being automatically created when a data source is assigned.
gridLookup.Properties.View.OptionsBehavior.AutoPopulateColumns = false;
// The data source for the dropdown rows
gridLookup.Properties.DataSource = dvDropDown;
// 下拉框显示的字段数据.
gridLookup.Properties.DisplayMember = "ProductName";
// The field matching the edit value.
gridLookup.Properties.ValueMember = "ProductID";
// Add two columns in the dropdown:
// A column to display the values of the ProductID field;
GridColumn col1 = gridLookup.Properties.View.Columns.AddField("ProductID");
col1.VisibleIndex = 0;
col1.Caption = "Product ID";
// A column to display the values of the ProductName field.
GridColumn col2 = gridLookup.Properties.View.Columns.AddField("ProductName");
col2.VisibleIndex = 1;
col2.Caption = "Product Name";
// Set column widths according to their contents.
gridLookup.Properties.View.BestFitColumns();
// Specify the total dropdown width.
gridLookup.Properties.PopupFormWidth = 300;
}
GridControl控件
1.设计数据源并绑定字段：
DataTable dt = new DataTable();
dt.Columns.Add("name", System.Type.GetType("System.String"));
dt.Columns.Add("sex", System.Type.GetType("System.String"));
dt.Columns.Add("age", System.Type.GetType("System.String"));
DataRow row=dt.NewRow();;
row["name"] = "11";
row["sex"] = "ss";
row["age"] = "age";
dt.Rows.Add(row);
//绑定字段
gridView1.Columns[1].FieldName = "sex";
gridView1.Columns[2].FieldName = "age";
gridView1.Columns[0].FieldName = "name";
gridControl1.DataSource = dt;
2、 如何解决单击记录整行选中的问题
View->OptionsBehavior->EditorShowMode 设置为：Click
3、 如何新增一条记录
(1)、gridView.AddNewRow()
(2)、实现 gridView_InitNewRow 事件
4、如何解决 GridControl 记录能获取而没有显示出来的问题
gridView.populateColumns();
5、如何让行只能选择而不能编辑（或编辑某一单元格）
(1)、View->OptionsBehavior->EditorShowMode 设置为：Click
(2)、View->OptionsBehavior->Editable 设置为：false
6、如何禁用 GridControl 中单击列弹出右键菜单
设置 Run Design->OptionsMenu->EnableColumnMenu 设置为：false
7、如何隐藏 GridControl 的 GroupPanel 表头
设置 Run Design->OptionsView->ShowGroupPanel 设置为：false
8、如何禁用 GridControl 中列头的过滤器 过滤器如下图所示：
设置 Run Design->OptionsCustomization->AllowFilter 设置为：false
9、如何在查询得到 0 条记录时显示自定义的字符提示/显示 如图所示：
方法如下：
//When no Records Are Being Displayed
private void gridView1_CustomDrawEmptyForeground(object sender, CustomDrawEventArgs e)
{
//方法一（此方法为GridView设置了数据源绑定时，可用）
ColumnView columnView = sender as ColumnView;
BindingSource bindingSource = this.gridView1.DataSource as BindingSource;
if(bindingSource.Count == 0)
{
string str = "没有查询到你所想要的数据!";
Font f = new Font("宋体", 10, FontStyle.Bold);
Rectangle r = new Rectangle(e.Bounds.Top + 5, e.Bounds.Left + 5, e.Bounds.Right - 5, e.Bounds.Height - 5);
e.Graphics.DrawString(str, f, Brushes.Black, r); }
//方法二（此方法为GridView没有设置数据源绑定时，使用，一般使用此种方 法）
if (this._flag)
{
if (this.gridView1.RowCount == 0)
{ string str = "没有查询到你所想要的数据!"; Font f = new Font("宋体", 10, FontStyle.Bold);
Rectangle r = new Rectangle(e.Bounds.Left + 5, e.Bounds.Top + 5, e.Bounds.Width - 5, e.Bounds.Height - 5);
e.Graphics.DrawString(str, f, Brushes.Black, r); } } }
10、如何显示水平滚动条
设置 this.gridView.OptionsView.ColumnAutoWidth = false;
列表宽度自适应内容
gridview1.BestFitColumns();
11、如何定位到第一条数据/记录？
设置 this.gridView.MoveFirst()
12、如何定位到下一条数据/记录？
设置 this.gridView.MoveNext()
13、如何定位到最后一条数据/记录？
设置 this.gridView.MoveLast()
14、设置成一次选择一行，并且不能被编辑
this.gridView1.FocusRectStyle = DevExpress.XtraGrid.Views.Grid.DrawFocusRectStyle.RowFocus;
this.gridView1.OptionsBehavior.Editable = false;
this.gridView1.OptionsSelection.EnableAppearanceFocusedCell = false;
15、如何显示？
private void gvPayList_CustomDrawRowIndicator(object sender, DevExpress.XtraGrid.Views.Grid.RowIndicatorCustomDrawEventArgs e) { e.Appearance.TextOptions.HAlignment = DevExpress.Utils.HorzAlignment.Far; if (e.Info.IsRowIndicator) { if (e.RowHandle >= 0) { e.Info.DisplayText = (e.RowHandle + 1).ToString(); } else if (e.RowHandle < 0 && e.RowHandle > -1000) { e.Info.Appearance.BackColor = System.Drawing.Color.AntiqueWhite; e.Info.DisplayText = "G" + e.RowHandle.ToString(); } } }
16、如何让各列头禁止移动？
设置 gridView1.OptionsCustomization.AllowColumnMoving = false;
17、如何让各列头禁止排序？
设置 gridView1.OptionsCustomization.AllowSort = false;
18、如何禁止各列头改变列宽？
设置 gridView1.OptionsCustomization.AllowColumnResizing = false;
19.拖动滚动条时固定某一列
|
设置Columns，选择要固定的列。设置Fixed属性，可以选择：固定在左边、固定在右边、不固定。 |
20.获取选定行,指定列单元格的内容
return gridView1.GetRowCellValue(pRows[0], ColumName).ToString ();
21.分组显示
OptionsView>OptionsBehavior>AutoExpandAllGroups = True 选择要分组的列，将GroupIndex属性设置为0
22.格式化数据
private void gvList_ValidatingEditor(object sender, DevExpress.XtraEditors.Controls.BaseContainerValidateEditorEventArgs e) { if (this.gvList.FocusedColumn.FieldName == "passQty") { string passQty = e.Value.ToString().Trim(); int receiveQty = orderDetailList[this.gvList.FocusedRowHandle].qty; if (!JXType.IsIntBigThanZero(passQty)) { e.Valid = false; e.ErrorText = "合格数量必须为大于等于0小于等于接货数量的整数！"; } else { if (int.Parse(passQty) > receiveQty) { e.Valid = false; e.ErrorText = "合格数量必须为大于0小于等于接货数量的整数！"; } } }
}
23.合并表头
界面操作：
代码操作如下：
示例代码1：
private DevExpress.XtraGrid.Views.BandedGrid.BandedGridView bandedGridView1;
private DevExpress.XtraGrid.Views.BandedGrid.GridBand gridBand1;
private DevExpress.XtraGrid.Views.BandedGrid.BandedGridColumn gridColumn1;
private DevExpress.XtraGrid.Views.BandedGrid.BandedGridColumn gridColumn2;
private DevExpress.XtraGrid.Views.BandedGrid.GridBand gridBand2;
private DevExpress.XtraGrid.Views.BandedGrid.BandedGridColumn gridColumn3;
private DevExpress.XtraGrid.Columns.GridColumn gridColumn5;
private DevExpress.XtraGrid.GridControl gridControl1;
private void InitializeComponent()
{
this.gridControl1 = new DevExpress.XtraGrid.GridControl();
this.button1 = new System.Windows.Forms.Button();
this.button2 = new System.Windows.Forms.Button();
this.gridColumn5 = new DevExpress.XtraGrid.Columns.GridColumn();
this.bandedGridView1 = new DevExpress.XtraGrid.Views.BandedGrid.BandedGridView();
this.gridColumn1 = new DevExpress.XtraGrid.Views.BandedGrid.BandedGridColumn();
this.gridColumn2 = new DevExpress.XtraGrid.Views.BandedGrid.BandedGridColumn();
this.gridColumn3 = new DevExpress.XtraGrid.Views.BandedGrid.BandedGridColumn();
this.gridBand1 = new DevExpress.XtraGrid.Views.BandedGrid.GridBand();
this.gridBand2 = new DevExpress.XtraGrid.Views.BandedGrid.GridBand();
((System.ComponentModel.ISupportInitialize)(this.gridControl1)).BeginInit();
((System.ComponentModel.ISupportInitialize)(this.bandedGridView1)).BeginInit();
this.SuspendLayout();
//
// gridControl1
//
this.gridControl1.Location = new System.Drawing.Point(74, 46);
this.gridControl1.MainView = this.bandedGridView1;
this.gridControl1.Name = "gridControl1";
this.gridControl1.Size = new System.Drawing.Size(400, 200);
this.gridControl1.TabIndex = 0;
this.gridControl1.ViewCollection.AddRange(new DevExpress.XtraGrid.Views.Base.BaseView[] {
this.bandedGridView1});
//
// button1
//
this.button1.Location = new System.Drawing.Point(88, 333);
this.button1.Name = "button1";
this.button1.Size = new System.Drawing.Size(75, 23);
this.button1.TabIndex = 1;
this.button1.Text = "button1";
this.button1.UseVisualStyleBackColor = true;
this.button1.Click += new System.EventHandler(this.button1_Click);
//
// button2
//
this.button2.Location = new System.Drawing.Point(273, 332);
this.button2.Name = "button2";
this.button2.Size = new System.Drawing.Size(75, 23);
this.button2.TabIndex = 2;
this.button2.Text = "button2";
this.button2.UseVisualStyleBackColor = true;
this.button2.Click += new System.EventHandler(this.button2_Click);
//
// gridColumn5
//
this.gridColumn5.Name = "gridColumn5";
//
// bandedGridView1
//
this.bandedGridView1.Bands.AddRange(new DevExpress.XtraGrid.Views.BandedGrid.GridBand[] {
this.gridBand1,
this.gridBand2});
this.bandedGridView1.Columns.AddRange(new DevExpress.XtraGrid.Views.BandedGrid.BandedGridColumn[] {
this.gridColumn1,
this.gridColumn2,
this.gridColumn3});
this.bandedGridView1.GridControl = this.gridControl1;
this.bandedGridView1.Name = "bandedGridView1";
//
// gridColumn1
//
this.gridColumn1.Caption = "Name";
this.gridColumn1.Name = "gridColumn1";
this.gridColumn1.Visible = true;
//
// gridColumn2
//
this.gridColumn2.Caption = "Sex";
this.gridColumn2.Name = "gridColumn2";
this.gridColumn2.Visible = true;
//
// gridColumn3
//
this.gridColumn3.Caption = "Age";
this.gridColumn3.Name = "gridColumn3";
this.gridColumn3.Visible = true;
//
// gridBand1
//
this.gridBand1.Caption = "gridBand1";
this.gridBand1.Columns.Add(this.gridColumn1);
this.gridBand1.Columns.Add(this.gridColumn2);
this.gridBand1.Name = "gridBand1";
this.gridBand1.VisibleIndex = 0;
this.gridBand1.Width = 150;
//
// gridBand2
//
this.gridBand2.Caption = "gridBand2";
this.gridBand2.Columns.Add(this.gridColumn3);
this.gridBand2.Name = "gridBand2";
this.gridBand2.VisibleIndex = 1;
this.gridBand2.Width = 75;
//
// Form8
//
this.AutoScaleDimensions = new System.Drawing.SizeF(6F, 12F);
this.AutoScaleMode = System.Windows.Forms.AutoScaleMode.Font;
this.ClientSize = new System.Drawing.Size(590, 429);
this.Controls.Add(this.button2);
this.Controls.Add(this.button1);
this.Controls.Add(this.gridControl1);
this.Name = "Form8";
this.Text = "Form8";
((System.ComponentModel.ISupportInitialize)(this.gridControl1)).EndInit();
((System.ComponentModel.ISupportInitialize)(this.bandedGridView1)).EndInit();
this.ResumeLayout(false);
}
示例代码2：
///初始化表格
using DevExpress.XtraGrid.Columns; using DevExpress.XtraGrid.Views.Base; using DevExpress.XtraGrid.Views.BandedGrid; using DevExpress.XtraEditors.Repository; private void InitGrid() { // advBandedGridView1是表格上的默认视图，注意这里声明的 是：BandedGridView BandedGridView view = advBandedGridView1 as BandedGridView; view.BeginUpdate(); //开始视图的编辑，防止触发其他事件 view.BeginDataUpdate(); //开始数据的编辑 view.Bands.Clear();
view.OptionsView.ShowColumnHeaders = false; // 因为有Band列了，所以把ColumnHeader隐藏 //添加列标题 //添加列标题 GridBand bandID = view.Bands.AddBand("ID"); bandID.Visible = false; //隐藏ID列 GridBand bandName = view.Bands.AddBand("姓名"); GridBand bandSex = view.Bands.AddBand("性别"); GridBand bandBirth = view.Bands.AddBand("出生日期"); GridBand bandScore = view.Bands.AddBand("分数"); GridBand bandMath = bandScore.Children.AdBand("数学"); GridBand bandChinese = bandScore.Children.AddBand("语文"); GridBand bandEnglish = bandScore.Children.AddBand("英语"); GridBand bandSubTotal = bandScore.Children.AddBand("小计"); GridBand bandRemark = view.Bands.AddBand("备注");
bandFile.AppearanceHeader.TextOptions.HAlignment = DevExpress.Utils.HorzAlignment.Center; //这是合并表头居中显示 view.EndDataUpdate();//结束数据的编辑 view.EndUpdate(); //结束视图的编辑 }
具体可看
dev gridcontrol 合并表头
24. 动态添加列
DevExpress.XtraGrid.Columns.GridColumn Col1 = new DevExpress.XtraGrid.Columns.GridColumn(); Col1.FieldName = "name"; Col1.Caption = "名字"; Col1.Visible = false; Col1.VisibleIndex = gvCountry.Columns.Count; gvCountry.Columns.Add(Col1);
25、设置自动增加的行号
private void gridview_CustomDrawRowIndicator(object sender, DevExpress.XtraGrid.Views.Grid.RowIndicatorCustomDrawEventArgs e) {
e.Appearance.TextOptions.HAlignment = DevExpress.Utils.HorzAlignment.Far; if (e.Info.IsRowIndicator) { if (e.RowHandle >= 0) { e.Info.DisplayText = (e.RowHandle + 1).ToString(); } else if (e.RowHandle < 0 && e.RowHandle > -1000) { e.Info.Appearance.BackColor = System.Drawing.Color.AntiqueWhite; e.Info.DisplayText = "G" + e.RowHandle.ToString(); } }
｝
26、特效：gridcontrol中有5种view 型式，普通的是gridview，然后分别为cardview、BandedView、Advanced BandedView、LayoutView；共5种。
1）、view组中把OptionView下的viewmode 设置成“Carousel”就达到这种“旋转木马”式 的gridcontrol view 特效了 2）、layoutView1.OptionsCarouselMode.PitchAngle 这个属性决定“旋转木马”的 pitch angle 螺距角; 螺旋角; 螺旋升角; 俯仰角; 倾角; 节锥半角 3）、Roll Angle 属性决定着 倾侧角度 4）、指定数据源，显示数据： //显示数据 private void showData(List<Employee > list) { DataTable dt = new DataTable("OneEmployee"); dt.Columns.Add("Caption", System.Type.GetType("System.String")); dt.Columns.Add("Department", System.Type.GetType("System.String")); dt.Columns.Add("PhotoName", System.Type.GetType("System.Byte[]"));
for (int i = 0; i < list.Count; i++) { DataRow dr = dt.NewRow(); dr["Caption"] = list[i].Name; dr["Department"] = list[i].Department; string imagePath = @"D:\C#\photos\" + list[i].PhotoPath; dr["PhotoName"] = getImageByte(imagePath); dt.Rows.Add(dr); } gridControl1.DataSource = dt; }
//返回图片的字节流byte[] private byte[] getImageByte(string imagePath) { FileStream files = new FileStream(imagePath, FileMode.Open); byte[] imgByte = new byte [files.Length ]; files.Read(imgByte, 0, imgByte.Length); files.Close(); return imgByte; }
27、检查数据的有效性
在gridview的ValidateRow事件中加入检查代码： #region 检查数据 private void gridView1_ValidateRow(object sender, ValidateRowEventArgs e) { GridView view = sender as GridView; view.ClearColumnErrors();
if (view.GetRowCellValue(e.RowHandle, "ReceiveDate") == DBNull.Value) { e.Valid = false; view.SetColumnError(view.Columns["ReceiveDate"], "必须指定日期"); }
}
28、设某一列文字和标题局中显示 gridView1.Columns[0].AppearanceHeader.TextOptions.HAlignment = DevExpress.Utils.HorzAlignment.Center; gridView1.Columns[0].AppearanceCell.TextOptions.HAlignment = DevExpress.Utils.HorzAlignment.Center;
29、列表过滤条件多选
列名.OptionsFilter.FilterPopupMode= DevExpress.XtraGrid.Columns.FilterPopupMode.CheckedList
30、隔行换色的方法
// 设置奇数行颜色，默认也是白色 可以省略
this.gridView1.Appearance.OddRow.BackColor = Color.White;
//使所以的奇数行能上面绑定 同时使用有效 this.gridView1.OptionsView.EnableAppearanceOddRow = true;
// 设置偶数行颜色 this.gridView1.Appearance.EvenRow.BackColor = Color.WhiteSmoke;
//使所以的偶数行能上面绑定 同时使用有效 this.gridView1.OptionsView.EnableAppearanceEvenRow = true;
31、删除选中行，添加行
删除选中行通过DeleteSelectedRows（）方法，可以通过AddNewRow()方法添加行；
具体示例代码如下：
if (gridView1.SelectedRowsCount > 0)
{
gridView1.DeleteSelectedRows();
}
32、设置只读属性
通过OptionColumn的readOnly属性，把某一列设置为只读属性；
this.gridView1.Columns[0].OptionsColumn.ReadOnly = true;
GridView
26.控制Cell中数据显示对齐
属性Column.AppearanceCell.TextOptions：
HAlignment:水平对齐
VAlignment:垂直对齐
27、控制Cell中数据折叠显示
属性Column.AppearanceCell.TextOptions.WordWrap
28、控制奇数和偶数行显示颜色
属性Gridview.OptionView
EnableAppearanceEvenRow
EnableAppearanceOddRow
29、显示过滤框
OptionView.ShowAutoFilterRow = True
30、获取选中的数据
int[] iRows = myGridView.GetSelectedRows();
for (int i = 0; i < iRows.Length; i++)
{
DataRow dr = (DataRow) myGridView.GetDataRow(iRows[i]);
}
31、定位指定的记录
1）按单元格的值定位记录
myGridView.LocateByValue(0, dt.Columns["FieldName"], Object(value));
2）按单元格的显示值定位记录（在GridView上编辑数据后，显示值（DispalyText）不同于实际值（Value））
myGridView.LocateByDisplayText(0,dt.Columns["FieldName"],value);
38、禁用主细表模式显示数据（当你绑定的对象内含集合类成员变量时，默认以主细表模式显示在GridView中）
myGridView.OptionsView.ShowChildrenInGroupPanel =false;
myGridView.OptionsDetail.EnableMasterViewMode = false;
TreeList控件
TreeList有一个KeyFieldName和ParentFieldName，这2个非常重要，只要构造一个DataTable赋值给 TreeList的DataSource，这个DataTable里面要有2列是必须的，因为这2列要赋给上面说的KeyFieldName和 ParentFieldName，先不说上面意思，树应该是从根节点递归、递归、一直往下递归到叶子，KeyFieldName和 ParentFieldName就起到这个作用，比如：下面的一个DataTable：
|
KeyFieldName |
ParentFieldName |
NodeName |
NodeCode |
Others |
|
1 |
Null |
根节点1名称 |
根节点1编码 |
其他 |
|
2 |
1 |
节点1子节点名称 |
节点1子节点编码 |
其他 |
|
3 |
1 |
节点1子节点名称 |
节点1子节点编码 |
其他 |
|
4 |
Null |
根节点4名称 |
根节点4编码 |
其他 |
|
5 |
4 |
节点4子节点名称 |
节点4子节点编码 |
其他 |
|
6 |
5 |
节点5子节点名称 |
节点5子节点编码 |
其他 |
这时，如果把这个DataTable赋给TreeList的话，就会产生下面的一棵树：
构造TreeList的数据源
/// <summary>
/// 构造一棵树型表结构
/// </summary>
/// <returns></returns>
private DataTable CreateTreeListTable()
{
DataTable dt = new DataTable();
DataColumn dcOID = new DataColumn("KeyFieldName", Type.GetType("System.Int32"));
DataColumn dcParentOID = new DataColumn("ParentFieldName", Type.GetType("System.Int32"));
DataColumn dcNodeName = new DataColumn("NodeName", Type.GetType("System.String"));
DataColumn dcNodeCode = new DataColumn("NodeCode", Type.GetType("System.String"));
DataColumn dcOthers = new DataColumn("Others", Type.GetType("System.String"));
dt.Columns.Add(dcOID);
dt.Columns.Add(dcParentOID);
dt.Columns.Add(dcNodeName);
dt.Columns.Add(dcNodeCode);
dt.Columns.Add(dcOthers);
//以上代码完成了DataTable的构架，但是里面是没有任何数据的
DataRow dr1 = dt.NewRow();
dr1["KeyFieldName"] = 1;
dr1["ParentFieldName"] = DBNull.Value;
dr1["NodeName"] = "根节点名称";
dr1["NodeCode"] = "根节点编码";
dr1["Others"] = "其他";
dt.Rows.Add(dr1);
DataRow dr2 = dt.NewRow();
dr2["KeyFieldName"] = 2;
dr2["ParentFieldName"] = 1;
dr2["NodeName"] = "节点子节点名称";
dr2["NodeCode"] = "节点子节点编码";
dr2["Others"] = "其他";
dt.Rows.Add(dr2);
DataRow dr3 = dt.NewRow();
dr3["KeyFieldName"] = 3;
dr3["ParentFieldName"] = 1;
dr3["NodeName"] = "节点子节点名称";
dr3["NodeCode"] = "节点子节点编码";
dr3["Others"] = "其他";
dt.Rows.Add(dr3);
DataRow dr4 = dt.NewRow();
dr4["KeyFieldName"] = 4;
dr4["ParentFieldName"] = DBNull.Value;
dr4["NodeName"] = "根节点名称";
dr4["NodeCode"] = "根节点编码";
dr4["Others"] = "其他";
dt.Rows.Add(dr4);
DataRow dr5 = dt.NewRow();
dr5["KeyFieldName"] = 5;
dr5["ParentFieldName"] = 4;
dr5["NodeName"] = "节点子节点名称";
dr5["NodeCode"] = "节点子节点编码";
dr5["Others"] = "其他";
dt.Rows.Add(dr5);
DataRow dr6 = dt.NewRow();
dr6["KeyFieldName"] = 6;
dr6["ParentFieldName"] = 5;
dr6["NodeName"] = "节点子节点名称";
dr6["NodeCode"] = "节点子节点编码";
dr6["Others"] = "其他";
dt.Rows.Add(dr6);
return dt;
}
TreeList的一些常用用法
点击节点前
/// <summary>
/// 点击节点前
/// </summary>
/// <param name="sender"></param>
/// <param name="e"></param>
private void treeLstModuleAction_BeforeCheckNode(object sender, DevExpress.XtraTreeList.CheckNodeEventArgs e)
{
e.State = (e.PrevState == CheckState.Checked ? CheckState.Unchecked : CheckState.Checked);
}
点击节点后
/// <summary>
/// 点击节点后
/// </summary>
/// <param name="sender"></param>
/// <param name="e"></param>
private void treeLstModuleAction_AfterCheckNode(object sender, DevExpress.XtraTreeList.NodeEventArgs e)
{
SetCheckedChildNodes(e.Node, e.Node.CheckState);
SetCheckedParentNodes(e.Node, e.Node.CheckState);
}
选择子节点时触发
/// <summary>
/// 选择子节点时触发
/// </summary>
/// <param name="node"></param>
/// <param name="check"></param>
private void SetCheckedChildNodes(TreeListNode node, CheckState check)
{
for (int i = 0; i < node.Nodes.Count; i++)
{
node.Nodes[i].CheckState = check;
SetCheckedChildNodes(node.Nodes[i], check);
}
}
选择父节点时触发
/// <summary>
/// 选择父节点时触发
/// </summary>
/// <param name="node"></param>
/// <param name="check"></param>
private void SetCheckedParentNodes(TreeListNode node, CheckState check)
{
if (node.ParentNode != null)
{
bool b = false;
CheckState state;
for (int i = 0; i < node.ParentNode.Nodes.Count; i++)
{
state = (CheckState)node.ParentNode.Nodes[i].CheckState;
if (!check.Equals(state))
{
b = !b;
break;
}
}
node.ParentNode.CheckState = b ? CheckState.Indeterminate : check;
SetCheckedParentNodes(node.ParentNode, check);
}
}
判断此节点下的所有孩子节点是否选中
/// <summary>
/// 判断此节点下的所有孩子节点是否选中
/// </summary>
/// <param name="node"></param>
/// <returns></returns>
private Boolean IsChildsChecked(TreeListNode node)
{
for (int i = 0; i < node.Nodes.Count; i++)
{
if (node.Nodes[i].CheckState == CheckState.Unchecked)
return false;
if (node.Nodes[i].HasChildren)
IsChildsChecked(node.Nodes[i]);
}
return true;
}
|
|
|
添加节点
示例代码：
/// <summary>
/// 实体类
/// </summary>
class PersonTo
{
public string Name
{
set;
get;
}
public string Age
{
set;
get;
}
}
private void AddTreeNode()
{
ArrayList pl = new ArrayList();
PersonTo p = new PersonTo();
p.Name = "liu";
p.Age = "20";
pl.Add(p);
PersonTo p2 = new PersonTo();
p2.Name = "yu";
p2.Age = "21";
pl.Add(p2);
treeList1.DataSource=pl;
object[] s = new object[] { "1", "1", "1" };
object ss = new object();
this.treeList1.AppendNode(s,0);
}
选择CheckBox时所触发的事件
树列表，该事件的AfterCheckNode事件是当选择CheckBox时所触发的事件；
是否每项前显示CheckBox
该控件下的OptionsView属性下的ShowCheckBoxes属性控制是否每项前显示CheckBox,该属性属于bool类型;
DEV中TreeList控件利用FilterNode实现数据过滤功能
使用TreeList控件实现数据过滤功能。TreeList自身是提供了一个数据过滤功能，但这个功能有一个缺点。就是如果目录树是多级目录树，并且父节点不符合过滤条件时，即使里面的子节点符合过滤条件，也不会显示对应的节点。
好在TreeList控件还提供了一个FilterNode事件，所以我们可以通过FilterNode事件进行处理：
private void treeList1_FilterNode(object sender, DevExpress.XtraTreeList.FilterNodeEventArgs e)
{
string NodeText = e.Node.GetDisplayText(treeList1.Nodes[0].Id);
bool IsVisible = NodeText.ToUpper().IndexOf("过滤的内容".ToUpper()) >= 0;
if(IsVisible)
{
DevExpress.XtraTreeList.Nodes.TreeListNode Node = e.Node.ParentNode;
while(Node !=null)
{
if(!Node.Visible)
{
Node.Visible =true;
Node = Node.ParentNode;
}
else
break;
}
}
e.Node.Visible = IsVisible;
e.Handled =true;
}
当我们需要进行过滤时，只要调用： treeList1.FilterNodes();
Common Controls
CheckTreeList控件
1.选中节点以不同颜色标示
Appearance.FocusedCel
LookUpEdit控件
1.实现主细表显示和编辑
主表：tblMain，绑定到MyGridControl上
细表:tblDetail，绑定到MyLookUpEdit上
假设：两个表的数据已经获取，下面重点关注如何进行数据绑定
BindingSourse bsMain= new BindingSource();
bsMain.DataSource = tblMain;
MyGridControl.DataSource = myBind;
MyLookUpEdit.Properties.DataSource = tblDetail;
//将MyLookUpEdit绑定到tblMain，以支持数据显示
MyLookUpEdit.DataBindings.Add("EditValue", bsMain, tblMain.EditColumn.ColumnName);//EditColumnColumn为要显示的主表的某一列，它对应与细表的ValueColumn
//将MyLookUpEdit绑定到tblDetail，以支持数据编辑
MyLookUpEdit.Properties.DisplayMember= tblDetail.DisplayColumn.ColumnaName;//**DisplayColumn为要显示的细表的某一列
MyLookUpEdit.Properties.ValueMember= tblDetail.ValueColumn.ColumnaName;//**ValueColumn为与主表EditColumn对应的细表的某一列
Dev控件，lookUpEdit数据源绑定
//绑定lookUpEdit
private void BoundData()
{
string sql =
"select daID,xm,sfzh from baseinfo";
DataSet ds =
Archives.DataAccess.DataSql.Query(sql);
if (ds !=
null)
{
int rows = ds.Tables[0].Rows.Count;
lookUpEdit1.EditValue = "daID";
lookUpEdit1.Properties.ValueMember = "daID";
lookUpEdit1.Properties.DisplayMember = "xm";
lookUpEdit1.Properties.DataSource = ds.Tables[0];
//自适应宽度
//lookUpEdit1.Properties.BestFitMode =
DevExpress.XtraEditors.Controls.BestFitMode.BestFitResizePopup;
//填充列
lookUpEdit1.Properties.PopulateColumns();
//设置列属性
//lookUpEdit1.Properties.Columns[0].Visible = false;
lookUpEdit1.Properties.Columns[1].Caption = "姓名";
lookUpEdit1.Properties.Columns[2].Caption = "身份证号";
lookUpEdit1.Properties.Columns[1].Width = 120;
lookUpEdit1.Properties.Columns[2].Width = 300;
//控制选择项的总宽度
lookUpEdit1.Properties.PopupWidth = 500;
//列格式设置
lookUpEdit1.Properties.Columns[0].FormatString = "000000";
//选择第一项
lookUpEdit1.ItemIndex = 0;
}
}
//值改变事件
private void
lookUpEdit1_EditValueChanged(object sender, EventArgs e)
{
string daID
= this.lookUpEdit1.EditValue.ToString(); //是ookUpEdit.Properties.ValueMember的值
string xm =
this.lookUpEdit1.Text.Trim();
}
效果图：
TextEdit控件
1、控制只能录入数值
myTextEdit.Properties.Mask.MaskType= Numeric;
2、控制只能录入整数
myTextEdit.Properties.Mask.MaskType= Numeric;
myTextEdit.Properties.Mask.EditMast= d;
3.以文本框的形式绑定各种形式的选择框；
4.文本框设置输入字符时有* 号掩盖输入的字符
代码如下:
textEdit1.Propertiex.PasswordChar=’*’;
ButtonEdit控件
以button按钮的形式绑定各种形式的选择框；
CheckButton控件
以按钮的形式显示Check的操作；
其Button Style属性设置Checked和UnChecked时的样式；
可以在其DX Image Gallery中用其内不的自带图片，当Check的状态发生改变时可以用
this.checkButton1.Image = global::WindowsDev.Properties.Resources.clear_32x32;改变其内部自带的图片。
ListBoxControl控件
示例代码：
string[] States = { "Alabama", "Alaska" };
// Initialize and create an instance of the ListBoxControl class
ListBoxControl listBox = new ListBoxControl();
// Define the parent control
listBox.Parent = this;
// Set the listBox's background color
listBox.BackColor = Color.FromArgb(254, 246, 212);
// Dock to all edges and fill the parent container
listBox.Dock = DockStyle.Fill;
// Add items
listBox.Items.AddRange(States);
DropDownButton控件
该控件以按钮的形式弹出上下文菜单，该控件通过DropDownControl属性绑定PopuMenu控件或PopupControlContainer控件。
可以通过该控件的DropDownArrowStyle属性控制下拉箭头的显示模式，如图：
PictureEdit控件
可在控件里添加图片
LabelControl控件
用法等同于Label控件
RadioGroup控件
其Columns属性决定显示的列数，
示例代码：
using DevExpress.XtraEditors.Controls;
///
///
object[] itemValues = new object[] {10, 11, 12, 13, 14};
string [] itemDescriptions = new string [] {"Circle", "Rectangle", "Ellipse", "Triangle", "Square"};
for(int i = 0; i < itemValues.Length; i++) {
radioGroup1.Properties.Items.Add(new RadioGroupItem(itemValues[i], itemDescriptions[i]));
}
//Select the Rectangle item.
radioGroup1.EditValue = 11;
MarqueeProgressBarControl控件
Text属性显示在运动时显示的文本；
其Properties属性下的MarqueeAnimationSpeed属性控制其滚动速度
如图所示：
marqueeProgressBarControl1.Properties.MarqueeAnimationSpeed = 100;
marqueeProgressBarControl1.Text = "Loading...";
ProgressBarControl控件
进度条
示例代码：
using System.IO;
using DevExpress.XtraEditors.Controls;
// ...
private void DeleteFiles(string source){
if (Directory.Exists(source)){
string[] fileEntries = Directory.GetFiles(source);
// Initializing progress bar properties
progressBarControl1.Properties.Step = 1;
progressBarControl1.Properties.PercentView = true;
progressBarControl1.Properties.Maximum = fileEntries.Length;
progressBarControl1.Properties.Minimum = 0;
// Removing the list of files found in the specified directory
foreach(string fileName in fileEntries){
File.Delete(fileName);
progressBarControl1.PerformStep();
//进行再次重绘
progressBarControl1.Update();
}
}
}
// ...
DeleteFiles("d:\\Temp");
ImageListBoxControl控件
ImageListBoxControl与ListBoxControl的区别是其列表框中的每一项都有显示图片的能力；
imageListBoxControl1.Items.Add("One");
imageListBoxControl1.Items.Add("Two");
imageListBoxControl1.Items.Add("Third");
imageListBoxControl1.Items[0].ImageIndex = 0;
imageListBoxControl1.Items[1].ImageIndex = 0;
imageListBoxControl1.Items[2}.ImageIndex = 0;
SpinEdit控件
此按钮控件是用来增加或减少在编辑的文本编辑区显示的数值，该编辑值可以是一个整数或浮点数。
其Text属性显示编辑区的文本；
其Value属性获得编辑区的值；
示例代码：spinEdit1.Text =( spinEdit1.Value +1).ToString();
ProgressPanel控件
该控件是用来表示任何操作的进度，该控件包含一个动画图像和两个标签，其中两个标签分别用来指定标题和描述属性；
如图：
ProgressPanel包含了许多图像，可以手动指定显示的图像格式，通过LookAndFeel属性来设定，示例代码：
DevExpress.XtraWaitForm.ProgressPanel progressPanel1=new DevExpress.XtraWaitForm.ProgressPanel();
this.progressPanel1.LookAndFeel.SkinName = "DevExpress Dark Style";
this.progressPanel1.LookAndFeel.Style= DevExpress.LookAndFeel.LookAndFeelStyle.UltraFlat;
this.progressPanel1.LookAndFeel.UseDefaultLookAndFeel = false;
SimpleButton控件
使用SimpleButton控制创建一个Button按钮，可以通过其Image属性添加图片；该控件与WinForm自带的Button按钮类同；
CheckedListBoxControl控件
该控件以列表框的形式显示复选列表；
效果如图：
示例代码：
using DevExpress.XtraEditors;
using DevExpress.XtraEditors.Controls;
// ...
CheckedListBoxItem[] items = {
new CheckedListBoxItem("January", false),
new CheckedListBoxItem("February", false),
new CheckedListBoxItem("March", true),
new CheckedListBoxItem("April", false),
new CheckedListBoxItem("May", false),
new CheckedListBoxItem("June", true),
new CheckedListBoxItem("July", true),
new CheckedListBoxItem("August", false),
new CheckedListBoxItem("September", false),
new CheckedListBoxItem("October", false),
new CheckedListBoxItem("November", false),
new CheckedListBoxItem("December", false)
};
private void CreateCheckedListBoxControl(CheckedListBoxItem[] items){
CheckedListBoxControl checkedListBoxControl = new CheckedListBoxControl();
Controls.Add(checkedListBoxControl);
checkedListBoxControl.Left = 20;
checkedListBoxControl.Top = 20;
checkedListBoxControl.Width = 200;
checkedListBoxControl.Height = 150;
checkedListBoxControl.Items.AddRange(items);
}
// ...
CreateCheckedListBoxControl(items);
RichEditControl控件
该控件可以生成类似Word文档的文本编辑器，可以通过CreateBarManger方法自动生成相应的菜单项；
SchedulerControl控件
该控件以可视化的效果显示预约或者设定的行程；该控件预约后的数据存储在SchedulerStorage对象里，当以拖动形式添加SchedulerControl控件时，系统会自动分配一个SchedulerStorage对象。
DateNavigator控件
该控件是一个可以快速在SchedulerControl控件中进行日期调度的控件，利用其schedulercontrol属性与SchedulerControl控件进行绑定；
示例代码：
// Hide the Today button.
dateNavigator1.ShowTodayButton = false;
// Assign the existing Scheduler Control to this Date Navigator.
dateNavigator1.SchedulerControl = schedulerControl1;
图片演示：
SpreadsheetControl控件
该控件生成Excel表格，可以通过CreateBarManger方法自动生成相应的菜单项；
SpreadSheetNameBoxControl控件
该控件可以结合SpreadSheetControl控件一起使用，可以显示当前选中的是哪个单元格；
SpreadsheetFomulaBarControl控件
该控件结合SpreadSheetControl控件一起使用，可以显示对几个单元格中的值进行计算；
