AllowUserTextSelection - TPdfView

Dieser API-Eintrag behält Bezeichner, Signaturen, Codeblöcke und PDF-Begriffe in ihrer Originalform.

Komponente: TPdfView · Unit: PDFium

Steuert die durch Benutzereingaben ausgelöste Textauswahl im Viewer

Syntax

property AllowUserTextSelection: Boolean;

Beschreibung

Wenn True (der Standardwert), reagiert der Viewer auf auswahlbezogene Benutzereingaben

Ein Linksklick auf ein Textzeichen startet eine Zieh-Auswahl; ein Klick auf Leerraum fällt auf den bestehenden Verschiebeweg zurück
Ein Doppelklick wählt das Wort unter dem Cursor aus; ein Dreifachklick wählt die Zeile aus
Beim Überfahren eines Zeichens mit der Maus wechselt Cursor zu crIBeam
Ctrl+A wählt die aktuelle Seite aus (beide Seiten in Spreadsichtmodi)
Ctrl+C kopiert die Auswahl als CF_UNICODETEXT in die Windows-Zwischenablage
Shift+Left / Right erweitert die Auswahl um ein Zeichen; Shift+Home / End erweitert sie bis zum sichtbaren Zeilenrand
Wenn Sie den Zeiger in eine 20-Pixel-Randzone des Viewers ziehen, wird die Seite während der aktiven Ziehbewegung automatisch weitergescrollt

Wenn False, wird alles oben Genannte stillschweigend deaktiviert und der Viewer verhält sich wie v1.16.x — nur verschieben, nur Link-Klick, nur Formularausfüllung. Kiosk-Hosts, Vorschaubereiche und schreibgeschützte Kontexte können dieses Flag zur Designzeit auf False festlegen

Dieses Flag steuert nur Benutzereingaben. Die öffentliche API auf Code-Ebene (SelectAll, ClearSelection, CopySelectionToClipboard) funktioniert unabhängig vom Flag-Wert weiter, sodass eine Host-Anwendung die benutzergetriebene Auswahl deaktivieren und dennoch Toolbar-Schaltflächen für "Alles auswählen / Kopieren" bauen kann, die dieselbe API verwenden

Hinweise

In v1.17.0 reserviert (Eigenschaft veröffentlicht, kein Verhalten verdrahtet). Seit v1.36.0 aktiv — bestehende Anwendungen aktualisieren sich ohne Verhaltensänderung, weil der Standard weiterhin True ist und das Formularfüll-Subsystem Vorrang behält
Während ein Formularfeld bearbeitet wird, werden alle Tastenkürzel für die Auswahl zurückgestellt, damit das Feld Ctrl+C / Ctrl+A / Shift+arrows für seine eigene Auswahl erhält
Legen Sie Standardwerte zur Entwurfszeit im Objektinspektor fest oder weisen Sie sie zur Laufzeit zu, bevor Active := True; die Auswahl wird bei Änderungen von SetPdf, SetPageNumber, SetActive(False) und DisplayMode gelöscht

Beispiel

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

Siehe auch

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