IMAPITable::SeekRowApprox
S’applique à : Outlook 2013 | Outlook 2016
Déplace le curseur à une position fractionnaire approximative dans la table.
HRESULT SeekRowApprox(
ULONG ulNumerator,
ULONG ulDenominator
);
Paramètres
ulNumerator
[in] Pointeur vers le numérateur de la fraction représentant la position de la table. Si le paramètre ulNumerator est égal à zéro, le curseur est positionné au début de la table, quelle que soit la valeur du dénominateur. Si ulNumerator est égal au paramètre ulDenominator , le curseur est positionné après la dernière ligne du tableau.
ulDenominator
[in] Pointeur vers le dénominateur de la fraction représentant la position de la table. Le paramètre ulDenominator ne peut pas être égal à zéro.
Valeur renvoyée
S_OK
L’opération de recherche a réussi.
MAPI_E_BUSY
Une autre opération est en cours qui empêche l’opération de recherche de ligne de démarrer. Soit l’opération en cours doit être autorisée à se terminer, soit elle doit être arrêtée.
Remarques
La position du curseur dans une table après un appel à la méthode IMAPITable ::SeekRowApprox est heuristiquement la fraction et peut ne pas être exacte. Par exemple, certains fournisseurs peuvent implémenter une table au-dessus d’une arborescence binaire, en traitant le point à mi-chemin de la table comme le haut de l’arborescence pour des raisons de performances. Si l’arborescence n’est pas équilibrée, le point à mi-chemin utilisé peut ne pas être exactement à mi-chemin dans la table.
Remarques pour les appelants
Appelez SeekRowApprox pour fournir les données d’une implémentation de barre de défilement. Par exemple, si l’utilisateur positionne la zone de défilement 2/3 vers le bas de la barre de défilement, vous pouvez modéliser cette action en appelant SeekRowApprox et en transmettant une valeur fractionnaire équivalente à l’aide de ulNumerator et ulDenominator. La recherche SeekRowApprox est toujours absolue à partir du début de la table. Pour atteindre la fin de la table, les valeurs dans ulNumerator et ulDenominator doivent être identiques .
Utilisez le schéma numérique approprié. Autrement dit, pour rechercher une position à mi-chemin dans la table, vous pouvez spécifier 1/2, 10/20 ou 50/100.