Das KDevelop-Programmierhandbuch: Leitfaden zur C++-Anwendungsentwicklung für das K Desktop Environment (KDE) mit Hilfe der KDevelop-IDE in der Version 1.2 | ||
---|---|---|
Zurück | Kapitel 8. Hilfefunktionen | Vor |
"Quick-Help"- oder Schnellhilfe-Fenster sind ein weiteres Beispiel guter Hilfestellung. Der Benutzer drückt dazu den rechten Mausbutton und wählt "Schnellhilfe" im Kontextmenü. Es handelt sich bei dieser Art Hilfe also um ein Mittelding zwischen einem detaillierten Referenzhandbuch und den Kurztipps: Ersteres wäre zu ausschweifend, ein Tipp böte hingegen zu wenig Information. Um zu sehen, wie Quick-Help funktioniert, öffnen Sie einen beliebigen Dialog in KDevelop und drücken die rechte Maustaste über dem gewünschten Eintrag. Dann wählen Sie den Menüpunkt "Schnellhilfe", und schon erscheint eine hilfreiche Mitteilung. Diese kann mit verschiedenen Farben und Schriften aufgepeppt werden and darf sogar URLs enthalten, die auf eine bestimmte Webseite (oder genau so gut auf das beiliegende Online-Handbuch) verweisen.
Um Quick-Help einzusetzen, fügen Sie das Include-File kquickhelp.h in die passende Quelldatei ein. Da die KQuickHelp-Klasse Bestandteil der KDE-UI-Bibliothek ist, sollte sie ohne weiteres Zutun von Ihrer Anwendung benutzt werden können. Ist dem nicht so, setzen Sie das Linker-Flag Ihres Projekts so, dass kdeui eingebunden wird.
Das Beispiel
KQuickHelp::add( yourwidget, i18n("your Tip") ); |
erinnert stark an das, mit dem wir QToolTip vorgestellt haben. Wenn Sie mit dem KDevelop-Dialogeditor einen Dialog erstellen, tragen Sie Ihre Kurztipps und Schnellhilfen in die Implementierungsdatei ein, und NICHT ins Quelltextfile, da dieses vom Dialogeditor jedes Mal neu erstellt wird, wenn Sie etwas an Ihrem Widget ändern.
Doch zurück zu dem, was die KQuickHelp-Klasse bietet. Wie schon erwähnt, haben Sie die Möglichkeit, Text mit Hilfe von Tags zu formatieren. Sie können Hyperlinks eintragen, die von Internetprotokollen wie http Gebrauch machen, Farben, Schriftarten und -größen fest legen. Im KDE Library Reference Guide und der Klassendokumentation zu KQuickTip finden Sie nährere Informationen.