Método ViewFilter.ExecCommand
Executa o comando especificado.
Namespace: Microsoft.VisualStudio.Package
Assemblies: Microsoft.VisualStudio.Package.LanguageService (em Microsoft.VisualStudio.Package.LanguageService.dll)
Microsoft.VisualStudio.Package.LanguageService.10.0 (em Microsoft.VisualStudio.Package.LanguageService.10.0.dll)
Microsoft.VisualStudio.Package.LanguageService.9.0 (em Microsoft.VisualStudio.Package.LanguageService.9.0.dll)
Microsoft.VisualStudio.Package.LanguageService.11.0 (em Microsoft.VisualStudio.Package.LanguageService.11.0.dll)
Sintaxe
'Declaração
Protected Overridable Function ExecCommand ( _
ByRef guidCmdGroup As Guid, _
nCmdId As UInteger, _
nCmdexecopt As UInteger, _
pvaIn As IntPtr, _
pvaOut As IntPtr _
) As Integer
protected virtual int ExecCommand(
ref Guid guidCmdGroup,
uint nCmdId,
uint nCmdexecopt,
IntPtr pvaIn,
IntPtr pvaOut
)
Parâmetros
- guidCmdGroup
Tipo: System.Guid%
[in] O GUID do grupo de comandos.
- nCmdId
Tipo: System.UInt32
[in] A ID específica do comando a partir do grupo de comando.Isso identifica o comando a ser executado.
- nCmdexecopt
Tipo: System.UInt32
[in] Parâmetros adicionais para o comando (incluídos em um valor de 32 bits).
- pvaIn
Tipo: System.IntPtr
[in] Um ponteiro de desempacotada para um Variant objeto mantendo quaisquer parâmetros necessários para o comando.Isso pode ser um valor nulo, indicando que não há nenhum parâmetro adicional.
- pvaOut
Tipo: System.IntPtr
[in, out] Um ponteiro de desempacotada para um Variant o objeto para reter o resultado do comando, se houver.
Valor de retorno
Tipo: System.Int32
Se bem-sucedida, retorna S_OK; Caso contrário, retorna um código de erro.
Comentários
Esse método é chamado para executar um determinado comando.Em geral, esse método deve chamar primeiro o HandlePreExec método e, em seguida, algum tipo de método de execução e, finalmente, o HandlePostExec método.Se o comando não é tratado por qualquer um desses, o comando deve ser passado para o seu próximo destino.
As chamadas de método base primeira o IsExpansionUIActive método para determinar se uma interface de usuário (UI) de expansão está ativa.Nesse caso, o método base imediatamente passa o comando para o próximo destino de comando e retorna o resultado.Caso contrário, o método base obtém o ExpansionProvider object e, se esse objeto existir, chama o HandlePreExec método.Ele o ExpansionProviderdo HandlePreExec método indica que o comando foi tratado, o método base retorna imediatamente.
Se nem a expansão da interface do usuário nem a ExpansionProvider está ativo, as chamadas de método base a HandlePreExec método.Se HandlePreExec faz a alça do comando, o comando é passada para o seu próximo destino.Chama o método base a HandlePostExec método na ExpansionProvider (se existir) o objeto antes de chamar o HandlePostExec método.
O método base também manipula caso especial de um Enter tecla pressionada enquanto um conjunto de conclusão está aberto, mas nada está selecionado no conjunto; Nesse caso, o Enter chave deve ser adicionado ao arquivo de origem e isso é feito passando o comando para o seu próximo destino uma segunda vez (a primeira vez que fecha o conjunto de conclusão e consome a tecla Enter).
Normalmente, este método é chamado da implementação de interno da classe base da Exec método na IOleCommandTarget interface.
Segurança do .NET Framework
- Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiáveis.