C1ToolBar工具栏将出现在C1ToolBar控件上。为了显示C1ToolBar工具栏，滑动您的鼠标光标至C1ToolBar控件的左上角区域。Open按钮将出现，用来打开C1ToolBar工具栏。

打开和关闭C1ToolBar工具栏

为打开C1ToolBar工具栏，点击按钮。为关闭C1ToolBar工具栏，点击按钮。
C1ToolBar工具栏包含以下命令按钮：

工具栏按钮	描述
	添加新的命令链接添加新的命令链接/命令：命令：向工具栏当前的命令之后添加一个新的命令。
	编辑命令链接：编辑命令链接：打开C1CommandLink 集合编辑器来编辑命令链接。
	编辑工具栏外观：编辑工具栏外观：打开C1ToolBar 外观对话框，在此您可以设置C1ToolBar控件的通用外观属性。
	编辑工具栏布局：编辑工具栏布局：打开布局对话框，在此您可以为CToolbar控件设置布局属性。
	编辑工具栏杂项属性：编辑工具栏杂项属性：打开C1ToolBar控件的Miscellaneous对话框，在此您可以应用行为相关的设置至C1ToolBar控件。

添加命令链接

点击添加命令链接按钮在当前命令之后添加一个新的命令。它将在新的命令下方显示Link to Command设计器，因此您可以容易地编辑新的命令，而不需要离开当前设计界面。

编辑命令链接

点击编辑命令链接按钮打开C1CommandLink 集合编辑器，在此您可以添加或删除命令链接并编辑commandlink的属性。
编辑工具栏的外观点击编辑工具栏外观按钮打开工具栏外观对话框，在此您可以修改C1ToolBar控件的外观属性。

下表定义了包含在C1ToolBar控件外观对话框中的项目：

项目	描述
*General*
Visual style	视觉样式下拉框包含以下选项，您可以从中选择以改变C1ToolBar控件的样式： Custom，System，Office2007Blue，Office2007Black，Office2007Silver， Office2003Blue，Office2003Olive，Office2003Silver，OfficeXP，Classic，以及 WindowsXP。
Text	Text文本框显示出现在选中的工具栏按钮上的文本名称。为重命名工具栏按钮的文本，请选中Text文本框中的文本，并键入期望的文本名称。
Font	字体下拉框打开字体对话框，在此您可以修改C1ToolBar控件的字体样式属性。
颜色
Foreground	Forground下拉列表框包含Custom，System，以及Web分类的颜色，您可以从中选取颜色设置C1Toolbar控件的前景色。
Highlight (ForeHiColor)	Highlight下拉列表框包含Custom，System，以及Web分类的颜色，您可以从中选取颜色设置设置C1ToolBar高亮显示的按钮的前景色。
Background	Background下拉列表框包含Custom，System，以及Web分类的颜色，您可以从中选取颜色设置C1ToolBar控件高亮显示按钮的背景色。
Highlight (BackHiColor)	Background下拉列表框包含Custom，System，以及Web分类的颜色，您可以从中选取颜色设置C1TopicBar控件中高亮显示项目的背景色。
背景图像

Image	图像下拉框打开Open对话框，在此您可以选取应用为C1ToolBar控件背景图片的图像。
Layout	布局下拉框打开一个布局选项（None，Tile，Center，Stretch，以及Zoom）的列表，您可以从中选择设置C1ToolBar控件的背景图像布局。
Show in image bar	在图像栏中显示复选框指示当工具栏的样式为Drop-downMenu时，是否在图像栏显示背景图像。（如果选中则为True；否则为False）
边框
Style	样式下拉框包含边框样式的列表，您可以从中选择设置C1ToolBar的边框样式。
Width	Width NumericUpDown控件设置C1ToolBar周围边框的宽度。
Light color	Light color下拉列表框包含Custom，System，以及Web分类的颜色，您可以从中选取颜色设置C1ToolBar控件周围边框的亮色颜色。
Dark color	Dark color下拉列表框包含Custom，System，以及Web分类的颜色，您可以从中选取颜色设置C1ToolBar控件周围边框的暗色颜色。
Edges	Edges复选框（Left，Right，Top，以及Bottom）允许您指定将此边框样式应用到哪一边。
Reset properties to default	选择重置属性为默认值选项重置修改过的C1ToolBar的属性为其默认值。

编辑工具栏布局点击编辑工具栏布局按钮打开"布局"对话框，在此您可以修改C1ToolBar控件的布局属性。

下表定义了包含在C1ToolBar控件布局对话框中的项目：

