Enumeração OLECMDID (docobj.h)
Especifica qual comando padrão deve ser executado. Um único valor dessa enumeração é passado no argumento 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_OPENValor: 1 Menu Arquivo, Comando Abrir |
OLECMDID_NEWValor: 2 Menu Arquivo , Novo comando |
OLECMDID_SAVEValor: 3 Menu Arquivo, comando Salvar |
OLECMDID_SAVEASValor: 4 Menu Arquivo, comando Salvar como |
OLECMDID_SAVECOPYASValor: 5 Menu Arquivo, comando Salvar Copiar como |
OLECMDID_PRINTValor: 6 Menu Arquivo, comando Imprimir |
OLECMDID_PRINTPREVIEWValor: 7 Menu Arquivo, comando Visualização de Impressão |
OLECMDID_PAGESETUPValor: 8 Menu Arquivo, comando Configuração de Página |
OLECMDID_SPELLValor: 9 Menu Ferramentas, comando Ortografia |
OLECMDID_PROPERTIESValor: 10 Menu Arquivo, comando Propriedades |
OLECMDID_CUTValor: 11 Menu Editar, comando Recortar |
OLECMDID_COPYValor: 12 Menu Editar, comando Copiar |
OLECMDID_PASTEValor: 13 Menu Editar, comando Colar |
OLECMDID_PASTESPECIALValor: 14 Menu Editar, comando Colar Especial |
OLECMDID_UNDOValor: 15 Menu Editar, comando Desfazer |
OLECMDID_REDOValor: 16 Menu Editar, comando Refazer |
OLECMDID_SELECTALLValor: 17 Menu Editar, comando Selecionar Tudo |
OLECMDID_CLEARSELECTIONValor: 18 Menu Editar, comando Limpar |
OLECMDID_ZOOMValor: 19 Menu Exibir , comando Zoom (veja abaixo para obter detalhes.) |
OLECMDID_GETZOOMRANGEValor: 20 Recupera o intervalo de zoom aplicável ao Zoom de Exibição (veja abaixo para obter detalhes.) |
OLECMDID_UPDATECOMMANDSValor: 21 Informa o receptor, geralmente um quadro, de alterações de estado. Em seguida, o receptor pode consultar o status dos comandos sempre que for conveniente. |
OLECMDID_REFRESHValor: 22 Solicita que o receptor atualize sua exibição. Implementado pelo documento/objeto. |
OLECMDID_STOPValor: 23 Interrompe todo o processamento atual. Implementado pelo documento/objeto. |
OLECMDID_HIDETOOLBARSValor: 24 Menu Exibir , comando Barras de ferramentas . Implementado pelo documento/objeto para ocultar suas barras de ferramentas. |
OLECMDID_SETPROGRESSMAXValor: 25 Define o valor máximo de um indicador de progresso se um pertencer ao objeto receptor, geralmente um quadro. O valor mínimo é sempre zero. |
OLECMDID_SETPROGRESSPOSValor: 26 Define o valor atual de um indicador de progresso se um pertencer ao objeto receptor, geralmente um quadro. |
OLECMDID_SETPROGRESSTEXTValor: 27 Define o texto contido em um indicador de progresso se um pertencer ao objeto receptor, geralmente um quadro. Se o receptor não tiver nenhum indicador de progresso no momento, esse texto deverá ser exibido na barra de status (se houver) como com IOleInPlaceFrame::SetStatusText. |
OLECMDID_SETTITLEValor: 28 Define o texto da barra de título do objeto receptor, geralmente um quadro. |
OLECMDID_SETDOWNLOADSTATEValor: 29 Chamado pelo objeto ao baixar o estado é alterado. Usa um parâmetro VT_BOOL, que é TRUE se o objeto estiver baixando dados e FALSE se não estiver. Implementado principalmente pelo quadro. |
OLECMDID_STOPDOWNLOADValor: 30 Interrompe o download quando executado. Normalmente, esse comando é propagado para todos os objetos contidos. Quando consultado, define MSOCMDF_ENABLED. Implementado pelo documento/objeto. |
OLECMDID_ONTOOLBARACTIVATEDValor: 31 |
OLECMDID_FINDValor: 32 Menu Editar, comando Localizar |
OLECMDID_DELETEValor: 33 Menu Editar, comando Excluir |
OLECMDID_HTTPEQUIVValor: 34 Emitido em resposta à metatag HTTP-EQUIV e resulta em uma chamada para o método OnHttpEquiv preterido com o parâmetro fDone definido como false. Esse comando usa um parâmetro VT_BSTR que é passado para OnHttpEquiv. |
OLECMDID_HTTPEQUIV_DONEValor: 35 Emitido em resposta à metatag HTTP-EQUIV e resulta em uma chamada para o método OnHttpEquiv preterido com o parâmetro fDone definido como true. Esse comando usa um parâmetro VT_BSTR que é passado para OnHttpEquiv. |
OLECMDID_ENABLE_INTERACTIONValor: 36 Pausa ou retoma a interação do receptor. Esse comando usa um parâmetro VT_BOOL que pausa a interação quando definido como FALSE e retoma a interação quando definido como TRUE. |
OLECMDID_ONUNLOADValor: 37 Notifica o receptor de uma intenção de fechar a janela iminentemente. Esse comando usa um parâmetro de saída VT_BOOL que retorna TRUE se o receptor puder fechar e FALSE se não puder. |
OLECMDID_PROPERTYBAG2Valor: 38 Esse comando não tem efeito. |
OLECMDID_PREREFRESHValor: 39 Notifica o receptor de que uma atualização está prestes a ser iniciada. |
OLECMDID_SHOWSCRIPTERRORValor: 40 Informa ao receptor para exibir a mensagem de erro de script. |
OLECMDID_SHOWMESSAGEValor: 41 Esse comando usa um parâmetro de entrada IHTMLEventObj que contém uma mensagem que o receptor mostra. |
OLECMDID_SHOWFINDValor: 42 Informa ao receptor para mostrar a caixa de diálogo Localizar. Ele usa um parâmetro de entrada VT_DISPATCH . |
OLECMDID_SHOWPAGESETUPValor: 43 Informa ao receptor para mostrar a caixa de diálogo Configuração de Página. Ele usa um parâmetro de entrada IHTMLEventObj2 . |
OLECMDID_SHOWPRINTValor: 44 Informa ao receptor para mostrar a caixa de diálogo Imprimir. Ele usa um parâmetro de entrada IHTMLEventObj2 . |
OLECMDID_CLOSEValor: 45 O comando exit para o menu Arquivo. |
OLECMDID_ALLOWUILESSSAVEASValor: 46 Dá suporte ao método QueryStatus . |
OLECMDID_DONTDOWNLOADCSSValor: 47 Notifica o receptor de que os arquivos CSS não devem ser baixados quando estiverem no DesignMode. |
OLECMDID_UPDATEPAGESTATUSValor: 48 Esse comando não tem efeito. |
OLECMDID_PRINT2Valor: 49 Menu Arquivo , comando Imprimir atualizado |
OLECMDID_PRINTPREVIEW2Valor: 50 Menu Arquivo , comando Visualização de Impressão atualizado |
OLECMDID_SETPRINTTEMPLATEValor: 51 Define um valor de Modelo de Impressão explícito de TRUE ou FALSE, com base em um parâmetro de entrada VT_BOOL . |
OLECMDID_GETPRINTTEMPLATEValor: 52 Obtém um parâmetro de saída VT_BOOL indicando se o valor do Modelo de Impressão é VERDADEIRO ou FALSO. |
OLECMDID_PAGEACTIONBLOCKEDValor: 55 Indica que uma ação de página foi bloqueada. PAGEACTIONBLOCKED foi projetado para uso com aplicativos que hospedam o controle WebBrowser do Explorer internet para implementar sua própria interface do usuário. |
OLECMDID_PAGEACTIONUIQUERYValor: 56 Especifica quais ações são exibidas na faixa de notificação Explorer internet. |
OLECMDID_FOCUSVIEWCONTROLSValor: 57 Faz com que o controle WebBrowser da Internet Explorer concentre sua faixa de notificação padrão. Os hosts podem enviar esse comando a qualquer momento. O valor retornado será S_OK se a banda estiver presente e estiver em foco ou S_FALSE caso contrário. |
OLECMDID_FOCUSVIEWCONTROLSQUERYValor: 58 Esse evento de notificação é fornecido para aplicativos que exibem a implementação de banda de notificação padrão do Internet Explorers. Por padrão, quando o usuário pressiona a combinação de teclas ALT-N, a Internet Explorer a trata como uma solicitação para concentrar a faixa de notificação. |
OLECMDID_SHOWPAGEACTIONMENUValor: 59 Faz com que o controle WebBrowser da Internet Explorer mostre o menu Barra de Informações. |
OLECMDID_ADDTRAVELENTRYValor: 60 Faz com que o controle WebBrowser Explorer Internet crie uma entrada no deslocamento atual do Log de Viagens. O Docobject deve implementar interfaces I TravelLogClient e IPersist , que são usadas pelo Log de Viagens à medida que processa esse comando com chamadas para GetWindowData e GetPersistID, respectivamente. |
OLECMDID_UPDATETRAVELENTRYValor: 61 Chamado quando LoadHistory é processado para atualizar o estado anterior do Docobject. Para tratamento síncrono, esse comando pode ser chamado antes de retornar da chamada LoadHistory. Para tratamento assíncrono, ele pode ser chamado posteriormente. |
OLECMDID_UPDATEBACKFORWARDSTATEValor: 62 Atualizações o estado dos botões Voltar e Avançar do navegador. |
OLECMDID_OPTICAL_ZOOMValor: 63 Internet do Windows Explorer 7 e posterior. Define o fator de zoom do navegador. Usa um parâmetro VT_I4 no intervalo de 10 a 1000 (por cento). |
OLECMDID_OPTICAL_GETZOOMRANGEValor: 64 Internet do Windows Explorer 7 e posterior. Recupera os limites mínimo e máximo de fator de zoom do navegador. Retorna um parâmetro VT_I4; o LOWORD é o fator de zoom mínimo, o HIWORD é o máximo. |
OLECMDID_WINDOWSTATECHANGEDValor: 65 Internet do Windows Explorer 7 e posterior. Notifica a Internet Explorer controle WebBrowser de alterações em estados de janela, como perder o foco ou ficar oculto ou minimizado. O host indica o que mudou definindo OLECMDID_WINDOWSTATE_FLAG sinalizadores de opção em nCmdExecOpt. |
OLECMDID_ACTIVEXINSTALLSCOPEValor: 66 Windows Internet Explorer 8 com Windows Vista. Não tem efeito com o Windows Internet Explorer 8 com o Windows XP. Notifica Trident para usar o Escopo de Instalação indicado para instalar o Controle ActiveX especificado pela ID de Classe indicada. Para obter mais informações, consulte a seção Comentários. |
OLECMDID_UPDATETRAVELENTRY_DATARECOVERYValor: 67 Internet Explorer 8. Ao contrário de OLECMDID_UPDATETRAVELENTRY, isso atualiza uma entrada do Log de Viagens que não é inicializada de um estado anterior do Docobject. Embora esse comando não seja chamado de IPersistHistory::LoadHistory, ele pode ser chamado separadamente para salvar o estado do navegador que pode ser usado posteriormente para se recuperar de uma falha. |
OLECMDID_SHOWTASKDLGValor: 68 |
OLECMDID_POPSTATEEVENTValor: 69 |
OLECMDID_VIEWPORT_MODEValor: 70 |
OLECMDID_LAYOUT_VIEWPORT_WIDTHValor: 71 |
OLECMDID_VISUAL_VIEWPORT_EXCLUDE_BOTTOMValor: 72 |
OLECMDID_USER_OPTICAL_ZOOMValor: 73 |
OLECMDID_PAGEAVAILABLEValor: 74 |
OLECMDID_GETUSERSCALABLEValor: 75 |
OLECMDID_UPDATE_CARETValor: 76 |
OLECMDID_ENABLE_VISIBILITYValor: 77 |
OLECMDID_MEDIA_PLAYBACKValor: 78 |
OLECMDID_SETFAVICONValor: 79 |
OLECMDID_SET_HOST_FULLSCREENMODEValor: 80 |
OLECMDID_EXITFULLSCREENValor: 81 |
OLECMDID_SCROLLCOMPLETEValor: 82 |
OLECMDID_ONBEFOREUNLOADValor: 83 |
OLECMDID_SHOWMESSAGE_BLOCKABLEValor: 84 |
OLECMDID_SHOWTASKDLG_BLOCKABLEValor: 85 |
Comentários
Na tecnologia Documentos Compostos OLE, um objeto que está sendo editado in-loco desabilita o controle Zoom em sua barra de ferramentas e o comando Zoom em seu menu Exibir , pois o comando Zoom se aplica logicamente ao documento do contêiner, não ao objeto . Os comandos OLECMDID_ZOOM e OLECMDID_GETZOOMRANGE notificam o objeto de quadro do contêiner do intervalo de zoom que ele deve usar para exibir um objeto de documento em sua interface do usuário. O quadro de contêiner é o objeto do lado do cliente que implementa IOleInPlaceFrame e, opcionalmente, IOleCommandTarget.
O comando OLECMDID_ZOOM usa um argumento LONG como entrada e grava um argumento LONG na saída. Esse comando é usado para três finalidades:
- Para consultar o valor de zoom atual. O chamador de IOleCommandTarget::Exec passa OLECMDEXECOPT_DONTPROMPTUSER como a opção execute em nCmdExecOpt e NULL para pvIn. O objeto retorna o valor de zoom atual em pvaOut. Quando o objeto fica ativo na interface do usuário, ele recupera o valor de zoom atual do objeto de quadro do contêiner usando esse mesmo mecanismo e atualiza seu controle de zoom com o valor retornado.
- Para exibir a caixa de diálogo Zoom . O chamador de IOleCommandTarget::Exec passa OLECMDEXECOPT_PROMPTUSER em nCmdExecOpt. Opcionalmente, o chamador pode passar o valor inicial para a caixa de diálogo por meio do pvaIn; caso contrário , pvaIn deve ser NULL. Se o usuário clicar em Cancelar, o objeto retornará OLECMDERR_E_CANCELED. Se o usuário clicar em OK, o objeto passará o valor selecionado pelo usuário no pvaOut. Quando o usuário escolhe o comando Zoom no menu Exibir , o objeto chama o objeto de quadro do contêiner da mesma maneira. Em seguida, o contêiner amplia o documento para o valor selecionado pelo usuário e o objeto atualiza seu controle Zoom com esse valor.
- Para definir um valor zoom . O chamador de IOleCommandTarget::Exec passa OLECMDEXECOPT_DONTPROMPTUSER em nCmdExecOpt e passa o valor de zoom a ser aplicado por meio de pvaIn. O objeto valida e normaliza o novo valor e retorna o valor validado em pvaOut. Quando o usuário seleciona um novo valor de zoom (usando o controle Zoom na barra de ferramentas, por exemplo), o objeto chama o objeto de quadro do contêiner dessa maneira. O contêiner amplia o documento para 100%, e o objeto atualiza o controle Zoom com esse valor.
O comando OLECMDID_ACTIVEXINSTALLSCOPE notifica Trident para usar o Escopo de Instalação indicado para instalar o Controle ActiveX especificado pela ID de classe indicada. O Escopo de Instalação é passado em um VT_ARRAY no pvaIn do método IOleCommandTarget::Exec cujos elementos são os seguintes.
| Dados | Tipo de VARIANTE | Índice |
|---|---|---|
| ID da Classe | VT_BSTR | 0 |
| Escopo de instalação | VT_UI4 | 1 |
O Escopo de Instalação deve ser um dos valores a seguir.
| Valor | Descrição |
|---|---|
| INSTALL_SCOPE_USERS | O controle ActiveX deve registrar-se no HKCU e somente para o usuário instantâneo. |
| INSTALL_SCOPE_MACHINE | O controle ActiveX deve registrar-se no HKLM e em todo o computador |
Veja a seguir um exemplo de uso do comando 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
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 2000 Professional [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows 2000 Server [somente aplicativos da área de trabalho] |
| Cabeçalho | docobj.h |
Confira também
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de