THPDFViewer Highlights and Marquee Selection

Marque des régions de page sans modifier le PDF et convertit les sélections interactives en coordonnées de page PDF

Déclaration

function THPDFViewerModel.AddHighlightRegion(PageIndex: Integer;
  const PageRect: THPDFRectangle; Color: TColor= clYellow): Integer;
function THPDFViewerModel.RemoveHighlightRegion(Index: Integer): boolean;
procedure THPDFViewerModel.ClearHighlightRegions;
function THPDFViewerModel.TryGetHighlightRegion(Index: Integer;
  out Highlight: THPDFViewerHighlight): boolean;

property THPDFViewer.InteractionMode: THPDFViewerInteractionMode;
property THPDFViewer.HighlightColor: TColor;
property THPDFViewer.OnMarqueeSelect: THPDFViewerMarqueeSelectEvent;

Programmatic highlights

Region.Left:= 72;
Region.Bottom:= 540;
Region.Right:= 240;
Region.Top:= 600;
HighlightIndex:= Viewer.HighlightRegion(0, Region, clLime);

Interactive selection

Viewer.InteractionMode:= vimHighlight;
Viewer.HighlightColor:= clYellow;
Viewer.OnMarqueeSelect:= ViewerMarqueeSelect;

Comportement

• Les index de pages sont en base zéro et les rectangles utilisent les coordonnées de page PDF
• Les rectangles d’entrée sont normalisés et découpés au MediaBox de la page
• Les surlignages ne sont qu’un état du Viewer et ne modifient ni n’enregistrent rien dans le PDF
• Chaque ajout réussi renvoie son index courant dans la liste ; les régions invalides ou vides renvoient -1
• vimHighlight capture un glissement du bouton gauche, dessine un contour temporaire, stocke la région achevée et déclenche OnMarqueeSelect
• Les coordonnées du lasso tiennent compte de la rotation de page, de la rotation du Viewer, du zoom et des modes d’ajustement
• L’affectation d’un autre document efface tous les surlignages existants