PDFium Component Docs

ShowHint Właściwość

Component: TPdfView  ·  Unit: PDFium
Włącza lub wyłącza dymek podpowiedzi wyświetlany, gdy wskaźnik myszy znajduje się nad podglądem PDF

Syntax

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

Description

ShowHint steruje tym, czy środowisko wyświetla etykietkę narzędziową opisaną przez Hint, gdy mysz spoczywa nad przeglądarką. Wraz z ParentShowHint (również publikowaną) tworzy standardowy potok podpowiedzi VCL/LCL: gdy ParentShowHint ma wartość True, wartość jest dziedziczona z nadrzędnego formularza lub panelu; gdy ma wartość False, wygrywa lokalne ShowHint.

W czytniku PDF podpowiedź najczęściej służy do komunikowania stanu dynamicznego: wyświetlania etykiety strony pod kursorem (obliczanej z OnMouseMove + DeviceToPage), adresu URL łącza internetowego pod kursorem albo skrótów klawiszowych aktywnego paska narzędzi. Zdarzenie OnShowHint formularza hosta może przepisać tekst podpowiedzi tuż przed wyświetleniem.

Wyłączanie podpowiedzi bywa przydatne, gdy przeglądarka jest centralnym elementem aplikacji w stylu kiosku, w której wyskakujące dymki rozpraszałyby użytkowników. Właściwość tłumi wyłącznie dymek — łańcuch Hint pozostaje dostępny z kodu.

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