DotNet控件使用方法.docx

1、DotNet控件使用方法DotNet第三方控件使用笔记1、1）ButtonX控件可实现如下效果： 在ButtonX上，是否显示“图像，取决于“images“属性2）在“buttomItem“控件中，是否“只是显示图像”，”只是文本”，还是“图像和文本都显示”，取决于2、BalloonTio控件（气泡提示）（1）使用效果1）效果一：在鼠标在控件上面停留时，出现提示信息，如下图： 2）效果二：当控件获得焦点时，也出现如上图一样的信息。（2）实现上述两种效果的途径1）将BalloonTip控件的“ShowBalloonOnFacus”属性设置为“False”即可实现，效果一。2）将“ShowBall

2、oonOnFacus”属性设置为“True”，即可实现效果二。（3）设置BalloonTip显示的内容：在欲设置该属性的控件的“BalloonTioOnFocus上的BalloonCaption”和“BalloonTioOnHover上的BalloonCaption”属性中，分别设置这两种效果的“标题”属性； 在“BalloonTioOnFocus上的BalloonText”和在“BalloonTioOnHover上的BalloonText”属性中，分别设置这两种效果的“显示内容”的属性。（4）属性“AlerAnimation”设置“BalloonTip”出现的效果,（5）“BalloonTi

3、p”除了出现在该控件附近，还可以出现在屏幕的右下角，示例程序如下： private AlertCustom m_AlertOnLoad=null;m_AlertOnLoad=new AlertCustom(); Rectangle r=Screen.GetWorkingArea(this); m_AlertOnLoad.Location=new Point(r.Right-m_AlertOnLoad.Width,r.Bottom-m_AlertOnLoad.Height); m_AlertOnLoad.AutoClose=true; m_AlertOnLoad.AutoCloseTimeOut

4、=15; m_AlertOnLoad.AlertAnimation=eAlertAnimation.BottomToTop; m_AlertOnLoad.AlertAnimationDuration=300; m_AlertOnLoad.Show(false);/false:指示该控件是否需要获得焦点才出现“BalloonTip”（6）“BalloonTip”除了可以通过“添加控件”的方式使用，也可以通过编程的方式使用，示例程序如下： DevComponents.DotNetBar.Balloon b=new DevComponents.DotNetBar.Balloon(); b.Style

5、=eBallonStyle.Alert; b.CaptionImage=balloonTipFocus.CaptionImage.Clone() as Image; b.CaptionText=Balloon Status Information; b.Text=Balloons are now enabled for Balloon Tip Test area. Hover mouse over the area and set the focus to any control.; b.AlertAnimation=eAlertAnimation.TopToBottom; b.AutoRes

6、ize(); b.AutoClose=true; b.AutoCloseTimeOut=4; b.Owner=this;/指示父控件 b.Show(button2,false);/button2：指示在那个控件附近出现“BalloonTip” （7）还可以对“BalloonTip”出现时的效果进行程序控制，如下： / BalloonTriggerControl property returns control that invoked balloon/ BalloonTriggerControl属性返回触发“BalloonTip”的控件 if(balloonTipHover.BalloonTr

7、iggerControl=groupBox1) / BalloonControl is already prepared Balloon control that is just about to be displayed / Setting BalloonControl to null will cancel balloon display Point p=Control.MousePosition; / Adjust cursor position so cursor is below tipp.Offset(-balloonTipHover.BalloonControl.TipOffse

8、t,balloonTipHover.BalloonControl.TipLength+4);/Offset属性将点p进行平移 balloonTipHover.BalloonControl.Location=p; （8）与之类似的是DotNetToolTip所有控件都有的“ToolTip”属性，也可以是控件在鼠标划过时出现类似的东西，如下图3、DotNetBarManager控件与Bar控件的使用 示例效果如下图：（1）DotNetBarManager控件 -将该控件添加到工程后，将给Bar控件提供了“停靠点（DockSite）”，可以实现是工具栏在窗体的“上、下、左、右“摆放。 可以通过程序实

