FlowDocument-Steuerelemente

WPF bietet drei spezielle Steuerelemente zum Anzeigen FlowDocument von Inhalten, die jeweils für unterschiedliche Präsentationsszenarien optimiert sind. Mit diesen Steuerelementen können Sie umfangreiche, dynamisch anpassbare Inhalte in Ihren Anwendungen anzeigen und bieten Benutzern verschiedene Möglichkeiten für die Interaktion mit diesen Inhalten.

Screenshot des FlowDocumentReader-Steuerelements mit geöffnetem Beispieldokument.

Die drei FlowDocument-Steuerelemente sind:

  • FlowDocumentScrollViewer: Zeigt Inhalte in einer fortlaufenden Bildlaufansicht an, ideal zum Lesen langer Dokumente ohne Paginierung.
  • FlowDocumentPageViewer: Stellt eine Inhaltsseite nach Seite dar, ähnlich wie ein Buch- oder Magazinlayout.
  • FlowDocumentReader: Bietet die größte Flexibilität, indem Benutzer zwischen verschiedenen Anzeigemodi wechseln können, einschließlich Bildlauf, Seiten-nach-Seite und Zwei-Seiten-Ansichtsansichten.

Alle drei Steuerelemente teilen den gemeinsamen Zweck der Darstellung von FlowDocument Inhalten, die sich automatisch an den verfügbaren Anzeigebereich anpassen. Wählen Sie das Steuerelement aus, das den Anforderungen Ihrer Anwendung am besten entspricht: Verwenden Sie FlowDocumentScrollViewer für einfache Bildlaufszenarien, FlowDocumentPageViewer für feste Seitenpräsentationen oder FlowDocumentReader, wenn Sie Benutzern die Kontrolle darüber geben möchten, wie sie den Inhalt anzeigen.

Ausführliche Informationen zum Erstellen und Arbeiten mit Flussdokumenten finden Sie unter Flow Document Overview.

FlowDocumentScrollViewer

Das FlowDocumentScrollViewer Steuerelement zeigt den FlowDocument Inhalt in einem Scroll-Container an. Dieses Steuerelement eignet sich ideal für ein kontinuierliches Leseerlebnis, bei dem Benutzer durch Inhalte scrollen möchten, anstatt zwischen Seiten zu navigieren. Im Gegensatz zu FlowDocumentPageViewer, welches Inhalte auf einer Pro-Seite-Basis ansieht.

Inhaltseigenschaft

Die Inhaltseigenschaft FlowDocumentScrollViewer ist Document, welche die anzuzeigende FlowDocument angibt.

Bestandteile

In der folgenden Tabelle sind die benannten Teile für das FlowDocumentScrollViewer Steuerelement aufgeführt.

Teilbezeichnung Teiletyp Description
PART_ContentHost ScrollViewer Der Bildlaufhost für den Inhalt des Flow-Dokuments.
PART_FindToolBarHost Decorator Der Host für die Suchsymbolleiste.
PART_ToolBarHost Decorator Der Host für die Symbolleiste.

Visuelle Zustände

In der folgenden Tabelle sind die visuellen Zustände für das FlowDocumentScrollViewer Steuerelement aufgeführt.

VisualState_Name Visualzustandsgruppe Name Description
Gültig Validierungszustände Das Steuerelement ist gültig und weist keine Überprüfungsfehler auf.
UngültigerFokusiert Validierungszustände Das Steuerelement weist einen Validierungsfehler auf und hat den Tastaturfokus.
InvalidNichtFokussiert Validierungszustände Das Steuerelement weist einen Überprüfungsfehler auf, hat jedoch keinen Tastaturfokus.

FlowDocumentPageViewer

Das FlowDocumentPageViewer Steuerelement zeigt FlowDocument Inhalte seitenweise an. Dieses Steuerelement bietet eine buchähnliche Leseerfahrung mit Seitennavigationssteuerelementen. Im Gegensatz zu FlowDocumentScrollViewer, das FlowDocument Inhalte in einer Scrollanzeige präsentiert.

Inhaltseigenschaft

Die Document Eigenschaft ist die Inhaltseigenschaft des FlowDocumentPageViewer Steuerelements und enthält das Flussdokument, das im Viewer angezeigt wird.

Bestandteile

In der folgenden Tabelle sind die benannten Teile für das FlowDocumentPageViewer Steuerelement aufgeführt.

Teilename Teiletyp Description
PART_FindToolBarHost Decorator Der Dekorateur, der die Suchsymbolleiste hostt.

Visuelle Zustände

In der folgenden Tabelle sind die visuellen Zustände für das FlowDocumentPageViewer Steuerelement aufgeführt.

Visueller Zustand Gruppe visueller Zustände Description
Gültig Validierungszustände Das Steuerelement ist gültig und weist keine Überprüfungsfehler auf.
UngültigerFokusiert Validierungszustände Das Steuerelement weist einen Validierungsfehler auf und hat den Tastaturfokus.
InvalidNichtFokussiert Validierungszustände Das Steuerelement weist einen Überprüfungsfehler auf, hat jedoch keinen Tastaturfokus.

FlowDocumentReader

Das FlowDocumentReader-Steuerelement zeigt FlowDocument-Inhalt an und unterstützt mehrere Anzeigemodi. Dieses Steuerelement bietet die größte Flexibilität, indem Benutzer ihre bevorzugte Leseerfahrung auswählen, zwischen Bildlauf, Einzelseiten- und Zweiseitenansichten wechseln können.

Inhaltseigenschaft

Die Document Eigenschaft ist die Inhaltseigenschaft und definiert den Inhalt, den FlowDocument der Leser anzeigt.

Bestandteile

In der folgenden Tabelle sind die benannten Teile für das FlowDocumentReader Steuerelement aufgeführt.

Bauteilname Teiletyp Description
PART_ContentHost Decorator Der Dekorateur, der die Inhaltsanzeige für verschiedene Anzeigemodi hosten soll.
PART_FindToolBarHost Decorator Der Dekorateur, der die Suchsymbolleiste hostet, wenn die Suchfunktion aktiviert ist.

Visuelle Zustände

In der folgenden Tabelle sind die visuellen Zustände für das FlowDocumentReader Steuerelement aufgeführt.

Name des visuellen Zustands Name der visuellen Zustandgruppe Description
Gültig Validierungszustände Das Steuerelement ist gültig und weist keine Überprüfungsfehler auf.
UngültigerFokusiert Validierungszustände Das Steuerelement weist einen Validierungsfehler auf und hat den Tastaturfokus.
InvalidNichtFokussiert Validierungszustände Das Steuerelement weist einen Überprüfungsfehler auf, hat jedoch keinen Tastaturfokus.

Stile und Vorlagen

Sie können die Standardeinstellung ControlTemplate für diese Steuerelemente ändern, um ihnen eine eindeutige Darstellung zu verleihen. Weitere Informationen finden Sie unter Was sind Formatvorlagen und Vorlagen? Und wie erstellen Sie eine Vorlage für ein Steuerelement.

Siehe auch

  • Last updated on