AllowUserTextSelection - TPdfView

Ten wpis API zachowuje identyfikatory, sygnatury, bloki kodu i terminy PDF w oryginalnej postaci.

Komponent: TPdfView · Moduł: PDFium

Steruje zaznaczaniem tekstu w widoku wywoływanym przez dane wejściowe użytkownika

Składnia

property AllowUserTextSelection: Boolean;

Opis

Gdy ma wartość True (domyślną), widok reaguje na dane wejściowe użytkownika związane z zaznaczaniem:

Lewy klik na znaku tekstu rozpoczyna zaznaczanie przez przeciąganie; kliknięcie w biały znak przechodzi do istniejącej ścieżki przesuwania
Dwuklik zaznacza słowo pod kursorem; potrójny klik zaznacza wiersz
Najazd na znak zmienia Cursor na crIBeam
Ctrl+A zaznacza bieżącą stronę (obie strony w trybach podwójnego widoku)
Ctrl+C kopiuje zaznaczenie do schowka Windows jako CF_UNICODETEXT
Shift+Left / Right rozszerza zaznaczenie o jeden znak; Shift+Home / End rozszerza je do krawędzi widocznego wiersza
Przeciągnięcie wskaźnika do 20-pikselowej strefy martwej przy krawędzi widoku automatycznie przewija stronę, gdy przeciąganie jest aktywne

Gdy ma wartość False, wszystko powyższe jest cicho wyłączone, a widok zachowuje się jak v1.16.x — tylko przesuwanie, tylko kliknięcie łącza, tylko wypełnianie formularza. Hosty kioskowe, panele podglądu i konteksty tylko do odczytu mogą przypiąć tę flagę do False już na etapie projektowania

Ta flaga blokuje wyłącznie dane wejściowe użytkownika. Publiczne API na poziomie kodu (SelectAll, ClearSelection, CopySelectionToClipboard) nadal działa niezależnie od wartości flagi, więc aplikacja hosta może wyłączyć zaznaczanie sterowane przez użytkownika, a jednocześnie budować przyciski paska narzędzi "Select All / Copy" korzystające z tego samego API

Uwagi

Zarezerwowane w v1.17.0 (właściwość opublikowana, bez podpiętego zachowania). Aktywne od v1.36.0 — istniejące aplikacje aktualizują się bez zmiany zachowania, ponieważ domyślna wartość nadal wynosi True, a podsystem wypełniania formularzy zachowuje priorytet
Podczas edycji pola formularza wszystkie skróty klawiaturowe związane z zaznaczaniem są odkładane, aby pole samo otrzymywało Ctrl+C / Ctrl+A / Shift+strzałki do własnego zaznaczenia
Ustaw domyślne wartości projektowe w Object Inspector albo przypisz je w czasie wykonywania przed Active := True; zaznaczenie jest czyszczone przy zmianach SetPdf, SetPageNumber, SetActive(False) i DisplayMode

Przykład

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

Zobacz też

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