AnnotationDocumentPaginator Klasse

Definition

Namespace:

System.Windows.Annotations

Assembly:

PresentationFramework.dll

Stellt einen DocumentPaginator zum Drucken eines Dokuments mit den zugeordneten Anmerkungen bereit.

public ref class AnnotationDocumentPaginator sealed : System::Windows::Documents::DocumentPaginator

public sealed class AnnotationDocumentPaginator : System.Windows.Documents.DocumentPaginator

type AnnotationDocumentPaginator = class
    inherit DocumentPaginator

Public NotInheritable Class AnnotationDocumentPaginator
Inherits DocumentPaginator

Vererbung

Object

DocumentPaginator

AnnotationDocumentPaginator

Beispiele

Das folgende Beispiel zeigt die Verwendung der AnnotationDocumentPaginator -Klasse.

PrintDialog prntDialog = new PrintDialog();
if ((bool)prntDialog.ShowDialog())
{
    // XpsDocumentWriter.Write() may change the current
    // directory to "My Documents" or another user selected
    // directory for storing the print document.  Save the
    // current directory and restore it after calling Write().
    string docDir = Directory.GetCurrentDirectory();

    // Create and XpsDocumentWriter for the selected printer.
    XpsDocumentWriter xdw = PrintQueue.CreateXpsDocumentWriter(
                                        prntDialog.PrintQueue);

    // Print the document with annotations.
    try
    {
        xdw.Write(_annotHelper.GetAnnotationDocumentPaginator(
            _xpsDocument.GetFixedDocumentSequence()));
    }
    catch (PrintingCanceledException)
    {
        // If in the PrintDialog the user chooses a file-based
        // output, such as the "MS Office Document Image Writer",
        // the user confirms or specifies the actual output
        // filename when the xdw.write operation executes.
        // If the user clicks "Cancel" in the filename
        // dialog a PrintingCanceledException is thrown
        // which we catch here and ignore.
        // MessageBox.Show("Print output cancelled");
    }

    // Restore the original document directory to "current".
    Directory.SetCurrentDirectory(docDir);
}

Dim prntDialog As New PrintDialog()
If CBool(prntDialog.ShowDialog()) Then
    ' XpsDocumentWriter.Write() may change the current
    ' directory to "My Documents" or another user selected
    ' directory for storing the print document.  Save the
    ' current directory and restore it after calling Write().
    Dim docDir As String = Directory.GetCurrentDirectory()

    ' Create and XpsDocumentWriter for the selected printer.
    Dim xdw As XpsDocumentWriter = PrintQueue.CreateXpsDocumentWriter(prntDialog.PrintQueue)

    ' Print the document with annotations.
    Try
        xdw.Write(_annotHelper.GetAnnotationDocumentPaginator(_xpsDocument.GetFixedDocumentSequence()))
    Catch e1 As PrintingCanceledException
        ' If in the PrintDialog the user chooses a file-based
        ' output, such as the "MS Office Document Image Writer",
        ' the user confirms or specifies the actual output
        ' filename when the xdw.write operation executes.
        ' If the user clicks "Cancel" in the filename
        ' dialog a PrintingCanceledException is thrown
        ' which we catch here and ignore.
    End Try

    ' Restore the original document directory to "current".
    Directory.SetCurrentDirectory(docDir)
End If

// ------------------ GetAnnotationDocumentPaginator ------------------
/// <summary>
///   Returns a paginator for printing annotations.</summary>
/// <param name="fds">
///   The FixedDocumentSequence containing
///   the annotations to print.</param>
/// <returns>
///   An paginator for printing the document's annotations.</returns>
public AnnotationDocumentPaginator GetAnnotationDocumentPaginator(
                                            FixedDocumentSequence fds)
{
    return new AnnotationDocumentPaginator(
                   fds.DocumentPaginator, _annotService.Store);
}

