OleComponent.IOleComponent.OnActivationChange(IOleComponent, Int32, OLECRINFO[], Int32, OLECHOSTINFO[], UInt32) Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Notifique o componente quando um novo objeto estiver sendo ativado. Simplesmente chama para OnActivationChangeCore(IOleComponent, Int32, OLECRINFO[], Int32, OLECHOSTINFO[], UInt32) .
virtual void Microsoft.VisualStudio.OLE.Interop.IOleComponent.OnActivationChange(Microsoft::VisualStudio::OLE::Interop::IOleComponent ^ pic, int fSameComponent, cli::array <Microsoft::VisualStudio::OLE::Interop::OLECRINFO> ^ pcrinfo, int fHostIsActivating, cli::array <Microsoft::VisualStudio::OLE::Interop::OLECHOSTINFO> ^ pchostinfo, System::UInt32 dwReserved) = Microsoft::VisualStudio::OLE::Interop::IOleComponent::OnActivationChange;
virtual void Microsoft.VisualStudio.OLE.Interop.IOleComponent.OnActivationChange(Microsoft::VisualStudio::OLE::Interop::IOleComponent ^ pic, int fSameComponent, Platform::Array <Microsoft::VisualStudio::OLE::Interop::OLECRINFO> ^ pcrinfo, int fHostIsActivating, Platform::Array <Microsoft::VisualStudio::OLE::Interop::OLECHOSTINFO> ^ pchostinfo, unsigned int dwReserved) = Microsoft::VisualStudio::OLE::Interop::IOleComponent::OnActivationChange;
void Microsoft.VisualStudio.OLE.Interop.IOleComponent.OnActivationChange(Microsoft::VisualStudio::OLE::Interop::IOleComponent const & pic, int fSameComponent, std::Array <Microsoft::VisualStudio::OLE::Interop::OLECRINFO> const & pcrinfo, int fHostIsActivating, std::Array <Microsoft::VisualStudio::OLE::Interop::OLECHOSTINFO> const & pchostinfo, unsigned int dwReserved);
void IOleComponent.OnActivationChange (Microsoft.VisualStudio.OLE.Interop.IOleComponent pic, int fSameComponent, Microsoft.VisualStudio.OLE.Interop.OLECRINFO[] pcrinfo, int fHostIsActivating, Microsoft.VisualStudio.OLE.Interop.OLECHOSTINFO[] pchostinfo, uint dwReserved);
abstract member Microsoft.VisualStudio.OLE.Interop.IOleComponent.OnActivationChange : Microsoft.VisualStudio.OLE.Interop.IOleComponent * int * Microsoft.VisualStudio.OLE.Interop.OLECRINFO[] * int * Microsoft.VisualStudio.OLE.Interop.OLECHOSTINFO[] * uint32 -> unit
override this.Microsoft.VisualStudio.OLE.Interop.IOleComponent.OnActivationChange : Microsoft.VisualStudio.OLE.Interop.IOleComponent * int * Microsoft.VisualStudio.OLE.Interop.OLECRINFO[] * int * Microsoft.VisualStudio.OLE.Interop.OLECHOSTINFO[] * uint32 -> unit
Sub OnActivationChange (pic As IOleComponent, fSameComponent As Integer, pcrinfo As OLECRINFO(), fHostIsActivating As Integer, pchostinfo As OLECHOSTINFO(), dwReserved As UInteger) Implements IOleComponent.OnActivationChange
Parâmetros
- pic
- IOleComponent
Se não for NULL, esse será o componente que está sendo ativado.
- fSameComponent
- Int32
True se pic for o componente que chamou esse método.
- fHostIsActivating
- Int32
Se pic for NULL e isso for true (1), ele indicará que o host está sendo ativado. Se pic for NULL e for false (0), não haverá nenhum objeto ativo atual.
- pchostinfo
- OLECHOSTINFO[]
Se fHostIsActivating for true (1), esses serão os hosts OLECHOSTINFO , caso contrário, isso será NULL.
- dwReserved
- UInt32
Reservado para uso futuro, deve ser 0.
Implementações
Comentários
Se pic está sendo ativado e pcrinfo . GRF tem o ExclusiveBorderSpace conjunto de bits, o componente deve ocultar suas ferramentas de espaço de borda (barras de ferramentas, barras de status, etc.); o componente também deve fazer isso se o host estiver ativando e pchostinfo . grfchost tiver o ExclusiveBorderSpace conjunto de bits. Em qualquer um desses casos, o componente deve Reexibir suas ferramentas de espaço de borda na próxima vez que for ativado.
Se pic está sendo ativado e pcrinfo . GRF tem o ExclusiveActivation conjunto de bits, pic está sendo ativado no modo "ExclusiveActive". O componente deve recuperar a janela de quadro superior que está hospedando pic (via pic. HwndGetWindow (WindowTypes. WindowToplevel, 0)). Se essa janela for diferente da janela superior do próprio componente, o componente deve desabilitar suas janelas e fazer outras coisas que ele faria ao receber a notificação oninsirastate (Componentestate. modal, TRUE).
Caso contrário, se o componente for de nível superior, ele deverá se recusar a ter sua janela ativada pelo processamento apropriado de WM_MOUSEACTIVATE (consulte a WM_MOUSEACTIVATE observação abaixo). O componente deve permanecer em um desses Estados até que o modo ExclusiveActive seja encerrado, indicado por uma chamada futura para OnActivationChange com ExclusiveActivation bit não definido ou com NULL pcrinfo
Nota WM_MOUSEACTIVATE (para Compoenents de nível superior e host): Se as informações de reg (ou acompanhamento) do registro de comp indicarem que ele deseja mensagens do mouse, nenhum valor de MA_xxxANDEAT deverá ser retornado de WM_MOUSEACTIVATE, de modo que a comp ativa (ou de rastreamento) poderá processar a mensagem resultante do mouse. Se não quiser examinar as informações de reg, nenhum valor de MA_xxxANDEAT deverá ser retornado de WM_MOUSEACTIVATE se qualquer comp estiver ativo (ou acompanhamento). Uma delas pode consultar as informações de reg do componente ativo (ou acompanhamento) a qualquer momento por meio de IOleComponentManager. FGetActiveComponent