9、现，也可以通过“属性页“的”Dock“属性进行设置。 bar.DockSide = eDockSide.Top;（2）DotNetBarManager控件，通过右键菜单可以轻松实现如下图所示的布局。通过拖动也可以轻易的实现如下视图的布局与上图相应的代码：/ Create new document and add it to existing barDevComponents.DotNetBar.DockContainerItem dockItem=new DevComponents.DotNetBar.DockContainerItem();dockItem.Text=Custom Docum

10、ent;/ Add control to itTextBox t=new TextBox();t.AutoSize=false;t.Multiline=true;t.Text=dockItem.Text;/ PanelDockContainer will be used to host any controls. It provides automatic focus management so focused/ document tab appears boldDevComponents.DotNetBar.PanelDockContainer panel = new DevComponen

11、ts.DotNetBar.PanelDockContainer();t.Dock = DockStyle.Fill;panel.Controls.Add(t);dockItem.Control=panel;bar1.Items.Add(dockItem);if(!bar1.Visible)bar1.Visible=true;elsebar1.RecalcLayout();/ Optimize display by disabling layout for all dock sitesdotNetBarManager1.SuspendLayout=true;tryforeach(DevCompo

12、nents.DotNetBar.Bar bar in dotNetBarManager1.Bars)if(bar.DockSide=DevComponents.DotNetBar.eDockSide.Document)foreach(DevComponents.DotNetBar.DockContainerItem dock in bar.Items)dock.Visible=true;if(!bar.Visible)bar.Visible=true;finallydotNetBarManager1.SuspendLayout=false;（2）下面的代码通过编程的方式实现如下图所示的功能pr

13、ivate void Form1_Load(object sender, System.EventArgs e)dotNetBarManager1.DockTabChange+=new DotNetBarManager.DockTabChangeEventHandler(this.DockTabChanged);CreateBottomBarAutoHide();CreateLeftDockedBars();private void DockTabChanged(object sender, DockTabChangeEventArgs e)/ Sync caption of the bar

14、with the currently selected dock tabBar bar=sender as Bar;if(bar=null | e.NewTab=null)return;bar.Text=e.NewTab.Text;private void CreateBottomBarAutoHide()Bar bar=new Bar(Bottom Bar in auto-hide state);bar.Name=bottomBar;bar.LayoutType=eLayoutType.DockContainer; / Dock Container Layout needed for doc

15、kable windowsbar.Stretch=true; / Dockable windows stretch to fill containerbar.AutoHideAnimationTime=0; / Some controls do not support animation so turn it offbar.GrabHandleStyle=eGrabHandleStyle.Caption; / Dockable Windows have captionsdotNetBarManager1.Bars.Add(bar); / DotNetBar needs to be aware

16、of the bar so it can manage its docking etc./ Create hosted controlsDockContainerItem dockItem=new DockContainerItem(bottomDockItem1,First dock item);bar.Items.Add(dockItem);/ Create control that we want to host on dockable windowUserControl1 dockedControl=new UserControl1();dockedControl.label1.Tex

17、t=bar.Name+ - +dockItem.Text;dockedControl.BackColor=Color.Azure;dockItem.Control=dockedControl; / Specify that control is hosted on the dock containerdockItem.Height=128; / Specify the height of the dockable container and at the same time control/ Create second dock container and add it to the bard

18、ockItem=new DockContainerItem(bottomDockItem2,Second dock item);bar.Items.Add(dockItem);dockedControl=new UserControl1();dockedControl.label1.Text=bar.Name+ - +dockItem.Text;dockedControl.BackColor=Color.Aquamarine;dockItem.Control=dockedControl; / Specify that control is hosted on the dock containe

19、r/ Dock bar to bottom dock sitedotNetBarManager1.BottomDockSite.GetDocumentUIManager().Dock(bar);dockItem.Height=128; / Specify the height of the dockable container and at the same time controlbar.RecalcLayout(); / Apply all changes.bar.AutoHide=true; / Place bar in auto-hide mode. Bar needs to be d

