Kontrolki FlowDocument

Platforma WPF udostępnia trzy wyspecjalizowane kontrolki do wyświetlania FlowDocument zawartości, z których każda jest zoptymalizowana pod kątem różnych scenariuszy prezentacji. Te kontrolki umożliwiają wyświetlanie rozbudowanej, powtarzalnej zawartości w aplikacjach, oferując użytkownikom różne sposoby interakcji z tę zawartością.

Zrzut ekranu przedstawiający kontrolkę FlowDocumentReader z otwartym przykładowym dokumentem.

Trzy kontrolki FlowDocument to:

  • FlowDocumentScrollViewer: Wyświetla zawartość w widoku ciągłego przewijania, idealną do odczytywania długich dokumentów bez stronicowania.
  • FlowDocumentPageViewer: Prezentuje zawartość strona po stronie, podobnie jak układ książki lub magazynu.
  • FlowDocumentReader: zapewnia największą elastyczność, umożliwiając użytkownikom przełączanie się między różnymi trybami wyświetlania, w tym przewijanie, strony po stronie i widoki rozłożone na dwie strony.

Wszystkie trzy kontrolki mają wspólny cel wyświetlania FlowDocument zawartości, która automatycznie dostosowuje się do dostępnego obszaru wyświetlania. Wybierz kontrolkę, która najlepiej odpowiada potrzebom aplikacji: użyj FlowDocumentScrollViewer do prostych scenariuszy przewijania, FlowDocumentPageViewer do prezentacji na stałej stronie, lub FlowDocumentReader gdy chcesz dać użytkownikom kontrolę nad sposobem wyświetlania zawartości.

Aby uzyskać szczegółowe informacje na temat tworzenia dokumentów przepływu i pracy z nimi, zobacz Omówienie dokumentu przepływu.

FlowDocumentScrollViewer

Kontrolka FlowDocumentScrollViewer wyświetla zawartość FlowDocument w przewijanym kontenerze. Ta kontrolka jest idealna w przypadku środowisk ciągłego czytania, w których użytkownicy chcą przewijać zawartość, a nie nawigować między stronami. Kontrast z elementem FlowDocumentPageViewer, który wyświetla zawartość na poszczególnych stronach.

Właściwość zawartości

Właściwość content parametru FlowDocumentScrollViewer to Document, która określa FlowDocument, który ma zostać wyświetlony.

Części

W poniższej tabeli wymieniono nazwane części kontrolki FlowDocumentScrollViewer .

Nazwa części Typ części Description
PART_ContentHost ScrollViewer Host przewijania zawartości dokumentu dynamicznego.
PART_FindToolBarHost Decorator Host paska narzędzi wyszukiwania.
PART_ToolBarHost Decorator Host paska narzędzi.

Stany wizualne

W poniższej tabeli wymieniono stany wizualizacji dla kontrolki FlowDocumentScrollViewer .

Stan wizualny Nazwa grupy VisualStateGroup Description
Prawidłowe StanyWalidacji Kontrolka jest prawidłowa i nie ma błędów walidacji.
Nieprawidłowe skupienie StanyWalidacji Kontrolka ma błąd weryfikacji i ma fokus klawiatury.
NieprawidłoweNieaktywne StanyWalidacji Kontrolka ma błąd weryfikacji, ale nie ma fokusu klawiatury.

FlowDocumentPageViewer

Kontrolka FlowDocumentPageViewer wyświetla FlowDocument zawartość na poszczególnych stronach. Ta kontrolka zapewnia środowisko do czytania przypominające książkę z kontrolkami nawigacji stron. W przeciwieństwie do FlowDocumentScrollViewer, który przedstawia FlowDocument zawartość w elemencie przeglądającym z przewijaniem.

Właściwość zawartości

Właściwość Document jest właściwością zawartości kontrolki FlowDocumentPageViewer i zawiera dokument przepływu wyświetlany w przeglądarce.

Części

W poniższej tabeli wymieniono nazwane części kontrolki FlowDocumentPageViewer .

Nazwa części Typ części Description
PART_FindToolBarHost Decorator Dekorator hostujący pasek narzędzi znajdowania.

Stany wizualne

W poniższej tabeli wymieniono stany wizualizacji dla kontrolki FlowDocumentPageViewer .

Stan wizualny Grupa stanów wizualnych Description
Prawidłowe StanyWalidacji Kontrolka jest prawidłowa i nie ma błędów walidacji.
Nieprawidłowe skupienie StanyWalidacji Kontrolka ma błąd weryfikacji i ma fokus klawiatury.
NieprawidłoweNieaktywne StanyWalidacji Kontrolka ma błąd weryfikacji, ale nie ma fokusu klawiatury.

FlowDocumentReader

Kontrolka FlowDocumentReader wyświetla FlowDocument zawartość i obsługuje wiele trybów wyświetlania. Ta kontrolka zapewnia największą elastyczność, umożliwiając użytkownikom wybór preferowanego środowiska czytania, przełączanie się między przewijaniem, jednostronicowym i dwustronicowym widokiem rozłożonym.

Właściwość zawartości

Właściwość Document jest właściwością zawartości i definiuje zawartość wyświetlaną FlowDocument przez czytelnika.

Części

W poniższej tabeli wymieniono nazwane części kontrolki FlowDocumentReader .

Nazwa części Typ części Description
PART_ContentHost Decorator Dekorator hostujący przeglądarkę zawartości dla różnych trybów wyświetlania.
PART_FindToolBarHost Decorator Dekorator hostujący pasek narzędzi znajdowania po włączeniu funkcji znajdowania.

Stany wizualne

W poniższej tabeli wymieniono stany wizualizacji dla kontrolki FlowDocumentReader .

Nazwa stanu wizualizacji Nazwa grupy stanów wizualnych Description
Prawidłowe StanyWalidacji Kontrolka jest prawidłowa i nie ma błędów walidacji.
Nieprawidłowe skupienie StanyWalidacji Kontrolka ma błąd weryfikacji i ma fokus klawiatury.
NieprawidłoweNieaktywne StanyWalidacji Kontrolka ma błąd weryfikacji, ale nie ma fokusu klawiatury.

Style i szablony

Możesz zmodyfikować ustawienie domyślne ControlTemplate dla tych kontrolek, aby nadać im unikatowy wygląd. Aby uzyskać więcej informacji, zobacz Co to są style i szablony? i Jak utworzyć szablon dla kontrolki.

Zobacz także

  • Last updated on