Winform DevExpress控件库(三) 使用NavBarControl控件定制导航栏


NavBarControl控件:主要做用是制做包含多个选项组而且每一个组里包含多个子选项的导航栏;
工具


位于 工具箱 -> Navigation & Layout(导航栏与布局类控件) 目录下;布局


在工具箱输入名称NavBarControl检索,而后直接拖拽到面板上即可使用,最好是放在一个子容器里(好比PanelControl);动画



NavBarControl控件经常使用属性描述:(选中NavBarControl控件实例,打开属性窗口)


蓝色为经常使用属性     红色为未知属性、几乎不会用到或不多用到的属性、其余托管属性、暂时不须要咱们去处理的属性spa


BarManager  
        MenuManager (BarManager)菜单管理
布局  
        Anchor (enum)控件锚点
通用属性,设置Top、Bottom、Right、Left四个位置以使
控件在指定方位跟随父容器变换而变换
        Dock (enum)控件在父容器中停靠方式
通用属性,五个可选值设置使控件停靠在父容器的上下左
右四个方位或充满整个父容器
        Location(X,Y) (int)控件的位置
通用属性,上方Dock属性为None时生效
        Size(W,H) (int)控件的长宽
通用属性,上方Dock属性为None时生效
行为  
        AllowDrop (bool)是否接收用户拖到控件上的数据
        Enabled (bool)控件是否激活
        LinkSelectionMode (enum)指定当前选中的项目是否保持选中
        TabIndex (int)tab键切换焦点的索引
        TabStop (bool)是否禁用tab键切换焦点
Visible (bool)控件是否可见
数据  
Groups (NavGroupCollection)当前导航栏的全部分组
Items (NavItemCollection)当前导航栏的全部选项
外观  
ActiveGroup                                                          
(NavBarGroup)当前展开的分组,PaintStyle不为
ExplorerBar(也就是同时只能有一个分组展开)时生效
Appearance (NavBarAppearances)整个控件的外观属性设置,应用
于控件中的全部部件
HotTrackedGroupCursor (enum)鼠标停在分组上的显示样式
HotTrackedItemCursor (enum)鼠标停在选项上的显示样式
LargeImages (ImageList)大图标集合,可供控件下的其余部件在其中
选择本身的大图标
LinkInterval (int)行间距
LookAndFeel 控件使用的皮肤
        NavigationPaneGroupClientHeight (int)导航面板组的高度,决定下方的分组栏目是否缩进
        NavigationPaneMaxVisibleGroups (int)导航面板最大可见分组
        NavigationPaneOverflowPaneUse
        SmallImages
(bool)导航窗格被缩进的分组是否使用小图标
    OptionsNavPane(导航窗格的选项设置)  
        AllowOptionsMenuItem (bool)菜单项是否容许选择
        AnimationFramesCount (int)导航栏缩进动画的帧数
        CollapsedNavpaneContentControl (Control)整个导航栏缩进时显示的控件
        CollapsedWidth (int)导航栏缩进时保持的宽度
        ExpandButtonMode (enum)导航栏缩进的方向,好比靠左仍是靠右
ExpandedWidth (int)导航栏展开时的宽度
        GroupImageShowMode (enum)导航栏的分组在什么状况下才显示图标
        MaxPopupFormWidth (int)导航栏缩进时,点击选项弹出的窗口最大值
        NavPaneState (enum)当前导航栏的状态,是展开仍是缩进
ShowExpandButton (bool)是否显示导航栏缩进按钮
        ShowGroupImageInHeader (bool)是否显示当前已展开分组的图标
        ShowHeaderText (bool)是否显示当前已展开分组的名称
ShowOverflowButton (bool)是否显示导航栏中分组的缩进按钮
ShowOverflowPanel (bool)是否显示导航栏中分组的缩进平面
        ShowSplitter (bool)是否显示分割线
   
PaintStyleKind (enum)导航栏的模式,好比同时只容许展开一个分组
或者能够多个分组一块儿展开
PaintStyleName (enum)导航栏的样式
RightToLeft (enum)导航栏是不是从右到左对齐
SkinExplorerBarViewScrollStyle (enum)PaintStyleKind为ExplorerBar模式时,内容超出
时的进度条显示模式
SmallImages (ImageList)控件的小图标集合,对应当前项目中的任一
图片集
Text (string)控件的显示内容
UseWaitCursor (bool)鼠标通过此控件时是否切换为等待状态光标
   


1、新建一个导航栏


拖入一个panel到窗口上作为导航栏的容器,而后再拖入一个NavBarControl到其上,点击NavBarControl控件的右上角三角箭头展开任务列表,选择PaintStyle模式为Navigationpane,也就是同时最大展开的分组数目为1。设计





2、手动为导航栏添加数据


点击控件右上角三角箭头展开任务列表,选择Run Designer打开设计界面。code




设计界面的Main -> Groups/Items/Links为导航栏的分组及子项目编辑界面,咱们进入此界面,在右侧的NavBar Groups窗口内点击鼠标焦点至此窗口时,上方的添加按钮能够添加新的分组,在右侧的NavBar Items窗口内点击鼠标焦点至此窗口时,上方的添加按钮能够添加新的子项目,选中每一个分组或子项目能够在右侧的属性窗口快捷设置他的经常使用属性,添加好了多个分组和子项目时,须要将子项目指定到某一分组内,直接用鼠标拖动NavBar Items中的子项目到NavBar Groups中的该分组下。orm




咱们建立好了多个分组和子项目后,直接点击运行,查看此时的效果。blog





3、捕获导航栏的基本事件


捕获导航栏子项目的鼠标点击事件LinkClicked:索引


public Form1()
        {
            InitializeComponent();

            OtherInit();
        }
        /// <summary>
        /// 其余的初始化处理
        /// </summary>
        private void OtherInit()
        {
            navBarItem1.LinkClicked += Item_Click;
            navBarItem2.LinkClicked += Item_Click;
            navBarItem3.LinkClicked += Item_Click;
            navBarItem4.LinkClicked += Item_Click;
            navBarItem5.LinkClicked += Item_Click;
            navBarItem6.LinkClicked += Item_Click;
            navBarItem7.LinkClicked += Item_Click;
            navBarItem8.LinkClicked += Item_Click;
            navBarItem9.LinkClicked += Item_Click;
        }
        /// <summary>
        /// 导航栏子项目的点击事件
        /// </summary>
        private void Item_Click(object sender, NavBarLinkEventArgs e)
        {
            MessageBox.Show("点击了子项目:" + e.Link.Caption);
        }





4、动态更改导航栏数据


只须要根据数据动态的建立分组和子项目,并将子项目添加到分组之下:事件


NavBarGroup nbGroup1 = new NavBarGroup();
            nbGroup1.Name = "nbGroup1";
            nbGroup1.Caption = "动态添加的分组";
            nbGroup1.SmallImageIndex = -1;
            nbGroup1.LargeImageIndex = -1;
            //添加到导航栏全部分组集合
            navBarControl1.Groups.Add(nbGroup1);


            NavBarItem nbItem1 = new NavBarItem();
            nbItem1.Name = "nbItem1";
            nbItem1.Caption = "动态添加的子项目";
            nbItem1.SmallImageIndex = -1;
            nbItem1.LargeImageIndex = -1;
            nbItem1.LinkClicked += Item_Click;
            //添加到导航栏全部子项目集合
            navBarControl1.Items.Add(nbItem1);


            //添加子项目至某一分组
            nbGroup1.ItemLinks.AddRange(new NavBarItemLink[] {
                new NavBarItemLink(nbItem1)
            });


相关文章
相关标签/搜索