AnnotationDocumentPaginator AnnotationDocumentPaginator AnnotationDocumentPaginator AnnotationDocumentPaginator Class

Definition

Stellt einen DocumentPaginator zum Drucken eines Dokuments mit den zugeordneten Anmerkungen bereit.Provides a DocumentPaginator for printing a document together with its associated annotations.

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
AnnotationDocumentPaginatorAnnotationDocumentPaginatorAnnotationDocumentPaginatorAnnotationDocumentPaginator

Beispiele

Im folgenden Beispiel wird die Verwendung AnnotationDocumentPaginator der-Klasse veranschaulicht.The following example shows use of the AnnotationDocumentPaginator class.

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 die DocumentPaginator angegebene AnnotationDocumentPaginator zum-Konstruktor, um die Benutzer Anmerkungen den Seiten zum Drucken hinzuzufügen.The AnnotationDocumentPaginator class wraps the DocumentPaginator specified to the AnnotationDocumentPaginator constructor to add the user annotations to the pages for printing.

Konstruktoren

AnnotationDocumentPaginator(DocumentPaginator, AnnotationStore) AnnotationDocumentPaginator(DocumentPaginator, AnnotationStore) AnnotationDocumentPaginator(DocumentPaginator, AnnotationStore) AnnotationDocumentPaginator(DocumentPaginator, AnnotationStore)

Initialisiert eine neue Instanz der AnnotationDocumentPaginator-Klasse auf der Grundlage des angegebenen DocumentPaginator und des angegebenen AnnotationStore.Initializes a new instance of the AnnotationDocumentPaginator class based on a specified DocumentPaginator and AnnotationStore.

AnnotationDocumentPaginator(DocumentPaginator, AnnotationStore, FlowDirection) AnnotationDocumentPaginator(DocumentPaginator, AnnotationStore, FlowDirection) AnnotationDocumentPaginator(DocumentPaginator, AnnotationStore, FlowDirection) AnnotationDocumentPaginator(DocumentPaginator, AnnotationStore, FlowDirection)

Initialisiert eine neue Instanz der AnnotationDocumentPaginator-Klasse auf der Grundlage des angegebenen DocumentPaginator, des angegebenen AnnotationStore und der angegebenen FlowDirection.Initializes a new instance of the AnnotationDocumentPaginator class based on a specified DocumentPaginator, AnnotationStore, and text FlowDirection.

AnnotationDocumentPaginator(DocumentPaginator, Stream) AnnotationDocumentPaginator(DocumentPaginator, Stream) AnnotationDocumentPaginator(DocumentPaginator, Stream) AnnotationDocumentPaginator(DocumentPaginator, Stream)

Initialisiert eine neue Instanz der AnnotationDocumentPaginator-Klasse auf der Grundlage eines angegebenen DocumentPaginator und eines angegebenen Anmerkungsspeicher-Stream.Initializes a new instance of the AnnotationDocumentPaginator class based on a specified DocumentPaginator and annotation storage Stream.

AnnotationDocumentPaginator(DocumentPaginator, Stream, FlowDirection) AnnotationDocumentPaginator(DocumentPaginator, Stream, FlowDirection) AnnotationDocumentPaginator(DocumentPaginator, Stream, FlowDirection) 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.Initializes a new instance of the AnnotationDocumentPaginator class based on a specified DocumentPaginator, annotation storage Stream, and text FlowDirection.

Eigenschaften

IsPageCountValid IsPageCountValid IsPageCountValid IsPageCountValid

Ruft einen Wert ab, der angibt, ob PageCount die Gesamtanzahl der Seiten darstellt.Gets a value that indicates whether PageCount is the total number of pages.

PageCount PageCount PageCount PageCount

Ruft einen Wert ab, der die Anzahl der gerade formatierten Seiten angibt.Gets a value that indicates the number of pages currently formatted.

PageSize PageSize PageSize PageSize

Ruft die vorgeschlagene Breite und Höhe der einzelnen Seiten ab oder legt diese fest.Gets or sets the suggested width and height of each page.

Source Source Source Source

Ruft das paginierte Quelldokument ab.Gets the source document that is being paginated.

Methoden

CancelAsync(Object) CancelAsync(Object) CancelAsync(Object) CancelAsync(Object)

Bricht alle für ein angegebenes userState-Objekt eingeleiteten asynchronen Vorgänge ab.Cancels all asynchronous operations initiated with a given userState object.

ComputePageCount() ComputePageCount() ComputePageCount() ComputePageCount()

Erzwingt eine Paginierung des Inhalts, aktualisiert PageCount mit dem neuen Gesamtbetrag und legt IsPageCountValid auf true fest.Forces a pagination of the content, updates PageCount with the new total, and sets IsPageCountValid to true.

