Partager via

Propriété AbsolutePage (ADO)

  • Article

S’applique à : Access 2013, Office 2013

Indique la page sur laquelle se trouve l'enregistrement actif.

Paramètres et valeurs de retour

Définit ou renvoie une valeur Long comprise entre 1 et le nombre de pages de l’objet Recordset (PageCount), ou renvoie l’une des valeurs PositionEnum .

Remarques

Cette propriété peut être utilisée pour identifier le numéro de page sur laquelle se trouve l'enregistrement actif. Elle utilise la propriété PageSize pour séparer logiquement le nombre total de jeux de lignes de l'objet Recordset en une série de pages, chacune possédant un nombre d'enregistrements égal à PageSize (à l'exception de la dernière page, qui peut comporter moins d'enregistrements). Le fournisseur doit prendre en charge les fonctions appropriées pour que cette propriété soit disponible.

Lors de l'extraction ou de la définition de la propriété AbsolutePage, ADO utilise conjointement les propriétés AbsolutePosition et PageSize, de la manière suivante :

  • Pour extraire AbsolutePage, ADO commence par extraire AbsolutePosition, qu'il divise par la valeur PageSize.

  • Pour définir AbsolutePage, ADO déplace AbsolutePosition de la manière suivante : il multiplie PageSize par la nouvelle valeur AbsolutePage et y ajoute 1. Par conséquent, la position actuelle dans l’objet Recordset après avoir correctement défini AbsolutePage est le premier enregistrement de cette page.

Comme la propriété AbsolutePosition, la propriété AbsolutePage est en base 1 et est égale à 1 lorsque l'enregistrement actif correspond au premier enregistrement du Recordset. Définissez cette propriété pour accéder au premier enregistrement d'une page déterminée. Le nombre total de pages est obtenu à l'aide de la propriété PageCount.