QWhatsThis Class

Ausführliche Beschreibung

Die „Was ist das?“-Hilfe ist Teil des Online-Hilfesystems einer Anwendung und bietet Benutzern Informationen über die Funktionalität und Verwendung eines bestimmten Widgets. „Was ist das?“-Hilfetexte sind in der Regel länger und ausführlicher als die „ tooltips “-Texte, enthalten jedoch im Allgemeinen weniger Informationen als separate Hilfefenster.

QWhatsThis stellt ein einzelnes Fenster mit einem erklärenden Text bereit, das erscheint, wenn der Benutzer „Was ist das?“ fragt. Standardmäßig stellen Benutzer die Frage, indem sie den Fokus auf das entsprechende Widget setzen und die Tastenkombination Umschalt+F1 drücken. Der Hilfetext erscheint sofort; er verschwindet, sobald der Benutzer eine andere Aktion ausführt. (Beachten Sie, dass dieser Mechanismus nicht funktioniert, wenn es bereits eine Tastenkombination für Umschalt+F1 gibt.) Einige Dialoge verfügen über eine „?“-Schaltfläche, auf die Benutzer klicken können, um in den „Was ist das?“-Modus zu wechseln; anschließend klicken sie auf das entsprechende Widget, um das „Was ist das?“-Fenster einzublenden. Es ist auch möglich, eine Menüoption oder eine Symbolleisten-Schaltfläche bereitzustellen, um in den „Was ist das?“-Modus zu wechseln.

Um einem Widget oder einer Aktion einen „Was ist das?“-Text hinzuzufügen, rufen Sie einfach ` QWidget::setWhatsThis()` oder ` QAction::setWhatsThis()` auf.

Der Text kann entweder Rich-Text oder Nur-Text sein. Wenn Sie eine als Rich-Text formatierte Zeichenkette angeben, wird diese unter Verwendung des Standard-Stylesheets gerendert, wodurch es möglich ist, Bilder in den angezeigten Text einzubetten. Um so schnell wie möglich zu sein, verwendet das Standard-Stylesheet eine einfache Methode, um festzustellen, ob der Text als Nur-Text gerendert werden kann. Weitere Details finden Sie unter Qt::mightBeRichText().

newAct = new QAction(tr("&New"), this);
newAct->setShortcut(tr("Ctrl+N"));
newAct->setStatusTip(tr("Create a new file"));
newAct->setWhatsThis(tr("Click this option to create a new file."));

Eine alternative Möglichkeit, den „Was ist das?“-Modus aufzurufen, besteht darin, createAction() aufzurufen und die zurückgegebene QAction entweder einem Menü oder einer Symbolleiste hinzuzufügen. Durch Aufrufen dieser Kontext-Hilfe-Aktion (in der Abbildung unten die Schaltfläche mit dem Pfeil- und Fragezeichen-Symbol) wechselt der Benutzer in den „Was ist das?“-Modus. Klickt er nun auf ein Widget, wird der entsprechende Hilfetext angezeigt. Der Modus wird verlassen, sobald die Hilfe angezeigt wurde oder der Benutzer die Esc-Taste drückt.

Sie können den „Was ist das?“-Modus programmgesteuert mit ` enterWhatsThisMode()` aufrufen, den Modus mit ` inWhatsThisMode()` überprüfen und mit ` leaveWhatsThisMode()` in den Normalmodus zurückkehren.

Wenn Sie das Verhalten von „Was ist das?“ eines Widgets manuell steuern möchten, siehe Qt::WA_CustomWhatsThis.

Es ist außerdem möglich, für verschiedene Bereiche eines Widgets unterschiedliche Hilfstexte anzuzeigen, indem Sie ein ` QHelpEvent ` vom Typ ` QEvent::WhatsThis` verwenden. Fangen Sie das Hilfe-Ereignis in der Funktion ` QWidget::event()` Ihres Widgets ab und rufen Sie ` QWhatsThis::showText()` mit dem Text auf, den Sie für die in ` QHelpEvent::pos()` angegebene Position anzeigen möchten. Wenn es sich bei dem Text um Rich-Text handelt und der Benutzer auf einen Link klickt, erhält das Widget außerdem ein ` QWhatsThisClickedEvent ` mit der Referenz des Links als ` QWhatsThisClickedEvent::href()`. Wenn ein ` QWhatsThisClickedEvent ` verarbeitet wird (d. h. ` QWidget::event()` gibt `true` zurück), bleibt das Hilfefenster sichtbar. Rufen Sie ` QWhatsThis::hideText()` auf, um es explizit auszublenden.