Development/Architecture/KDE4/Providing Online Help (es) - Revision history

AnneW at 16:22, 15 July 2012

2012-07-15T16:22:49Z

Neverendingo: Text replace - "" to ""

2011-06-29T20:49:43Z

Text replace - "</code>" to "</syntaxhighlight>"

Neverendingo: Text replace - "`" to ""`


2011-06-29T20:35:27Z
Text replace - "<code cppqt3>" to "<syntaxhighlight lang="cpp-qt">"

				
				
				
				
			
			← Older revision
			Revision as of 20:35, 29 June 2011
			
Line 16:
Line 16:
    
  Desde el punto de vista del programador, Qt proporciona una forma fácil de usar la API para la ayuda online. Para asignar un tooltip a un widget, simplemente usa el método setToolTip():   Desde el punto de vista del programador, Qt proporciona una forma fácil de usar la API para la ayuda online. Para asignar un tooltip a un widget, simplemente usa el método setToolTip():
− <code cppqt3> + <syntaxhighlight lang="cpp-qt">
  widget->setToolTip(i18n("Este widget hace algo."))   widget->setToolTip(i18n("Este widget hace algo."))
  </code>   </code>
Line 22:
Line 22:
  Si la barra de menú y la barra de herramientas han sido creadas usando [[../Action Pattern|action pattern]], la cadena usada como tooltip se hereda del primer argumento del constructor [http://api.kde.org/4.x-api/kdelibs-apidocs/kdeui/html/classKAction.html KAction]:   Si la barra de menú y la barra de herramientas han sido creadas usando [[../Action Pattern|action pattern]], la cadena usada como tooltip se hereda del primer argumento del constructor [http://api.kde.org/4.x-api/kdelibs-apidocs/kdeui/html/classKAction.html KAction]:
    
− <code cppqt3> + <syntaxhighlight lang="cpp-qt">
  action = new KAction(i18n("&Delete"), "editdelete",   action = new KAction(i18n("&Delete"), "editdelete",
                        SHIFT+Key_Delete, actionCollection(), "del")                         SHIFT+Key_Delete, actionCollection(), "del")
Line 29:
Line 29:
  Aquí también es posible asignar un texto que es mostrado en la barra de estado cuando el respectivo ítem del menú es "highlighted":   Aquí también es posible asignar un texto que es mostrado en la barra de estado cuando el respectivo ítem del menú es "highlighted":
    
− <code cppqt3> + <syntaxhighlight lang="cpp-qt">
  action->setStatusText(i18n("Borrar el fichero seleccionado"))   action->setStatusText(i18n("Borrar el fichero seleccionado"))
  </code>   </code>
Line 35:
Line 35:
  La Api para la ayuda "¿Qué es esto?" es muy similar. En los diálogos, usa el siguiente código:   La Api para la ayuda "¿Qué es esto?" es muy similar. En los diálogos, usa el siguiente código:
    
− <code cppqt3> + <syntaxhighlight lang="cpp-qt">
  widget->setWhatsThis(i18n("<qt>This demonstrates <b>Qt</b>'s"   widget->setWhatsThis(i18n("<qt>This demonstrates <b>Qt</b>'s"
                           " rich text engine.<ul>"                            " rich text engine.<ul>"
Line 45:
Line 45:
    
  Para los ítems del menú, usa:   Para los ítems del menú, usa:
− <code cppqt3> + <syntaxhighlight lang="cpp-qt">
  action->setWhatsThis(i18n("Borrar el fichero seleccionado"))   action->setWhatsThis(i18n("Borrar el fichero seleccionado"))
  </code>   </code>
    
  La invocación de khelpcenter esta encapsulada en la clase [http://api.kde.org/4.x-api/kdelibs-apidocs/kdecore/html/classKToolInvocation.html KToolInvocation]. Para mostrar el manual de tu aplicación, usa simplemente el método estático:   La invocación de khelpcenter esta encapsulada en la clase [http://api.kde.org/4.x-api/kdelibs-apidocs/kdecore/html/classKToolInvocation.html KToolInvocation]. Para mostrar el manual de tu aplicación, usa simplemente el método estático:
− <code cppqt3> + <syntaxhighlight lang="cpp-qt">
  KToolInvocation::invokeHelp()   KToolInvocation::invokeHelp()
  </code>   </code>



Edumardo: update translation (es)
2009-03-09T23:06:01Z
update translation (es)

				
				
				
				
			
			← Older revision
			Revision as of 23:06, 9 March 2009
			
Line 1:
Line 1:
  + {{Template:I18n/Language Navigation Bar|Development/Architecture/KDE4/Providing Online Help}}
  + 
  '''Arquitectura de KDE - Suministro de ayuda online'''   '''Arquitectura de KDE - Suministro de ayuda online'''
    



Edumardo: update
2008-09-17T11:09:10Z
update

				
				
				
				
			
			← Older revision
			Revision as of 11:09, 17 September 2008
			
Line 47:
Line 47:
  </code>   </code>
    
− La invocación de khelpcenter esta encapsulada en la clase [http://api.kde.org/4.x-api/kdelibs-apidocs/kdecore/html/classKToolInvocation.html KToolInvocation] + La invocación de khelpcenter esta encapsulada en la clase [http://api.kde.org/4.x-api/kdelibs-apidocs/kdecore/html/classKToolInvocation.html KToolInvocation]. Para mostrar el manual de tu aplicación, usa simplemente el método estático:
− . Para mostrar el manual de tu aplicación, usa simplemente el método estático: + 
  <code cppqt3>   <code cppqt3>
  KToolInvocation::invokeHelp()   KToolInvocation::invokeHelp()



Edumardo: translation to spanish:tildes
2008-09-16T17:54:08Z
translation to spanish:tildes

				
				
				
				
			
			← Older revision
			Revision as of 17:54, 16 September 2008
			
Line 7:
Line 7:
  *Los tooltips son las pequeñas etiquetas que aparecen sobre los elementos de la interfaz de usuario cuando el ratón permanece sobre estos durante un periodo de tiempo largo. Son especialmente importantes en las "toolbars", donde los iconos no siempre son suficientes para explicar el cometido de un botón.   *Los tooltips son las pequeñas etiquetas que aparecen sobre los elementos de la interfaz de usuario cuando el ratón permanece sobre estos durante un periodo de tiempo largo. Son especialmente importantes en las "toolbars", donde los iconos no siempre son suficientes para explicar el cometido de un botón.
    
− * La ayuda "¿Qué ese esto?" normalmente es una extensa explicación de un widget o de un ítem de un menú. También es mas patosa de usar: el los diálogos, puede ser invocada de dos maneras: presionando Shift+F1 o pulsando sobre el signo de interrogación en la barra de título (donde el soporte de este depende del administrador de ventanas). Entonces el puntero del ratón se convierte en una flecha con un signo de interrogación, y cuando se hace clic sobre un elemento de la interfaz de usuario aparece la ventana de ayuda. La ayuda "¿Que es esto?" de los ítems del menú se activa normalmente mediante un botón en la "toolbar", que contiene una flecha y un signo de interrogación.<br/>El problema de este método es que el usuario no puede saber cuando un widget proporciona ayuda o no. Cuando el usuario activa el botón de signo de interrogación, y no obtiene ninguna ayuda cuando pulsa sobre un elemento de la interfaz de usuario, se frustrará rápidamente.<br/><br/>La ventaja de la ayuda "¿Qué es esto?" proporcionada por Qt y KDE es que puede contener [http://doc.trolltech.com/4.4/richtext.html texto enriquecido], es decir, puede contener diferentes tipos de letra, texto cursiva y negrita e incluso imágenes y tablas. + * La ayuda "¿Qué ese esto?" normalmente es una extensa explicación de un widget o de un ítem de un menú. También es mas patosa de usar: el los diálogos, puede ser invocada de dos maneras: presionando Shift+F1 o pulsando sobre el signo de interrogación en la barra de título (donde el soporte de este depende del administrador de ventanas). Entonces el puntero del ratón se convierte en una flecha con un signo de interrogación, y cuando se hace clic sobre un elemento de la interfaz de usuario aparece la ventana de ayuda. La ayuda "¿Que es esto?" de los ítems del menú se activa normalmente mediante un botón en la "toolbar", que contiene una flecha y un signo de interrogación.<br/>El problema de este método es que el usuario no puede saber si un widget proporciona ayuda o no. Cuando el usuario activa el botón de signo de interrogación y pulsa sobre un elemento de la interfaz de usuario y no obtiene ayuda, se frustrará rápidamente.<br/><br/>La ventaja de la ayuda "¿Qué es esto?" proporcionada por Qt y KDE es que puede contener [http://doc.trolltech.com/4.4/richtext.html texto enriquecido], es decir, puede contener diferentes tipos de letra, texto cursiva y negrita e incluso imágenes y tablas.
  <br/>   <br/>
  [[Image:Kde4-queEsEsto.png‎|frame|center|Captura de pantalla ¿Qué es esto?]]   [[Image:Kde4-queEsEsto.png‎|frame|center|Captura de pantalla ¿Qué es esto?]]
  <br/>   <br/>
− *Finalmente, cada programa debería tener un manual. Normalmente se consulta un manual en khelpcenter, activando el menú de ayuda. Esto significa cargar una nueva aplicación y desviar la atencion del usuario. Por tanto, la consulta del manual solo deberia ser necesaria si las otras facilidades como los tooltips o la ayuda "¿Qué es esto?" no son suficientes. Por supuesto, un manual tiene la ventaja de que no explica un aspecto aislado de la interfaz de usuario, en cambio, puede explicar aspectos de la aplicación en un contexto mas amplio. Los manuales de KDE están escritos usando el lenguaje de etiquetado [http://i18n.kde.org DocBook].   + *Finalmente, cada programa debería tener un manual. Normalmente se consulta un manual en khelpcenter, activando el menú de ayuda. Esto significa cargar una nueva aplicación y desviar la atención del usuario. Por tanto, la consulta del manual solo debería ser necesaria si las otras facilidades como los tooltips o la ayuda "¿Qué es esto?" no son suficientes. Por supuesto, un manual tiene la ventaja de que no explica un aspecto aislado de la interfaz de usuario, sino que explica aspectos de la aplicación en un contexto mas amplio. Los manuales de KDE están escritos usando el lenguaje de etiquetado [http://i18n.kde.org DocBook].  
    
  Desde el punto de vista del programador, Qt proporciona una forma fácil de usar la API para la ayuda online. Para asignar un tooltip a un widget, simplemente usa el método setToolTip():   Desde el punto de vista del programador, Qt proporciona una forma fácil de usar la API para la ayuda online. Para asignar un tooltip a un widget, simplemente usa el método setToolTip():
Line 53:
Line 53:
  </code>   </code>
    
− Este código muestra la primera página con la tabla de contenidos. Cuando quieras mostrar solo una sección del manual, puedes invocar a invokeHelp() con un argumento adicional que determina que sección quieres mostrar. + Este código muestra la primera página con la tabla de contenidos. Cuando quieras mostrar solo una sección del manual, puedes invocar a invokeHelp() con un argumento adicional que determina la sección a saltar.
    
  ''Initial Author:'' [mailto:bernd@kdevelop.org Bernd Gehrmann]   ''Initial Author:'' [mailto:bernd@kdevelop.org Bernd Gehrmann]



Edumardo: translate to spanish
2008-09-16T00:25:34Z
translate to spanish

				
				
				
				
			
			← Older revision
			Revision as of 00:25, 16 September 2008
			
Line 1:
Line 1:
  '''Arquitectura de KDE - Suministro de ayuda online'''   '''Arquitectura de KDE - Suministro de ayuda online'''
    
− La construcción de un programa facil e intuitivo de usar implica un amplio rango de   + La construcción de un programa fácil e intuitivo de usar implica un amplio rango de  
  facilidades que por lo general se llama ayuda online. La ayuda online persigue     facilidades que por lo general se llama ayuda online. La ayuda online persigue  
− varios objetivos parcialmente contradictorios: por un lado, debería dar respuesta a la pregunta del usuario "¿Como puedo realizar una cierta tarea?", pero por el otro lado debería ayudar al usuario que explora la aplicación y se encuentra con caracteristicas que aun desconoce. Es importante reconocer que esta situacion sólo puede ser tratada ofreciendo varios niveles de ayuda:   + varios objetivos parcialmente contradictorios: por un lado, debería dar respuesta a la pregunta del usuario "¿Como puedo realizar una cierta tarea?", pero por el otro lado debería ayudar al usuario que explora la aplicación y se encuentra con características que aun desconoce. Es importante reconocer que esta situación sólo puede ser tratada ofreciendo varios niveles de ayuda:  
    
  *Los tooltips son las pequeñas etiquetas que aparecen sobre los elementos de la interfaz de usuario cuando el ratón permanece sobre estos durante un periodo de tiempo largo. Son especialmente importantes en las "toolbars", donde los iconos no siempre son suficientes para explicar el cometido de un botón.   *Los tooltips son las pequeñas etiquetas que aparecen sobre los elementos de la interfaz de usuario cuando el ratón permanece sobre estos durante un periodo de tiempo largo. Son especialmente importantes en las "toolbars", donde los iconos no siempre son suficientes para explicar el cometido de un botón.
    
− * La ayuda "¿Qué ese esto?" normalmente es una extensa explicación de un widget o de un item de un menu. Tambien es mas patosa de usar: el los dialogos, puede ser invocada de dos maneras: presionando Shift+F1 o pulsando sobre el signo de interrogación en la barra de título (donde el soporte de este depende del administrador de ventanas). Entonces el puntero del ratón se convierte en una flecha con un signo de interrogación, y cuando se hace clic sobre un elemento de la interfaz de usuario aparece la ventana de ayuda. La ayuda "¿Que es esto?" de los items del menu se activa normalmento mediante un boton en la "toolbar", que contiene una flecha y un signo de interrogación.<br/>El problema de este método es que el usuario no puede saber cuando un widget proporciona ayuda o no. Cuando el usuario activa el boton de signo de interrogación, y no obtiene ninguna ayuda cuando pulsa sobre un elemento de la interfaz de usuario, se frustrará rapidamente.<br/><br/>La ventaja de la ayuda "¿Qué es esto?" proporcionada por Qt y KDE es que puede contener [http://doc.trolltech.com/4.4/richtext.html texto enriquecido], es decir, puede contener diferentes tipos de letra, texto cursiva y negrita e incluso imagenes y tablas. + * La ayuda "¿Qué ese esto?" normalmente es una extensa explicación de un widget o de un ítem de un menú. También es mas patosa de usar: el los diálogos, puede ser invocada de dos maneras: presionando Shift+F1 o pulsando sobre el signo de interrogación en la barra de título (donde el soporte de este depende del administrador de ventanas). Entonces el puntero del ratón se convierte en una flecha con un signo de interrogación, y cuando se hace clic sobre un elemento de la interfaz de usuario aparece la ventana de ayuda. La ayuda "¿Que es esto?" de los ítems del menú se activa normalmente mediante un botón en la "toolbar", que contiene una flecha y un signo de interrogación.<br/>El problema de este método es que el usuario no puede saber cuando un widget proporciona ayuda o no. Cuando el usuario activa el botón de signo de interrogación, y no obtiene ninguna ayuda cuando pulsa sobre un elemento de la interfaz de usuario, se frustrará rápidamente.<br/><br/>La ventaja de la ayuda "¿Qué es esto?" proporcionada por Qt y KDE es que puede contener [http://doc.trolltech.com/4.4/richtext.html texto enriquecido], es decir, puede contener diferentes tipos de letra, texto cursiva y negrita e incluso imágenes y tablas.
  <br/>   <br/>
  [[Image:Kde4-queEsEsto.png‎|frame|center|Captura de pantalla ¿Qué es esto?]]   [[Image:Kde4-queEsEsto.png‎|frame|center|Captura de pantalla ¿Qué es esto?]]
  <br/>   <br/>
− *Finalmente, cada programa debería tener un manual. Normalmente se consulta un manual en khelpcenter,activando el menu de ayuda. Esto significa cargar una nueva aplicacion y desviar la atencion del usuario. Por tanto, la consulta del manual solo deberia ser necesaria si las otras faclidades como los tooltips o la ayuda "¿Qué es esto?" no son suficientes. Por supuesto, un manual tiene la ventaja de que no explica un aspecto aislado de la interfaz de usuario, en cambio, puede explicar aspectos de la aplicacion en un contexto mas amplio. Los manuales de KDE están escritos usando el lenguaje de etiquetado [http://i18n.kde.org DocBook].   + *Finalmente, cada programa debería tener un manual. Normalmente se consulta un manual en khelpcenter, activando el menú de ayuda. Esto significa cargar una nueva aplicación y desviar la atencion del usuario. Por tanto, la consulta del manual solo deberia ser necesaria si las otras facilidades como los tooltips o la ayuda "¿Qué es esto?" no son suficientes. Por supuesto, un manual tiene la ventaja de que no explica un aspecto aislado de la interfaz de usuario, en cambio, puede explicar aspectos de la aplicación en un contexto mas amplio. Los manuales de KDE están escritos usando el lenguaje de etiquetado [http://i18n.kde.org DocBook].  
    
− Desde el punto de vista del programador, Qt proporciona una forma facil de usar la API para la ayuda online. Para asinar un tooltip a un widget, simplemente usa el metodo setToolTip(): + Desde el punto de vista del programador, Qt proporciona una forma fácil de usar la API para la ayuda online. Para asignar un tooltip a un widget, simplemente usa el método setToolTip():
  <code cppqt3>   <code cppqt3>
  widget->setToolTip(i18n("Este widget hace algo."))   widget->setToolTip(i18n("Este widget hace algo."))
  </code>   </code>
    
− Si la barra de menu y la barra de herramientas han sido creadas usando [[../Action Pattern|action pattern]], la cadena usada como tooltip se hereda del primer argumento del constructor [http://api.kde.org/4.x-api/kdelibs-apidocs/kdeui/html/classKAction.html KAction]: + Si la barra de menú y la barra de herramientas han sido creadas usando [[../Action Pattern|action pattern]], la cadena usada como tooltip se hereda del primer argumento del constructor [http://api.kde.org/4.x-api/kdelibs-apidocs/kdeui/html/classKAction.html KAction]:
    
  <code cppqt3>   <code cppqt3>
Line 25:
Line 25:
  </code>   </code>
    
− Aqui tambien es posible asignar un texto que es mostrado en la barra de estado cuando el respectivo item del menu es "highlighted": + Aquí también es posible asignar un texto que es mostrado en la barra de estado cuando el respectivo ítem del menú es "highlighted":
    
  <code cppqt3>   <code cppqt3>
Line 31:
Line 31:
  </code>   </code>
    
− La Api para la ayuda "¿Qué es esto?" es muy similar. En los dialogos, usa el siguiente codigo: + La Api para la ayuda "¿Qué es esto?" es muy similar. En los diálogos, usa el siguiente código:
    
  <code cppqt3>   <code cppqt3>
Line 42:
Line 42:
    
    
− Para los items del menu, usa: + Para los ítems del menú, usa:
  <code cppqt3>   <code cppqt3>
  action->setWhatsThis(i18n("Borrar el fichero seleccionado"))   action->setWhatsThis(i18n("Borrar el fichero seleccionado"))
  </code>   </code>
    
− La invocacion de khelpcenter esta encapsulada en la clase [http://api.kde.org/4.x-api/kdelibs-apidocs/kdecore/html/classKToolInvocation.html KToolInvocation] + La invocación de khelpcenter esta encapsulada en la clase [http://api.kde.org/4.x-api/kdelibs-apidocs/kdecore/html/classKToolInvocation.html KToolInvocation]
− . Para mostrar el manual de tu aplicacion, usa simplemente el metodo estatico: + . Para mostrar el manual de tu aplicación, usa simplemente el método estático:
  <code cppqt3>   <code cppqt3>
  KToolInvocation::invokeHelp()   KToolInvocation::invokeHelp()
  </code>   </code>
    
− Este codigo muestra la primera pagina con la tabla de contenidos. Cuando quieras mostrar solo una seccion del manual, puedes invocar a invokeHelp() con un argumento adicional que determina que seccion quieres mostrar. + Este código muestra la primera página con la tabla de contenidos. Cuando quieras mostrar solo una sección del manual, puedes invocar a invokeHelp() con un argumento adicional que determina que sección quieres mostrar.
    
  ''Initial Author:'' [mailto:bernd@kdevelop.org Bernd Gehrmann]   ''Initial Author:'' [mailto:bernd@kdevelop.org Bernd Gehrmann]



Edumardo: translate to spanish
2008-09-16T00:19:48Z
translate to spanish

				
				
				
				
			
			← Older revision
			Revision as of 00:19, 16 September 2008
			
Line 8:
Line 8:
    
  * La ayuda "¿Qué ese esto?" normalmente es una extensa explicación de un widget o de un item de un menu. Tambien es mas patosa de usar: el los dialogos, puede ser invocada de dos maneras: presionando Shift+F1 o pulsando sobre el signo de interrogación en la barra de título (donde el soporte de este depende del administrador de ventanas). Entonces el puntero del ratón se convierte en una flecha con un signo de interrogación, y cuando se hace clic sobre un elemento de la interfaz de usuario aparece la ventana de ayuda. La ayuda "¿Que es esto?" de los items del menu se activa normalmento mediante un boton en la "toolbar", que contiene una flecha y un signo de interrogación.<br/>El problema de este método es que el usuario no puede saber cuando un widget proporciona ayuda o no. Cuando el usuario activa el boton de signo de interrogación, y no obtiene ninguna ayuda cuando pulsa sobre un elemento de la interfaz de usuario, se frustrará rapidamente.<br/><br/>La ventaja de la ayuda "¿Qué es esto?" proporcionada por Qt y KDE es que puede contener [http://doc.trolltech.com/4.4/richtext.html texto enriquecido], es decir, puede contener diferentes tipos de letra, texto cursiva y negrita e incluso imagenes y tablas.   * La ayuda "¿Qué ese esto?" normalmente es una extensa explicación de un widget o de un item de un menu. Tambien es mas patosa de usar: el los dialogos, puede ser invocada de dos maneras: presionando Shift+F1 o pulsando sobre el signo de interrogación en la barra de título (donde el soporte de este depende del administrador de ventanas). Entonces el puntero del ratón se convierte en una flecha con un signo de interrogación, y cuando se hace clic sobre un elemento de la interfaz de usuario aparece la ventana de ayuda. La ayuda "¿Que es esto?" de los items del menu se activa normalmento mediante un boton en la "toolbar", que contiene una flecha y un signo de interrogación.<br/>El problema de este método es que el usuario no puede saber cuando un widget proporciona ayuda o no. Cuando el usuario activa el boton de signo de interrogación, y no obtiene ninguna ayuda cuando pulsa sobre un elemento de la interfaz de usuario, se frustrará rapidamente.<br/><br/>La ventaja de la ayuda "¿Qué es esto?" proporcionada por Qt y KDE es que puede contener [http://doc.trolltech.com/4.4/richtext.html texto enriquecido], es decir, puede contener diferentes tipos de letra, texto cursiva y negrita e incluso imagenes y tablas.
−   + <br/>
  [[Image:Kde4-queEsEsto.png‎|frame|center|Captura de pantalla ¿Qué es esto?]]   [[Image:Kde4-queEsEsto.png‎|frame|center|Captura de pantalla ¿Qué es esto?]]
−   + <br/>
  *Finalmente, cada programa debería tener un manual. Normalmente se consulta un manual en khelpcenter,activando el menu de ayuda. Esto significa cargar una nueva aplicacion y desviar la atencion del usuario. Por tanto, la consulta del manual solo deberia ser necesaria si las otras faclidades como los tooltips o la ayuda "¿Qué es esto?" no son suficientes. Por supuesto, un manual tiene la ventaja de que no explica un aspecto aislado de la interfaz de usuario, en cambio, puede explicar aspectos de la aplicacion en un contexto mas amplio. Los manuales de KDE están escritos usando el lenguaje de etiquetado [http://i18n.kde.org DocBook].     *Finalmente, cada programa debería tener un manual. Normalmente se consulta un manual en khelpcenter,activando el menu de ayuda. Esto significa cargar una nueva aplicacion y desviar la atencion del usuario. Por tanto, la consulta del manual solo deberia ser necesaria si las otras faclidades como los tooltips o la ayuda "¿Qué es esto?" no son suficientes. Por supuesto, un manual tiene la ventaja de que no explica un aspecto aislado de la interfaz de usuario, en cambio, puede explicar aspectos de la aplicacion en un contexto mas amplio. Los manuales de KDE están escritos usando el lenguaje de etiquetado [http://i18n.kde.org DocBook].  
    
− From the programmer's point of view, Qt provides an easy to use API for online + Desde el punto de vista del programador, Qt proporciona una forma facil de usar la API para la ayuda online. Para asinar un tooltip a un widget, simplemente usa el metodo setToolTip():
− help. To assign a tooltip to widget, simply use its setToolTip() method. + 
  <code cppqt3>   <code cppqt3>
− widget->setToolTip(i18n("This widget does something.")) + widget->setToolTip(i18n("Este widget hace algo."))
  </code>   </code>
    
− If the menu bars and tool bars are created using the [[../Action Pattern|action pattern]], the string used as tooltip is derived from the first argument + Si la barra de menu y la barra de herramientas han sido creadas usando [[../Action Pattern|action pattern]], la cadena usada como tooltip se hereda del primer argumento del constructor [http://api.kde.org/4.x-api/kdelibs-apidocs/kdeui/html/classKAction.html KAction]:
− of the [http://api.kde.org/4.x-api/kdelibs-apidocs/kdeui/html/classKAction.html KAction] constructor: + 
    
  <code cppqt3>   <code cppqt3>
Line 27:
Line 25:
  </code>   </code>
    
− Here it is also possible to assign a text which is shown in the status bar when the  respective menu item is highlighted: + Aqui tambien es posible asignar un texto que es mostrado en la barra de estado cuando el respectivo item del menu es "highlighted":
    
  <code cppqt3>   <code cppqt3>
− action->setStatusText(i18n("Deletes the marked file")) + action->setStatusText(i18n("Borrar el fichero seleccionado"))
  </code>   </code>
    
− The API for "What's this?' help is very similar. In dialogs, use the following + La Api para la ayuda "¿Qué es esto?" es muy similar. En los dialogos, usa el siguiente codigo:
− code: + 
    
  <code cppqt3>   <code cppqt3>
Line 44:
Line 41:
  </code>   </code>
    
− For menu items, use +  
  + Para los items del menu, usa:
  <code cppqt3>   <code cppqt3>
− action->setWhatsThis(i18n("Deletes the marked file")) + action->setWhatsThis(i18n("Borrar el fichero seleccionado"))
  </code>   </code>
    
− The invocation of khelpcenter is encapsulated in the + La invocacion de khelpcenter esta encapsulada en la clase [http://api.kde.org/4.x-api/kdelibs-apidocs/kdecore/html/classKToolInvocation.html KToolInvocation]
− [http://api.kde.org/4.x-api/kdelibs-apidocs/kdecore/html/classKToolInvocation.html KToolInvocation] + . Para mostrar el manual de tu aplicacion, usa simplemente el metodo estatico:
− class. In order to show the manual of your application, just use the static method: + 
−   + 
  <code cppqt3>   <code cppqt3>
  KToolInvocation::invokeHelp()   KToolInvocation::invokeHelp()
  </code>   </code>
    
− This displays the first page with the table of contents. When + Este codigo muestra la primera pagina con la tabla de contenidos. Cuando quieras mostrar solo una seccion del manual, puedes invocar a invokeHelp() con un argumento adicional que determina que seccion quieres mostrar.
− you want to display only a certain section of the manual, you + 
− can give an additional argument to invokeHelp() determining + 
− the anchor which the browser jumps to. + 
−   + 
    
  ''Initial Author:'' [mailto:bernd@kdevelop.org Bernd Gehrmann]   ''Initial Author:'' [mailto:bernd@kdevelop.org Bernd Gehrmann]



Edumardo: translate to spanish
2008-09-16T00:05:13Z
translate to spanish

				
				
				
				
			
			← Older revision
			Revision as of 00:05, 16 September 2008
			
Line 11:
Line 11:
  [[Image:Kde4-queEsEsto.png‎|frame|center|Captura de pantalla ¿Qué es esto?]]   [[Image:Kde4-queEsEsto.png‎|frame|center|Captura de pantalla ¿Qué es esto?]]
    
− *Finally, every program should have a manual. A manual is normally viewed in khelpcenter by activating the help menu. That means, a complete additional application pops up and diverts the user from his work. Consequently, consulting the manual should only be necessary if other facilities like tooltips and what's this help are not sufficient. Of course, a manual has the advantage that it does not explain single, isolated aspects of the user interface. Instead, it can explain aspects of the application in a greater context. Manuals for KDE are written using the [http://i18n.kde.org DocBook] markup language. + *Finalmente, cada programa debería tener un manual. Normalmente se consulta un manual en khelpcenter,activando el menu de ayuda. Esto significa cargar una nueva aplicacion y desviar la atencion del usuario. Por tanto, la consulta del manual solo deberia ser necesaria si las otras faclidades como los tooltips o la ayuda "¿Qué es esto?" no son suficientes. Por supuesto, un manual tiene la ventaja de que no explica un aspecto aislado de la interfaz de usuario, en cambio, puede explicar aspectos de la aplicacion en un contexto mas amplio. Los manuales de KDE están escritos usando el lenguaje de etiquetado [http://i18n.kde.org DocBook].  
    
  From the programmer's point of view, Qt provides an easy to use API for online   From the programmer's point of view, Qt provides an easy to use API for online



Edumardo: translate to spanish
2008-09-15T23:34:54Z
translate to spanish

				
				
				
				
			
			← Older revision
			Revision as of 23:34, 15 September 2008
			
Line 8:
Line 8:
    
  * La ayuda "¿Qué ese esto?" normalmente es una extensa explicación de un widget o de un item de un menu. Tambien es mas patosa de usar: el los dialogos, puede ser invocada de dos maneras: presionando Shift+F1 o pulsando sobre el signo de interrogación en la barra de título (donde el soporte de este depende del administrador de ventanas). Entonces el puntero del ratón se convierte en una flecha con un signo de interrogación, y cuando se hace clic sobre un elemento de la interfaz de usuario aparece la ventana de ayuda. La ayuda "¿Que es esto?" de los items del menu se activa normalmento mediante un boton en la "toolbar", que contiene una flecha y un signo de interrogación.<br/>El problema de este método es que el usuario no puede saber cuando un widget proporciona ayuda o no. Cuando el usuario activa el boton de signo de interrogación, y no obtiene ninguna ayuda cuando pulsa sobre un elemento de la interfaz de usuario, se frustrará rapidamente.<br/><br/>La ventaja de la ayuda "¿Qué es esto?" proporcionada por Qt y KDE es que puede contener [http://doc.trolltech.com/4.4/richtext.html texto enriquecido], es decir, puede contener diferentes tipos de letra, texto cursiva y negrita e incluso imagenes y tablas.   * La ayuda "¿Qué ese esto?" normalmente es una extensa explicación de un widget o de un item de un menu. Tambien es mas patosa de usar: el los dialogos, puede ser invocada de dos maneras: presionando Shift+F1 o pulsando sobre el signo de interrogación en la barra de título (donde el soporte de este depende del administrador de ventanas). Entonces el puntero del ratón se convierte en una flecha con un signo de interrogación, y cuando se hace clic sobre un elemento de la interfaz de usuario aparece la ventana de ayuda. La ayuda "¿Que es esto?" de los items del menu se activa normalmento mediante un boton en la "toolbar", que contiene una flecha y un signo de interrogación.<br/>El problema de este método es que el usuario no puede saber cuando un widget proporciona ayuda o no. Cuando el usuario activa el boton de signo de interrogación, y no obtiene ninguna ayuda cuando pulsa sobre un elemento de la interfaz de usuario, se frustrará rapidamente.<br/><br/>La ventaja de la ayuda "¿Qué es esto?" proporcionada por Qt y KDE es que puede contener [http://doc.trolltech.com/4.4/richtext.html texto enriquecido], es decir, puede contener diferentes tipos de letra, texto cursiva y negrita e incluso imagenes y tablas.
− [[Image:Qt3-whatsthis.png|frame|center|QWhatsThis screenshot]] +  
  + [[Image:Kde4-queEsEsto.png‎|frame|center|Captura de pantalla ¿Qué es esto?]]
  +  
  *Finally, every program should have a manual. A manual is normally viewed in khelpcenter by activating the help menu. That means, a complete additional application pops up and diverts the user from his work. Consequently, consulting the manual should only be necessary if other facilities like tooltips and what's this help are not sufficient. Of course, a manual has the advantage that it does not explain single, isolated aspects of the user interface. Instead, it can explain aspects of the application in a greater context. Manuals for KDE are written using the [http://i18n.kde.org DocBook] markup language.   *Finally, every program should have a manual. A manual is normally viewed in khelpcenter by activating the help menu. That means, a complete additional application pops up and diverts the user from his work. Consequently, consulting the manual should only be necessary if other facilities like tooltips and what's this help are not sufficient. Of course, a manual has the advantage that it does not explain single, isolated aspects of the user interface. Instead, it can explain aspects of the application in a greater context. Manuals for KDE are written using the [http://i18n.kde.org DocBook] markup language.

← Older revision		Revision as of 16:22, 15 July 2012
Line 1:		Line 1:
−	~~{{Template:I18n/Language Navigation Bar\|Development/Architecture/KDE4/Providing Online Help}}~~	+

	'''Arquitectura de KDE - Suministro de ayuda online'''		'''Arquitectura de KDE - Suministro de ayuda online'''

← Older revision		Revision as of 23:06, 9 March 2009
Line 1:		Line 1:
		+	{{Template:I18n/Language Navigation Bar\|Development/Architecture/KDE4/Providing Online Help}}
		+
	'''Arquitectura de KDE - Suministro de ayuda online'''		'''Arquitectura de KDE - Suministro de ayuda online'''