📄 kdevelop-manual-11.html
字号:
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN"><HTML><HEAD> <META NAME="GENERATOR" CONTENT="LinuxDoc-Tools 0.9.21"> <TITLE>Kdevelop使用手册: 对话框编辑器</TITLE> <LINK HREF="kdevelop-manual-12.html" REL=next> <LINK HREF="kdevelop-manual-10.html" REL=previous> <LINK HREF="kdevelop-manual.html#toc11" REL=contents></HEAD><BODY><A HREF="kdevelop-manual-12.html">Next</A><A HREF="kdevelop-manual-10.html">Previous</A><A HREF="kdevelop-manual.html#toc11">Contents</A><HR><H2><A NAME="The Dialog Editor"></A> <A NAME="s11">11.</A> <A HREF="kdevelop-manual.html#toc11">对话框编辑器</A></H2><P>Kdevelop集成的对话框编辑器dialog editor允许通过图表的方式对控件widgets和你的应用使用的对话进行简易创建。你可以直接看见你的对话的外观,就象它为用户显示的一样。使用对话框编辑器dialog editor通常是你在创建了一个新的项目并用应用向导KAppWizard创建你的主视,用户交互对话, 和在完成图解工作及代码生成后要完成的第一步。这样, 你的项目将包含所有通常认为是很"困难"、一般要花很长时间才能实现的部分。然后, 你剩下的工作就是实现生成的代码中的功能了。本章涉及如何使用对话框编辑器dialog editor创建你的项目控件widgets及当你觉得你的控件widgets在进一步的开发过程中需要更正或增加时应该如何做。</P><P>你可以通过从视图菜单"View"中选择"对话框编辑器"或通过工具条相关按钮来切换到对话编辑器dialog editor。要切换回项目编辑器, 可从对话框编辑器dialog editor的视图菜单中选择"KDevelop""View"或按下相关工具条按钮。</P><P>对话框编辑器dialog editor的界面还为你提供了什么呢?主要来说, 按照主视图的分割,它的外貌和项目编辑器以及菜单条,工具条几乎一样。这允许你可以很快的习惯对话编辑器dialog editor, 而且,由于他完全和项目管理进行交互,如果你想要控制你的建立过程,你可以一直在对话框编辑器dialog editor里。需要切换回KDevelop的操作将为你自动完成它, 比如进入文件浏览器。只需选择菜单命令, Kdevelop将如你所愿。</P><P>下面的章节总体的介绍了对话框编辑器dialog editor界面, 最初如何创建一个新的对话及如何设置你的对话包含的孩子控件的widgets属性。</P><H2><A NAME="ss11.1">11.1</A> <A HREF="kdevelop-manual.html#toc11.1">对话框编辑器视图</A></H2><H3>主视</H3><P>对话框编辑器dialog editor视图逻辑分割为:<UL><LI>控件定位装置, 包含"控件", "对话" 及"项目"制表符。参见<A HREF="#Adding Widgets">添加控件</A>中的描述。</LI><LI>控件编辑器, 代表创建你的对话的编辑视图,参见<A HREF="#The Widget Editor">控件编辑器</A>。</LI><LI>属性窗口, 包含属性及其值的列表, 由当前再控件编辑器中选中的的控件决定。参见<A HREF="#Setting Properties">设置属性</A>以获得关于如何指明控件行为及外观的信息。</LI></UL></P><H3>与 Kdevelop不同的菜单条Menubar, 工具条Toolbar及状态条 Statusbar。</H3><P>在对话框编辑器模式, Kdevelop对菜单条, 工具条及状态条有些许改变以提供你创建控件widgets所需要的功能。它们是:</P><H3>菜单条Menubar</H3><P>文件菜单<B>"File"-menu:</B> 用"新的对话"取代"新的"。"打开"允许打开一个对话定义文件。</P><P>视图菜单<B>"View"-menu:</B> 用"控件-视图"取代"树-视图",激活/不激活控件-视图定位装置;加入"属性-视图"以激活/不激活属性-视图和"网格尺寸"来让你用水平及垂直的像素值指定网格尺寸。</P><P>建立菜单<B>"Build"-menu:</B> 由"生成资源"代替"编译文件Compile File"。这让你实际生成你对话的资源。</P><H3>工具条Toolbar</H3><P>工具条包含一个"新的对话"的新按钮,并由"生成资源"代替"编译文件CompileFile"。</P><H3>状态条Statusbar</H3><P>状态条为你提供关于当前选中的控件的信息, 尤其在坐标系中显示X及Y的值。对于状态条Statusbar帮助, 你将被提供与项目编辑模式同样的功能。</P><P>在改变控件尺寸时, 状态条会显示选中控件长宽的当前值。</P><H2><A NAME="ss11.2">11.2</A> <A HREF="kdevelop-manual.html#toc11.2">创建新的对话</A></H2><P>在创建了你的项目骨架后, 按照你的参数选择将为你提供一个运行准备好的了应用。由于Kdevelop提供项目类型KDE及Qt应用, 对话框编辑器dialog editor认可它并由以前的库提供的控件widgets来提供控件构造。要节省时间, 你还需在头脑中由格设计来完成想要的操作。要得到关于控件设计的信息, 请参见<A HREF="programming/index- 6.html">KDevelop编程手册</A>。要创建一个新的对话, 请从文件菜单"File"-menu中选择"新建"或在"对话"标签上从上下文菜单中选择"新建"。"新的对话"菜单会出现,你必须在此给Kdevelop一个对话---关于基础类资源文件名称及目的地的具体信息。</P><H3>对话类</H3><P>你可以选择的对话类, 是由你的新控件继承的类, 专门由类本身来代表。因此,你有以下选项:<OL><LI><B>QWidget:</B> Qt提供的所有用户交互控件widgets的基类。用于主视及最高层的控件widgets。</LI><LI><B>QFrame:</B> 继承<CODE>QWidget</CODE>并由众多控件widgets 用作基类。这对于除<CODE>QWidget</CODE>方法外还想拥有<CODE>QFrame</CODE>功能的控件widgets很有用。</LI><LI><B>Custom:</B> 继承一个必须在"自定义属性"中设置的自定义类。这可能是一个由你的项目提供或库的已经设计好的类。</LI><LI><B>QDialog:</B> 你要继承为用户交互--例如设置属性或改变参数--使用的对话的基类。</LI><LI><B>QTabDialog:</B> 继承QDialog并提供一个有预先定义的按钮及一套标签的对话, 这是你将由你要创建的控件widgets提供的。</LI></OL></P><P>自定义属性<B>Custom Properties</B></P><P>对在对话类域中选中的一个自定义类的继承, 你必须指定类名, 在"自定义类"里。对话编辑器dialog editor 使用它来生成代码;因此, 你还必须插入"自定义头部", 在此还必须设置自定义类的头文件名。</P><H3>文件</H3><P>在"文件"章节, 你必须键入控件的具体信息。即类名(这将是,例如对于一个允许选择钢笔颜色的对话:KColorSelectDlg), 头部, C++ 及数据文件名。当插入类名, 文件名将由对话编辑器dialog editor指定, 但是你也可以改变文件名。现在,你的文件又如何呢? 当你准备构建可视化控件时, 你将不得不生成包含了你的控件的实现implementation的文件。由于这将是一个类, 对话将与包含了类声明classdeclaration的头文件,一个包含了你的控件的方法和槽的实现implementation方法的C++文件一起存在。数据文件是包含了一个可由你的控件的构造器及<EM>initDialog()</EM>方法调用的函数。由于它将包含从对话框编辑器dialog editor生成的代码以在屏幕上创建控件这个文件本身不应该改动。如果你必须改变参数值, 你应该通过构造器来完成或保证你在开发过程中不会改变对话, 因为每次生成可你的控件的代码,数据文件都会被重写。头部及C++ 文件包含多个零件, 对话框编辑器dialog editor会在此编写;这些由评论标注。在文件生成后, 你可以改变任何值并在这些零件之外设置; 否则你的改动会在下一次代码生成时丢失。</P><H3>定位</H3><P>要生成控件的资源, 对话框编辑器dialog editor 需要知道他们将被设置的位置。output目录的缺省值是当前项目的子目录,它包含已有的资源。</P><P>在按下"确定"后, 你的缺省值就已经生成,一个空的控件构造器也打开。然后你就准备开始创建你自己的控件了。注意,对话框编辑器dialog editor 当前只支持没有几何管理的静态控件 widgets 。如果你准备为你的控件widgets使用几何管理, 你应该让自己习惯于Qt为此提供的类classes, 使用类生成器创建一个新的类并自动编写自己的控件。要获得更多信息,请参见<A HREF="programming/index.html"> KDevelop编程手册</A>。</P><H2><A NAME="Adding Widgets"></A> <A NAME="ss11.3">11.3</A> <A HREF="kdevelop-manual.html#toc11.3">增加控件</A></H2><P>在指定了对话或控件widgets的类及文件名以后, 你可以准备开始创建控件并充实其内容.为你的对话增加低水平的控件widgets是件很容易的事. 只需从左边的"控件"定位装置中通过在相关控件按钮上单击选择你要加入的控件. 然后控件就会放于当前打开的主控件的左上角. 一个增加的控件会在编辑器editor视图中得到缺省的100x30像素的大小. 要移动一个控件, 在其上点击以激活绘图框架, 它以深灰色显示,控件的顶部,底部,左边,右边的中间及角落上都有热点。十字光标表明控件可以移动。要移动它, 请按下鼠标左键不动,然后用你的鼠标移动控件到你希望它其后显示的位置.</P><P>要对一个控件重新设置大小, 请在一个已经激活的项目的热点上方移动你的鼠标光标。鼠标光标会变为双箭头,表明重设大小的方向。按下鼠标左键不放。当鼠标移动到光标指示的方向时,控件项目会改变它的大小。</P><P>另外, 控件编辑器包含许多上下文菜单以帮助你协调你的工作。这些对控件widgets定位器中所有项目都可用,并提供一个快速帮助信息框,显示选中控件的类名并给予简短叙述。在选中控件上方, 上下文菜单显示选中项目的类名并提供:</P><P><UL><LI>升高</LI><LI>降低</LI><LI>升到顶部</LI><LI>降到底部</LI><LI>剪切</LI><LI>删除</LI><LI>拷贝</LI><LI>粘贴</LI><LI>帮助</LI></UL></P><P>在设置了尺寸和位置后, 你可以在参数窗口编辑选中项目的参数。</P><H3>控件定位装置</H3><P>对话框编辑器控件<!--dialog editor widgets-->控件widgets 标签代表你可以放于对话的控件widgets。如果你想得到关于某个控件的信息, 请在控件按钮上按下鼠标右键并从弹出菜单中选择"快速-帮助"。注意如果你的项目类型是纯Qt或KDE的,对话框编辑器dialog editor是自动测定的。这会阻止你在Qt应用中使用KDE-widgets。在你选中了一个控件项目后, 它将以缺省尺寸及参数值放置于编辑器窗口并由一个框架和涂黑的角标注为选中. 要改变一个控件的大小, 请在一个黑色的点山移动你的鼠标,你的光标会改变以显示可能的变改方向. 然后一直按下鼠标键并移动鼠标. 当你完成控件尺寸的改动后,松开鼠标. 在改变尺寸时, 状态条将通过X和Y的值显示项目的当前位置,并以W(宽) 和H(高)的值显示当前大小.</P><H3>对话定位装置</H3><P>项目对话<!--project dialogs-->对话定位装置旨在让你通过鼠标点击打开你的项目的对话. 由于对话的结构时保存于在包含了生成的文件的目录中的一个*.kdevdlg 文件内, 只有那些对话定义文件会显示. 还要注意不要删除了这些定义文件.</P><P>选择了一个对话后, 它会在控件编辑视图中显示上一次编辑步骤后保存的状态.</P><H3>项目定位装置</H3><P>对话项目<!--dialog items-->项目定位装置让你可以分级的浏览当前显示的对话的控件项目. 这意味着, 由于你的背景代表了对话中所有控件widgets的父体, 它将显示在树的顶部. 主对话的孩子则列于树的下一个级别.</P><P>选择了一个项目后, 它会标注于编辑器视图中, 其属性也会显示于属性窗口.使用项目视图有时很重要,如果你控件widgets的行为要依靠父子关系的话。</P><H2><A NAME="The Widget Editor"></A> <A NAME="ss11.4">11.4</A> <A HREF="kdevelop-manual.html#toc11.4">控件编辑器</A></H2><P>控件编辑器是居中的主视,你棵在此构造你的控件. 在增加了一个控件后, 它们可以选中并重设大小, 或移动到你需要的位置. 对于所有项目, 弹出菜单会提供快速进入例如剪切,复制,插入等操作的途径。</P><H2><A NAME="Setting Properties"></A> <A NAME="ss11.5">11.5</A> <A HREF="kdevelop-manual.html#toc11.5">设置属性</A></H2><P>设置控件属性<!--setting widget properties-->右端的属性窗口是你可以设置控件及其项目缺省行为的地方. 它会立即展示每个选中项目的预设值; 改变参数值会导致控件编辑器视图的直接变化, 例如,名称标签或按钮.</P><P>要通过其效果分开一定的属性值, 属性窗口包含四个文件夹; 选择其一会弹出属性组的所有值. 所有可能的值都得到描述. 注意,属性相对于控件独立, 例如,一个标签和按钮会有在显示屏幕上的名称属性, 而行编辑会有方法属性,例如<EM>setText()</EM>.</P><P>对于每个项目可用值的完全列表, 你可以查看控件的类-参考,它解释了所使用的方法及所有可能的值. 注意,大多数值在<CODE>QWidget</CODE> 中得到应用,并由所有继承了QWidget的widgets所使用. 还要注意最终代码并不包含任何不可由用户改变因此只能使用控件构造器所给定的缺省值的方法调用.</P><P>所支持的可在属性窗口为每个控件项目设置的属性的完整列表.</P><H2><A NAME="ss11.6">11.6</A> <A HREF="kdevelop-manual.html#toc11.6">生成文件</A></H2><P>对话源代码的生成<!--dialog sourcecode generation--></P><P>在生成了一个控件后, 你必须生成源代码以让它在你的项目中可用. 这可以由"建立"菜单的"生成资源"或通过对话框编辑器dialog editor工具条上的相关按钮来完成. 你的Makefiles 将自动更新以在编译程序中包含新的控件; 因此, 在调用了"生成资源"以后, 你可以在对话框编辑器dialog editor中再次建立你的项目. 在项目编辑器模式下输出output window在控件编辑器窗口下弹出.</P><P>现在你的项目包含了一个新的控件, 你作为程序员的工作就是实现所使用的槽的功能,并最后加入你可能需要的其他方法. <BLOCKQUOTE>参见 <A HREF="programming/index- 6.html">KDevelop编程手册, 对话框编辑器</A>以获取关于控件属性及资源代码生成的更多信息.</BLOCKQUOTE></P><HR><A HREF="kdevelop-manual-12.html">Next</A><A HREF="kdevelop-manual-10.html">Previous</A><A HREF="kdevelop-manual.html#toc11">Contents</A></BODY></HTML>
⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -