LoadingText 속성

LoadingText는 AsyncRendering이 True일 때 뷰어가 부분적으로 렌더링된 페이지 위에 겹쳐 표시하는 캡션입니다. 뷰어는 현재 상속된 글꼴로 문자열을 측정한 다음, 결과를 가운데 정렬된 사각형으로 확장하고, 그 안을 LoadingColor로 채운 뒤 텍스트를 위에 그립니다. 기본값 'Loading...'는 사용자에게 일시적인 상태로 인식되며, 페이지를 지나치게 가리지 않을 만큼만 넓습니다

이 오버레이는 별도의 표시 플래그가 아니라 텍스트를 기준으로 결정됩니다. 빈 문자열 ''을 지정하면 비동기 렌더링이 활성화된 상태에서도 오버레이가 표시되지 않습니다. 이는 호스트 애플리케이션이 자체 로딩 위젯(애니메이션 GIF, 모달 진행 대화상자, 별도 상태 표시줄 패널 등)을 표시하고 싶고, 내장 사각형이 시선을 빼앗지 않게 하려는 경우에 유용합니다

시작 시 번역된 리소스를 할당해 문자열을 지역화합니다. 이 속성은 호스트 애플리케이션이 만들어낼 수 있는 어떤 string이든 받으며, 중국어, 일본어, 아랍어 같은 다중 바이트 문자도 포함할 수 있습니다

• 사각형 크기는 렌더링된 텍스트에 맞춰집니다. 따라서 문자열이 길수록 더 넓은 배지가 생기므로, 간결한 표시기를 원한다면 짧게 유지합니다
• 오버레이는 페이지 비트맵 뒤에 그려지므로, 페이지가 아래에서 부분적으로만 그려졌더라도 항상 보입니다
• 비동기 렌더링을 끄지 않고 표시기만 숨기려면 LoadingText를 지우고, async rendering을 완전히 끄려면 AsyncRendering을 False로 설정합니다