Énumération OLECMDID (docobj.h)

Article
08/23/2023

Spécifie la commande standard à exécuter. Une valeur unique de cette énumération est passée dans l’argument nCmdID de IOleCommandTarget ::Exec.

Syntax

typedef enum OLECMDID {
  OLECMDID_OPEN = 1,
  OLECMDID_NEW = 2,
  OLECMDID_SAVE = 3,
  OLECMDID_SAVEAS = 4,
  OLECMDID_SAVECOPYAS = 5,
  OLECMDID_PRINT = 6,
  OLECMDID_PRINTPREVIEW = 7,
  OLECMDID_PAGESETUP = 8,
  OLECMDID_SPELL = 9,
  OLECMDID_PROPERTIES = 10,
  OLECMDID_CUT = 11,
  OLECMDID_COPY = 12,
  OLECMDID_PASTE = 13,
  OLECMDID_PASTESPECIAL = 14,
  OLECMDID_UNDO = 15,
  OLECMDID_REDO = 16,
  OLECMDID_SELECTALL = 17,
  OLECMDID_CLEARSELECTION = 18,
  OLECMDID_ZOOM = 19,
  OLECMDID_GETZOOMRANGE = 20,
  OLECMDID_UPDATECOMMANDS = 21,
  OLECMDID_REFRESH = 22,
  OLECMDID_STOP = 23,
  OLECMDID_HIDETOOLBARS = 24,
  OLECMDID_SETPROGRESSMAX = 25,
  OLECMDID_SETPROGRESSPOS = 26,
  OLECMDID_SETPROGRESSTEXT = 27,
  OLECMDID_SETTITLE = 28,
  OLECMDID_SETDOWNLOADSTATE = 29,
  OLECMDID_STOPDOWNLOAD = 30,
  OLECMDID_ONTOOLBARACTIVATED = 31,
  OLECMDID_FIND = 32,
  OLECMDID_DELETE = 33,
  OLECMDID_HTTPEQUIV = 34,
  OLECMDID_HTTPEQUIV_DONE = 35,
  OLECMDID_ENABLE_INTERACTION = 36,
  OLECMDID_ONUNLOAD = 37,
  OLECMDID_PROPERTYBAG2 = 38,
  OLECMDID_PREREFRESH = 39,
  OLECMDID_SHOWSCRIPTERROR = 40,
  OLECMDID_SHOWMESSAGE = 41,
  OLECMDID_SHOWFIND = 42,
  OLECMDID_SHOWPAGESETUP = 43,
  OLECMDID_SHOWPRINT = 44,
  OLECMDID_CLOSE = 45,
  OLECMDID_ALLOWUILESSSAVEAS = 46,
  OLECMDID_DONTDOWNLOADCSS = 47,
  OLECMDID_UPDATEPAGESTATUS = 48,
  OLECMDID_PRINT2 = 49,
  OLECMDID_PRINTPREVIEW2 = 50,
  OLECMDID_SETPRINTTEMPLATE = 51,
  OLECMDID_GETPRINTTEMPLATE = 52,
  OLECMDID_PAGEACTIONBLOCKED = 55,
  OLECMDID_PAGEACTIONUIQUERY = 56,
  OLECMDID_FOCUSVIEWCONTROLS = 57,
  OLECMDID_FOCUSVIEWCONTROLSQUERY = 58,
  OLECMDID_SHOWPAGEACTIONMENU = 59,
  OLECMDID_ADDTRAVELENTRY = 60,
  OLECMDID_UPDATETRAVELENTRY = 61,
  OLECMDID_UPDATEBACKFORWARDSTATE = 62,
  OLECMDID_OPTICAL_ZOOM = 63,
  OLECMDID_OPTICAL_GETZOOMRANGE = 64,
  OLECMDID_WINDOWSTATECHANGED = 65,
  OLECMDID_ACTIVEXINSTALLSCOPE = 66,
  OLECMDID_UPDATETRAVELENTRY_DATARECOVERY = 67,
  OLECMDID_SHOWTASKDLG = 68,
  OLECMDID_POPSTATEEVENT = 69,
  OLECMDID_VIEWPORT_MODE = 70,
  OLECMDID_LAYOUT_VIEWPORT_WIDTH = 71,
  OLECMDID_VISUAL_VIEWPORT_EXCLUDE_BOTTOM = 72,
  OLECMDID_USER_OPTICAL_ZOOM = 73,
  OLECMDID_PAGEAVAILABLE = 74,
  OLECMDID_GETUSERSCALABLE = 75,
  OLECMDID_UPDATE_CARET = 76,
  OLECMDID_ENABLE_VISIBILITY = 77,
  OLECMDID_MEDIA_PLAYBACK = 78,
  OLECMDID_SETFAVICON = 79,
  OLECMDID_SET_HOST_FULLSCREENMODE = 80,
  OLECMDID_EXITFULLSCREEN = 81,
  OLECMDID_SCROLLCOMPLETE = 82,
  OLECMDID_ONBEFOREUNLOAD = 83,
  OLECMDID_SHOWMESSAGE_BLOCKABLE = 84,
  OLECMDID_SHOWTASKDLG_BLOCKABLE = 85
} ;