20、ocked before it can be places in auto-hide modeprivate void CreateLeftDockedBars()/ Dock first two bars side by side and dock third bar next to them.Bar bar=new Bar(Bar1);bar.Name=leftBar1;bar.LayoutType=eLayoutType.DockContainer; / Dock Container Layout needed for dockable windowsbar.Stretch=true;

21、/ Dockable windows stretch to fill containerbar.AutoHideAnimationTime=0; / Some controls do not support animation so turn it offbar.GrabHandleStyle=eGrabHandleStyle.Caption; / Dockable Windows have captionsbar.CanHide=true;/ Create DockContainerItem for the bar. The item should be added before the b

22、ar is docked.DockContainerItem dockItem=new DockContainerItem(leftDockItem1,Top Left Dock Container);bar.Items.Add(dockItem);/ Create control that is hosted on dock containerUserControl1 dockedControl=new UserControl1();dockedControl.label1.Text=bar.Name+ - +dockItem.Text;dockedControl.BackColor=Col

23、or.Khaki;dockItem.Control=dockedControl; / Specify that control is hosted on the dock containerdotNetBarManager1.Bars.Add(bar); / DotNetBar needs to be aware of the bar so it can manage its docking etc.dotNetBarManager1.LeftDockSite.GetDocumentUIManager().Dock(bar); /Performs actual docking of the B

24、ar to the specified dock sitedockItem.Width=128; / Specify Width of dock container item after it is docked/ Create second bar and dock it below the first bar but still on the same lineBar bar2=new Bar(Bar2);bar2.Name=leftBar2;bar2.LayoutType=eLayoutType.DockContainer; / Dock Container Layout needed

25、for dockable windowsbar2.AutoHideAnimationTime=0; / Some controls do not support animation so turn it offbar2.Stretch=true; / Dockable windows stretch to fill containerbar2.CanHide=true;bar2.GrabHandleStyle=eGrabHandleStyle.Caption; / Dockable Windows have captions/ Add new Dock Container to the bar

26、, should be done before adding the bar so size can be calculated properlydockItem=new DockContainerItem(leftDockItem2,Bottom Left Dock Container);bar2.Items.Add(dockItem);/ Create control that is hosted on dock containerdockedControl=new UserControl1();dockedControl.label1.Text=bar.Name+ - +dockItem

27、.Text;dockedControl.BackColor=Color.Lavender;dockItem.Control=dockedControl; / Specify that control is hosted on the dock containerdotNetBarManager1.Bars.Add(bar2); / DotNetBar needs to be aware of the bar so it can manage its docking etc.dotNetBarManager1.LeftDockSite.GetDocumentUIManager().Dock(ba

28、r, bar2, eDockSide.Bottom); / Dock new bar2 below the bar that we created previously/ Create third bar that is docked next to the first and second/ i.e. on the line 1bar=new Bar(Bar3);bar.Name=leftBar3;bar.LayoutType=eLayoutType.DockContainer; / Dock Container Layout needed for dockable windowsbar.A

29、utoHideAnimationTime=0; / Some controls do not support animation so turn it offbar.Stretch=true; / Dockable windows stretch to fill containerbar.CanHide=true;bar.GrabHandleStyle=eGrabHandleStyle.Caption; / Dockable Windows have captionsdockItem=new DockContainerItem(leftDockItem3,Left Dock Container

30、 line 1);bar.Items.Add(dockItem);/ Create control that is hosted on dock containerdockedControl=new UserControl1();dockedControl.label1.Text=bar.Name+ - +dockItem.Text;dockedControl.BackColor=Color.LemonChiffon;dockItem.Control=dockedControl; / Specify that control is hosted on the dock containerdot

31、NetBarManager1.Bars.Add(bar); / DotNetBar needs to be aware of the bar so it can manage its docking etc.dotNetBarManager1.LeftDockSite.GetDocumentUIManager().Dock(bar);/ Setting the width of the dock site will also scale the bars docked inside,/ however the size should be large enough to accomodate all bars including the constraints like MinimumSize etc.dotNetBarManager1.LeftDo