ch09.sgm 34 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594
  1. <!-- $XConsortium: ch09.sgm /main/10 1996/12/20 20:20:38 rws $ -->
  2. <!-- (c) Copyright 1995 Digital Equipment Corporation. -->
  3. <!-- (c) Copyright 1995 Hewlett-Packard Company. -->
  4. <!-- (c) Copyright 1995 International Business Machines Corp. -->
  5. <!-- (c) Copyright 1995 Sun Microsystems, Inc. -->
  6. <!-- (c) Copyright 1995 Novell, Inc. -->
  7. <!-- (c) Copyright 1995 FUJITSU LIMITED. -->
  8. <!-- (c) Copyright 1995 Hitachi. -->
  9. <chapter id="SAG.dtCrA.div.1">
  10. <title id="SAG.dtCrA.mkr.1"><indexterm><primary>Crear Acci&oacute;n</primary>
  11. </indexterm>Creaci&oacute;n de acciones y de tipos de datos utilizando Crear
  12. Acci&oacute;n</title>
  13. <para><indexterm><primary>Crear Acci&oacute;n</primary><secondary>introducci&oacute;n</secondary></indexterm><indexterm><primary>dtCreate, Vea Crear Acci&oacute;n&lt;$nopage></primary></indexterm>Crear Acci&oacute;n es una herramienta para crear:</para>
  14. <itemizedlist remap="Bullet1"><listitem><para>Una acci&oacute;n para iniciar
  15. una aplicaci&oacute;n</para>
  16. </listitem><listitem><para>Uno o m&aacute;s tipos de datos para los archivos
  17. de datos de una aplicaci&oacute;n</para>
  18. </listitem><listitem><para>Acciones para abrir e imprimir los archivos de
  19. datos de la aplicaci&oacute;n</para>
  20. </listitem></itemizedlist>
  21. <para>Crear Acci&oacute;n tambi&eacute;n es &uacute;til para crear acciones
  22. simples para ejecutar mandatos del sistema operativo y scripts del shell.
  23. </para>
  24. <informaltable id="SAG.dtCrA.itbl.1" frame="All">
  25. <tgroup cols="1" colsep="1" rowsep="1">
  26. <colspec colwidth="4.00in">
  27. <tbody>
  28. <row>
  29. <entry align="left" valign="top"><para><!--Original XRef content: 'What Create
  30. Action Does141'--><xref role="JumpText" linkend="SAG.dtCrA.mkr.2"></para></entry>
  31. </row>
  32. <row>
  33. <entry align="left" valign="top"><para><!--Original XRef content: 'Limitations
  34. of Create Action142'--><xref role="JumpText" linkend="SAG.dtCrA.mkr.3"></para></entry>
  35. </row>
  36. <row>
  37. <entry align="left" valign="top"><para><!--Original XRef content: 'Creating
  38. an Action and Data Type for an Application with Create Action143'--><xref
  39. role="JumpText" linkend="SAG.dtCrA.mkr.4"></para></entry></row></tbody></tgroup>
  40. </informaltable>
  41. <para>Para obtener informaci&oacute;n de consulta, vea la p&aacute;gina de
  42. manual <filename moreinfo="RefEntry">dtcreate(1X)</filename>.</para>
  43. <sect1 id="SAG.dtCrA.div.2">
  44. <title id="SAG.dtCrA.mkr.2">Qu&eacute; hace Crear Acci&oacute;n<indexterm>
  45. <primary>Crear Acci&oacute;n</primary><secondary>funciones</secondary></indexterm></title>
  46. <para>Crear Acci&oacute;n incluye una ventana principal y un conjunto de cuadros
  47. de di&aacute;logo para crear una acci&oacute;n y los tipos de datos asociados.
  48. </para>
  49. <para>Crear Acci&oacute;n realiza lo siguiente:</para>
  50. <itemizedlist remap="Bullet1"><listitem><para>Crea una definici&oacute;n de
  51. acci&oacute;n que ejecuta un mandato.</para>
  52. </listitem><listitem><para><indexterm><primary>Crear Acci&oacute;n</primary>
  53. <secondary>archivo de configuraci&oacute;n creado</secondary></indexterm><indexterm>
  54. <primary>archivo de definici&oacute;n de acci&oacute;n, creado por Crear Acci&oacute;n</primary></indexterm>Crea un archivo <symbol role="Variable">DirectorioInicio</symbol><filename>/.dt/types/</filename><symbol role="Variable">nombre_acci&oacute;n</symbol><filename>.dt.</filename> Este archivo almacena las definiciones
  55. de acci&oacute;n y de tipo de datos creadas para la aplicaci&oacute;n.</para>
  56. </listitem><listitem><para>Crea un<indexterm><primary>archivo de acci&oacute;n</primary></indexterm> <emphasis>archivo de acci&oacute;n</emphasis> en el
  57. directorio de inicio del usuario. El archivo de acci&oacute;n es un archivo
  58. ejecutable con el mismo<indexterm><primary>acciones</primary><secondary>nombre</secondary></indexterm> nombre que la acci&oacute;n.</para>
  59. <para>La representaci&oacute;n del archivo de acci&oacute;n en el Gestor de
  60. archivos se denomina<indexterm><primary>icono de aplicaci&oacute;n</primary>
  61. <secondary>utilizar Crear Acci&oacute;n</secondary></indexterm> <emphasis>icono de aplicaci&oacute;n</emphasis> porque, si se pulsa dos veces, se inicia
  62. la aplicaci&oacute;n.</para>
  63. <para>Opcionalmente se puede hacer que el icono de acci&oacute;n sea una zona
  64. de soltar, especificando, al crear la acci&oacute;n, tipos de datos que se
  65. puedan soltar.</para>
  66. </listitem><listitem><para>Crea uno o m&aacute;s tipos de datos para los archivos
  67. de datos de la aplicaci&oacute;n (opcional).</para>
  68. </listitem><listitem><para>Crea una acci&oacute;n Abrir para cada tipo de
  69. datos.</para>
  70. </listitem><listitem><para>Crea una acci&oacute;n Imprimir para cada tipo
  71. de datos (opcional).</para>
  72. </listitem><listitem><para>Vuelve a cargar la base de datos de acciones y
  73. de tipos de datos. Esto hace que las acciones y los tipos de datos entren
  74. en vigor inmediatamente.</para>
  75. </listitem></itemizedlist>
  76. </sect1>
  77. <sect1 id="SAG.dtCrA.div.3">
  78. <title id="SAG.dtCrA.mkr.3">Limitaciones de Crear Acci&oacute;n<indexterm>
  79. <primary>Crear Acci&oacute;n</primary><secondary>limitaciones</secondary>
  80. </indexterm></title>
  81. <para>Crear Acci&oacute;n est&aacute; dise&ntilde;ado para crear acciones
  82. y tipos de datos para ejecutar aplicaciones. Sin embargo, las acciones y los
  83. tipos de datos son muy flexibles e incluyen funciones adicionales a las que
  84. s&oacute;lo se puede acceder si se crean las definiciones manualmente.</para>
  85. <para>Para obtener m&aacute;s informaci&oacute;n, consulte:</para>
  86. <itemizedlist remap="Bullet1"><listitem><para>El <!--Original XRef content:
  87. 'Chapter&numsp;10, &rdquo;Creating Actions Manually'--><xref role="ChapNumAndTitle"
  88. linkend="SAG.CrAct.mkr.1">&rdquo;</para>
  89. </listitem><listitem><para>El <!--Original XRef content: 'Chapter&numsp;11,
  90. &rdquo;Creating Data Types Manually'--><xref role="ChapNumAndTitle" linkend="SAG.CrDT.mkr.1">
  91. </para>
  92. </listitem></itemizedlist>
  93. <sect2 id="SAG.dtCrA.div.4">
  94. <title>Limitaciones de las acciones<indexterm><primary>acciones</primary>
  95. <secondary>limitaciones de Crear Acci&oacute;n</secondary></indexterm></title>
  96. <para>Crear Acci&oacute;n no se puede utilizar para crear la acci&oacute;n
  97. para una aplicaci&oacute;n si no se cumple ninguna de las siguientes condiciones:
  98. </para>
  99. <itemizedlist remap="Bullet1"><listitem><para>La l&iacute;nea de mandatos
  100. necesita un<indexterm><primary>acciones</primary><secondary>argumentos que
  101. no son de archivo</secondary></indexterm><indexterm><primary>&lt;$nopage>acciones</primary><secondary>par&aacute;metros, Vea argumentos</secondary></indexterm> argumento
  102. (par&aacute;metro) que no sea de archivo.</para>
  103. <para>Por ejemplo, Crear Acci&oacute;n no se puede utilizar para escribir
  104. una acci&oacute;n para el mandato:</para>
  105. </listitem></itemizedlist>
  106. <para><command>lp -d<symbol role="Variable">dispositivo nombre de archivo</symbol> </command></para>
  107. <para>donde el usuario tiene que proporcionar <symbol role="Variable">dispositivo</symbol> cada vez que se ejecuta el mandato.</para>
  108. <itemizedlist remap="Bullet1"><listitem><para>El icono de aplicaci&oacute;n
  109. debe tener una etiqueta diferente del nombre de acci&oacute;n.</para>
  110. <para>Por ejemplo, no se puede utilizar Crear Acci&oacute;n para proporcionar
  111. una versi&oacute;n en idioma local de una acci&oacute;n existente.</para>
  112. </listitem><listitem><para>La acci&oacute;n necesita cualquiera de las caracter&iacute;sticas
  113. avanzadas de la base de datos de acciones.</para>
  114. <para>Son ejemplos de estas caracter&iacute;sticas avanzadas acciones que:
  115. </para>
  116. <itemizedlist remap="Bullet2"><listitem><para>Ejecutan mandatos en sistemas
  117. ajenos a la definici&oacute;n de acci&oacute;n</para>
  118. </listitem><listitem><para>Invocan otras acciones</para>
  119. </listitem><listitem><para>Deben ejecutarse como si se tratara de un usuario
  120. diferente (por ejemplo, como superusuario)</para>
  121. </listitem><listitem><para>Utilizan con frecuencia la caracter&iacute;stica
  122. de ''establecer correspondencia''</para>
  123. </listitem><listitem><para>Tienen comportamientos muy diferentes, en funci&oacute;n
  124. del n&uacute;mero de argumentos de archivo proporcionados a la acci&oacute;n
  125. </para>
  126. </listitem></itemizedlist>
  127. </listitem></itemizedlist>
  128. </sect2>
  129. <sect2 id="SAG.dtCrA.div.5">
  130. <title><indexterm><primary>tipos de datos</primary><secondary>requisitos para
  131. la creaci&oacute;n manual</secondary></indexterm>Limitaciones de los tipos
  132. de datos<indexterm><primary>tipos de datos</primary><secondary>limitaci&oacute;n
  133. de Crear Acci&oacute;n</secondary></indexterm></title>
  134. <para>Crear Acci&oacute;n no se puede utilizar para crear el tipo de datos
  135. para una aplicaci&oacute;n si no se cumple ninguna de las siguientes condiciones:
  136. </para>
  137. <itemizedlist remap="Bullet1"><listitem><para>El tipo de datos deben tener
  138. acciones adicionales asociadas a &eacute;l distintas de Abrir e Imprimir.
  139. </para>
  140. </listitem><listitem><para>La acci&oacute;n Abrir para el tipo de datos no
  141. es el mandato de la acci&oacute;n.</para>
  142. <para>Por ejemplo, no se puede utilizar Crear Acci&oacute;n para crear el
  143. tipo de datos que proporciona un icono exclusivo para el directorio que representa
  144. el grupo de aplicaciones de la aplicaci&oacute;n.</para>
  145. </listitem></itemizedlist>
  146. </sect2>
  147. </sect1>
  148. <sect1 id="SAG.dtCrA.div.6">
  149. <title id="SAG.dtCrA.mkr.4">Creaci&oacute;n de una acci&oacute;n y de un tipo
  150. de datos para una aplicaci&oacute;n con Crear Acci&oacute;n<indexterm><primary>Crear Acci&oacute;n</primary><secondary>utilizar</secondary></indexterm></title>
  151. <para>Existen algunos aspectos relacionados con la aplicaci&oacute;n que debe
  152. conocer antes de ejecutar Crear Acci&oacute;n.</para>
  153. <itemizedlist remap="Bullet1"><listitem><para>La l&iacute;nea de mandatos
  154. para iniciar la aplicaci&oacute;n.</para>
  155. <para>Deber&aacute; saber si la l&iacute;nea de mandatos incluye un argumento
  156. de archivo necesario, un argumento de archivo opcional o no incluye ning&uacute;n
  157. argumento de archivo.</para>
  158. <para>Si la aplicaci&oacute;n necesita un argumento que no sea de archivo,
  159. no podr&aacute; utilizar Crear Acci&oacute;n para crear la acci&oacute;n.
  160. </para>
  161. </listitem><listitem><para>Los tipos de archivos de datos que puede aceptar
  162. una aplicaci&oacute;n.</para>
  163. <para>Algunas aplicaciones s&oacute;lo pueden aceptar un tipo de datos. Otras
  164. (por ejemplo, un editor ASCII o un editor de gr&aacute;ficos) pueden aceptar
  165. varios tipos de datos.</para>
  166. </listitem><listitem><para>El modo en que la aplicaci&oacute;n identifica
  167. sus archivos de datos.</para>
  168. <para>Esto puede ser un convenio de denominaci&oacute;n (por ejemplo, nombres
  169. de archivo que terminen por<filename>.doc</filename>), y/o puede depender
  170. del contenido del archivo. Si la aplicaci&oacute;n no utiliza ning&uacute;n
  171. convenio de nombres de archivo, puede definir uno para el icono de acci&oacute;n.
  172. </para>
  173. </listitem><listitem><para>Opcional: La l&iacute;nea de mandatos para imprimir
  174. los archivos</para>
  175. </listitem></itemizedlist>
  176. <sect2 id="SAG.dtCrA.div.7" role="Procedure">
  177. <title id="SAG.dtCrA.mkr.5">Crear una acci&oacute;n para una aplicaci&oacute;n</title>
  178. <orderedlist><listitem><para>Pulse dos veces<indexterm><primary>Crear Acci&oacute;n</primary><secondary>iniciar</secondary></indexterm> Crear Acci&oacute;n en
  179. el grupo de aplicaciones Apls_Escritorio.</para>
  180. <figure>
  181. <title>Icono de Crear Acci&oacute;n del Gestor de aplicaciones</title>
  182. <graphic id="sag.dtcra.grph.1" entityref="SAG.dtCrA.fig.1"></graphic>
  183. </figure>
  184. <para><indexterm><primary>Crear Acci&oacute;n</primary><secondary>ventana
  185. principal</secondary></indexterm>Se muestra la ventana principal Crear Acci&oacute;n.
  186. </para>
  187. <figure>
  188. <title>Ventana principal Crear Acci&oacute;n</title>
  189. <graphic id="sag.dtcra.grph.2" entityref="SAG.dtCrA.fig.2"></graphic>
  190. </figure>
  191. </listitem><listitem><para>Escriba el nombre que etiquetar&aacute; el icono
  192. de acci&oacute;n en el<indexterm><primary>Nombre de acci&oacute;n, campo
  193. de Crear Acci&oacute;n</primary></indexterm><indexterm><primary>Crear Acci&oacute;n</primary><secondary>nombre de acci&oacute;n</secondary></indexterm> campo
  194. de texto Nombre de Acci&oacute;n.</para>
  195. </listitem><listitem><para>Utilice los<indexterm><primary>Iconos de acci&oacute;n,
  196. controles, en Crear Acci&oacute;n</primary></indexterm> controles Iconos de
  197. Acci&oacute;n para especificar el icono para la aplicaci&oacute;n. Inicialmente
  198. se muestra el icono predeterminado.</para>
  199. <itemizedlist remap="Bullet2"><listitem><para>Para elegir un icono existente
  200. diferente, pulse Buscar Conjunto para mostrar el cuadro de di&aacute;logo
  201. Buscar Conjunto. Consulte la secci&oacute;n <!--Original
  202. XRef content: '&rdquo;Using
  203. the Find Set Dialog Box To Speci--><!--fy an Icon&rdquo;
  204. on
  205. page&numsp;152'--><xref role="SecTitleAndPageNum" linkend="sag.dtcra.mkr.7">.
  206. </para>
  207. </listitem><listitem><para>Para crear iconos nuevos, elija Editar Icono para
  208. ejecutar el Editor de iconos.</para>
  209. </listitem></itemizedlist>
  210. </listitem><listitem><para>En el campo de texto Mandato cuando se abra la
  211. acci&oacute;n, escriba el mandato para iniciar la aplicaci&oacute;n.</para>
  212. <para><indexterm><primary>Crear Acci&oacute;n</primary><secondary>sintaxis
  213. del mandato de acci&oacute;n</secondary></indexterm>Utilice la sintaxis <filename>$</filename><symbol role="Variable">n</symbol> para un argumento de archivo;
  214. por ejemplo:</para>
  215. <programlisting remap="CodeIndent1">emacs
  216. bitmap $1
  217. diff $1 $2
  218. lp -oraw $1</programlisting>
  219. <para><indexterm><primary>Crear Acci&oacute;n</primary><secondary>especificar
  220. argumento de archivo</secondary></indexterm><indexterm><primary>argumento
  221. de archivo</primary><secondary>especificado con Crear Acci&oacute;n</secondary>
  222. </indexterm>Si la l&iacute;nea de mandatos incluye un argumento de archivo
  223. (<filename>$</filename><symbol role="Variable">n</symbol>), el icono de acci&oacute;n
  224. ser&aacute; una zona de soltar para los archivos.</para>
  225. <para>Las l&iacute;neas de mandatos no se pasan a un shell a no ser que se
  226. especifique expl&iacute;citamente el uso de un shell. Por ejemplo, estas l&iacute;neas
  227. utilizan el proceso de shell:</para>
  228. <programlisting remap="CodeIndent1">/bin/sh -c 'ps | lp'
  229. /bin/sh -c 'spell $1 | more'</programlisting>
  230. </listitem><listitem><para>Escriba el texto de ayuda sobre el tema para el
  231. icono de acci&oacute;n en el campo de texto &ldquo;Texto de Ayuda para Icono
  232. de Acci&oacute;n&rdquo;.</para>
  233. <para><indexterm><primary>ayuda</primary><secondary>especificada utilizando
  234. Crear Acci&oacute;n</secondary></indexterm>El texto se acomodar&aacute; autom&aacute;ticamente
  235. en el campo de texto. Sin embargo, las divisiones de l&iacute;nea no se conservan
  236. en l&iacute;nea. Si desea especificar una divisi&oacute;n de l&iacute;nea
  237. forzada, utilice <filename></filename>.</para>
  238. </listitem><listitem><para><indexterm><primary>acciones</primary><secondary>soporte de ventana</secondary></indexterm><indexterm><primary>soporte de
  239. ventana para las acciones</primary></indexterm>Elija el soporte de ventanas
  240. necesario para la acci&oacute;n en el men&uacute; de opciones Tipo de ventana.
  241. </para>
  242. <informaltable>
  243. <tgroup cols="2" colsep="0" rowsep="0">
  244. <colspec colwidth="219*">
  245. <colspec colwidth="237*">
  246. <tbody>
  247. <row>
  248. <entry align="left" valign="top"><para>Gr&aacute;fica (Ventana de X)</para></entry>
  249. <entry align="left" valign="top"><para>La aplicaci&oacute;n crea su propia
  250. ventana</para></entry></row>
  251. <row>
  252. <entry align="left" valign="top"><para><indexterm><primary>emulador de terminal</primary><secondary>opci&oacute;n de acci&oacute;n cierre autom&aacute;tico</secondary></indexterm>Terminal (Cierre autom&aacute;tico)</para></entry>
  253. <entry align="left" valign="top"><para>La aplicaci&oacute;n se ejecutar&aacute;
  254. en una ventana de emulador de terminal que se cerrar&aacute; autom&aacute;ticamente
  255. cuando el usuario salga de la aplicaci&oacute;n</para></entry></row>
  256. <row>
  257. <entry align="left" valign="top"><para><indexterm><primary>emulador de terminal</primary><secondary>opci&oacute;n de acci&oacute;n cierre manual</secondary>
  258. </indexterm>Terminal (Cierre manual)</para></entry>
  259. <entry align="left" valign="top"><para>La aplicaci&oacute;n se ejecutar&aacute;
  260. en una ventana de emulador de terminal que permanecer&aacute; abierta hasta
  261. que el usuario la cierre expl&iacute;citamente</para></entry></row>
  262. <row>
  263. <entry align="left" valign="top"><para><indexterm><primary>acciones</primary>
  264. <secondary>sin salida de pantalla</secondary></indexterm>Sin Salida</para></entry>
  265. <entry align="left" valign="top"><para>La aplicaci&oacute;n no produce salida
  266. en la pantalla</para></entry></row></tbody></tgroup></informaltable>
  267. </listitem><listitem><para>Proceda del siguiente modo:</para>
  268. <itemizedlist remap="Bullet2"><listitem><para>Si la aplicaci&oacute;n tiene
  269. archivos de datos y desea crear uno o m&aacute;s tipos de datos para ellos,
  270. consulte la siguiente secci&oacute;n, <!--Original
  271. XRef content: '&rdquo;To
  272. Create One or More Data Types
  273. for --><!--an Application'--><xref role="SectionTitle" linkend="sag.dtcra.mkr.6">.
  274. </para>
  275. </listitem><listitem><para>Si no necesita crear un tipo de datos, guarde la
  276. acci&oacute;n eligiendo Guardar en el men&uacute; Archivo. A continuaci&oacute;n,
  277. pruebe la nueva acci&oacute;n pulsando dos veces su icono en el directorio
  278. de inicio.</para>
  279. </listitem></itemizedlist>
  280. </listitem></orderedlist>
  281. </sect2>
  282. <sect2 id="SAG.dtCrA.div.8" role="Procedure">
  283. <title id="SAG.dtCrA.mkr.6">Crear uno o m&aacute;s tipos de datos para una
  284. aplicaci&oacute;n<indexterm><primary>Crear Acci&oacute;n</primary><secondary>creaci&oacute;n de tipos de datos</secondary></indexterm><indexterm><primary>tipos de datos</primary><secondary>creados con Crear Acci&oacute;n</secondary>
  285. </indexterm></title>
  286. <orderedlist><listitem><para>Defina la acci&oacute;n para la aplicaci&oacute;n
  287. utilizando el procedimiento de la secci&oacute;n anterior, <!--Original
  288. XRef content: '&rdquo;To Create an Action for an
  289. Application--><!--'--><xref role="SectionTitle" linkend="sag.dtcra.mkr.5">.
  290. </para>
  291. </listitem><listitem><para>Pulse el bot&oacute;n Avanzada en la ventana Crear
  292. Acci&oacute;n para ampliar la ventana.</para>
  293. <figure>
  294. <title>Caracter&iacute;sticas avanzadas de la ventana principal Crear Acci&oacute;n</title>
  295. <graphic id="sag.dtcra.grph.3" entityref="SAG.dtCrA.fig.3"></graphic>
  296. </figure>
  297. </listitem><listitem><para><indexterm><primary>indicador de archivo, especificado
  298. con Crear Acci&oacute;n</primary></indexterm><indexterm><primary>Crear Acci&oacute;n</primary><secondary>indicador de solicitud de archivo</secondary></indexterm>Si
  299. desea que el icono de aplicaci&oacute;n solicite un argumento de archivo cuando
  300. se pulsa dos veces el icono, escriba el texto del indicador de solicitud en
  301. el campo de texto ''Cuando se abra la acci&oacute;n, solicitar a los usuarios''.
  302. </para>
  303. <para>Utilice estas directrices para este campo de texto:</para>
  304. <itemizedlist remap="Bullet2"><listitem><para>Debe utilizar este campo si
  305. la l&iacute;nea de mandatos de la aplicaci&oacute;n tiene un argumento de
  306. archivo <symbol role="Variable">necesario</symbol>.</para>
  307. </listitem><listitem><para>Debe dejar en blanco este campo si la l&iacute;nea
  308. de mandatos no incluye ning&uacute;n argumento de archivo.</para>
  309. </listitem><listitem><para>Si el argumento de archivo de la l&iacute;nea de
  310. mandatos de la aplicaci&oacute;n es opcional, tiene dos posibilidades. Si
  311. proporciona el texto del indicador de solicitud, el icono de acci&oacute;n
  312. solicitar&aacute; el archivo cuando se pulse dos veces. Si no proporciona
  313. el texto del indicador de solicitud, la acci&oacute;n se ejecutar&aacute;
  314. con una cadena nula como argumento de archivo.</para>
  315. </listitem></itemizedlist>
  316. </listitem><listitem><para>Especifique los tipos de archivos que la acci&oacute;n
  317. aceptar&aacute; como argumentos:</para>
  318. <itemizedlist remap="Bullet2"><listitem><para>Si la acci&oacute;n puede aceptar
  319. cualquier tipo de datos, seleccione Todos los tipos de datos.</para>
  320. </listitem><listitem><para>Si la acci&oacute;n s&oacute;lo puede aceptar los
  321. tipos de datos creados para la aplicaci&oacute;n, seleccione S&oacute;lo la
  322. lista anterior.</para>
  323. <para>Inicialmente, la<indexterm><primary>lista de tipos de datos en Crear
  324. Acci&oacute;n</primary></indexterm> lista Tipos de datos que usan esta acci&oacute;n
  325. estar&aacute; vac&iacute;a. A medida que vaya creando tipos de datos para
  326. la aplicaci&oacute;n, &eacute;stos se a&ntilde;adir&aacute;n a la lista.</para>
  327. </listitem></itemizedlist>
  328. </listitem><listitem><para>Pulse A&ntilde;adir, que se encuentra junto al
  329. cuadro de lista &ldquo;Tipos de datos que usan esta acci&oacute;n&rdquo; para
  330. mostrar el cuadro de di&aacute;logo A&ntilde;adir Tipo de Datos.</para>
  331. <figure>
  332. <title>Cuadro de di&aacute;logo A&ntilde;adir Tipo de Datos de Crear Acci&oacute;n</title>
  333. <graphic id="sag.dtcra.grph.4" entityref="SAG.dtCrA.fig.4"></graphic>
  334. </figure>
  335. </listitem><listitem><para>Opcional: Si no desea utilizar el nombre de tipo
  336. de datos predeterminado, escriba un nuevo nombre para el tipo de datos en
  337. el<indexterm><primary>Nombre de tipo de datos, campo de texto</primary></indexterm><indexterm>
  338. <primary>Crear Acci&oacute;n</primary><secondary>nombre de tipo de datos</secondary>
  339. </indexterm> campo de texto Nombre de la Familia de Tipos de Datos.</para>
  340. <para>El nombre no puede incluir espacios. Los usuarios de la aplicaci&oacute;n
  341. no ven el nombre del tipo de datos; &eacute;ste se utiliza en la base de
  342. datos de acciones o tipos de datos para identificar la definici&oacute;n
  343. del tipo de datos.</para>
  344. </listitem><listitem><para>Pulse el bot&oacute;n Editar situado junto al<indexterm>
  345. <primary>Caracter&iacute;sticas de Identificaci&oacute;n</primary><secondary>cuadro de di&aacute;logo</secondary></indexterm> cuadro Caracter&iacute;sticas
  346. de Identificaci&oacute;n para mostrar el cuadro de di&aacute;logo Caracter&iacute;sticas
  347. de Identificaci&oacute;n.</para>
  348. <figure>
  349. <title>Cuadro de di&aacute;logo Caracter&iacute;sticas de Identificaci&oacute;n
  350. de Crear Acciones</title>
  351. <graphic id="sag.dtcra.grph.5" entityref="SAG.dtCrA.fig.5"></graphic>
  352. </figure>
  353. <para>Las caracter&iacute;sticas de un tipo de datos son los criterios utilizados
  354. para diferenciar el tipo de datos de los dem&aacute;s. Puede elegir uno o
  355. m&aacute;s de los siguientes criterios:</para>
  356. <informaltable>
  357. <tgroup cols="2" colsep="0" rowsep="0">
  358. <colspec colwidth="158*">
  359. <colspec colwidth="370*">
  360. <tbody>
  361. <row>
  362. <entry align="left" valign="top"><para>Archivos o Carpetas</para></entry>
  363. <entry align="left" valign="top"><para>El tipo de datos se aplica s&oacute;lo
  364. a archivos o s&oacute;lo a carpetas</para></entry></row>
  365. <row>
  366. <entry align="left" valign="top"><para><indexterm><primary>tipos de datos</primary><secondary>basados en el nombre</secondary></indexterm><indexterm>
  367. <primary>basados en el nombre, tipos de datos</primary></indexterm>Patr&oacute;n
  368. de nombre</para></entry>
  369. <entry align="left" valign="top"><para>Tipos de datos basados en el nombre
  370. de archivo</para></entry></row>
  371. <row>
  372. <entry align="left" valign="top"><para><indexterm><primary>patr&oacute;n de
  373. permiso, especificado con Crear Acci&oacute;n</primary></indexterm><indexterm>
  374. <primary>tipos de datos</primary><secondary>patr&oacute;n de permiso</secondary>
  375. </indexterm>Patr&oacute;n de Permiso</para></entry>
  376. <entry align="left" valign="top"><para>Permisos de lectura, escritura y ejecuci&oacute;n
  377. </para></entry></row>
  378. <row>
  379. <entry align="left" valign="top"><para><indexterm><primary>tipos de datos</primary><secondary>basado en el contenido</secondary></indexterm><indexterm>
  380. <primary>basado en el contenido, tipo de datos</primary></indexterm>Contenido
  381. </para></entry>
  382. <entry align="left" valign="top"><para>Contenido de una parte especificada
  383. del archivo</para></entry></row></tbody></tgroup></informaltable>
  384. </listitem><listitem><para>Seleccione si el tipo de datos representa un archivo
  385. o una carpeta.</para>
  386. <figure>
  387. <title>Especificaci&oacute;n de una caracter&iacute;stica de archivo o de
  388. directorio para un tipo de datos.</title>
  389. <graphic id="sag.dtcra.grph.6" entityref="SAG.dtCrA.fig.6"></graphic>
  390. </figure>
  391. </listitem><listitem><para>Si el tipo de datos depende del nombre, seleccione
  392. la casilla de verificaci&oacute;n Patr&oacute;n de Nombre y rellene el campo
  393. de texto.</para>
  394. <figure>
  395. <title>Especificaci&oacute;n de la caracter&iacute;stica de nombre de archivo
  396. para un tipo de datos</title>
  397. <graphic id="sag.dtcra.grph.7" entityref="SAG.dtCrA.fig.7"></graphic>
  398. </figure>
  399. <para>Se puede utilizar * y ? como caracteres comod&iacute;n:</para>
  400. <informaltable>
  401. <tgroup cols="2" colsep="0" rowsep="0">
  402. <colspec colwidth="55*">
  403. <colspec colwidth="473*">
  404. <tbody>
  405. <row>
  406. <entry align="left" valign="top"><para>*</para></entry>
  407. <entry align="left" valign="top"><para>Coincide con cualquier secuencia de
  408. caracteres</para></entry></row>
  409. <row>
  410. <entry align="left" valign="top"><para>?</para></entry>
  411. <entry align="left" valign="top"><para>Coincide con cualquier car&aacute;cter
  412. individual</para></entry></row></tbody></tgroup></informaltable>
  413. </listitem><listitem><para>Si el tipo de datos depende de los permisos, seleccione
  414. la casilla de verificaci&oacute;n Patr&oacute;n de Permiso y seleccione los
  415. permisos para el tipo de datos.</para>
  416. <figure>
  417. <title>Especificaci&oacute;n de las caracter&iacute;sticas de permiso para
  418. un tipo de datos</title>
  419. <graphic id="sag.dtcra.grph.8" entityref="SAG.dtCrA.fig.8"></graphic>
  420. </figure>
  421. <informaltable>
  422. <tgroup cols="2" colsep="0" rowsep="0">
  423. <colspec colwidth="107*">
  424. <colspec colwidth="421*">
  425. <tbody>
  426. <row>
  427. <entry align="left" valign="top"><para>Activar</para></entry>
  428. <entry align="left" valign="top"><para>El archivo debe tener el permiso especificado
  429. </para></entry></row>
  430. <row>
  431. <entry align="left" valign="top"><para>Desactivar</para></entry>
  432. <entry align="left" valign="top"><para>El archivo debe carecer del permiso
  433. especificado</para></entry></row>
  434. <row>
  435. <entry align="left" valign="top"><para>Cualquiera</para></entry>
  436. <entry align="left" valign="top"><para>No importa el permiso especificado
  437. </para></entry></row></tbody></tgroup></informaltable>
  438. </listitem><listitem><para>Si el tipo de datos depende del contenido, seleccione
  439. la casilla de verificaci&oacute;n Contenido y proporcione la informaci&oacute;n
  440. solicitada: Patr&oacute;n a buscar y Tipo de contenido. Opcionalmente puede
  441. proporcionar la ubicaci&oacute;n del byte en la que debe iniciarse la busqueda.
  442. </para>
  443. <figure>
  444. <title>Especificaci&oacute;n de las caracter&iacute;sticas del contenido para
  445. un tipo de datos</title>
  446. <graphic id="sag.dtcra.grph.9" entityref="SAG.dtCrA.fig.9"></graphic>
  447. </figure>
  448. <note>
  449. <para>La utilizaci&oacute;n de tipo de datos basado en el contenido puede
  450. afectar al rendimiento del sistema.</para>
  451. </note>
  452. </listitem><listitem><para>Pulse OK para cerrar el cuadro de di&aacute;logo
  453. Caracter&iacute;sticas de Identificaci&oacute;n.</para>
  454. <para>Las caracter&iacute;sticas se mostrar&aacute;n en el<indexterm><primary>Caracter&iacute;sticas de Identificaci&oacute;n</primary><secondary>campo</secondary></indexterm> campo Caracter&iacute;sticas de Identificaci&oacute;n
  455. utilizando esta codificaci&oacute;n:</para>
  456. <informaltable>
  457. <tgroup cols="2" colsep="0" rowsep="0">
  458. <colspec colwidth="55*">
  459. <colspec colwidth="473*">
  460. <tbody>
  461. <row>
  462. <entry align="left" valign="top"><para>d</para></entry>
  463. <entry align="left" valign="top"><para>Un directorio</para></entry></row>
  464. <row>
  465. <entry align="left" valign="top"><para>r</para></entry>
  466. <entry align="left" valign="top"><para>El archivo tiene permiso de lectura
  467. </para></entry></row>
  468. <row>
  469. <entry align="left" valign="top"><para>w</para></entry>
  470. <entry align="left" valign="top"><para>El archivo tiene permiso de escritura
  471. </para></entry></row>
  472. <row>
  473. <entry align="left" valign="top"><para>x</para></entry>
  474. <entry align="left" valign="top"><para>El archivo tiene permiso de ejecuci&oacute;n
  475. </para></entry></row>
  476. <row>
  477. <entry align="left" valign="top"><para>!</para></entry>
  478. <entry align="left" valign="top"><para>Operador l&oacute;gico NOT</para></entry>
  479. </row>
  480. <row>
  481. <entry align="left" valign="top"><para>&amp;</para></entry>
  482. <entry align="left" valign="top"><para>Operador l&oacute;gico AND</para></entry>
  483. </row></tbody></tgroup></informaltable>
  484. </listitem><listitem><para>Escriba el texto de ayuda para los archivos de
  485. datos en el campo de texto Texto de Ayuda.</para>
  486. </listitem><listitem><para>Utilice los controles Iconos de Tipo de Datos
  487. para especificar el icono para la aplicaci&oacute;n. Inicialmente se muestra
  488. el icono predeterminado.</para>
  489. <itemizedlist remap="Bullet2"><listitem><para>Para elegir un icono existente
  490. diferente, pulse Buscar conjunto para mostrar el cuadro de di&aacute;logo
  491. Buscar Conjunto. Consulte la secci&oacute;n <!--Original XRef content: '&rdquo;Using
  492. the Find Set Dialog Box To Speci--><!--fy an Icon&rdquo; on page&numsp;152'--><xref
  493. role="SecTitleAndPageNum" linkend="sag.dtcra.mkr.7">.</para>
  494. </listitem><listitem><para>Para crear iconos nuevos, pulse Editar Icono para
  495. ejecutar el Editor de iconos.</para>
  496. </listitem></itemizedlist>
  497. </listitem><listitem><para>Verifique el mandato del campo de texto Mandato
  498. para Abrir este Tipo de Datos. &Eacute;ste es el mandato que se ejecutar&aacute;
  499. cuando el usuario pulse dos veces un archivo de datos.</para>
  500. </listitem><listitem><para>Opcional: Si la aplicaci&oacute;n proporciona un
  501. mandato de impresi&oacute;n para imprimir archivos de datos desde la l&iacute;nea
  502. de mandatos, escriba el mandato en el campo de texto Mandato para Imprimir
  503. este Tipo de Datos, utilizando la sintaxis <filename>$</filename><symbol role="Variable">n</symbol> para un argumento de archivo.</para>
  504. </listitem><listitem><para>Para guardar la definici&oacute;n del tipo de datos,
  505. realice una de estas acciones:</para>
  506. <itemizedlist remap="Bullet1"><listitem><para>Pulse OK para guardar el tipo
  507. de datos y cerrar el cuadro de di&aacute;logo A&ntilde;adir Tipo de Datos.
  508. </para>
  509. </listitem><listitem><para>Pulse Aplicar para guardar el tipo de datos sin
  510. cerrar el cuadro de di&aacute;logo A&ntilde;adir Tipo de Datos. Esto le permite
  511. continuar definiendo inmediatamente otro tipo de datos para la acci&oacute;n.
  512. </para>
  513. </listitem></itemizedlist>
  514. </listitem></orderedlist>
  515. </sect2>
  516. <sect2 id="SAG.dtCrA.div.9">
  517. <title id="SAG.dtCrA.mkr.7">Utilizaci&oacute;n del cuadro de di&aacute;logo
  518. Buscar Conjunto para especificar un<indexterm><primary>Crear Acci&oacute;n</primary><secondary>especificar iconos</secondary></indexterm><indexterm>
  519. <primary>iconos</primary><secondary>cuadro de di&aacute;logo Buscar Conjunto</secondary></indexterm> icono<indexterm><primary>Buscar Conjunto, cuadro
  520. de di&aacute;logo</primary></indexterm></title>
  521. <para>El cuadro de di&aacute;logo Buscar conjunto se muestra al pulsar Buscar
  522. conjunto en la ventana principal Crear Acciones o en la ventana A&ntilde;adir
  523. Tipo de Datos. Utilice el cuadro de di&aacute;logo para especificar el icono
  524. que se utilizar&aacute; para la acci&oacute;n o el tipo de datos.</para>
  525. <figure>
  526. <title>Cuadro de di&aacute;logo Buscar Conjunto<indexterm><primary>Tipos
  527. de datos</primary><secondary>iconos para</secondary></indexterm><indexterm>
  528. <primary>iconos</primary><secondary>tipos de datos</secondary></indexterm><indexterm>
  529. <primary>iconos</primary><secondary>acciones</secondary></indexterm><indexterm>
  530. <primary>acciones</primary><secondary>iconos para</secondary></indexterm></title>
  531. <graphic id="SAG.dtCrA.grph.10" entityref="SAG.dtCrA.fig.10"></graphic>
  532. </figure>
  533. <para>El cuadro de di&aacute;logo Buscar Conjunto le permite especificar
  534. un conjunto de archivos de im&aacute;genes de iconos ubicados:</para>
  535. <itemizedlist remap="Bullet1"><listitem><para>En un directorio de la ruta
  536. de b&uacute;squeda de iconos. La lista Carpetas de Iconos incluye todos los
  537. directorios de la ruta de b&uacute;squeda de iconos.</para>
  538. </listitem><listitem><para>En un paquete de registro que se integrar&aacute;
  539. con el escritorio utilizando <command>dtappintegrate</command>. Estos iconos
  540. todav&iacute;a no est&aacute;n ubicados en un directorio de la ruta de b&uacute;squeda
  541. de iconos, pero <command>dtappintegrate</command> los colocar&aacute; all&iacute;.
  542. </para>
  543. </listitem></itemizedlist>
  544. <note>
  545. <para>Las definiciones de acciones y de tipos de datos creadas utilizando
  546. Crear Acci&oacute;n escriben el nombre base de los archivos de iconos (el
  547. nombre de archivo menos los sufijos de nombre de archivo para el tama&ntilde;o
  548. y el tipo). Los iconos para las acciones y los tipos de datos creados con
  549. Crear Acci&oacute;n deben ponerse finalmente en directorios de la ruta de
  550. b&uacute;squeda de iconos.</para>
  551. </note>
  552. <sect3 id="SAG.dtCrA.div.10" role="Procedure">
  553. <title>Especificar un conjunto de iconos ubicados en la ruta de b&uacute;squeda
  554. de iconos</title>
  555. <orderedlist><listitem><para>En la lista Carpetas de Iconos del cuadro de
  556. di&aacute;logo Buscar Conjunto, pulse dos veces la ruta de carpeta que contiene
  557. el icono.</para>
  558. <para>La lista Archivos de Iconos mostrar&aacute; todos los archivos de iconos
  559. de dicha carpeta.</para>
  560. </listitem><listitem><para>En la lista Archivos de Iconos, pulse el icono
  561. que desea utilizar.</para>
  562. <para>Esta acci&oacute;n pone el nombre base del archivo de iconos en el campo
  563. de texto Entre el nombre del archivo de iconos.</para>
  564. </listitem><listitem><para>Pulse OK.</para>
  565. </listitem></orderedlist>
  566. </sect3>
  567. <sect3 id="SAG.dtCrA.div.11" role="Procedure">
  568. <title>Especificar un icono en un paquete de registro</title>
  569. <para>Si es usted administrador del sistema o programador y est&aacute; creando
  570. un paquete de registro, los archivos de im&aacute;genes de iconos se ubican
  571. inicialmente en un directorio del paquete de registro:</para>
  572. <programlisting><symbol role="Variable">apl_ra&iacute;z</symbol>/dt/appconfig/icons/<symbol role="Variable">idioma</symbol></programlisting>
  573. <para>Despu&eacute;s del registro con <command>dtappintegrate</command>,
  574. los archivos de iconos se copiar&aacute;n en <filename>/etc/dt/appconfig/icons/</filename><symbol role="Variable">idioma</symbol>, que se encuentra en la
  575. ruta de b&uacute;squeda de iconos.</para>
  576. <para>Utilice este procedimiento para especificar iconos que forman parte
  577. de un paquete de registro:</para>
  578. <orderedlist><listitem><para>En el campo de texto Entre el nombre del archivo
  579. de iconos del cuadro de di&aacute;logo Buscar Conjunto, escriba el nombre
  580. base del archivo de iconos.</para>
  581. </listitem><listitem><para>Pulse OK.</para>
  582. <para>Crear Acci&oacute;n muestra un cuadro de di&aacute;logo para informarle
  583. que no se han encontrado los iconos en los directorios de la ruta de b&uacute;squeda
  584. de directorio.</para>
  585. </listitem><listitem><para>En el cuadro de di&aacute;logo de informaci&oacute;n
  586. que aparece, elija Sin cambio.</para>
  587. </listitem></orderedlist>
  588. </sect3>
  589. </sect2>
  590. </sect1>
  591. </chapter>
  592. <!--fickle 1.14 mif-to-docbook 1.7 01/02/96 14:35:19-->
  593. <?Pub Caret>
  594. <?Pub *0000039287>