Constantes


`OLECMDID_OPEN` Valeur : 1 Menu Fichier, commande Ouvrir
`OLECMDID_NEW` Valeur : 2 Menu Fichier, commande Nouveau
`OLECMDID_SAVE` Valeur : 3 Menu Fichier, commande Enregistrer
`OLECMDID_SAVEAS` Valeur : 4 Menu Fichier, commande Enregistrer sous
`OLECMDID_SAVECOPYAS` Valeur : 5 Menu Fichier, commande Enregistrer la copie sous
`OLECMDID_PRINT` Valeur : 6 Menu Fichier, commande Imprimer
`OLECMDID_PRINTPREVIEW` Valeur : 7 Menu Fichier, commande Aperçu avant impression
`OLECMDID_PAGESETUP` Valeur : 8 Menu Fichier, commande Mise en page
`OLECMDID_SPELL` Valeur : 9 Menu Outils, commande Orthographe
`OLECMDID_PROPERTIES` Valeur : 10 Menu Fichier, commande Propriétés
`OLECMDID_CUT` Valeur : 11 Menu Modifier, commande Couper
`OLECMDID_COPY` Valeur : 12 Menu Modifier, commande Copier
`OLECMDID_PASTE` Valeur : 13 Menu Modifier, commande Coller
`OLECMDID_PASTESPECIAL` Valeur : 14 Menu Modifier, commande Coller spécial
`OLECMDID_UNDO` Valeur : 15 Menu Modifier, commande Annuler
`OLECMDID_REDO` Valeur : 16 Menu Modifier, commande Rétablir
`OLECMDID_SELECTALL` Valeur : 17 Menu Modifier, commande Sélectionner tout
`OLECMDID_CLEARSELECTION` Valeur : 18 Menu Modifier, commande Effacer
`OLECMDID_ZOOM` Valeur : 19 Menu Affichage , commande Zoom (voir ci-dessous pour plus d’informations).)
`OLECMDID_GETZOOMRANGE` Valeur : 20 Récupère la plage de zoom applicable au zoom d’affichage (voir ci-dessous pour plus d’informations).)
`OLECMDID_UPDATECOMMANDS` Valeur : 21 Informe le récepteur, généralement une trame, des changements d’état. Le récepteur peut ensuite interroger la status des commandes chaque fois que cela est pratique.
`OLECMDID_REFRESH` Valeur : 22 Demande au récepteur d’actualiser son affichage. Implémenté par le document/objet.
`OLECMDID_STOP` Valeur : 23 Arrête tout traitement en cours. Implémenté par le document/objet.
`OLECMDID_HIDETOOLBARS` Valeur : 24 Menu Affichage , commande Barres d’outils . Implémenté par le document/objet pour masquer ses barres d’outils.
`OLECMDID_SETPROGRESSMAX` Valeur : 25 Définit la valeur maximale d’un indicateur de progression s’il appartient à l’objet récepteur, généralement un frame. La valeur minimale est toujours égale à zéro.
`OLECMDID_SETPROGRESSPOS` Valeur : 26 Définit la valeur actuelle d’un indicateur de progression s’il appartient à l’objet récepteur, généralement un frame.
`OLECMDID_SETPROGRESSTEXT` Valeur : 27 Définit le texte contenu dans un indicateur de progression s’il appartient à l’objet récepteur, généralement un cadre. Si le récepteur n’a actuellement aucun indicateur de progression, ce texte doit être affiché dans la barre de status (le cas échéant) comme avec IOleInPlaceFrame ::SetStatusText.
`OLECMDID_SETTITLE` Valeur : 28 Définit le texte de la barre de titre de l’objet récepteur, généralement un cadre.
`OLECMDID_SETDOWNLOADSTATE` Valeur : 29 Appelé par l’objet lors du téléchargement des modifications d’état. Prend un paramètre VT_BOOL, qui est TRUE si l’objet télécharge des données et FALSE si ce n’est pas le cas. Principalement implémenté par le frame.
`OLECMDID_STOPDOWNLOAD` Valeur : 30 Arrête le téléchargement lorsqu’il est exécuté. En règle générale, cette commande est propagée à tous les objets contenus. Lorsqu’il est interrogé, définit MSOCMDF_ENABLED. Implémenté par le document/objet.
`OLECMDID_ONTOOLBARACTIVATED` Valeur : 31
`OLECMDID_FIND` Valeur : 32 Menu Modifier, commande Rechercher
`OLECMDID_DELETE` Valeur : 33 Menu Modifier, commande Supprimer
`OLECMDID_HTTPEQUIV` Valeur : 34 Émis en réponse à la métatag HTTP-EQUIV et entraînent un appel à la méthode OnHttpEquiv dépréciée avec le paramètre fDone défini sur false. Cette commande prend un paramètre VT_BSTR qui est passé à OnHttpEquiv.
`OLECMDID_HTTPEQUIV_DONE` Valeur : 35 Émis en réponse à la métatag HTTP-EQUIV et entraînent un appel à la méthode OnHttpEquiv dépréciée avec le paramètre fDone défini sur true. Cette commande prend un paramètre VT_BSTR qui est passé à OnHttpEquiv.
`OLECMDID_ENABLE_INTERACTION` Valeur : 36 Suspend ou reprend l’interaction du récepteur. Cette commande prend un paramètre VT_BOOL qui interrompt l’interaction lorsqu’elle est définie sur FALSE et reprend l’interaction lorsqu’elle est définie sur TRUE.
`OLECMDID_ONUNLOAD` Valeur : 37 Avertit le récepteur d’une intention de fermer la fenêtre de façon imminente. Cette commande prend un paramètre de sortie VT_BOOL qui retourne TRUE si le récepteur peut se fermer et FALSE si ce n’est pas le cas.
`OLECMDID_PROPERTYBAG2` Valeur : 38 Cette commande n’a aucun effet.
`OLECMDID_PREREFRESH` Valeur : 39 Avertit le destinataire qu’une actualisation est sur le point de démarrer.
`OLECMDID_SHOWSCRIPTERROR` Valeur : 40 Indique au récepteur d’afficher le message d’erreur de script.
`OLECMDID_SHOWMESSAGE` Valeur : 41 Cette commande prend un paramètre d’entrée IHTMLEventObj qui contient un message affiché par le récepteur.
`OLECMDID_SHOWFIND` Valeur : 42 Indique au récepteur d’afficher la boîte de dialogue Rechercher. Il prend un VT_DISPATCH param d’entrée.
`OLECMDID_SHOWPAGESETUP` Valeur : 43 Indique au récepteur d’afficher la boîte de dialogue Mise en page. Il prend un paramètre d’entrée IHTMLEventObj2 .
`OLECMDID_SHOWPRINT` Valeur : 44 Indique au récepteur d’afficher la boîte de dialogue Imprimer. Il prend un paramètre d’entrée IHTMLEventObj2 .
`OLECMDID_CLOSE` Valeur : 45 Commande exit pour le menu Fichier.
`OLECMDID_ALLOWUILESSSAVEAS` Valeur : 46 Prend en charge la méthode QueryStatus .
`OLECMDID_DONTDOWNLOADCSS` Valeur : 47 Avertit le destinataire que les fichiers CSS ne doivent pas être téléchargés dans DesignMode.
`OLECMDID_UPDATEPAGESTATUS` Valeur : 48 Cette commande n’a aucun effet.
`OLECMDID_PRINT2` Valeur : 49 Menu Fichier , commande Imprimer mise à jour
`OLECMDID_PRINTPREVIEW2` Valeur : 50 Menu Fichier , commande Aperçu avant impression mise à jour
`OLECMDID_SETPRINTTEMPLATE` Valeur : 51 Définit une valeur de modèle d’impression explicite true ou FALSE, en fonction d’un paramètre d’entrée VT_BOOL .
`OLECMDID_GETPRINTTEMPLATE` Valeur : 52 Obtient un paramètre de sortie VT_BOOL indiquant si la valeur Print Template est TRUE ou FALSE.
`OLECMDID_PAGEACTIONBLOCKED` Valeur : 55 Indique qu’une action de page a été bloquée. PAGEACTIONBLOCKED est conçu pour être utilisé avec des applications qui hébergent le contrôle Internet Explorer WebBrowser pour implémenter leur propre interface utilisateur.
`OLECMDID_PAGEACTIONUIQUERY` Valeur : 56 Spécifie les actions affichées dans la bande de notification Internet Explorer.
`OLECMDID_FOCUSVIEWCONTROLS` Valeur : 57 Entraîne le contrôle WebBrowser Internet Explorer à concentrer sa bande de notification par défaut. Les hôtes peuvent envoyer cette commande à tout moment. La valeur de retour est S_OK si la bande est présente et est en focus, ou S_FALSE sinon.
`OLECMDID_FOCUSVIEWCONTROLSQUERY` Valeur : 58 Cet événement de notification est fourni pour les applications qui affichent l’implémentation de la bande de notification par défaut d’Internet Explorer. Par défaut, lorsque l’utilisateur appuie sur la combinaison de touches ALT-N, Internet Explorer la traite comme une demande de focus sur la bande de notification.
`OLECMDID_SHOWPAGEACTIONMENU` Valeur : 59 Entraîne l’affichage du menu Barre d’informations par le contrôle Internet Explorer WebBrowser.
`OLECMDID_ADDTRAVELENTRY` Valeur : 60 Entraîne la création d’une entrée par le contrôle WebBrowser Internet Explorer au décalage actuel du journal de voyage. Docobject doit implémenter les interfaces ITravelLogClient et IPersist , qui sont utilisées par le journal de voyage, car il traite cette commande avec des appels à GetWindowData et GetPersistID, respectivement.
`OLECMDID_UPDATETRAVELENTRY` Valeur : 61 Appelé lorsque LoadHistory est traité pour mettre à jour l’état Docobject précédent. Pour la gestion synchrone, cette commande peut être appelée avant de retourner à partir de l’appel LoadHistory. Pour la gestion asynchrone, elle peut être appelée ultérieurement.
`OLECMDID_UPDATEBACKFORWARDSTATE` Valeur : 62 Mises à jour l’état des boutons Précédent et Précédent du navigateur.
`OLECMDID_OPTICAL_ZOOM` Valeur : 63 Windows Internet Explorer 7 et versions ultérieures. Définit le facteur de zoom du navigateur. Prend un paramètre VT_I4 dans la plage de 10 à 1 000 (pour cent).
`OLECMDID_OPTICAL_GETZOOMRANGE` Valeur : 64 Windows Internet Explorer 7 et versions ultérieures. Récupère les limites minimales et maximales du facteur de zoom du navigateur. Retourne un paramètre VT_I4 ; loWORD est le facteur de zoom minimal, hiword est le maximum.
`OLECMDID_WINDOWSTATECHANGED` Valeur : 65 Windows Internet Explorer 7 et versions ultérieures. Avertit le contrôle Internet Explorer WebBrowser des modifications apportées à l’état de la fenêtre, telles que la perte du focus, ou la perte de la mise en cache ou de la réduction. L’hôte indique ce qui a changé en définissant OLECMDID_WINDOWSTATE_FLAG indicateurs d’option dans nCmdExecOpt.
`OLECMDID_ACTIVEXINSTALLSCOPE` Valeur : 66 Windows Internet Explorer 8 avec Windows Vista. N’a aucun effet avec Windows Internet Explorer 8 avec Windows XP. Avertit Trident d’utiliser l’étendue d’installation indiquée pour installer le contrôle ActiveX spécifié par l’ID de classe indiqué. Pour plus d'informations, consultez la section Notes.
`OLECMDID_UPDATETRAVELENTRY_DATARECOVERY` Valeur : 67 Internet Explorer 8. Contrairement à OLECMDID_UPDATETRAVELENTRY, cela met à jour une entrée de journal de voyage qui n’est pas initialisée à partir d’un état Docobject précédent. Bien que cette commande ne soit pas appelée à partir de IPersistHistory ::LoadHistory, elle peut être appelée séparément pour enregistrer l’état du navigateur qui peut être utilisé ultérieurement pour récupérer après un incident.
`OLECMDID_SHOWTASKDLG` Valeur : 68
`OLECMDID_POPSTATEEVENT` Valeur : 69
`OLECMDID_VIEWPORT_MODE` Valeur : 70
`OLECMDID_LAYOUT_VIEWPORT_WIDTH` Valeur : 71
`OLECMDID_VISUAL_VIEWPORT_EXCLUDE_BOTTOM` Valeur : 72
`OLECMDID_USER_OPTICAL_ZOOM` Valeur : 73
`OLECMDID_PAGEAVAILABLE` Valeur : 74
`OLECMDID_GETUSERSCALABLE` Valeur : 75
`OLECMDID_UPDATE_CARET` Valeur : 76
`OLECMDID_ENABLE_VISIBILITY` Valeur : 77
`OLECMDID_MEDIA_PLAYBACK` Valeur : 78
`OLECMDID_SETFAVICON` Valeur : 79
`OLECMDID_SET_HOST_FULLSCREENMODE` Valeur : 80
`OLECMDID_EXITFULLSCREEN` Valeur : 81
`OLECMDID_SCROLLCOMPLETE` Valeur : 82
`OLECMDID_ONBEFOREUNLOAD` Valeur : 83
`OLECMDID_SHOWMESSAGE_BLOCKABLE` Valeur : 84
`OLECMDID_SHOWTASKDLG_BLOCKABLE` Valeur : 85