' ------------------ GetAnnotationDocumentPaginator ------------------
''' <summary>
'''   Returns a paginator for printing annotations.</summary>
''' <param name="fds">
'''   The FixedDocumentSequence containing
'''   the annotations to print.</param>
''' <returns>
'''   An paginator for printing the document's annotations.</returns>
Public Function GetAnnotationDocumentPaginator(ByVal fds As FixedDocumentSequence) As AnnotationDocumentPaginator
    Return New AnnotationDocumentPaginator(fds.DocumentPaginator, _annotService.Store)
End Function

Hinweise

Die AnnotationDocumentPaginator -Klasse umschließt das DocumentPaginator angegebene in den AnnotationDocumentPaginator Konstruktor, um die Benutzeranmerkungen zu den Seiten zum Drucken hinzuzufügen.

Konstruktoren

AnnotationDocumentPaginator(DocumentPaginator, AnnotationStore)	Initialisiert eine neue Instanz der AnnotationDocumentPaginator-Klasse auf der Grundlage des angegebenen DocumentPaginator und des angegebenen AnnotationStore.
AnnotationDocumentPaginator(DocumentPaginator, AnnotationStore, FlowDirection)	Initialisiert eine neue Instanz der AnnotationDocumentPaginator-Klasse auf der Grundlage des angegebenen DocumentPaginator, des angegebenen AnnotationStore und der angegebenen FlowDirection.
AnnotationDocumentPaginator(DocumentPaginator, Stream)	Initialisiert eine neue Instanz der AnnotationDocumentPaginator-Klasse auf der Grundlage eines angegebenen DocumentPaginator und eines angegebenen Anmerkungsspeicher-Stream.
AnnotationDocumentPaginator(DocumentPaginator, Stream, FlowDirection)	Initialisiert eine neue Instanz der AnnotationDocumentPaginator-Klasse auf der Grundlage eines angegebenen DocumentPaginator, eines angegebenen Anmerkungsspeicher-Stream und einer angegebenen Text-FlowDirection.

Eigenschaften

IsPageCountValid	Ruft einen Wert ab, der angibt, ob PageCount die Gesamtanzahl der Seiten darstellt.
PageCount	Ruft einen Wert ab, der die Anzahl der gerade formatierten Seiten angibt.
PageSize	Ruft die vorgeschlagene Breite und Höhe der einzelnen Seiten ab oder legt diese fest.
Source	Ruft das paginierte Quelldokument ab.

Methoden

CancelAsync(Object)	Bricht alle für ein angegebenes userState-Objekt eingeleiteten asynchronen Vorgänge ab.
ComputePageCount()	Erzwingt eine Paginierung des Inhalts, aktualisiert PageCount mit dem neuen Gesamtbetrag und legt IsPageCountValid auf true fest.
ComputePageCountAsync()	Erzwingt eine asynchrone Paginierung des Inhalts, aktualisiert PageCount mit dem neuen Gesamtbetrag und legt IsPageCountValid auf true fest. (Geerbt von DocumentPaginator)
ComputePageCountAsync(Object)	Startet eine asynchrone Paginierung des Inhalts, aktualisiert PageCount mit dem neuen Gesamtwert und legt IsPageCountValid nach Abschluss auf true fest.
Equals(Object)	Bestimmt, ob das angegebene Objekt gleich dem aktuellen Objekt ist. (Geerbt von Object)
GetHashCode()	Fungiert als Standardhashfunktion. (Geerbt von Object)
GetPage(Int32)	Gibt eine DocumentPage und die zugeordneten Benutzeranmerkungen für eine angegebene Seitenzahl zurück.
GetPageAsync(Int32)	Gibt (über das GetPageCompleted-Ereignis) die DocumentPage für die angegebene Seitenzahl asynchron zurück. (Geerbt von DocumentPaginator)
GetPageAsync(Int32, Object)	Gibt asynchron eine DocumentPage zusammen mit zugehörigen Benutzeranmerkungen für eine angegebene Seitenzahl zurück.
GetType()	Ruft den Type der aktuellen Instanz ab. (Geerbt von Object)
MemberwiseClone()	Erstellt eine flache Kopie des aktuellen Object. (Geerbt von Object)
OnComputePageCountCompleted(AsyncCompletedEventArgs)	Löst das ComputePageCountCompleted-Ereignis aus. (Geerbt von DocumentPaginator)
OnGetPageCompleted(GetPageCompletedEventArgs)	Löst das GetPageCompleted-Ereignis aus. (Geerbt von DocumentPaginator)
OnPagesChanged(PagesChangedEventArgs)	Löst das PagesChanged-Ereignis aus. (Geerbt von DocumentPaginator)
ToString()	Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt. (Geerbt von Object)

Ereignisse

ComputePageCountCompleted	Tritt ein, wenn ein ComputePageCountAsync-Vorgang beendet wurde. (Geerbt von DocumentPaginator)
GetPageCompleted	Tritt auf, wenn GetPageAsync abgeschlossen wurde. (Geerbt von DocumentPaginator)
PagesChanged	Tritt auf, wenn der Dokumentinhalt geändert wird. (Geerbt von DocumentPaginator)