项目	描述
*General*
Toolbar style	工具栏样式下拉框包含ToolBarStyle 属性的两个选项（Default以及DropdownMenu），您可以从中选取设置工具栏的样式。
Horizontal	水平复选框指示设置C1ToolBar的方向为水平方向。（如果选中则为True；否则为 False）。
Movable	可移动复选框指示是否用户可以移动工具栏。（如果选中则为True；否则为False）
Wrap	Wrap复选框指示当一行无法显示下全部的项目时是对工具栏进行折行还是显示一个 \"More...\" 按钮。（如果选中则为True；否则为False）
按钮
Alignment	Alignment下拉框获取垂直工具栏按钮的对齐方式，可用的选项包括Left，Right，或者 Center。
Minimum button size	最小按钮尺寸获取或设置工具栏上按钮的最小尺寸（宽度和高度）。
Button width	按钮宽度获取或设置所有按钮的宽度（仅应用到水平工具栏；如果设置为0，则每一个按钮单独指定尺寸）。
Wrap text in buttons	按钮中文本折行复选框获取或设置一个值，该值指定是否当C1ToolBar.ButtonWidth的值大于零，且宽度无法放下全部文本时，链接的文本是否折行显示。
水平方向
Layout	布局下拉框包含以下成员，用作设置C1ToolBar类型实例的 C1ToolBar.ButtonLayoutHorz属性：Default，Image，Text，以及TextAndImage。
Look	ook下拉框包含以下成员，用作设置C1ToolBar类型实例的C1ToolBar.ButtonLookHorz 属性：TextAbove，TextBelow，TextOnLeft，以及TextOnRight。
Enforce look on all buttons	Enforce look on all buttons复选框获取水平方向全部按钮的指定外观。
竖直方向
Layout	布局下拉框包含以下成员，用作设置C1ToolBar类型实例的C1ToolBar.ButtonLookVert 属性：Default，Image，Text，以及TextAndImage。
Look	Look下拉框包含以下成员，用作设置C1ToolBar类型实例的C1ToolBar.ButtonLookVert 属性：TextAbove，TextBelow，TextOnLeft，以及TextOnRight。
Enforce look on all buttons	Enforce look on all buttons复选框获取垂直方向全部按钮的指定外观。
Reset properties to default	选择重置属性为默认值选项重置修改过的C1ToolBar的布局属性为其默认值。

编辑杂项属性单击编辑Miscellaneous属性按钮打开C1ToolBar对话框，在此您可以编辑C1ToolBar控件的各种杂项属性。

下表定义了包含在C1ToolBar控件的C1ToolBar对话框中的字段：

项目	描述
*Behavior*
Enabled		Enabled复选框指示该C1ToolBar将在运行时启用。（如果选中则为True；否则为False）
Visible		Visible复选框指示是否C1Toolbar控件在运行时可见。（如果选中则为True；否则为False）
AutoSize		AutoSize复选框指示是否工具栏自动调整其尺寸以适应显示全部项目。（如果选中则为True；否则为False）
Show tooltips		显示工具提示复选框获取或设置一个值，该值指示当鼠标移动到工具栏按钮时是否显示工具提示文本。
Minimum size		最小尺寸的字段包括一个指定C1ToolBar最小宽度和高度尺寸的表示宽度和高度的NumericUpDown控件。
Maximum size		最大尺寸的字段包括一个指定C1ToolBar最大宽度和高度尺寸的表示宽度和高度的NumericUpDown控件。
Dock		Dock下拉框包含一些项目，您可以从中选择定义C1ToolBar控件的哪一边绑定到容器。
Close More menu on item click		单击项目关闭额外菜单复选框获取或设置一个值，该值表示当一些项目无法在工具栏上显示时自动创建的菜单，在其中某个项目单击时是否关闭此菜单。
Cursor		Cursor下拉框打开一个不同类型的光标项目列表，您可以从中选择设置当鼠标指针移动到C1ToolBar控件上方时，出现的光标类型。

Use wait cursor		Use wait cursor复选框指示是否使用表示等待状态的光标。
自定义
customize button	自定义按钮复选框指示是否显示自定义按钮。（如果选中则为True；否则为False）
Options	Options下拉框包含以下成员，用于设置C1ToolBar类型的实例上的 C1ToolBar.CustomizeOptions属性的值：AllowAddItem，AllowAll， AllowDelete，AllowNone，AllowRemoveItem，以及 AllowToggleCustomizeButton。
*Design*
Generate member	Generate member复选框指示是否为C1ToolBar控件的成员生成代码。（如果选中则为True；否则为False）
Locked	Locked复选框指示是否C1ToolBar为锁定状态。（如果选中则为 True；否则为False）
Show invisible items	Show invisible items复选框指示是否在C1ToolBar控件上显示不可见的按钮。（如果选中则为True；否则为False）
Margin	Margin指定C1ToolBar控件和另一个控件之间的间距。
Reset properties to default	选择重置属性为默认值项目重置C1ToolBar控件修改过的属性为其默认值。