Remarques

Dans la technologie Documents composés OLE, un objet en cours de modification sur place désactive le contrôle Zoom dans sa barre d’outils et la commande Zoom dans son menu Affichage , car la commande Zoom s’applique logiquement au document conteneur, et non à l’objet. Les commandes OLECMDID_ZOOM et OLECMDID_GETZOOMRANGE informent l’objet frame du conteneur de la plage de zoom qu’il doit utiliser pour afficher un objet de document dans son interface utilisateur. Le cadre de conteneur est l’objet côté client qui implémente IOleInPlaceFrame et, éventuellement, IOleCommandTarget.

La commande OLECMDID_ZOOM prend un argument LONG comme entrée et écrit un argument LONG sur la sortie. Cette commande est utilisée à trois fins :

Pour interroger la valeur de zoom actuelle. L’appelant de IOleCommandTarget ::Exec passe OLECMDEXECOPT_DONTPROMPTUSER comme option d’exécution dans nCmdExecOpt et NULL pour pvIn. L’objet retourne la valeur de zoom actuelle dans pvaOut. Lorsque l’objet devient actif dans l’interface utilisateur, il récupère la valeur de zoom actuelle de l’objet frame du conteneur à l’aide de ce même mécanisme et met à jour son contrôle de zoom avec la valeur retournée.
Pour afficher la boîte de dialogue Zoom . L’appelant de IOleCommandTarget ::Exec passe OLECMDEXECOPT_PROMPTUSER dans nCmdExecOpt. L’appelant peut éventuellement passer la valeur initiale de la boîte de dialogue via pvaIn ; dans le cas contraire , pvaIn doit être NULL. Si l’utilisateur clique sur Annuler, l’objet retourne OLECMDERR_E_CANCELED. Si l’utilisateur clique sur OK, l’objet passe la valeur sélectionnée par l’utilisateur dans pvaOut. Lorsque l’utilisateur choisit la commande Zoom dans le menu Affichage , l’objet appelle l’objet frame du conteneur de la même manière. Le conteneur effectue ensuite un zoom sur le document sur la valeur sélectionnée par l’utilisateur, et l’objet met à jour son contrôle Zoom avec cette valeur.
Pour définir une valeur zoom . L’appelant de IOleCommandTarget ::Exec passe OLECMDEXECOPT_DONTPROMPTUSER dans nCmdExecOpt et transmet la valeur de zoom à appliquer via pvaIn. L’objet valide et normalise la nouvelle valeur et retourne la valeur validée dans pvaOut. Lorsque l’utilisateur sélectionne une nouvelle valeur de zoom (à l’aide du contrôle Zoom dans la barre d’outils, pour instance), l’objet appelle l’objet frame du conteneur de cette manière. Le conteneur effectue un zoom sur le document à 100 %, et l’objet met à jour le contrôle Zoom avec cette valeur.

