Weiterführende Themen: Erstellen von FlowDocumentReader-Steuerelementen
Einige Eigenschaften im Eigenschaftenpanel sind komplexer und enthalten nicht nur einen einzelnen Wert. Beispielsweise stellen einige Eigenschaften eine Auflistung von Werten oder ein Objekt mit eigenen Eigenschaften dar. Mit dem Auflistungs- und dem Untereigenschaften-Editor können Sie diese Werte ändern.
Im folgenden Verfahren wird gezeigt, wie Sie FlowDocumentReader-Steuerelementen mit dem Untereigenschaften- und dem Auflistungs-Editor Inhalt hinzufügen.
Hinweis: |
---|
Dieses Verfahren ist nicht geeignet, um Text in FlowDocumentScrollViewer-Steuerelementen zu bearbeiten. Hierfür stehen stattdessen andere Verfahren zur Verfügung, die unter Bearbeiten von Text, Formatieren von Text und in den anderen Abschnitten zu Vorgehensweisen unter Text und Typografie beschrieben werden. |
So fügen Sie einem FlowDocumentReader-Steuerelement Inhalt hinzu
Das FlowDocumentReader-Steuerelement wird in der Objektbibliothek aufgerufen. Klicken Sie in der Werkzeugpalette auf die Schaltfläche Objektbibliothek.
Aktivieren Sie das Kontrollkästchen Alles anzeigen, um alle verfügbaren Steuerelemente anzuzeigen.
Wählen Sie auf der Registerkarte Steuerelemente die Option Systemsteuerelemente (Standard) aus, und wählen Sie dann das FlowDocumentReader-Steuerelement aus. Über der Schaltfläche Objektbibliothek in der Werkzeugpalette wird ein generisches Symbol angezeigt. Es ist bereits markiert und kann in die Zeichenfläche eingefügt werden.
Zeichnen Sie ein FlowDocumentReader-Steuerelement auf der Zeichenfläche.
Ein auf der Zeichenfläche gezeichnetes FlowDocumentReader-Steuerelement
Erweitern Sie im Eigenschaftenpanel die Kategorie Sonstiges. Unter Objekte und Zeitachsen muss das FlowDocumentReader-Objekt aktiviert sein.
Klicken Sie neben der Document-Eigenschaft auf die Schaltfläche Neu. Die Document-Eigenschaft (Dokument) wird mit einem FlowDocument-Objekt gefüllt, und der Untereigenschaften-Editor für das FlowDocument-Objekt wird geöffnet. Sie können den Untereigenschaften-Editor erweitern und reduzieren. Die Document-Eigenschaft (Dokument) kann nur ein FlowDocument-Objekt enthalten.
Hinweis: Eigenschaften, für die ein Untereigenschaften-Editor angezeigt wird, sind in der Regel durch die Schaltfläche Neu und einen Erweiterungspfeil gekennzeichnet. Wenn der Eigenschaft standardmäßige Untereigenschaften zugeordnet sind, wird neben der Eigenschaft ein Dropdownpfeil angezeigt. In der der BitmapEffect-Eigenschaft (Bitmapeffekt) zugeordneten Dropdownliste sind beispielsweise die untergeordneten Eigenschaften BevelBitmapEffect (Bitmapeffekt Abschrägung) und BlurBitmapEffect (Bitmapeffekt Weichzeichner) enthalten, die Sie auswählen können.
Der Untereigenschaften-Editor der Document-Eigenschaft (Dokument) zeigt die Eigenschaft Blocks (Collection) (Blöcke (Auflistung)) an.
Klicken Sie im Untereigenschaften-Editor für die Document-Eigenschaft (Dokument) neben der Eigenschaft Blocks (Collection) (Blöcke (Sammlung)) auf die Schaltfläche Elemente in dieser Auflistung bearbeiten. Der Auflistungs-Editor für die Blocks-Eigenschaft (Blöcke) wird geöffnet.
Hinweis: Eigenschaften, für die ein Auflistungs-Editor angezeigt wird, sind in der Regel durch den Begriff (Auflistung) und die Schaltfläche Elemente in dieser Auflistung bearbeiten gekennzeichnet.
Auflistungs-Editor der Blocks-Untereigenschaft (Blöcke)
Klicken Sie im Auflistungs-Editor für die Blocks-Untereigenschaft (Blöcke) auf die Schaltfläche Anderes Element hinzufügen. Das Fenster Objekt auswählen wird geöffnet. Hier können Sie ein beliebiges Windows Presentation Foundation-Objekt (WPF) auswählen.
Geben Sie im Textfeld Suchen den Begriff Paragraph ein, um die Paragraph-Klasse schnell zu finden. Wählen Sie Paragraph aus der Liste unter System.Windows.Documents aus, und klicken Sie auf OK. Das Fenster Objekt auswählen wird geschlossen, und dem Auflistungs-Editor wird an der Position Index 0 ein Paragraph-Element hinzugefügt. Die Eigenschaften des Paragraph-Objekts werden auf der rechten Seite angezeigt.
Hinweis: Es ist nicht immer einfach zu verstehen, welche Objekte für eine bestimmte Auflistung gültig sind. Für die Auflistungseigenschaften der häufig verwendeten Steuerelemente (z. B. die Items-Auflistungseigenschaft des ListBox-Steuerelements) steht im Auflistungs-Editor eine Dropdownliste der vorgeschlagenen Elemente sowie die Schaltfläche Anderes Element hinzufügen bereit. Bei weniger gängigen Steuerelementen (z. B. FlowDocumentReader) empfiehlt es sich, in der MSDN-Dokumentation für den Steuerelementtyp nachzulesen, welche Elemente für die Auflistung gültig sind. Im Abschnitt zu den Klassen in Flussdokumenten unter Flussdokumente (Übersicht) in MSDN (möglicherweise in englischer Sprache) ist z. B. ein Diagramm dargestellt, das die Struktur von FlowDocument-Steuerelementen zeigt. Aus diesem Diagramm wird deutlich, dass die Blocks-Eigenschaft (Blöcke) die Elemente Paragraph, Section, List, Table und/oder BlockUIContainer enthalten kann. In den folgenden Schritten fügen Sie der Inlines-Auflistungseigenschaft des Paragraph-Objekts ein Run-Element hinzu.
Klicken Sie im Eigenschaftenfenster des Paragraph-Objekts neben der Inlines-Eigenschaft auf die Schaltfläche Elemente in dieser Auflistung bearbeiten. Der Auflistungs-Editor wechselt in den Bereich der Inlines-Eigenschaft.
Klicken Sie auf die Schaltfläche Anderes Element hinzufügen, und wählen Sie dann im Fenster Objekt auswählen die Run-Klasse aus. Dem Auflistungs-Editor wird an der Position 0 des Index ein Run-Objekt hinzugefügt.
Fügen Sie im Eigenschaftenfenster des Run-Objekts Inhalt hinzu, indem Sie Daten in die Text-Eigenschaft eingeben. Zum Formatieren des Textes können Sie auch Eigenschaften der Kategorien Pinsel und Text verwenden. Einige Eigenschaften sind deaktiviert, da sie auf der Ebene des FlowDocumentViewer-Steuerelements festgelegt werden müssen.
Der Auflistungs-Editor der Inlines-Eigenschaft nach Hinzufügen eines Run-Objekts und Bearbeiten der Text-Eigenschaft
Klicken Sie auf OK, um den Auflistungs-Editor für die Inlines-Eigenschaft zu beenden, und klicken Sie dann auf OK, um den Auflistungs-Editor für die Blocks-Eigenschaft (Blöcke) zu beenden. Der von Ihnen im vorherigen Schritt eingegebene Text wird im FlowDocumentViewer-Steuerelement angezeigt.
Wichtig: Klicken Sie nur auf die Schaltfläche Neu neben der Document-Eigenschaft (Dokument) des FlowDocumentViewer-Objekts, wenn Sie den gerade erstellten Inhalt löschen möchten. Die Document-Eigenschaft (Dokument) kann nur ein FlowDocument-Objekt enthalten. Nur Eigenschaften mit dem Zusatz (Auflistung) können mehrere Objekte enthalten.
Hinweis: |
---|
Wenn Sie ein FlowDocumentScrollViewer- oder RichTextBox-Objekt bearbeiten, können Sie den Text-Editor von Microsoft Expression Blend verwenden. Markieren Sie hierzu das Objekt, und drücken Sie F2. Weitere Informationen finden Sie unter Bearbeiten von Text. Wenn Sie ein DocumentViewer- oder FlowDocumentPageViewer-Objekt bearbeiten, wird Inhalt programmgesteuert hinzugefügt. Weitere Informationen finden Sie unter Flussdokumente (Übersicht) und Dokumente in Windows Presentation Foundation in MSDN (möglicherweise in englischer Sprache). Siehe auch DocumentViewer (Beispiele) und FlowDocumentReader (Beispiele), die Sie unter Windows SDK .NET Framework 3.0 Samples (möglicherweise in englischer Sprache) herunterladen können. |