PDFium Component Docs

LoadingText Właściwość

Component: TPdfView  ·  Unit: PDFium
Tekst pokazywany na środku strony, gdy asynchroniczne renderowanie nadal trwa

Syntax

property LoadingText: string; // default 'Loading...'

Description

LoadingText to napis, który przeglądarka nakłada na częściowo renderowaną stronę, gdy AsyncRendering ma wartość True. Przeglądarka mierzy ciąg bieżącym odziedziczonym fontem, rozszerza wynik do wyśrodkowanego prostokąta, wypełnia go kolorem LoadingColor, a następnie rysuje tekst na wierzchu. Domyślny 'Loading...' jest dla użytkowników rozpoznawalny jako stan przejściowy i wystarczająco szeroki, by być widocznym bez dominowania nad stroną

Nakładka jest uzależniona od tekstu, a nie od osobnej flagi widoczności. Przypisanie pustego ciągu ('') tłumi nakładkę nawet podczas aktywnego renderowania asynchronicznego — przydatne, gdy aplikacja hosta chce pokazać własny element ładowania (animowany GIF, modalne okno postępu, osobny panel paska stanu) i woli, żeby wbudowany prostokąt nie konkuruował o uwagę

Zlokalizuj ciąg, przypisując przetłumaczony zasób przy starcie; właściwość przyjmuje dowolny string, jaki potrafi wygenerować aplikacja hosta, w tym znaki wielobajtowe, takie jak chińskie, japońskie czy arabskie

Remarks

Example

// Localized loading caption.
PdfView1.AsyncRendering := True;
PdfView1.LoadingText := SLoadingPdf; // resourcestring lookup

// Suppress the built-in indicator; use a TActivityIndicator instead.
PdfView1.LoadingText := '';
ActivityIndicator1.Animate := True;

// Stage-specific message for slow first paint.
PdfView1.LoadingText := 'Decoding first page...';
PdfView1.Active := True;

See Also

LoadingColor, AsyncRendering, Font, Active