Docs de PDFiumPas

ShowHint Propiedad

Esta entrada API conserva identificadores, firmas, bloques de código y términos PDF en su forma original.
Componente: TPdfView  ·  Unidad: PDFium
Activa o desactiva el globo de ayuda que se muestra cuando el ratón pasa sobre el visor de PDF

Sintaxis

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

Descripción

ShowHint controla si el framework muestra la información sobre herramientas descrita por Hint cuando el ratón se detiene sobre el visor. Junto con ParentShowHint (también publicada) forma la canalización estándar de sugerencias de VCL/LCL: cuando ParentShowHint es True, el valor se hereda del formulario o panel padre; cuando es False, prevalece el ShowHint local

En un lector de PDF, la sugerencia se usa sobre todo para comunicar estado dinámico: mostrar la etiqueta de página bajo el cursor (calculada a partir de 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 de la sugerencia justo antes de mostrarse

Desactivar las sugerencias resulta útil a veces cuando el visor es el elemento central de una aplicación de tipo quiosco en la que los mensajes emergentes distraerían al usuario. La propiedad solo suprime el globo — la cadena Hint sigue accesible mediante código

Notas

Ejemplo

// Mostrar la etiqueta de página bajo el cursor como sugerencia
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;

Véase también

OnMouseMove, Visible, Enabled, DeviceToPage