PDFium Delphi Component Docs

ShowHint Eigenschaft

Komponente: TPdfView  ·  Unit: PDFium
Aktiviert oder deaktiviert die Hinweis-Sprechblase, die angezeigt wird, wenn die Maus über dem PDF-Viewer schwebt

Syntax

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

Description

ShowHint steuert, ob das Framework den Tooltip anzeigt, den Hint beschreibt, wenn die Maus über dem Viewer ruht. Zusammen mit ParentShowHint (ebenfalls published) bildet es die Standard-VCL/LCL-Hint-Pipeline: Ist ParentShowHint True, erbt der Wert von der Parent-Form/dem Parent-Panel; ist er False, gewinnt das lokale ShowHint

In einem PDF-Reader dient der Hint meist dazu, dynamischen Zustand zu kommunizieren: das Seitenlabel unter dem Cursor (berechnet aus OnMouseMove + DeviceToPage), die URL eines Web-Links unter dem Cursor oder die Tastenkürzel der aktiven Toolbar. Das OnShowHint-Ereignis der Host-Form kann den Hint-Text unmittelbar vor der Anzeige umschreiben

Hints abzuschalten ist gelegentlich nützlich, wenn der Viewer das Kernstück einer Kiosk-Anwendung ist, in der Pop-ups Nutzer ablenken würden. Die Eigenschaft unterdrückt nur den Ballon — der Hint-String bleibt per Code erreichbar

Remarks

Example

// Show the page label under the cursor as a tooltip
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;

See Also

OnMouseMove, Visible, Enabled, DeviceToPage