定义前面板控制

用户可通过在"安装图标"控制上拉放图标来创建个人控制。

虽然这样可提供简捷的可定制性，但所提供的功能却是"前面板"控制的功能的子集。例如，使用"安装图标"控制所创建的控制无法：

• 提供动画

• 显示客户机窗口

• 在事件发生时 (例如，在收到新的邮件时) 更改外观

  本节描述如何手动地创建"前面板"控制。

  有关"前面板"控制的语法参考信息，请参见 dtfpfile(4X) 手册页。

前面板控制的定义

"前面板"控制定义的结构是：

CONTROL control_name
 {
   TYPE            control_type
   CONTAINER_NAME  value
   CONTAINER_TYPE  value
   other fields defining appearance and behavior}

控制类型

在控制定义中的 TYPE 字段指定了控制的基本性能。

控制 TYPE

控制性能

图标 (缺省的)

用户单击控制或在其上拉放文件时，它将运行指定的操作。

空格

用于调整控制间距的占位符。

忙

忙灯。调用操作时，该控制闪烁 (切换图像)

客户机

"前面板"中的客户机窗口。

时钟

时钟。

日期

显示当前日期。

文件

代表文件。选择控制将运行该文件的缺省操作。

创建新控制

本节描述定义控制的一般步骤，以及如何创建各种类型的控制。

1. 如果控制有一个 PUSH_ACTION 和/或 DROP_ACTION，则创建操作定义。这些是在用户单击控制或在其上拉放文件时运行的操作。

2. 创建控制的图标图像文件。

   有关图标大小、名称和位置的信息，请参见"图标图像文件"。

