AllowUserTextSelection - TPdfView

Deze API-entry behoudt identifiers, signatures, codeblokken en PDF-termen in hun oorspronkelijke vorm.

Component: TPdfView · Unit: PDFium

Gates user-input-driven text selection in the viewer.

Syntaxis

property AllowUserTextSelection: Boolean;

Beschrijving

When True (the default), the viewer reacts to selection-related user input:

Linksklikken op een tekenteken start een sleepselectie; klikken op witruimte valt terug op het bestaande pan-pad
Dubbelklikken selecteert het woord onder de cursor; driedubbelklikken selecteert de regel
Hoveren over een teken zet Cursor op crIBeam
Ctrl+A selecteert de huidige pagina (beide pagina's in spread-displaymodi)
Ctrl+C kopieert de selectie naar het Windows-klembord als CF_UNICODETEXT
Shift+Left / Right breidt de selectie één teken uit; Shift+Home / End breidt uit tot de rand van de visuele regel
Wanneer je de aanwijzer naar een 20-pixel dode zone aan de rand van de viewer sleept, scrolt de pagina automatisch zolang de sleep actief is

Wanneer False is ingesteld, wordt al het bovenstaande stilzwijgend uitgeschakeld en gedraagt de viewer zich als v1.16.x — alleen pannen, alleen linkklikken, alleen formuliervulling. Kiosk-hosts, voorvertoningspanelen en alleen-lezen contexten kunnen deze vlag op design-time op False vastzetten

Deze vlag beperkt alleen gebruikersinvoer. De openbare API op codeniveau (SelectAll, ClearSelection, CopySelectionToClipboard) blijft werken ongeacht de vlagwaarde, zodat een hosttoepassing selectie door gebruikers kan uitschakelen en toch werkbalkknoppen "Alles selecteren / Kopiëren" kan bouwen die dezelfde API gebruiken

Opmerkingen

Gereserveerd in v1.17.0 (eigenschap gepubliceerd, geen gedrag gekoppeld). Actief sinds v1.36.0 — bestaande toepassingen upgraden zonder gedragswijziging omdat de standaard nog steeds True is en het formuliervulsysteem voorrang houdt
Terwijl een formulierveld wordt bewerkt, worden alle toetsenbordsnelkoppelingen voor selectie uitgesteld zodat het veld zijn eigen selectie met Ctrl+C / Ctrl+A / Shift+arrows ontvangt
Stel ontwerp-tijdbaselines in de Object Inspector in of wijs ze tijdens runtime toe vóór Active := True; selectie wordt gewist bij SetPdf, SetPageNumber, SetActive(False) en DisplayMode-wijzigingen

Voorbeeld

begin
  PdfView1.AllowUserTextSelection := True;
  PdfView1.SelectionColor := clHighlight;
  PdfView1.OnSelectionChange := DoSelectionChange;
  PdfView1.Active := True;
end;

Zie ook

SelectionColor, OnSelectionChange, HasSelection, SelectAll, ClearSelection, SelectedText, CopySelectionToClipboard