DynamicDocumentPaginator Classe
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Fournit une classe de base abstraite qui prend en charge la pagination d'arrière-plan automatique et les positions du contenu de suivi dans les repaginations, outre les méthodes et propriétés de sa propre classe de base.
public ref class DynamicDocumentPaginator abstract : System::Windows::Documents::DocumentPaginatorpublic abstract class DynamicDocumentPaginator : System.Windows.Documents.DocumentPaginatortype DynamicDocumentPaginator = class
inherit DocumentPaginatorPublic MustInherit Class DynamicDocumentPaginator
Inherits DocumentPaginator- Héritage
Remarques
Par défaut, un DynamicDocumentPaginator prépro pagine automatiquement le contenu en arrière-plan (ce processus commence quand IsBackgroundPaginationEnabled est true, qui est le paramètre par défaut).
Lorsque IsBackgroundPaginationEnabled a truela valeur , la disposition est également réappariquée en raison de modifications du contenu ou de modifications apportées à PageSize.
L’événement PaginationProgress se produit à l’achèvement de la pagination (ou de la repagination) d’une ou plusieurs pages, par exemple dans les situations suivantes :
PaginationProgress les événements se produisent lorsque le contenu est paginé en arrière-plan. Selon l’implémentation, l’événement peut se produire lors de la pagination d’une ou de plusieurs pages (PaginationProgressEventArgs spécifie les pages qui ont été paginées).
Les appels à GetPage ou GetPageAsync peuvent provoquer un PaginationProgress événement si la page spécifiée n’a pas été paginé. Par exemple, si la pagination en arrière-plan est activée (IsBackgroundPaginationEnabled =
true) mais que la pagination n’a été effectuée que jusqu’à la troisième page, un appel de GetPage avec un argument de 6 entraîne la pagination des pages quatre, cinq, six et sept. Une fois terminé, un PaginationProgress événement est déclenché avec PaginationProgressEventArgs les paramètres = Start 4 et Count = 4.Une fois la pagination en arrière-plan activée (IsBackgroundPaginationEnabled =
true), une modification du PageSize contenu au format de flux, tel qu’un , peut entraîner la FlowDocumentrepagination et les événements associés.PaginationProgress Notez que PageSize n’a aucun effet dans la repagination sur le contenu au format fixe, comme FixedDocument, où la taille de la page visuelle n’affecte pas la mise en page.
Un PaginationCompleted événement se produit également lorsque la pagination en arrière-plan est désactivée. Par exemple, s’il n’existe qu’une seule page de contenu et IsBackgroundPaginationEnabled = false), l’appel GetPage avec un argument 0 entraîne deux événements :
Événement PaginationProgress avec PaginationProgressEventArgs les paramètres Start = 0 et Count = 1.
Événement PaginationCompleted .
Constructeurs
| DynamicDocumentPaginator() |
Initialise une nouvelle instance de la classe DynamicDocumentPaginator. |
Propriétés
| IsBackgroundPaginationEnabled |
Obtient ou définit une valeur indiquant si la pagination est réalisée automatiquement en arrière-plan en réponse à certains événements, tels qu'une modification de la taille de la page. |
| IsPageCountValid |
En cas de substitution dans une classe dérivée, obtient une valeur indiquant si PageCount correspond au nombre total de pages. (Hérité de DocumentPaginator) |
| PageCount |
En cas de substitution dans une classe dérivée, obtient le nombre de pages mises en forme. (Hérité de DocumentPaginator) |
| PageSize |
En cas de substitution dans une classe dérivée, obtient ou définit la largeur et la hauteur suggérées de chaque page. (Hérité de DocumentPaginator) |
| Source |
En cas de substitution dans une classe dérivée, retourne l'élément en cours de pagination. (Hérité de DocumentPaginator) |
Méthodes
| CancelAsync(Object) |
Annule une opération GetPageAsync ou GetPageNumberAsync précédente. (Hérité de DocumentPaginator) |
| ComputePageCount() |
Force une pagination du contenu, met à jour PageCount avec le nouveau total et affecte à IsPageCountValid la valeur |
| ComputePageCountAsync() |
Force, de manière asynchrone, une pagination du contenu, met à jour PageCount avec le nouveau total et affecte à IsPageCountValid la valeur |
| ComputePageCountAsync(Object) |
Force, de manière asynchrone, une pagination du contenu, met à jour PageCount avec le nouveau total et affecte à IsPageCountValid la valeur |
| Equals(Object) |
Détermine si l'objet spécifié est égal à l'objet actuel. (Hérité de Object) |
| GetHashCode() |
Fait office de fonction de hachage par défaut. (Hérité de Object) |
| GetObjectPosition(Object) |
En cas de substitution dans une classe dérivée, retourne une ContentPosition pour le Object spécifié. |
| GetPage(Int32) |
En cas de substitution dans une classe dérivée, obtient la DocumentPage correspondant au numéro de page spécifié. (Hérité de DocumentPaginator) |
| GetPageAsync(Int32) |
Retourne, de manière asynchrone (par l'événement GetPageCompleted), la DocumentPage correspondant au numéro de page spécifié. (Hérité de DocumentPaginator) |
| GetPageAsync(Int32, Object) |
Retourne, de manière asynchrone (par l'événement GetPageCompleted), la DocumentPage correspondant au numéro de page spécifié et assigne l'ID indiqué à la tâche asynchrone. (Hérité de DocumentPaginator) |
| GetPageNumber(ContentPosition) |
En cas de substitution dans une classe dérivée, retourne le numéro de page de base zéro correspondant à la ContentPosition spécifiée. |
| GetPageNumberAsync(ContentPosition) |
Retourne, de manière asynchrone (par l'événement GetPageNumberCompleted), le numéro de page de base zéro de la ContentPosition spécifiée. |
| GetPageNumberAsync(ContentPosition, Object) |
Retourne, de manière asynchrone (par l'événement GetPageNumberCompleted), le numéro de page de base zéro de la ContentPosition spécifiée. |
| GetPagePosition(DocumentPage) |
En cas de substitution dans une classe dérivée, obtient la position de la page spécifiée dans le contenu du document. |
| GetType() |
Obtient le Type de l'instance actuelle. (Hérité de Object) |
| MemberwiseClone() |
Crée une copie superficielle du Object actuel. (Hérité de Object) |
| OnComputePageCountCompleted(AsyncCompletedEventArgs) |
Déclenche l’événement ComputePageCountCompleted. (Hérité de DocumentPaginator) |
| OnGetPageCompleted(GetPageCompletedEventArgs) |
Déclenche l’événement GetPageCompleted. (Hérité de DocumentPaginator) |
| OnGetPageNumberCompleted(GetPageNumberCompletedEventArgs) |
Déclenche l’événement GetPageNumberCompleted. |
| OnPagesChanged(PagesChangedEventArgs) |
Déclenche l’événement PagesChanged. (Hérité de DocumentPaginator) |
| OnPaginationCompleted(EventArgs) |
Déclenche l’événement PaginationCompleted. |
| OnPaginationProgress(PaginationProgressEventArgs) |
Déclenche l’événement PaginationProgress. |
| ToString() |
Retourne une chaîne qui représente l'objet actuel. (Hérité de Object) |
Événements
| ComputePageCountCompleted |
Se produit lorsqu'une opération ComputePageCountAsync est terminée. (Hérité de DocumentPaginator) |
| GetPageCompleted |
Se produit lorsque GetPageAsync est terminé. (Hérité de DocumentPaginator) |
| GetPageNumberCompleted |
Se produit lorsque GetPageNumberAsync est terminé. |
| PagesChanged |
Se produit lorsque le contenu du document est modifié. (Hérité de DocumentPaginator) |
| PaginationCompleted |
Déclenché lorsque l'intégralité du contenu du document a été paginé. |
| PaginationProgress |
Déclenché lorsqu'au moins une page de contenu a été paginée. |
