Método IPointerInactive::GetActivationPolicy (ocidl.h)

  • Artigo

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

Confira também

Ioleinplacesitewindowless

Ipointerinactive