IAddrBook::Details
S’applique à : Outlook 2013 | Outlook 2016
Affiche une boîte de dialogue qui affiche des détails sur une entrée de carnet d’adresses particulière.
HRESULT Details(
ULONG_PTR FAR * lpulUIParam,
LPFNDISMISS lpfnDismiss,
LPVOID lpvDismissContext,
ULONG cbEntryID,
LPENTRYID lpEntryID,
LPFNBUTTON lpfButtonCallback,
LPVOID lpvButtonContext,
LPSTR lpszButtonText,
ULONG ulFlags
);
Paramètres
lpulUIParam
[in] Pointeur vers un handle de la fenêtre parente pour la boîte de dialogue.
lpfnDismiss
[in] Pointeur vers une fonction basée sur le prototype DISMISSMODELESS , ou NULL. Ce membre s’applique uniquement à la version sans mode de la boîte de dialogue, comme indiqué par l’indicateur DIALOG_SDI défini. MAPI appelle la fonction DISMISSMODELESS lorsque l’utilisateur ferme la boîte de dialogue d’adresse sans mode, informant un client qui appelle Details que la boîte de dialogue n’est plus active.
lpvDismissContext
[in] Pointeur vers les informations de contexte à passer à la fonction DISMISSMODELESS pointée par le paramètre lpfnDismiss . Ce paramètre s’applique uniquement à la version sans mode de la boîte de dialogue, en incluant l’indicateur DIALOG_SDI dans le paramètre ulFlags .
cbEntryID
[in] Nombre d’octets dans l’identificateur d’entrée vers lequel pointe le paramètre lpEntryID .
lpEntryID
[in] Pointeur vers l’identificateur d’entrée de l’entrée pour laquelle les détails sont affichés.
lpfButtonCallback
[in] Pointeur vers une fonction basée sur le prototype de fonction LPFNBUTTON . Une fonction LPFNBUTTON ajoute un bouton à la boîte de dialogue détails.
lpvButtonContext
[in] Pointeur vers les données utilisées comme paramètre pour la fonction spécifiée par le paramètre lpfButtonCallback .
lpszButtonText
[in] Pointeur vers une chaîne qui contient du texte à appliquer au bouton ajouté, si ce bouton est extensible. Le paramètre lpszButtonText doit être NULL si vous n’avez pas besoin d’un bouton extensible.
ulFlags
[in] Masque de bits d’indicateurs qui contrôle le type du texte pour le paramètre lpszButtonText . Les indicateurs suivants peuvent être définis :
AB_TELL_DETAILS_CHANGE
Indique que Details retourne S_OK si des modifications sont réellement apportées à l’adresse ; sinon, Details retourne S_FALSE.
DIALOG_MODAL
Afficher la version modale de la boîte de dialogue d’adresse commune, qui est toujours affichée dans les clients non-Outlook. Cet indicateur s’exclue mutuellement avec DIALOG_SDI.
DIALOG_SDI
Afficher la version sans mode de la boîte de dialogue Adresse commune. Cet indicateur est ignoré pour les clients non-Outlook.
MAPI_UNICODE
Les chaînes transmises sont au format Unicode. Si l’indicateur MAPI_UNICODE n’est pas défini, les chaînes sont au format ANSI.
Valeur renvoyée
S_OK
La boîte de dialogue Détails s’est correctement affichée pour l’entrée du carnet d’adresses.
Remarques
Les applications clientes appellent la méthode Details pour afficher une boîte de dialogue qui fournit des détails sur une entrée particulière dans le carnet d’adresses. Vous pouvez utiliser les paramètres lpfButtonCallback, lpvButtonContext et lpszButtonText pour ajouter un bouton défini par le client à la boîte de dialogue. Lorsque vous cliquez sur le bouton, MAPI appelle la fonction de rappel pointée par lpfButtonCallback, en transmettant à la fois l’identificateur d’entrée du bouton et les données dans lpvButtonContext. Si vous n’avez pas besoin d’un bouton extensible, lpszButtonText doit avoir la valeur NULL.
Details prend en charge les chaînes de caractères Unicode ; Les chaînes Unicode sont converties au format MBCS (multioctet character string) avant d’être affichées dans la boîte de dialogue détails.
Référence MFCMAPI
Pour voir un exemple de code MFCMAPI, consultez le tableau suivant.
| Fichier | Fonction | Commentaire |
|---|---|---|
| BaseDialog.cpp |
CBaseDialog ::OnOpenEntryID |
MFCMAPI utilise la méthode Details pour afficher une boîte de dialogue qui affiche les détails d’une entrée de carnet d’adresses. |