AnnotationDocumentPaginator Classe

Définition

Fournit un DocumentPaginator pour imprimer un document avec ses annotations associées.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
Héritage
AnnotationDocumentPaginator

Exemples

L’exemple suivant illustre l’utilisation de la AnnotationDocumentPaginator classe.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

Remarques

La AnnotationDocumentPaginator classe encapsule le DocumentPaginator spécifié dans le AnnotationDocumentPaginator constructeur pour ajouter les annotations utilisateur aux pages à imprimer.The AnnotationDocumentPaginator class wraps the DocumentPaginator specified to the AnnotationDocumentPaginator constructor to add the user annotations to the pages for printing.

Constructeurs

AnnotationDocumentPaginator(DocumentPaginator, AnnotationStore)

Initialise une nouvelle instance de la classe AnnotationDocumentPaginator basée sur un DocumentPaginator et un AnnotationStore spécifiés.Initializes a new instance of the AnnotationDocumentPaginator class based on a specified DocumentPaginator and AnnotationStore.

AnnotationDocumentPaginator(DocumentPaginator, AnnotationStore, FlowDirection)

Initialise une nouvelle instance de la classe AnnotationDocumentPaginator basée sur un DocumentPaginator, un AnnotationStore et un FlowDirection du texte spécifiés.Initializes a new instance of the AnnotationDocumentPaginator class based on a specified DocumentPaginator, AnnotationStore, and text FlowDirection.

AnnotationDocumentPaginator(DocumentPaginator, Stream)

Initialise une nouvelle instance de la classe AnnotationDocumentPaginator basée sur un DocumentPaginator et un Stream du stockage de l'annotation spécifiés.Initializes a new instance of the AnnotationDocumentPaginator class based on a specified DocumentPaginator and annotation storage Stream.

AnnotationDocumentPaginator(DocumentPaginator, Stream, FlowDirection)

Initialise une nouvelle instance de la classe AnnotationDocumentPaginator basée sur un DocumentPaginator, un Stream du stockage de l'annotation et un FlowDirection du texte spécifiés.Initializes a new instance of the AnnotationDocumentPaginator class based on a specified DocumentPaginator, annotation storage Stream, and text FlowDirection.

Propriétés

IsPageCountValid

Obtient une valeur qui indique si PageCount est le nombre total de pages.Gets a value that indicates whether PageCount is the total number of pages.

PageCount

Obtient une valeur qui indique le nombre de pages actuellement mises en forme.Gets a value that indicates the number of pages currently formatted.

PageSize

Obtient ou définit la largeur et la hauteur suggérées de chaque page.Gets or sets the suggested width and height of each page.

Source

Obtient le document source paginé.Gets the source document that is being paginated.

Méthodes

CancelAsync(Object)

Annule toutes les opérations asynchrones initiées avec un objet userState donné.Cancels all asynchronous operations initiated with a given userState object.

ComputePageCount()

Force une pagination du contenu, met à jour PageCount avec le nouveau total et affecte à IsPageCountValid la valeur true.Forces a pagination of the content, updates PageCount with the new total, and sets IsPageCountValid to true.

ComputePageCountAsync()

Force, de manière asynchrone, une pagination du contenu, met à jour PageCount avec le nouveau total et affecte à IsPageCountValid la valeur true.Asynchronously, forces a pagination of the content, updates PageCount with the new total, and sets IsPageCountValid to true.

(Hérité de DocumentPaginator)
ComputePageCountAsync(Object)

Démarre une pagination asynchrone du contenu, met à jour PageCount avec le nouveau total et définit IsPageCountValid sur true quand elle est terminée.Starts an asynchronous pagination of the content, updates PageCount with the new total, and sets IsPageCountValid to true when it is finished.

Equals(Object)

Détermine si l'objet spécifié est égal à l'objet actuel.Determines whether the specified object is equal to the current object.

(Hérité de Object)
GetHashCode()

Fait office de fonction de hachage par défaut.Serves as the default hash function.

(Hérité de Object)
GetPage(Int32)

Retourne un DocumentPage avec les annotations utilisateur associées pour un numéro de page spécifié.Returns a DocumentPage together with associated user-annotations for a specified page number.

GetPageAsync(Int32)

Retourne, de manière asynchrone (par l'événement GetPageCompleted), la DocumentPage correspondant au numéro de page spécifié.Asynchronously returns (through the GetPageCompleted event) the DocumentPage for the specified page number.

(Hérité de DocumentPaginator)
GetPageAsync(Int32, Object)

Retourne de manière asynchrone un DocumentPage avec des annotations utilisateur associées pour un numéro de page spécifié.Asynchronously returns a DocumentPage together with associated user-annotations for a specified page number.

GetType()

Obtient le Type de l'instance actuelle.Gets the Type of the current instance.

(Hérité de Object)
MemberwiseClone()

Crée une copie superficielle du Object actuel.Creates a shallow copy of the current Object.

(Hérité de Object)
OnComputePageCountCompleted(AsyncCompletedEventArgs)

Déclenche l’événement ComputePageCountCompleted.Raises the ComputePageCountCompleted event.

(Hérité de DocumentPaginator)
OnGetPageCompleted(GetPageCompletedEventArgs)

Déclenche l’événement GetPageCompleted.Raises the GetPageCompleted event.

(Hérité de DocumentPaginator)
OnPagesChanged(PagesChangedEventArgs)

Déclenche l’événement PagesChanged.Raises the PagesChanged event.

(Hérité de DocumentPaginator)
ToString()

Retourne une chaîne qui représente l'objet actuel.Returns a string that represents the current object.

(Hérité de Object)

Événements

ComputePageCountCompleted

Se produit lorsqu'une opération ComputePageCountAsync est terminée.Occurs when a ComputePageCountAsync operation has finished.

(Hérité de DocumentPaginator)
GetPageCompleted

Se produit lorsque GetPageAsync est terminé.Occurs when GetPageAsync has completed.

(Hérité de DocumentPaginator)
PagesChanged

Se produit lorsque le contenu du document est modifié.Occurs when the document content is changed.

(Hérité de DocumentPaginator)

S’applique à