eclipse 用户界面指南.htm

是Eclipse Interface Guide的中文翻译。比较详细的介绍了界面开发。

    <TD>Local Toolbar图标：在视图标题区域的最右边<BR>Overlay图标： 
      在模型对象图标的上面，用来表示条件的改变。 <BR>Model 
      Object图标：在Tree视图，List视图和Properties视图中使用。 
      <BR>View图标和Perspective图标：位于视图的左上角。</TD></TR>
  <TR vAlign=top bgColor=#e4e4e4>
    <TD>*_mode</TD>
    <TD>切换视图的工作模式</TD>
    <TD>Local Toolbar图标：在视图标题区域的最右边。</TD></TR>
  <TR vAlign=top>
    <TD>*_menu</TD>
    <TD>菜单中</TD>
    <TD>Local Toolbar图标：在视图标题区域的最右边。 </TD></TR>
  <TR vAlign=top bgColor=#e4e4e4>
    <TD>*_ps</TD>
    <TD>属性页中</TD>
    <TD>Local Toolbar图标：在视图标题区域的最右边。 
      <BR>View图标和Perspective图标，在视图的左上角。 </TD></TR>
  <TR vAlign=top>
    <TD>*_obj</TD>
    <TD>表示模型对象</TD>
    <TD>Model Object图标：在Tree视图，List视图和Properties视图中使用。</TD></TR>
  <TR vAlign=top bgColor=#e4e4e4>
    <TD>*_pal</TD>
    <TD>对象调色板的模型对象图标</TD>
    <TD>Model Object图标：在对象调色板中使用</TD></TR>
  <TR vAlign=top>
    <TD>*_co</TD>
    <TD>系统命令，例如，build命令</TD>
    <TD>Toolbar图标：在级联菜单和全局工具条中使用。 <BR>Local 
      Toolbar图标：在视图标题区域的最右边。 </TD></TR><!-- Use the following table row if the last row of data has a white background. It provides
a line to define the table information from the rest of the text. If the last row of data has
the dark gray background, you don't need it, so comment it out. -->
  <TR vAlign=top bgColor=#e4e4e4 height=1>
    <TD></TD>
    <TD></TD>
    <TD></TD></TR></TBODY></TABLE><BR></TD></TR></TABLE><BR>为了帮助你选择合适的文件名，我们提供以下指南： 

<P><IMG height=16 
src="http://www.eclipse.org/articles/Article-UI-Guidelines/images/guidelineIndicator.gif" 
width=16> <B><FONT color=#09448d>指南 2.16</FONT></B> 
<BLOCKQUOTE><FONT color=#09448d>采用缩写文件名，不要使用图标名称的全名。 
  例如，New Interface 变成 “newint” 。</FONT></BLOCKQUOTE>
<P></P>
<HR>

<P><IMG height=16 
src="http://www.eclipse.org/articles/Article-UI-Guidelines/images/guidelineIndicator.gif" 
width=16> <B><FONT color=#09448d>指南 2.17</FONT></B> 
<BLOCKQUOTE><FONT color=#09448d>在文件名中使用小写字母。 例如，DTD 写成 
  “dtd”。</FONT></BLOCKQUOTE>
<P></P>
<HR>

<P><IMG height=16 
src="http://www.eclipse.org/articles/Article-UI-Guidelines/images/guidelineIndicator.gif" 
width=16> <B><FONT color=#09448d>指南 2.18</FONT></B> 
<BLOCKQUOTE><FONT color=#09448d>在文件名中尽可能使用少于10个字母。 
  （下划线也作为一个字母计算）</FONT></BLOCKQUOTE>
<P></P>
<HR>

<P><IMG height=16 
src="http://www.eclipse.org/articles/Article-UI-Guidelines/images/guidelineIndicator.gif" 
width=16> <B><FONT color=#09448d>指南 2.19</FONT></B> 
<BLOCKQUOTE><FONT 
  color=#09448d>使用文件名后缀来描述它在工具中的位置和功能。例如newint_wiz。</FONT></BLOCKQUOTE>
<P></P>
<HR>

<P><IMG height=16 
src="http://www.eclipse.org/articles/Article-UI-Guidelines/images/guidelineIndicator.gif" 
width=16> <B><FONT color=#09448d>指南 2.20</FONT></B> 
<BLOCKQUOTE><FONT 
  color=#09448d>对于所有的用户界面图标和向导图形，使用透明背景的 *.gif 
  格式，除非应用环境要求不同的文件格式。</FONT></BLOCKQUOTE>
<P></P>
<HR>