La commande OLECMDID_GETZOOMRANGE permet de déterminer la plage de valeurs de zoom valides à partir d’un objet qui implémente IOleCommandTarget. L’appelant passe MSOCMDEXECOPT_DONTPROMPTUSER dans nCmdExecOpt et NULL pour pvaIn. L’objet retourne sa plage de zoom dans pvaOut , où HIWORD contient la valeur de zoom maximale et LOWORD contient la valeur de zoom minimale. En règle générale, cette commande est utilisée lorsque l’utilisateur supprime le contrôle Zoom dans la barre d’outils de l’objet actif de l’interface utilisateur. Les applications et les objets qui prennent en charge cette commande sont nécessaires pour prendre en charge toutes les valeurs de zoom intégrales qui se trouvent dans la paire (min,max) qu’elles retournent.

La commande OLECMDID_ACTIVEXINSTALLSCOPE notifie Trident d’utiliser l’étendue d’installation indiquée pour installer le contrôle ActiveX spécifié par l’ID de classe indiqué. L’étendue d’installation est passée dans un VT_ARRAY dans pvaIn de la méthode IOleCommandTarget ::Exec dont les éléments sont les suivants.

Données	Type VARIANT	Index
ID de classe	VT_BSTR	0
Étendue Install	VT_UI4	1

L’étendue d’installation doit être l’une des valeurs suivantes.

Valeur	Description
INSTALL_SCOPE_USERS	Le contrôle ActiveX doit s’inscrire auprès de HKCU et pour l’utilisateur instantané uniquement.
INSTALL_SCOPE_MACHINE	Le contrôle ActiveX doit s’inscrire à HKLM et sur l’ordinateur

Voici un exemple d’utilisation de la commande OLECMDID_ACTIVEXINSTALLSCOPE.

IOleCommandTarget::Exec(
NULL, // Pointer to command group
OLECMDARGINDEX_ACTIVEXINSTALL_INSTALLSCOPE, // ID of command to execute
NULL, // Options
&varArgs, // pvain pointer to input arguments
NULL) // pointer to command output

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]
En-tête	docobj.h

Voir aussi

IOleCommandTarget

IOleCommandTarget ::Exec

IOleInPlaceFrame