ComputePageCountAsync() ComputePageCountAsync() ComputePageCountAsync() ComputePageCountAsync()

Erzwingt eine asynchrone Paginierung des Inhalts, aktualisiert PageCount mit dem neuen Gesamtbetrag und legt IsPageCountValid auf true fest.Asynchronously, forces a pagination of the content, updates PageCount with the new total, and sets IsPageCountValid to true.

(Inherited from DocumentPaginator)
ComputePageCountAsync(Object) ComputePageCountAsync(Object) ComputePageCountAsync(Object) ComputePageCountAsync(Object)

Startet eine asynchrone Paginierung des Inhalts, aktualisiert PageCount mit dem neuen Gesamtwert und legt IsPageCountValid nach Abschluss auf true fest.Starts an asynchronous pagination of the content, updates PageCount with the new total, and sets IsPageCountValid to true when it is finished.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

Bestimmt, ob das angegebene Objekt mit dem aktuellen Objekt identisch ist.Determines whether the specified object is equal to the current object.

(Inherited from Object)
GetHashCode() GetHashCode() GetHashCode() GetHashCode()

Fungiert als Standardhashfunktion.Serves as the default hash function.

(Inherited from Object)
GetPage(Int32) GetPage(Int32) GetPage(Int32) GetPage(Int32)

Gibt eine DocumentPage und die zugeordneten Benutzeranmerkungen für eine angegebene Seitenzahl zurück.Returns a DocumentPage together with associated user-annotations for a specified page number.

GetPageAsync(Int32) GetPageAsync(Int32) GetPageAsync(Int32) GetPageAsync(Int32)

Gibt (über das GetPageCompleted-Ereignis) die DocumentPage für die angegebene Seitenzahl asynchron zurück.Asynchronously returns (through the GetPageCompleted event) the DocumentPage for the specified page number.

(Inherited from DocumentPaginator)
GetPageAsync(Int32, Object) GetPageAsync(Int32, Object) GetPageAsync(Int32, Object) GetPageAsync(Int32, Object)

Gibt asynchron eine DocumentPage zusammen mit zugehörigen Benutzeranmerkungen für eine angegebene Seitenzahl zurück.Asynchronously returns a DocumentPage together with associated user-annotations for a specified page number.

GetType() GetType() GetType() GetType()

Ruft den Type der aktuellen Instanz ab.Gets the Type of the current instance.

(Inherited from Object)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

Erstellt eine flache Kopie des aktuellen Object.Creates a shallow copy of the current Object.

(Inherited from Object)
OnComputePageCountCompleted(AsyncCompletedEventArgs) OnComputePageCountCompleted(AsyncCompletedEventArgs) OnComputePageCountCompleted(AsyncCompletedEventArgs) OnComputePageCountCompleted(AsyncCompletedEventArgs)

Löst das ComputePageCountCompleted -Ereignis aus.Raises the ComputePageCountCompleted event.

(Inherited from DocumentPaginator)
OnGetPageCompleted(GetPageCompletedEventArgs) OnGetPageCompleted(GetPageCompletedEventArgs) OnGetPageCompleted(GetPageCompletedEventArgs) OnGetPageCompleted(GetPageCompletedEventArgs)

Löst das GetPageCompleted-Ereignis aus.Raises the GetPageCompleted event.

(Inherited from DocumentPaginator)
OnPagesChanged(PagesChangedEventArgs) OnPagesChanged(PagesChangedEventArgs) OnPagesChanged(PagesChangedEventArgs) OnPagesChanged(PagesChangedEventArgs)

Löst das PagesChanged-Ereignis aus.Raises the PagesChanged event.

(Inherited from DocumentPaginator)
ToString() ToString() ToString() ToString()

Gibt eine Zeichenfolge zurück, die das aktuelle Objekt darstellt.Returns a string that represents the current object.

(Inherited from Object)

Ereignisse

ComputePageCountCompleted ComputePageCountCompleted ComputePageCountCompleted ComputePageCountCompleted

Tritt ein, wenn ein ComputePageCountAsync-Vorgang beendet wurde.Occurs when a ComputePageCountAsync operation has finished.

(Inherited from DocumentPaginator)
GetPageCompleted GetPageCompleted GetPageCompleted GetPageCompleted

Tritt auf, wenn GetPageAsync abgeschlossen wurde.Occurs when GetPageAsync has completed.

(Inherited from DocumentPaginator)
PagesChanged PagesChanged PagesChanged PagesChanged

Tritt auf, wenn der Dokumentinhalt geändert wird.Occurs when the document content is changed.

(Inherited from DocumentPaginator)

Gilt für: