(Created page with "Para itens de menu, use") |
(Created page with "''Autor inicial:'' [mailto:bernd@kdevelop.org Bernd Gehrmann]") |
||
(2 intermediate revisions by the same user not shown) | |||
Line 36: | Line 36: | ||
action->setWhatsThis(i18n("Deletes the marked file")) | action->setWhatsThis(i18n("Deletes the marked file")) | ||
</syntaxhighlight> | </syntaxhighlight> | ||
− | + | A invocação do khelpcenter está contida na classe [http://api.kde.org/4.x-api/kdelibs-apidocs/kdecore/html/classKToolInvocation.html KToolInvocation]. A fim de mostrar o manual de seu aplicativo, use o método estático: | |
− | [http://api.kde.org/4.x-api/kdelibs-apidocs/kdecore/html/classKToolInvocation.html KToolInvocation] | + | |
− | + | ||
<syntaxhighlight lang="cpp"> | <syntaxhighlight lang="cpp"> | ||
KToolInvocation::invokeHelp() | KToolInvocation::invokeHelp() | ||
</syntaxhighlight> | </syntaxhighlight> | ||
− | + | Isso mostra a primeira página com a tabela de conteúdos. Quando você deseja exibir somente uma certa do manual, você pode fornecer um argumento adicional para invokeHelp() determinando a âncora para qual o navegador vai. | |
− | + | ||
− | + | ||
− | + | ||
− | '' | + | ''Autor inicial:'' [mailto:bernd@kdevelop.org Bernd Gehrmann] |
[[Category:KDE4]] | [[Category:KDE4]] | ||
[[Category:Architecture]] | [[Category:Architecture]] |
Arquitetura do KDE - Fornecendo ajuda online
Tornar um programa fácil e intuitivo de usar envolve uma grande variedade de facilidades que são geralmente chamadas de ajuda online. Ajuda online tem vários objetivos parcialmente conflitantes: de um lado, ela deveria dar aos usuários as respostas à pergunta: "Como posso fazer uma determinada tarefa?", por outro lado, deveria ajudar o usuário a explorar o aplicativo e encontrar recursos que ele ainda não conhece. É importante reconhecer que isso só pode ser alcançado através da oferta de vários níveis de ajuda:
Do ponto de vista do programador, o Qt fornece uma API para ajuda online fácil para usar. Para atribuir uma dica para widget, simplesmente use o seu método setToolTip().
widget->setToolTip(i18n("This widget does something."))
Se as barras de menu e de ferramentas são criadas usando o action pattern, a string usada como tooltip é derivada do primeiro argumento do construtor do KAction:
action = new KAction(i18n("&Delete"), "editdelete",
SHIFT+Key_Delete, actionCollection(), "del")
Aqui é também possível atribuir um texto que é mostrado na barra de status quando o respectivo item de menu é realçado:
action->setStatusText(i18n("Deletes the marked file"))
A API para a ajuda "O que é isso?' é muito similar. Em diálogos, use o seguinte código:
widget->setWhatsThis(i18n("<qt>This demonstrates <b>Qt</b>'s"
" rich text engine.<ul>"
"<li>Foo</li>"
"<li>Bar</li>"
"</ul></qt>"))
Para itens de menu, use
action->setWhatsThis(i18n("Deletes the marked file"))
A invocação do khelpcenter está contida na classe KToolInvocation. A fim de mostrar o manual de seu aplicativo, use o método estático:
KToolInvocation::invokeHelp()
Isso mostra a primeira página com a tabela de conteúdos. Quando você deseja exibir somente uma certa do manual, você pode fornecer um argumento adicional para invokeHelp() determinando a âncora para qual o navegador vai.
Autor inicial: Bernd Gehrmann