IMAPIFormMgr::SelectForm
S’applique à : Outlook 2013 | Outlook 2016
Présente une boîte de dialogue qui permet à l’utilisateur de sélectionner un formulaire et retourne un objet d’informations de formulaire qui décrit ce formulaire.
HRESULT SelectForm(
ULONG_PTR ulUIParam,
ULONG ulFlags,
LPCSTR pszTitle,
LPMAPIFOLDER pfld,
LPMAPIFORMINFO FAR * ppfrminfoReturned
);
Paramètres
ulUIParam
[in] Handle de la fenêtre parente de la boîte de dialogue affichée.
ulFlags
[in] Masque de bits d’indicateurs qui contrôle le type des chaînes passées. L’indicateur suivant peut être défini :
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.
pszTitle
[in] Pointeur vers une chaîne qui contient les légende de la boîte de dialogue. Si le paramètre pszTitle a la valeur NULL, le fournisseur de bibliothèque de formulaires fournit une légende par défaut.
pfld
[in] Pointeur vers le dossier à partir duquel sélectionner le formulaire. Si le paramètre pfld a la valeur NULL, le formulaire peut être sélectionné à partir du conteneur de formulaire local, personnel ou organization.
ppfrminfoReturned
[out] Pointeur vers un pointeur vers l’objet d’informations de formulaire retourné.
Valeur renvoyée
S_OK
L'appel a r�ussi et a renvoy� la valeur attendue ou les valeurs.
MAPI_E_BAD_CHARWIDTH
Soit l’indicateur MAPI_UNICODE a été défini et l’implémentation ne prend pas en charge Unicode, soit MAPI_UNICODE n’a pas été défini et l’implémentation prend uniquement en charge Unicode.
MAPI_E_USER_CANCEL
L’utilisateur a annulé l’opération, généralement en cliquant sur le bouton Annuler dans la boîte de dialogue.
Remarques
Les visionneuses de formulaires appellent la méthode IMAPIFormMgr ::SelectForm pour présenter d’abord une boîte de dialogue qui permet à l’utilisateur de sélectionner un formulaire, puis de récupérer un objet d’informations de formulaire qui décrit le formulaire sélectionné. La boîte de dialogue contraint l’utilisateur à sélectionner un formulaire unique.
Remarques pour les appelants
La boîte de dialogue Sélectionnerform affiche uniquement les formulaires qui ne sont pas masqués (autrement dit, les formulaires dont les propriétés masquées sont effacées). Si une visionneuse de formulaires transmet l’indicateur MAPI_UNICODE dans le paramètre ulFlags , toutes les chaînes sont Unicode. Les fournisseurs de bibliothèques de formulaires qui ne prennent pas en charge les chaînes Unicode doivent retourner MAPI_E_BAD_CHARWIDTH si MAPI_UNICODE est passé.
Référence MFCMAPI
Pour voir un exemple de code MFCMAPI, consultez le tableau suivant.
| Fichier | Fonction | Commentaire |
|---|---|---|
| FolderDlg.cpp |
CFolderDlg ::OnSelectForm |
MFCMAPI utilise la méthode IMAPIFormMgr ::SelectForm pour sélectionner un formulaire et envoyer des informations sur le formulaire à un ou plusieurs journaux. |