Partager via

OleUIConvertW, fonction (oledlg.h)

  • Article

Appelle la boîte de dialogue Convertir standard, ce qui permet à l’utilisateur de modifier le type d’un objet spécifié unique ou le type de tous les objets OLE de la classe de l’objet spécifié.

Syntaxe

UINT OleUIConvertW(
  [in] LPOLEUICONVERTW unnamedParam1
);

Paramètres

[in] unnamedParam1

Pointeur vers une structure OLEUICONVERT qui contient des informations utilisées pour initialiser la boîte de dialogue.

Valeur de retour

Définitions de réussite/d’erreur standard

Retourner le code Description
OLEUI_FALSE
 Échec inconnu (inutilisé).
OLEUI_OK
 L’utilisateur a appuyé sur le bouton OK.
OLEUI_SUCCESS
 Aucune erreur, identique à OLEUI_OK.
OLEUI_CANCEL
 L’utilisateur a appuyé sur le bouton Annuler.
 

Erreurs de validation de champ standard

Retourner le code Description
OLEUI_ERR_STANDARDMIN
 Les erreurs courantes dans toutes les boîtes de dialogue se trouvent dans la plage OLEUI_ERR_STANDARDMIN à OLEUI_ERR_STANDARDMAX. Cette valeur permet à l’application de tester les messages standard afin d’afficher les messages d’erreur à l’utilisateur.
OLEUI_ERR_STRUCTURENULL
 Le pointeur vers une structure OLEUIXXX passée dans la fonction était NULL.
OLEUI_ERR_STRUCTUREINVALID
 Autorisations insuffisantes pour l’accès en lecture ou en écriture à une structure OLEUIXXX.
OLEUI_ERR_CBSTRUCTINCORRECT
 La valeur cbstruct est incorrecte.
OLEUI_ERR_HWNDOWNERINVALID
 La valeur hWndOwner n’est pas valide.
OLEUI_ERR_LPSZCAPTIONINVALID
 La valeur lpszCaption n’est pas valide.
OLEUI_ERR_LPFNHOOKINVALID
 La valeur lpfnHook n’est pas valide.
OLEUI_ERR_HINSTANCEINVALID
 La valeur hInstance n’est pas valide.
OLEUI_ERR_LPSZTEMPLATEINVALID
 La valeur lpszTemplate n’est pas valide.
OLEUI_ERR_HRESOURCEINVALID
 La valeur hResource n’est pas valide.
 

Erreurs d’initialisation

Retourner le code Description
OLEUI_ERR_FINDTEMPLATEFAILURE
 Impossible de trouver le modèle de boîte de dialogue.
OLEUI_ERR_LOADTEMPLATEFAILURE
 Impossible de charger le modèle de boîte de dialogue.
OLEUI_ERR_DIALOGFAILURE
 Échec de l’initialisation de la boîte de dialogue.
OLEUI_ERR_LOCALMEMALLOC
 Un appel à localAlloc ou au IMalloc standard allocator a échoué.
OLEUI_ERR_GLOBALMEMALLOC
 Un appel à GlobalAlloc ou au IMalloc standard allocator a échoué.
OLEUI_ERR_LOADSTRING
 Impossible d’appeler LoadString pour les ressources localisées à partir de la bibliothèque.
OLEUI_ERR_OLEMEMALLOC
 Un appel à la norme IMalloc allocator a échoué.
 

Erreurs spécifiques à la fonction

Retourner le code Description
OLEUI_ERR_STANDARDMAX
 Les erreurs courantes dans toutes les boîtes de dialogue se trouvent dans la plage OLEUI_ERR_STANDARDMIN à OLEUI_ERR_STANDARDMAX. Cette valeur permet à l’application de tester les messages standard afin d’afficher les messages d’erreur à l’utilisateur.
OLEUI_CTERR_CLASSIDINVALID
 Une valeur clsid n’était pas valide.
OLEUI_CTERR_DVASPECTINVALID
 La valeur dvAspect n’était pas valide. Ce membre spécifie l’aspect de l’objet.
OLEUI_CTERR_CBFORMATINVALID
 La valeur wFormat n’était pas valide. Ce membre spécifie le format de données de l’objet.
OLEUI_CTERR_STRINGINVALID
 Une valeur de chaîne (par exemple, lpszUserType ou lpszDefLabel) n’était pas valide.

Remarques

OleUIConvert remplit la zone de liste Convertir boîte de dialogue avec des classes d’objets en parcourant le Registre et en recherchant des entrées dans les clés lisibles et lisibles. Chaque classe qui inclut le format de fichier par défaut de la classe d’origine dans sa clé lisible est ajoutée à la liste Convert, et chaque classe qui inclut le format de fichier par défaut de la classe d’origine dans sa clé ReadWritable est ajoutée à la liste Activate As. La liste Convertir s’affiche dans la zone de liste de la boîte de dialogue lorsque la case d’option Convertir est sélectionnée (sélection par défaut) et que la liste Activer en tant que s’affiche lorsque Activer en tant que est sélectionnée.

Notez que vous pouvez modifier le type de tous les objets d’une classe donnée uniquement lorsque CF_CONVERTONLY n’est pas spécifié.

La commande convert, qui appelle cette fonction, ne doit être rendue accessible à l’utilisateur que si OleUICanConvertOrActivateAs retourne S_OK.

Note

L’en-tête oledlg.h définit OLEUICONVERT comme alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Exigences

Exigence Valeur
client minimum pris en charge Windows 2000 Professionnel [applications de bureau uniquement]
serveur minimum pris en charge Windows 2000 Server [applications de bureau uniquement]
plateforme cible Windows
d’en-tête oledlg.h
bibliothèque OleDlg.lib
DLL OleDlg.dll

Voir aussi

OLEUICONVERT

oleUICanConvertOrActivateAs