<P><IMG height=16 
src="http://www.eclipse.org/articles/Article-UI-Guidelines/images/guidelineIndicator.gif" 
width=16> <B><FONT color=#09448d>指南 2.21</FONT></B> 
<BLOCKQUOTE><FONT color=#09448d>保留提供的?shy;始文件名。</FONT></BLOCKQUOTE>
<P></P><!-- IMPLEMENTATION CONVENTIONS SECTION ENDS --><!-- END OF VISUAL DESIGN CONTENT -->
<H2><A name="Component Development"></A>组件开发</H2>
<H3><A 
name=Commands></A>命令</H3>命令是被用户调用来执行某些特定的功能，它可以作为菜单项出现，也可以是工具条中的一项。 
因此，它有菜单项或者工具项标签，工具提示（Tooltip）以及图像等属性。 
<P>作为plug-in开发者，你可以在窗口菜单条和工具条中，或者单独的视图和编?shy;器中添加自定义的命令。 
在窗口中可以添加一个action set，action 
set是一系列用户可以显示或者隐藏的针对任务的命令。在视图或编?shy;器中只能添加单个的命令。 

<P>下面演示了添加自定义命令的主要区域。 
<P><IMG height=664 hspace=40 
src="http://www.eclipse.org/articles/Article-UI-Guidelines/images/actionExamples.gif" 
width=789> 
<P>在本节中，我们来看一下通用的命令指南。对于针对窗口，视图，编?shy;器的相关指南，请参见<A 
href="http://www.eclipse.org/articles/Article-UI-Guidelines/index_cn.html#Windows">窗口</A>，<A 
href="http://www.eclipse.org/articles/Article-UI-Guidelines/index_cn.html#Views">视图</A>，和<A 
href="http://www.eclipse.org/articles/Article-UI-Guidelines/index_cn.html#Editors">编?shy;器</A>. 

<H4>外观</H4>
<P>每个命令必须有标签，工具提示和图像。如果命令在工具条中出现，命令图像会显示在所有平台中。如果命令出现在菜单中，图像只能在某些平台下显示，例如Windows 
2000 。 
标签和工具提示必须使用标题大写风格，就如我们在通用用户界面指南中定义的那样。 
<P>每个命令必须提供一个全彩色图像。该图像会在鼠标移到命令上时显示。它也可以在普通命令使用中作为可用，不可用和按下 
状态图像。在代码中添加的命令也有选项可以定义可用，不可用和反转（roll 
over）的图像。 该选项可以更好地控制图像外观。 
<P>下面显示了工具条（译：工具提示）中标题大写形式的使用。 
<P><IMG height=141 
src="http://www.eclipse.org/articles/Article-UI-Guidelines/images/tooltipCaps.gif" 
width=244> <BR>&nbsp; 
<P><IMG height=16 src="" width=16><B><FONT color=#09448d>指南 3.1</FONT></B> 
<BLOCKQUOTE><FONT 
  color=#09448d>每个命令必须有标签，工具提示和全彩色图像。标签和工具提示 
  必须使用标题大写风格。</FONT></BLOCKQUOTE>
<HR>

<P>命令的tooltip必须描述命令被调用时的<I>行为</I>，并且当前状态无关。对于按钮，<EM>标签</EM>必须描述用户按下该按钮时的结果。对于图钉按钮（Toogle 
Bbutton），要描述当其被钉住时的效果，而且，标签不应该随着按钮的状态变化。 
在Eclipse 2.1 版本中，建议命令的工具提示使用和命令标签一样的文字。 
例如，在下面的截图中，可以看到 Show Type Hierarchy按钮的行为使用工具提示来显示。 

<P><IMG height=169 hspace=40 
src="http://www.eclipse.org/articles/Article-UI-Guidelines/images/goodTooltips.gif" 
width=213> 
<P><IMG height=16 
src="http://www.eclipse.org/articles/Article-UI-Guidelines/images/guidelineIndicator.gif" 
width=16><B><FONT color=#09448d>指南 3.2</FONT></B> 
<BLOCKQUOTE><FONT 
  color=#09448d>命令的工具提示必须描述命令的结果，而不是其当前状态。 
  使用和命令标签同样的文字。</FONT></BLOCKQUOTE>
<HR>

<P>为了保持一致，在workbench中行为相似的命令都必须采用同样的术语。 
<P>在创建资源时，在命令或向导中必须使用 “New” 这个词。例如"New File"，"New 
Project" 和 "New Java Class"。 在删除存在的资源时必须使用 "Delete"这个词。 
<P><BR>在资源中创建对象时，（例如，在XML文件中的tag； 
Java类中的方法或者field），必须使用”Add“这个词。 用户在现有的资源中添加东西。 
<P><IMG height=16 
src="http://www.eclipse.org/articles/Article-UI-Guidelines/images/guidelineIndicator.gif" 
width=16><B><FONT color=#09448d>指南 3.3</FONT></B> 
<BLOCKQUOTE><FONT color=#09448d>对于New，Delete和Add 
  命令，采用workbench的标签术语。</FONT></BLOCKQUOTE>
