LoadingText Eigenschaft

LoadingText ist die Beschriftung, die der Viewer über einer teilweise gerenderten Seite anzeigt, wenn AsyncRendering True ist. Der Viewer misst die Zeichenkette mit der aktuell geerbten Schrift, erweitert das Ergebnis zu einem zentrierten Rechteck, füllt es mit LoadingColor und zeichnet dann den Text darüber. Der Standard 'Loading...' ist für Anwender als vorübergehender Zustand erkennbar und breit genug, um sichtbar zu sein, ohne die Seite zu dominieren

Das Overlay hängt am Text und nicht an einem separaten Sichtbarkeitsflag. Das Zuweisen einer leeren Zeichenkette ('') unterdrückt das Overlay auch dann, wenn asynchrones Rendering aktiv ist — nützlich, wenn die Hostanwendung ihr eigenes Lade-Widget anzeigen möchte (ein animiertes GIF, ein modaler Fortschrittsdialog, ein separates Statusleisten-Panel) und das eingebaute Rechteck nicht um Aufmerksamkeit konkurrieren soll

Lokalisieren Sie die Zeichenkette, indem Sie beim Start eine übersetzte Ressource zuweisen; die Eigenschaft akzeptiert jede string, die die Hostanwendung erzeugen kann, einschließlich mehrbyteiger Zeichen wie Chinesisch, Japanisch oder Arabisch

• Das Rechteck wird an den gerenderten Text angepasst. Eine lange Zeichenkette erzeugt daher ein breiteres Badge; halten Sie sie kurz, wenn der Hinweis kompakt bleiben soll
• Das Overlay wird nach dem Seiten-Bitmap gezeichnet, also ist es immer sichtbar, selbst wenn die Seite darunter bereits teilweise gerendert wurde
• Um den Hinweis auszublenden, ohne asynchrones Rendering zu deaktivieren, löschen Sie LoadingText; um asynchrones Rendering komplett zu deaktivieren, setzen Sie AsyncRendering auf False