Compartilhar via

Enumeração OLECMDID (docobj.h)

  • Artigo

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_OPEN
Valor: 1
Menu Arquivo, Comando Abrir
OLECMDID_NEW
Valor: 2
Menu Arquivo , Novo comando
OLECMDID_SAVE
Valor: 3
Menu Arquivo, comando Salvar
OLECMDID_SAVEAS
Valor: 4
Menu Arquivo, comando Salvar como
OLECMDID_SAVECOPYAS
Valor: 5
Menu Arquivo, comando Salvar Copiar como
OLECMDID_PRINT
Valor: 6
Menu Arquivo, comando Imprimir
OLECMDID_PRINTPREVIEW
Valor: 7
Menu Arquivo, comando Visualização de Impressão
OLECMDID_PAGESETUP
Valor: 8
Menu Arquivo, comando Configuração de Página
OLECMDID_SPELL
Valor: 9
Menu Ferramentas, comando Ortografia
OLECMDID_PROPERTIES
Valor: 10
Menu Arquivo, comando Propriedades
OLECMDID_CUT
Valor: 11
Menu Editar, comando Recortar
OLECMDID_COPY
Valor: 12
Menu Editar, comando Copiar
OLECMDID_PASTE
Valor: 13
Menu Editar, comando Colar
OLECMDID_PASTESPECIAL
Valor: 14
Menu Editar, comando Colar Especial
OLECMDID_UNDO
Valor: 15
Menu Editar, comando Desfazer
OLECMDID_REDO
Valor: 16
Menu Editar, comando Refazer
OLECMDID_SELECTALL
Valor: 17
Menu Editar, comando Selecionar Tudo
OLECMDID_CLEARSELECTION
Valor: 18
Menu Editar, comando Limpar
OLECMDID_ZOOM
Valor: 19
Menu Exibir , comando Zoom (veja abaixo para obter detalhes.)
OLECMDID_GETZOOMRANGE
Valor: 20
Recupera o intervalo de zoom aplicável ao Zoom de Exibição (veja abaixo para obter detalhes.)
OLECMDID_UPDATECOMMANDS
Valor: 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_REFRESH
Valor: 22
Solicita que o receptor atualize sua exibição. Implementado pelo documento/objeto.
OLECMDID_STOP
Valor: 23
Interrompe todo o processamento atual. Implementado pelo documento/objeto.
OLECMDID_HIDETOOLBARS
Valor: 24
Menu Exibir , comando Barras de ferramentas . Implementado pelo documento/objeto para ocultar suas barras de ferramentas.
OLECMDID_SETPROGRESSMAX
Valor: 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_SETPROGRESSPOS
Valor: 26
Define o valor atual de um indicador de progresso se um pertencer ao objeto receptor, geralmente um quadro.
OLECMDID_SETPROGRESSTEXT
Valor: 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_SETTITLE
Valor: 28
Define o texto da barra de título do objeto receptor, geralmente um quadro.
OLECMDID_SETDOWNLOADSTATE
Valor: 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_STOPDOWNLOAD
Valor: 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_ONTOOLBARACTIVATED
Valor: 31
OLECMDID_FIND
Valor: 32
Menu Editar, comando Localizar
OLECMDID_DELETE
Valor: 33
Menu Editar, comando Excluir
OLECMDID_HTTPEQUIV
Valor: 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_DONE
Valor: 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_INTERACTION
Valor: 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_ONUNLOAD
Valor: 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_PROPERTYBAG2
Valor: 38
Esse comando não tem efeito.
OLECMDID_PREREFRESH
Valor: 39
Notifica o receptor de que uma atualização está prestes a ser iniciada.
OLECMDID_SHOWSCRIPTERROR
Valor: 40
Informa ao receptor para exibir a mensagem de erro de script.
OLECMDID_SHOWMESSAGE
Valor: 41
Esse comando usa um parâmetro de entrada IHTMLEventObj que contém uma mensagem que o receptor mostra.
OLECMDID_SHOWFIND
Valor: 42
Informa ao receptor para mostrar a caixa de diálogo Localizar. Ele usa um parâmetro de entrada VT_DISPATCH .
OLECMDID_SHOWPAGESETUP
Valor: 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_SHOWPRINT
Valor: 44
Informa ao receptor para mostrar a caixa de diálogo Imprimir. Ele usa um parâmetro de entrada IHTMLEventObj2 .
OLECMDID_CLOSE
Valor: 45
O comando exit para o menu Arquivo.
OLECMDID_ALLOWUILESSSAVEAS
Valor: 46
Dá suporte ao método QueryStatus .
OLECMDID_DONTDOWNLOADCSS
Valor: 47
Notifica o receptor de que os arquivos CSS não devem ser baixados quando estiverem no DesignMode.
OLECMDID_UPDATEPAGESTATUS
Valor: 48
Esse comando não tem efeito.
OLECMDID_PRINT2
Valor: 49
Menu Arquivo , comando Imprimir atualizado
OLECMDID_PRINTPREVIEW2
Valor: 50
Menu Arquivo , comando Visualização de Impressão atualizado
OLECMDID_SETPRINTTEMPLATE
Valor: 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_GETPRINTTEMPLATE
Valor: 52
Obtém um parâmetro de saída VT_BOOL indicando se o valor do Modelo de Impressão é VERDADEIRO ou FALSO.
OLECMDID_PAGEACTIONBLOCKED
Valor: 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_PAGEACTIONUIQUERY
Valor: 56
Especifica quais ações são exibidas na faixa de notificação Explorer internet.
OLECMDID_FOCUSVIEWCONTROLS
Valor: 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_FOCUSVIEWCONTROLSQUERY
Valor: 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_SHOWPAGEACTIONMENU
Valor: 59
Faz com que o controle WebBrowser da Internet Explorer mostre o menu Barra de Informações.
OLECMDID_ADDTRAVELENTRY
Valor: 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_UPDATETRAVELENTRY
Valor: 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_UPDATEBACKFORWARDSTATE
Valor: 62
Atualizações o estado dos botões Voltar e Avançar do navegador.
OLECMDID_OPTICAL_ZOOM
Valor: 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_GETZOOMRANGE
Valor: 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_WINDOWSTATECHANGED
Valor: 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_ACTIVEXINSTALLSCOPE
Valor: 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_DATARECOVERY
Valor: 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_SHOWTASKDLG
Valor: 68
OLECMDID_POPSTATEEVENT
Valor: 69
OLECMDID_VIEWPORT_MODE
Valor: 70
OLECMDID_LAYOUT_VIEWPORT_WIDTH
Valor: 71
OLECMDID_VISUAL_VIEWPORT_EXCLUDE_BOTTOM
Valor: 72
OLECMDID_USER_OPTICAL_ZOOM
Valor: 73
OLECMDID_PAGEAVAILABLE
Valor: 74
OLECMDID_GETUSERSCALABLE
Valor: 75
OLECMDID_UPDATE_CARET
Valor: 76
OLECMDID_ENABLE_VISIBILITY
Valor: 77
OLECMDID_MEDIA_PLAYBACK
Valor: 78
OLECMDID_SETFAVICON
Valor: 79
OLECMDID_SET_HOST_FULLSCREENMODE
Valor: 80
OLECMDID_EXITFULLSCREEN
Valor: 81
OLECMDID_SCROLLCOMPLETE
Valor: 82
OLECMDID_ONBEFOREUNLOAD
Valor: 83
OLECMDID_SHOWMESSAGE_BLOCKABLE
Valor: 84
OLECMDID_SHOWTASKDLG_BLOCKABLE
Valor: 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_GETZOOMRANGE é usado para determinar o intervalo de valores de zoom válidos de um objeto que implementa IOleCommandTarget. O chamador passa MSOCMDEXECOPT_DONTPROMPTUSER em nCmdExecOpt e NULL para pvaIn. O objeto retorna seu intervalo de zoom em pvaOut , onde HIWORD contém o valor máximo de zoom e LOWORD contém o valor mínimo de zoom. Normalmente, esse comando é usado quando o usuário descarta o controle Zoom na barra de ferramentas do objeto ativo da interface do usuário. Os aplicativos e objetos que dão suporte a esse comando são necessários para dar suporte a todos os valores integrais de zoom que estão dentro do par (min,max) que retornam.

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

IOleCommandTarget

IOleCommandTarget::Exec

Ioleinplaceframe