Anzeigen von Kontexthilfe zu Bildschirmobjekten mit der Eigenschaft Hint

Aus RAD Studio
Wechseln zu: Navigation, Suche

Nach oben zu Aufrufen von HTML-Hilfe aus Anwendungen


VCL-GUI-Komponenten, wie Steuerelemente, unterstützen die Eigenschaft Hint, z. B. TApplication.Hint und TControl.Hint. Die Verwendung der Hint-Eigenschaften ist der empfohlene Weg, Kontexthilfe zu Formularen, Steuerelementen und anderen Bildschirmobjekten anzuzeigen. Diese Kontexthilfe für Bildschirmobjekte wird auch "Was ist das?"-Hilfe genannt.

Die VCL und die IDE unterstützen die Eigenschaft Hint.

Hinweis: VCL-Steuerelemente unterstützen dreiteilige Hinweis-Strings, die an getrennten Positionen angezeigt werden können. Siehe Vcl.Controls.TControl.Hint.

Festlegen von Hinweisen mit der VCL

Die VCL stellt die Eigenschaft Hint für viele GUI-Komponenten bereit. Die Eigenschaft Hint enthält den Text-String, der angezeigt werden kann, wenn der Benutzer den Mauszeiger auf ein Steuerelement setzt.

Zum Aktivieren des Hinweistextes setzen Sie im Code Ihres Formulars die Eigenschaft ShowHint (Controls.TControl.ShowHint) auf True, wie in dem folgenden Codefragment gezeigt. 

Button1.ShowHint := True;                       // show the control's Hint 
Button1.Hint := 'Hint text for the component';  // Hint text

In den Beispielen ShowHint (Delphi) und ShowHint (C++) wird demonstriert, wie Hinweise für Steuerelemente angezeigt werden. In den Beispielen OnHint (Delphi) und OnHint (C++) wird demonstriert, wie Hinweise in der Ereignisbehandlungsroutine des Ereignisses TApplication.OnHint angezeigt werden.

Festlegen von Hinweisen im Objektinspektor

Weil im Objektinspektor die Eigenschaften zur Verwaltung von Hinweisen (Hint, ShowHint und andere) von VCL-Komponenten angezeigt werden, können Sie die entsprechenden Werte direkt im Objektinspektor ohne manuelle Bearbeitung Ihres Programmcodes eingeben.

Die folgenden Schritte zeigen beispielsweise, wie Sie im Objektinspektor für verschiedene Steuerelemente auf einem Formular die Anzeige von Hinweisen und den Text für diese Hinweise festlegen.

  1. Wählen Sie im Formular-Designer das Formular aus, das Sie anpassen möchten.
  2. Öffnen Sie den Objektinspektor; der Objektinspektor zeigt die Eigenschaften Ihres Formulars an.
  3. Suchen Sie die Eigenschaft ShowHint des Formulars.
Tipp: Wenn die meisten Steuerelemente auf dem Formular Hinweise anzeigen sollen, setzen Sie für das Formular ShowHint auf True. Ansonsten setzen Sie ShowHint auf False.
  1. Wählen Sie im Formular-Designer eine Komponente aus, die einen Hinweis anzeigen soll. Die Eigenschaften dieser Komponente werden im Objektinspektor angezeigt.
  2. Suchen Sie die Eigenschaft ParentShowHint. Überprüfen Sie, ob ihr Wert True ist (das ist die Vorgabe).
    Wenn die Eigenschaft ParentShowHint True ist, übernimmt die Komponente die Eigenschaft ShowHint vom übergeordneten Objekt (d. h. vom Formular). Der Wert der Eigenschaft ShowHint in der Komponente wird ignoriert.
In diesem Beispiel ist die Eigenschaft ShowHint des übergeordneten Formulars True. Das bedeutet, dass die Komponente den Hinweis anzeigt.
Wenn die Eigenschaft ParentShowHint False ist (oder ShowHint des übergeordneten Formulars False ist), dann wird der Wert der Eigenschaft ShowHint in der Komponente verwendet. Wenn ShowHint True ist, dann zeigt die Komponente den Hinweis an.
  1. Suchen Sie die Eigenschaft Hint. Klicken Sie in die Wertezelle der Eigenschaft, und geben Sie den Hinweistext ein. Beachten Sie bei der Eingabe des Hinweistextes die Regeln von Vcl.Controls.TControl.Hint.
  2. Passen Sie mithilfe der Eigenschaften CustomHint (Vcl.Controls.TControl.CustomHint) und ParentCustomHint das Erscheinungsbild der Hinweise an.
  3. Wiederholen Sie die Schritte 4 bis 7 für alle Komponenten auf dem Formular, um die Komponenten festzulegen, die Hinweise anzeigen sollen, um die Hinweistexte zu definieren, und um anzugeben, wie die Hinweise angezeigt werden sollen.
  4. Erzeugen Sie das Projekt, und führen Sie es aus. Öffnen Sie das Formular. Die gewünschten Komponenten zeigen die angegebenen Hinweise an.

Siehe auch

Codebeispiele

Abgerufen von „https://docwiki.embarcadero.com/RADStudio/Athens/d/index.php?title=Anzeigen_von_Kontexthilfe_zu_Bildschirmobjekten_mit_der_Eigenschaft_Hint&oldid=179123“