<HR>

<P>
<H4>可用性</H4>一个命令只有在能够成功执行的时候才能够被设置为可用，否则，就必须设置为不可用。 

<P><IMG height=16 
src="http://www.eclipse.org/articles/Article-UI-Guidelines/images/guidelineIndicator.gif" 
width=16><B><FONT color=#09448d>指南 3.4</FONT></B> 
<BLOCKQUOTE><FONT 
  color=#09448d>命令只有在能够成功执行的时候才能够被设置为可用。</FONT></BLOCKQUOTE>
<HR>

<P>命令是否能被设置为可用应该能很快决定；如果决定起来太费事的话，就先乐观地把该命令设置为可用。 
在commmand被调用时，必须计算是否能真正可用，如果不能，要给用户显示一个对话框。 
<P><IMG height=16 
src="http://www.eclipse.org/articles/Article-UI-Guidelines/images/guidelineIndicator.gif" 
width=16><B><FONT color=#09448d>指南 3.5</FONT></B> 
<BLOCKQUOTE><FONT 
  color=#09448d>命令是否可用必须能快速决定。若不能，就先乐观地把命令设置为可用。万一命令被调用而不能成功执行，就给用户显示合适的消息。</FONT></BLOCKQUOTE>
<P>
<H3><A 
name=Dialogs></A>对话框</H3>对话框用来和用户进行模式交互。它可以用来要求信息输入或者提供反馈信息。 
<BR>&nbsp; 
<H4>初始化&lt;初始化&gt;</H4>当对话框第一次打开时，初始的焦点应该位于获得用户信息的控件上。这个控件可以根据控件的tab顺序直到找到需要信息输入的控件决定。如果对话框提供简单的反馈信息，或者需要用户简单的确认，初始焦点应该设在缺省按钮上。 

<P><IMG height=16 
src="http://www.eclipse.org/articles/Article-UI-Guidelines/images/guidelineIndicator.gif" 
width=16><B><FONT color=#09448d> 指南 4.1</FONT></B> 
<BLOCKQUOTE><FONT 
  color=#09448d>对话框打开时，把初始焦点设在容器的第一个输入控件上。如果没有输入控件，就把初始焦点设在缺省按钮上。 
  </FONT></BLOCKQUOTE>
<HR>

<P>
<H4>多项目选择</H4>Slush Bucket widgets （也叫做Twin 
Box设计）必须是从左边选到右边，供选择的源对象在左边，被选择的文件在右边。 
<P>Slush 
Buckets必须有下列控制按钮，按照下面的顺序，用来把对象从源对象框移动到被选择框内。 

<TABLE class=indent cellSpacing=0 cellPadding=3 border=1>
  <TBODY>
  <TR>
    <TD width=42><B>按钮</B></TD>
    <TD width=248><B>功能</B></TD></TR>
  <TR>
    <TD>&gt;</TD>
    <TD>把左边所有选择的添加到右边</TD></TR>
  <TR>
    <TD>&lt;</TD>
    <TD>从右边删除选择的项目</TD></TR>
  <TR>
    <TD>&gt;&gt;</TD>
    <TD>添加所有的项目（无论是否被选择）</TD></TR>
  <TR>
    <TD>&lt;&lt;</TD>
    <TD>删除所有项目</TD></TR></TBODY></TABLE>
<P><IMG height=278 hspace=40 
src="http://www.eclipse.org/articles/Article-UI-Guidelines/images/slushBucket.gif" 
width=533> 
<P><IMG height=16 
src="http://www.eclipse.org/articles/Article-UI-Guidelines/images/guidelineIndicator.gif" 
width=16><B><FONT color=#09448d> 指南 4.2</FONT></B> 
<BLOCKQUOTE><FONT color=#09448d>Slush Bucket widget（或者叫做Twin 
  Box）必须是从左边选择到右边，供选择的源对象位于左边。它必须按照顺序有&gt;， 
  &lt;， &gt;&gt;， &lt;&lt; 控制按钮。</FONT></BLOCKQUOTE>
<P>
<H3><A 
name=Wizards></A>向导</H3>在Eclipse中，向导?shy;常用于创建资源，资源导入或者资源导出。它也可以用来执行一系列按顺序执行的命令。 
当一个任务中有很多步骤，并且必须按特定的顺序执行时，我们可以使用向导。 
<P><IMG height=16 
src="http://www.eclipse.org/articles/Article-UI-Guidelines/images/guidelineIndicator.gif" 
width=16><B><FONT color=#09448d>指南 5.1</FONT></B> 
<BLOCKQUOTE><FONT 
  color=#09448d>对于包含