Docs PDFiumPas

ShowHint Propriété

Cette entrée API conserve identifiants, signatures, blocs de code et termes PDF dans leur forme d’origine.
Composant: TPdfView  ·  Unité: PDFium
Active ou désactive l’infobulle affichée lorsque la souris survole la visionneuse PDF

Syntaxe

property ShowHint: Boolean; // published, inherited from TControl

Description

ShowHint contrôle si l'infrastructure affiche l'info-bulle décrite par Hint lorsque la souris reste sur le visualiseur. Avec ParentShowHint (également publié), elle forme le pipeline d'info-bulle standard VCL/LCL : lorsque ParentShowHint vaut True, la valeur est héritée du formulaire ou du panneau parent ; lorsqu'elle vaut False, le ShowHint local l'emporte.

Dans un lecteur PDF, l'info-bulle sert le plus souvent à communiquer un état dynamique : afficher l'étiquette de page sous le curseur (calculée à partir de OnMouseMove + DeviceToPage), l'URL d'un lien Web sous le curseur ou les raccourcis clavier de la barre d'outils active. L'événement OnShowHint du formulaire hôte peut réécrire le texte de l'info-bulle juste avant l'affichage.

Désactiver les info-bulles est parfois utile quand le visualiseur est l'élément central d'une application de type kiosque où les fenêtres contextuelles distrairaient les utilisateurs. La propriété ne supprime que l'infobulle — la chaîne Hint reste accessible par code.

Remarques

Exemple

// Affiche l'étiquette de page sous le curseur sous forme d'info-bulle
procedure TForm1.FormCreate(Sender: TObject);
begin
  PdfView1.ShowHint := True;
  PdfView1.OnMouseMove := PdfView1MouseMove;
end;

procedure TForm1.PdfView1MouseMove(Sender: TObject;
  Shift: TShiftState; X, Y: Integer);
var PageNo: Integer;
begin
  if PdfView1.PointToPage(Point(X, Y), PageNo) then
    PdfView1.Hint := 'Page ' + IntToStr(PageNo) + ' / ' +
      IntToStr(PdfView1.Pdf.PageCount);
end;

Voir aussi

OnMouseMove, Visible, Enabled, DeviceToPage