AnnotationDocumentPaginator Clase

Definición

Espacio de nombres:

System.Windows.Annotations

Ensamblado:

PresentationFramework.dll

Proporciona un DocumentPaginator para imprimir un documento junto con sus anotaciones asociadas.

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

Herencia

Object

DocumentPaginator

AnnotationDocumentPaginator

Ejemplos

En el ejemplo siguiente se muestra el uso de la AnnotationDocumentPaginator clase .

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

Comentarios

La AnnotationDocumentPaginator clase ajusta el DocumentPaginator especificado al AnnotationDocumentPaginator constructor para agregar las anotaciones de usuario a las páginas para imprimir.

Constructores

AnnotationDocumentPaginator(DocumentPaginator, AnnotationStore)	Inicializa una nueva instancia de la clase AnnotationDocumentPaginator basada en el DocumentPaginator y el AnnotationStore especificados.
AnnotationDocumentPaginator(DocumentPaginator, AnnotationStore, FlowDirection)	Inicializa una nueva instancia de la clase AnnotationDocumentPaginator basada en un DocumentPaginator, un AnnotationStore y una FlowDirection de texto especificados.
AnnotationDocumentPaginator(DocumentPaginator, Stream)	Inicializa una nueva instancia de la clase AnnotationDocumentPaginator basada en un DocumentPaginator y una Stream de almacenamiento de anotaciones especificados.
AnnotationDocumentPaginator(DocumentPaginator, Stream, FlowDirection)	Inicializa una nueva instancia de la clase AnnotationDocumentPaginator basada en un DocumentPaginator, una Stream de almacenamiento de anotaciones y una FlowDirection de texto especificados.

Propiedades

IsPageCountValid	Obtiene un valor que indica si PageCount es el número total de páginas.
PageCount	Obtiene un valor que indica el número de páginas a las que se ha dado formato actualmente.
PageSize	Obtiene o establece el ancho y alto sugeridos de cada página.
Source	Obtiene el documento de origen que se está paginando.

Métodos

CancelAsync(Object)	Cancela todas las operaciones asincrónicas iniciadas con un objeto userState dado.
ComputePageCount()	Fuerza una paginación del contenido, actualiza PageCount con el nuevo total y establece IsPageCountValid en true.
ComputePageCountAsync()	De forma asincrónica, fuerza una paginación del contenido, actualiza PageCount con el nuevo total y establece IsPageCountValid en true. (Heredado de DocumentPaginator)
ComputePageCountAsync(Object)	Inicia una paginación asincrónica del contenido, actualiza PageCount con el nuevo total y establece IsPageCountValid en true cuando finaliza.
Equals(Object)	Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object)
GetHashCode()	Sirve como la función hash predeterminada. (Heredado de Object)
GetPage(Int32)	Devuelve DocumentPage junto con las anotaciones de usuario asociadas para un número de página especificado.
GetPageAsync(Int32)	De forma asincrónica, devuelve (mediante el evento GetPageCompleted) DocumentPage para el número de página especificado. (Heredado de DocumentPaginator)
GetPageAsync(Int32, Object)	Devuelve de forma asincrónica una clase DocumentPage junto con las anotaciones de usuario asociadas a un número de página especificado.
GetType()	Obtiene el Type de la instancia actual. (Heredado de Object)
MemberwiseClone()	Crea una copia superficial del Object actual. (Heredado de Object)
OnComputePageCountCompleted(AsyncCompletedEventArgs)	Genera el evento ComputePageCountCompleted. (Heredado de DocumentPaginator)
OnGetPageCompleted(GetPageCompletedEventArgs)	Genera el evento GetPageCompleted. (Heredado de DocumentPaginator)
OnPagesChanged(PagesChangedEventArgs)	Genera el evento PagesChanged. (Heredado de DocumentPaginator)
ToString()	Devuelve una cadena que representa el objeto actual. (Heredado de Object)

Eventos

ComputePageCountCompleted	Se produce al finalizar una operación ComputePageCountAsync. (Heredado de DocumentPaginator)
GetPageCompleted	Se produce al finalizar GetPageAsync. (Heredado de DocumentPaginator)
PagesChanged	Se produce cuando se cambia el contenido del documento. (Heredado de DocumentPaginator)