PDFium Delphi Component Docs

ShowHint Propiedad

Componente: TPdfView  ·  Unidad: PDFium
Activa o desactiva el globo de ayuda que se muestra cuando el ratón pasa sobre el visor de PDF

Syntax

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

Description

ShowHint controla si el framework muestra el tooltip descrito por Hint cuando el ratón se posa sobre el visor. Junto con ParentShowHint (también published) forma el pipeline de hints estándar de VCL/LCL: cuando ParentShowHint es True, el valor se hereda del formulario/panel padre; cuando es False, manda el ShowHint local

En un lector PDF el hint se usa sobre todo para comunicar estado dinámico: mostrar la etiqueta de página bajo el cursor (calculada desde OnMouseMove + DeviceToPage), la URL de un enlace web bajo el cursor o los atajos de teclado de la barra de herramientas activa. El evento OnShowHint del formulario anfitrión puede reescribir el texto del hint justo antes de mostrarlo

Deshabilitar los hints resulta útil de vez en cuando cuando el visor es el elemento focal de una aplicación tipo kiosk donde los popups distraerían al usuario. La propiedad solo suprime el globo — la cadena Hint sigue siendo accesible por código

Remarks

Example

// Mostrar la etiqueta de página bajo el cursor como información sobre herramientas
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