GetSelectedFormText 메서드

GetSelectedFormText는 PDFium의 FORM_GetSelectedText 바인딩 위에 얹힌 고수준 진입점입니다. 이 PDFium API는 유닛 수준에서 이미 바인딩되어 있었지만 v1.23.0까지 Pascal에 맞는 접근자가 없었고, 이 메서드가 깔끔하게 감싸 줍니다

이 메서드는 뷰의 활성 페이지에서 현재 포커스를 쥔 AcroForm 위젯(키보드 입력에 반응하는 바로 그 위젯)을 대상으로 합니다. 사용자가 그 위젯 안에서 문자 범위를 선택했다면 — 예컨대 Shift+화살표나 클릭 후 드래그로 — GetSelectedFormText는 선택 텍스트를 WString으로 반환합니다. 선택된 텍스트가 없으면(캐럿 위치만 있는 경우) GetSelectedFormText는 빈 문자열을 반환합니다

다음 경우에는 이 메서드가 no-op입니다

• 뷰가 비활성 상태일 때(Active = False)
• 문서에 AcroForm이 없을 때(FormType = ftNone)
• 현재 페이지에 포커스된 위젯이 없을 때

세 경우 모두 반환값은 빈 문자열이며 — 이 메서드는 절대 예외를 일으키지 않습니다

• 전체 위젯 값을 선택하려면 SelectAllFormText와 함께 사용하고, 방어적인 Unicode 클립보드 처리를 위해 CopySelectedFormTextToClipboard를 호출하세요
• 선택은 위젯 로컬입니다 — 위젯 밖의 페이지 텍스트를 선택해도 GetSelectedFormText로는 반환되지 않습니다. 그런 용도에는 문자 수준 텍스트 추출 API를 사용하세요
• 선택 상태는 PDFium의 폼필 모듈이 관리합니다. FormField[i] := ...로 새 값을 대입하면 선택이 캐럿으로 무너질 수 있습니다