sm_name_hdr(SMIT 选择器标题)对象类

选择器屏幕是由两个对象指定的:指定屏幕标题和其他信息 的 sm_name_hdr 对象,以及指定将要获取的数据项类型的 sm_cmd_opt 对象。

注意: 在此对象类中对对象进行编码时,请将未使用的空字符串设置为""(双引号) 和未使用的整数字段0.

在类型为 "c" 的 SMIT 选择器标题屏幕 ( sm_name_hdr) 中,如果使用: (冒号) 指定值 (例如, tty:0) ,那么 SMIT 将插入 #! (井号,感叹号) 在: 表示: 不是字段分隔符。 SMIT 将除去 #! 在解析该值的其余部分之后,在将其传递到 cmd_to_classify 描述符之前。 要对 cmd_to_classify 描述符进行任何进一步的添加,请重新插入 #! 前:

sm_name_hdr 对象类的描述符为:

描述信息 定义
标识 对象的标识或名称。 该id可以将字段外部化为快速路径标识,除非 has_name_select 设置为"y"(是)。 id 的值是一个字符串,该字符串 的最大长度是 64 个字符。 标识对于应用程序来说必须唯一,而且在系统内必须唯一。
next_id 指定后续屏幕的标题对象; 设置为idsm_cmd_hdr 对象或此选择器后面的 sm_name_hdr 对象的字段。 该next_type下面描述的字段指定指示的对象类。 next_id 的值是一个字符串,该字符串的最大长度是 64 个字符。
选项标识 指定此选择器的主体; 设置为idsm_cmd_opt 对象的字段。 option_id 的值是一个字符串,该字符串的最大长度是 64 个字符。
has_name_select 指定此屏幕是否以选择器屏幕开头。 有效值是:
"""n"
否;这是缺省大小写值。 即使以选择器屏幕开始,此对象的 id 仍可被用作快速路径。
"y"
是;选择器必须在此对象之前。 这一设置防止将此对象的 id 用作相应对话框屏幕的快速路径。
名称 显示为选择器屏幕标题的文本。 name 的值是一个字符串,该字符串的最大长度是 1024 个字符。 可以使用嵌入式格式来格式化字符串\n(换行) 字符。
名称消息文件 字符串 name 消息工具目录的文件名(不是全路径名)。 name_msg_file 的值是一个字符串,该字符串的最大长度是 1024 个字符。 可使用消息工具开发应用程序所需的消息目录。
名称消息集 字符串 name 的消息工具集标识。 可使用集标识指示 单个目录的子集。 name_msg_set 的值为整数。
名称消息标识 字符串 name 的消息工具集标识。 name_msg_id 的值为整数。
TYPE 用来处理选择器的方法。 type 的值是一个字符串,该 字符串的最大长度是 1 个字符。 有效值是:
"""j"
恰好是下个标识;跟随此对象的对象总是由 next_id 描述符的值指定的对象。 next_id 描述符是在开发时初始化的完全定义了的字符串。
"r"
Cat 原始名;在这种情况下,next_id 描述符是在开发时特别是在运行时由用户输入部分定义的。 将在开发时定义的 next_id 描述符的值与用户选定的值连接在一起,以创建 id 值搜索下一个(要显示的对话框或选择器的值)。
"c"
Cat cooked 名称;用户选定的值要求处理更多信息。 将该值传递给在 cmd_to_classify 描述符中命名的命令,然后将命令输出与 next_id 描述符的值连接在一起,以创建 id 描述符搜索下一个(要显示的对话框或选择器的值)。
ghost 指定是显示此选择器屏幕,还是仅显示命令在屏幕中生成的列表弹出面板。cmd_to_listghost 的值为字符串。 有效值是:
"""n"
否;显示此选择器屏幕。
"y"
是; 仅显示使用以下命令构造的命令字符串生成的弹出面板:cmd_to_listcmd_to_list_postfix关联的 sm_cmd_opt 对象中的字段。 如果无 cmd_to_list 值,那么 SMIT 假定此对象为 super-ghost(不显示任何内容),运行 cmd_to_classify 命令,并继续。
cmd_to_classify 要用于对值进行分类的命令字符串 (如果需要)name与此选择器关联的 sm_cmd_opt 对象的字段。 cmd_to_classify 的值是一个字符串,该字符串的最大长度是 1024 个字符。 cmd_to_classify 的输入从entry字段称为 "原始名称" , cmd_to_classify 的输出称为 "熟名"。 在AIX 4.2.1 版之前,使用cmd_too_classify 只能创建一个值。 如果该值包含冒号,那么它将被自动转义。 在 AIX 4.2.1 及更高版本中,可以使用 cmd_to_classify创建多个值,但不再对冒号进行转义。 此命令现在将冒号作为定界符使用。 如果在值中使用 冒号,那么必须手工保留它们。
cmd_too_classify_postfix 要对命令字符串进行解释和添加的后缀cmd_to_classifycmd_to_classify_postfix 的值是一个字符串,该字符串的最大长度是 1024 个字符。
原始字段名 原始值的备用名称。 raw_field_name 的值是一个字符串,该字符串的最大长度是 1024 个字符。 缺省值为"_rawname".
熟字段名称 cooked 值的备用名称。 cooked_field_name 的值是一个字符串,该字符串的最大长度是 1024 个字符。 缺省值为"cookedname".
next_type 遵循此选择器的屏幕的类型。 有效值是:
"n"
名称;选择器屏幕使用的名称。 请参阅上面的 next_id 的描述以获得相关信息。
"d"
对话框;对话框屏幕使用的对话框。 请参阅上面的 next_id 的描述以获得相关信息。
help_msg_id 使用逗号将消息工具消息集号和消息标识号指定为等价于 SMIT 标识标记的分隔符或数字字符串。
help_msg_loc 为了检索帮助文本而作为参数发送到 man 命令 的文件名,或包含帮助文本的文件的文件名。 help_msg_loc 的值是一个字符串,该字符串的最大长度是 1024 个字符。
help_msg_base 为获取与更正书籍相关联的文件名而由 SMIT 读取的库的全限定路径名。
帮助信息 包含带有命名文件值的字符串,而该命名文件包含在 help_msg_base 指示的文件库中。