THPDFHeadlessDocument.SetTextFieldValueWithAppearance

procedure SetTextFieldValueWithAppearance(FieldIndex: Integer;
  const Text: UnicodeString; const TrueTypeFont: SysUtils.TBytes;
  const Options: THPDFHeadlessTextAppearanceOptions);

쓰기 가능한 터미널 AcroForm 텍스트 필드를 갱신하고 기존 각 위젯에 명시적인 normal appearance를 만듭니다. 네이티브 Linux와 Windows에서 같은 문서 객체 그래프를 씁니다

위젯 사각형이 appearance 치수를 공급합니다. 상속된 필드 Q가 있으면 왼쪽·가운데·오른쪽 정렬을 공급하고, 없으면 옵션 정렬이 적용됩니다

이 프로필은 한 줄·여러 줄 평문 텍스트, 문자 폴백이 있는 측정 기반 워드 래핑, CR/LF 행나눔, 고정 크기 또는 자동 맞춤, 양의 상속 MaxLen을 가진 comb 셀, 90도 배수 위젯 회전을 지원합니다

복합 스크립트, bidi run, 리가처, 조합 시퀀스는 ShapeComplexText가 켜져 있을 때 HarfBuzz와 FriBidi를 씁니다. 직접 Unicode 텍스트는 이 런타임과 무관하며, 없는 글리프나 잘못된 서러게이트 쌍은 appearance 진단을 냅니다

복합 multiline 래핑은 bidi 재정렬과 리쉐이핑 전에 논리 Unicode 클러스터로 동작합니다. comb 셀은 scalar당 글리프 하나인 직접 프로필을 유지합니다

기존 리치 텍스트 필드에 대해 이 메서드는 내용을 한 평문 스타일로 교체하고 V, RV, 모든 위젯 appearance를 동기화합니다. 혼합 스타일은 SetRichTextFieldValueWithAppearance로 공급하세요

암호 필드는 Unicode scalar당 글머리 기호 하나를 만들고 실제 Unicode 필드 값을 V에 유지합니다. appearance 글리프 매핑과 접근성 텍스트는 마스크를 담고, 값은 문서 암호화 정책을 따릅니다

암호 필드는 multiline이나 comb 필드일 수 없습니다. 잘못된 Unicode, 제어 문자, 없는 마스크 글리프, 취소, 리소스 소진은 원본 필드를 유지합니다

파일 선택 필드는 literal Unicode 경로를 일반 필드 텍스트로 표시합니다. 이 연산은 선택한 파일을 열거나 실행하거나 첨부하지 않습니다

폰트는 유효한 이름 있는 TrueType 아웃라인과 실제 메트릭, installable 또는 editable 임베딩 플래그가 필요합니다. 전체 폰트 임베딩은 no-subsetting 권한을 존중하고 restricted, preview-and-print, bitmap-only, 없는, 모르는 권한을 거절합니다

메서드는 필드를 바꾸기 전에 모든 필드 교체, appearance 사전, 새 폰트·Form 객체, 직렬화 예산을 준비합니다. 프리플라이트 실패는 이전 값과 appearance 링크를 유지합니다

새 객체는 문서가 소유하고 원본 bounded 증분 라이터로 저장됩니다. 원본 AES-256 R5 또는 R6 정책 아래에서 새 문자열·스트림 암호화도 포함입니다

명시적인 appearance가 바뀐 필드를 덮으면 NeedAppearances가 지워집니다. 다른 값 전용 편집이나 원본 미해결 appearance 요구가 남아 있으면 예외입니다

원본 플래그가 true이면 다른 비서명 필드는 appearance 요구가 충족될 때까지 보수적으로 true를 유지합니다. 해당 필드들은 별도 choice·버튼 메서드로 재생성하세요

읽기 전용, MaxLen, 기존 서명, certification 권한, AES 폼 채우기 권한, 소스 보호, 취소, 원자적 출력 정책은 그대로 적용됩니다

문서와 appearance 옵션이 둘 다 취소 토큰을 지정하면 같은 토큰이어야 합니다

bounded 폰트·레이아웃 계약은 THPDFHeadlessTextAppearanceOptions와 HPDFBuildHeadlessTextAppearance를 참고하세요