PDFium Delphi Component Docs

ShowHint Proprietà

Componente: TPdfView  ·  Unità: PDFium
Abilita o disabilita il fumetto di suggerimento mostrato quando il mouse passa sopra il visualizzatore PDF

Syntax

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

Description

ShowHint controlla se il framework mostra il tooltip descritto da Hint quando il mouse si ferma sopra il viewer. Insieme a ParentShowHint (anch'essa published) compone la pipeline di hint standard VCL/LCL: quando ParentShowHint è True il valore si eredita dalla form/pannello padre; quando è False vince il valore locale di ShowHint

In un lettore PDF l'hint serve soprattutto per comunicare stato dinamico: l'etichetta di pagina sotto il cursore (calcolata da OnMouseMove + DeviceToPage), l'URL di un link web sotto il cursore, o le scorciatoie da tastiera della toolbar attiva. L'evento OnShowHint della form host può riscrivere il testo dell'hint poco prima che venga mostrato

Disabilitare gli hint serve ogni tanto quando il viewer è l'elemento focale di un'applicazione kiosk in cui i popup distrarrebbero l'utente. La proprietà sopprime solo il balloon — la stringa Hint resta accessibile da codice

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