菜单和工具条概述
C1Command将一套完整的菜单和工具条集成到简单的系统中，这样将允许你通过简单的对象和代码来复用菜单条目和工具条按钮。
C1Command提供五种主要的对象来生成菜单系统，包括C1MainMenu, C1CommandMenu, C1CommandControl,
C1CommandMdiList, 和C1ContextMenu。同样的，用于生成工具条系统的几种主要对象包括C1ToolBar，
C1CommandMenu，C1CommandControl，C1CommandMdiList，和C1ContextMenu。两类对象唯一的不同在于两个私有控制器：C1MainMenu和C1ToolBar。

C1MainMenu

C1MainMenu是一类主要用于在Windows表单中显示主要菜单的控制器。当你将这个对象放置到你的表单中，它将显示在表单的上部横跨整个窗口，就像常规Windows主菜单一样。除了在表单上部的主菜单之外，一个C1CommandHolder 将自动的显示在组件托盘处。C1CommandHolder作为一个单独连接，将存储所有的菜单命令。想要了解更多关于如何使用C1CommandHolder，请参阅C1CommandHolder Component。
C1CommandLink类型的命令链接主要用于代表菜单中的命令。

C1ToolBar

C1ToolBar是一款代表工具条的控制器。就像C1MainMenu一样，它包括一个存储在C1CommandHolder组件中的命令链接。命令链接代表着主菜单的菜单条目，同理，C1ToolBar 的命令链接主要代表工具条上的按钮。
下面的章节主要介绍菜单和工具条的详细功能，并且介绍用于创建菜单和工具条系统的命令和一系列的对象。
菜单和工具条功能
菜单条目和工具条按钮的常用功能与C1Command中的功能类似。菜单条目或者工具条按钮通过两个组件进行区分，分别是：command 和command link。

C1Command 组件的功能

command （一个C1Command类型对象或者或者此对象派生的其他对象，更多详细信息，请参阅ClassHierarchy）主要使用属性以及事件句柄来连接命令代表的实际动作。命令并不包含在C1Commands菜单和工具条中。取而代之的是，所有的表单中的命令都作为一个单独连接存储在C1CommandHolder组件中，这是一个单例对象，它将在你添加第一个
C1Commands菜单和工具条时自动创建在表单中。

C1CommandLink 组件功能

command link是一个小巧而简单的组件。Command是它最重要的属性，主要用于指向命令链接中实际的命令对象。除了这一点，命令链接允许你重载部分已经连接的命令属性。例如文本等。命令链接的外观主要取决于两个因素：命令连接到何处，以及连接内是否包含主菜单，弹出式菜单或者工具条。
属性主要用于显示从命令中取出的命令链接。例如，文本或者图片，同理，它们的显示方式将取决于容器。例如，在一个主菜单中，只有命令的文本才能够显示，在一个弹出式菜单中，图片和快捷键同样显示，等等。多个命令链接可以指向同一个命令，这也是命令和命令链接进行条目区分的主要原因之一。
命令，命令链接，菜单和工具条以及命令持有者的关系。简单概括后，下面的关系存在于表单中的命令，命令链接，菜单和工具条以及命令持有者之间：
命令（C1Command类和其子类）自动存储在表单中的命令持有者（一个C1CommandHolder类型对象）中
菜单和工具条（一个C1MainMenu, C1CommandMenu, C1ContextMenu,C1ToolBar类型对象），包括命令链接（C1CommandLink类型），命令链接代表菜单条目或是工具条按钮。每个命令链接都代表一个命令持有者中的实际命令。命令链接存储在菜单或是工具条中的CommandLinks 连接中。
多个命令链接能够指向同一个命令。并且命令链接可以指向不同容器中的同一个命令。例如，文件菜单或者其他文件选项工具条中的链接可以指向同一个文件打开命令。
用户可以看到大部分命令链接中的属性（文本，图片或是其他等等）。命令链接的显示状态（可见/不可见，选中/未选中，以及其他等等）都由已经连接的命令（命令链接并不含有状态属性）的一致状态决定。
更重要的是，事件句柄将展示用户定义的实际动作（例如，打开文件，或是复制到剪贴板），通常使用
commands 而不是command links。当一个菜单条目被选中或是一个工具条按钮被点击之后，已连接命令的单击事件句柄将被激活。
想要列举所有报表中的命令，可以使用Commands 收集所有的命令持有者（显示在表单组件工具栏中）。你同样可以使用Connection编辑器来添加或是删除命令（虽然使用菜单或是工具条设计器是一种更简单的方式来访问命令的链接）。
创建菜单和工具条常用对象
C1Command的菜单和工具条使用下面的对象来创建菜单和工具条系统：
C1CommandHolder component
C1CommandMenu command
C1ContextMenu control
C1CommandControl command
C1CommandMdiList command
下面的章节主要介绍创建菜单和工具条过程中使用到的命令和组件。

Page tree

C1ToolBar 工具栏