3. 在下面的位置创建新的"前面板"配置文件：

   • 系统范围：/etc/dt/appconfig/types/language /*.fp

   • 个人：HomeDirectory /.dt/types/*.fp

4. 在文件中添加控制定义。

5. 保存文件。

6. 从"工作区"菜单中选择"重启工作区管理器"。

创建被单击时运行操作的控制

使用下面的字段定义控制的性能：

• TYPE：设置为图标

• PUSH_ACTION：指定要运行的操作名称

  例如，下面这一控制将放置到"个人应用程序"子面板，它运行用户已获得的游戏：

  CONTROL Ball
   {
   	TYPE							icon
   	CONTAINER_NAME				PersAppsSubpanel
   	CONTAINER_TYPE				SUBPANEL
   	ICON							ball
   	PUSH_ACTION					RunBallGame
   	HELP_STRING					"选择此控制以播放 Ball。"
   }

  下面的控制将位于 switch (开关) 的左上角。它启动名为 CutDisp 的操作。

  CONTROL StartCutDisp
   {
     TYPE							icon
     CONTAINER_NAME			Switch
     CONTAINER_TYPE			SWITCH
     POSITION_HINTS			first
     ICON							cutdisp
     HELP_STRING				"选择此控制以运行 cutdisp。"
        PUSH_ACTION				CutDisp
   }

创建打开文件的控制

使用下面的字段定义控制的性能：

• TYPE：设置为文件

• FILE_NAME：指定要打开文件的路径

• PUSH_ACTION：设置为打开

  必须有为文件的数据类型而定义的"打开"操作。

  例如，下面的控制将位于"主面板"的最右边。它用数据文件 /users/ellen/PhoneList.txt 启动"文本编辑器"。*.txt 文件的"打开"操作是缺省的操作数据库的一部分。

  CONTROL EditPhoneList
   {
   	TYPE							file
   	FILE_NAME					/users/ellen/PhoneList.txt
   	CONTAINER_NAME				Top
   	CONTAINER_TYPE				BOX
   	POSITION_HINTS				last
   	ICON							PhoneBook
   	HELP_STRING					"此控制显示 Ellen 的电话列表。"
   	PUSH_ACTION					Open
   }

创建作为拉放区的控制

当用户将一个文件拉放在控制上时，使用 DROP_ACTION 字段来指定运行的操作。操作必须能够接收文件变量。

常常，控制定义包括一个 PUSH_ACTION 字段和 DROP_ACTION 字段。对于按下和拉放操作可使用相同的操作。

例如，下面的位于"个人应用程序"子面板的控制运行 X 客户 xwud，它带有一个文件变量。

CONTROL Run_xwud
 {
 	CONTAINER_NAME				PerAppsSubpanel
 	CONTAINER_TYPE				SUBPANEL
 	POSITION_HINTS				2
 	ICON							XwudImage
 	PUSH_ACTION					RunXwud
 	DROP_ACTION					RunXwud
 }

创建监视文件的控制

使用下面的字段定义控制的性能：

• TYPE：指定下面的值之一：

  图标-如要指定此控制的一个 PUSH_ACTION 和/或 DROP_ACTION，则使用此类型。

  文件-如果要使选中的控制在 "文件管理器"中双击文件的图标时表现得象文件，则使用此类型。

• ICON 和 ALTERNATE_ICON：描述用于表示被监视文件的未更改和已更改状态的图像。

• MONITOR_TYPE：描述引起图像更改的条件。使用下面的值之一：

  邮件-当向文件添加信息时，该控制将更改外观。

  文件-当指定文件变成非空时，该控制将更改。

• FILE_NAME：指定要监视的文件。

  例如，下面的控制寻找名为会议的文件的存在， 您希望使用匿名 ftp 将该文件传输到系统上。这个控制放置在"个人应用程序" 子面板的顶部。

  CONTROL MonitorCalendar
   {
   	TYPE							file
   	CONTAINER_NAME				PersonalApps
   	CONTAINER_TYPE				SUBPANEL
   	POSITION_HINTS				first
   	FILE_NAME					/users/ftp/meetings
   	MONITOR_TYPE				file
   	ICON							meetingsno
   	ALTERNATE_ICON				meetingsyes
   }

创建单一实例 (切换) 控制

单一实例控制检查由 PUSH_ACTION 启动的进程是否已在运行。如果该进程没有运行，则运行 PUSH_ACTION。如果该进程已在运行， 则将窗口移动到当前工作区窗口 stack (栈) 的顶部。

使用下面的字段定义控制的性能：

• PUSH_RECALL：设置为真。

• CLIENT_NAME：指定控制的客户机名称。

  CLIENT_NAME 的值必须与应用程序的顶级窗口上 WM_CLASS 特性中的第一个字符串 (res_name) 相匹配。有关详细信息，请参见 xprop(1) 手册页。

• PUSH_ACTION：描述用户单击控制时所运行的操作。

  例如，下面的控制运行应用程序的单一实例，其操作名为 MyEditor。

  CONTROL MyEditor  
    {  
     	TYPE		icon  	
     CONTAINER_NAME				Top  
     CONTAINER_TYPE				BOX  	
     POSITION_HINTS				15  	
     PUSH_RECALL					True  
     CLIENT_NAME					BestEditor  	
     PUSH_ACTION					StartMyEditor  	
     ICON							MyEd 
    }

创建客户机窗口控制

客户机窗口控制是嵌入"前面板"中的应用程序窗口。例如，通过创建 xload 客户机窗口控制，可将系统负荷监测器放置在"前面板"中。

1. 定义控制。

   使用下面的字段定义控制的性能：

   • TYPE：设置为客户机。

   • CLIENT_NAME：指定要启动的客户机。

     CLIENT_NAME 的值必须与应用程序顶层窗口上的 WM_CLASS 特性中的第一个字符串 (res_name) 相匹配。有关详细信息，请参见 xprop(1) 手册页。

   • CLIENT_GEOMETRY：以像素为单位指定客户机"前面板"窗口所需的大小。

     xwininfo(1) 手册页描述如何找出以像素为单位的窗口的大小。

2. 从"工作区"菜单中选择"重启工作区管理器"。

3. 从终端仿真器的命令行启动客户机。

   例如，下面的控制显示了 30 乘 20 像素的负荷监测器。

   CONTROL LoadMeter  
     {  	
      TYPE		client  	
      CONTAINER_NAME				Top  
      CONTAINER_TYPE				BOX  	
      CLIENT_NAME					xload  	
      CLIENT_GEOMETRY			30x20
     }  

   如果未在会话之间保存和恢复客户机，您可能想配置控制，以便当用户单击它时启动客户机。例如，可以通过向定义添加下面的行，来配置"负荷监测器"控制，以便启动 xload：

    PUSH_ACTION				StartXload

   并创建操作：

   ACTION StartXload  
     {  	
      WINDOW_TYPE				NO_STDIO  	
      EXEC_STRING				/usr/contrib/bin/X11/xload
     }

启动动画控制

可附加动画序列，它将在用户选中控制或在其上拉放对象时使用。

为了具有动画序列，控制必须：

• 为类型图标

• 具有 PUSH_ACTION 或 DROP_ACTION

1. 使用 ANIMATION 组件指定动画序列：

   ANIMATION animation_name
    	  {  
   		ANIMATION	icon1				[milisecond_delay]  
   		ANIMATION	icon1				[milisecond_delay]
    		...
    	}

   其中 icon1、icon 2 等等为图标的名称，而 milisecond_delay 是动画图标之间的以毫秒为单位的时间延迟。缺省的时间延迟为二百毫秒。

2. 将 PUSH_ANIMATION 和/或 DROP_ANIMATION 字段添加到控制定义中。该值是 ANIMATION 序列的名称。

   例如，下面的行激励了启动 BestEditor 应用程序的控制。图标间的时间延迟为三百毫秒。该实例假定已创建了图标文件框架 1、框架 2 等等。

   CONTROL BestEditor
    {
    	...
    	PUSH_ANIMATION BestEdAnimation
    	...
    }

    ANIMATION BestEdAnimation
    {
    	frame1			300
    	frame2
    	...
    }

提供前面板控制的针对项帮助

有两种提供控制帮助的方法：

• 在控制定义中提供帮助字符串。

  当用户调用控制的针对项帮助时，帮助字符串显示在帮助查看器中。帮助字符串不能包含格式 (如标题之类) 或链接。

  要提供帮助字符串，在控制定义中将其指定为：

  	HELP_STRING   			 help_string
   
  

• 在注册的帮助卷中指定帮助主题。

  帮助主题是使用帮助系统的全部能力而编辑的信息。编辑帮助主题需要使用桌面"帮助开发者工具包"。

  要提供帮助主题，请指定控制定义中的帮助卷和主题 ID：

  HELP_VOLUME		help_volume_name
   	   HELP_TOPIC		topic_id