OleUIConvertA, fonction (oledlg.h)
Appelle la boîte de dialogue Convertir standard, ce qui permet à l’utilisateur de modifier le type d’un seul objet spécifié ou le type de tous les objets OLE de la classe de l’objet spécifié.
Syntaxe
UINT OleUIConvertA(
[in] LPOLEUICONVERTA unnamedParam1
);
Paramètres
[in] unnamedParam1
Pointeur vers une structure OLEUICONVERT qui contient les informations utilisées pour initialiser la boîte de dialogue.
Valeur retournée
Définitions de réussite/d’erreur standard
| Code de retour | Description |
|---|---|
|
Échec inconnu (inutilisé). |
|
L’utilisateur a appuyé sur le bouton OK. |
|
Aucune erreur, identique à OLEUI_OK. |
|
L’utilisateur a appuyé sur le bouton Annuler. |
Erreurs de validation de champ standard
| Code de retour | Description |
|---|---|
|
Les erreurs communes à 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. |
|
Le pointeur vers une structure OLEUIXXX passée dans la fonction était NULL. |
|
Autorisations insuffisantes pour l’accès en lecture ou en écriture à une structure OLEUIXXX. |
|
La valeur cbstruct est incorrecte. |
|
La valeur hWndOwner n’est pas valide. |
|
La valeur lpszCaption n’est pas valide. |
|
La valeur lpfnHook n’est pas valide. |
|
La valeur hInstance n’est pas valide. |
|
La valeur lpszTemplate n’est pas valide. |
|
La valeur hResource n’est pas valide. |
Erreurs d’initialisation
| Code de retour | Description |
|---|---|
|
Impossible de trouver le modèle de boîte de dialogue. |
|
Impossible de charger le modèle de boîte de dialogue. |
|
Échec de l’initialisation de la boîte de dialogue. |
|
Un appel à LocalAlloc ou à l’allocator IMalloc standard a échoué. |
|
Un appel à GlobalAlloc ou à l’allocateur IMalloc standard a échoué. |
|
Impossible d’appeler LoadString pour les ressources localisées à partir de la bibliothèque. |
|
Un appel à l’allocateur IMalloc standard a échoué. |
Erreurs spécifiques à la fonction
| Code de retour | Description |
|---|---|
|
Les erreurs communes à 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. |
|
Une valeur de clsid n’est pas valide. |
|
La valeur dvAspect n’était pas valide. Ce membre spécifie l’aspect de l’objet . |
|
La valeur wFormat n’était pas valide. Ce membre spécifie le format de données de l’objet . |
|
Une valeur de chaîne (par exemple, lpszUserType ou lpszDefLabel) n’était pas valide. |
Remarques
OleUIConvert remplit la zone de liste de la boîte de dialogue Convertir avec des classes d’objets en parcourant le Registre et en recherchant des entrées dans les clés Readable et ReadWritable. 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 Activer en tant que. 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 la liste Activer en tant que s’affiche lorsque l’option Activer sous 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 mise à la disposition de l’utilisateur que si OleUICanConvertOrActivateAs retourne S_OK.
Notes
L’en-tête oledlg.h définit OLEUICONVERT en tant qu’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. La combinaison 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.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 2000 Professionnel [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows 2000 Server [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | oledlg.h |
| Bibliothèque | OleDlg.lib |
| DLL | OleDlg.dll |