Método IPointerInactive::GetActivationPolicy (ocidl.h)
Recupera a política de ativação atual do objeto. Esse método é chamado pelo contêiner ao receber uma mensagem de WM_SETCURSOR ou WM_MOUSEMOVE quando um objeto inativo está sob o ponteiro do mouse.
Sintaxe
HRESULT GetActivationPolicy(
[out] DWORD *pdwPolicy
);
Parâmetros
[out] pdwPolicy
Um ponteiro para uma variável que recebe a política de ativação. Os valores possíveis vêm da enumeração POINTERINACTIVE .
Retornar valor
Se o método for bem-sucedido, o valor retornado será S_OK. Caso contrário, será E_FAIL.
Comentários
O objeto pode solicitar a ativação in-loco assim que o mouse o insere por meio do valor POINTERINACTIVE_ACTIVATEONENTRY. Um objeto que fornece mais comentários visuais do que simplesmente definir o ponteiro do mouse usaria esse valor. Por exemplo, se o objeto der suporte a comentários visuais especiais, ele deverá inserir o estado ativo para que possa desenhar os comentários visuais compatíveis.
Um objeto também pode usar esse método para solicitar ativação quando o mouse é arrastado sobre eles durante uma operação de arrastar e soltar pelo POINTERINACTIVE_ACTIVATEONDRAG.
Se o objeto retornar um desses valores, o contêiner deverá ativar o objeto imediatamente e encaminhar a mensagem janela que disparou a chamada. Em seguida, o objeto permanece ativo e processa mensagens subsequentes por meio de sua própria janela até que o contêiner obtenha outra WM_SETCURSOR ou WM_MOUSEMOVE. Neste ponto, o contêiner deve desativar o objeto .
Para objetos OLE sem janelas, esse mecanismo é ligeiramente diferente. Consulte IOleInPlaceSiteWindowless para obter mais informações sobre operações de arrastar e soltar para objetos sem janelas.
Se o objeto retornar os valores POINTERINACTIVE_ACTIVATEONENTRY e POINTERINACTIVE_DEACTIVATEONLEAVE, o objeto será ativado somente quando o mouse estiver sobre o objeto. Se o valor POINTERINACTIVE_ACTIVATEONENTRY sozinho for definido, o objeto será ativado uma vez quando o mouse o inserir pela primeira vez e permanecerá ativo.
Anotações para chamadores
A política de ativação não deve ser armazenada em cache. O contêiner deve chamar esse método sempre que o mouse inserir um objeto inativo.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] |
| Plataforma de Destino | Windows |
| Cabeçalho | ocidl.h |