IOleInPlaceComponentUIManager.UIActivateForMe – metoda (UInt32, Guid, IOleInPlaceActiveObject, IOleCommandTarget, UInt32, Int32 )

Článek
08/05/2016

Požaduje, aby SOleComponentUIManager služby účastní aktivace nebo deaktivace objektu v místě VSPackage.

Obor názvů: Microsoft.VisualStudio.Shell.Interop
Sestavení: Microsoft.VisualStudio.Shell.Interop (v Microsoft.VisualStudio.Shell.Interop.dll)

Syntaxe

int UIActivateForMe(
    uint dwCompRole,
    [InAttribute] ref Guid rclsidActive,
    IOleInPlaceActiveObject pIPActObj,
    IOleCommandTarget pCmdTrgtActive,
    uint cCmdGrpId,
    int[] rgnCmdGrpId
)

int UIActivateForMe(
    unsigned int dwCompRole,
    [InAttribute] Guid% rclsidActive,
    IOleInPlaceActiveObject^ pIPActObj,
    IOleCommandTarget^ pCmdTrgtActive,
    unsigned int cCmdGrpId,
    array<int>^ rgnCmdGrpId
)

abstract UIActivateForMe : 
        dwCompRole:uint32 *
        rclsidActive:Guid byref *
        pIPActObj:IOleInPlaceActiveObject *
        pCmdTrgtActive:IOleCommandTarget *
        cCmdGrpId:uint32 *
        rgnCmdGrpId:int[] -> int

Function UIActivateForMe (
    dwCompRole As UInteger,
    <InAttribute> ByRef rclsidActive As Guid,
    pIPActObj As IOleInPlaceActiveObject,
    pCmdTrgtActive As IOleCommandTarget,
    cCmdGrpId As UInteger,
    rgnCmdGrpId As Integer()
) As Integer

Parametry

dwCompRole
[v] Role v místě VSPackage objektu, který je aktivace nebo deaktivace.Pro platné dwCompRole hodnoty, viz OLEROLE.

rclsidActive
[v] Identifikátor (třídy CLSID) v místě VSPackage objektu, který je aktivace nebo deaktivace třídy.

pIPActObj
[v] Ukazatel IOleInPlaceActiveObject rozhraní vnitřní aktivní objekt.pIPActObj Musí být parametr null když je objekt v místě dezaktivování a rozhraní platný ukazatel, když je aktivace.

pCmdTrgtActive
[v] Ukazatel IOleCommandTarget rozhraní pro odesílání příkazů aktivní objekt v místě.pCmdTrgtActive Parametr musí být null, pokud je objekt v místě deaktivace a rozhraní platný ukazatel, když je aktivace.

cCmdGrpId
[v] Počet identifikátorů vlastní panel nástrojů rgnCmdGrpId parametr.

rgnCmdGrpId
[v] Pole pro vlastní panel nástrojů zobrazení identifikátorů SOleComponentUIManager služby.

Vrácená hodnota

Type: System.Int32

Pokud metoda uspěje, vrací S_OK.Pokud se nezdaří, vrátí kód chyby.

Poznámky

Podpis COM

Z oleipc.idl:

HRESULT IOleInPlaceComponentUIManager::UIActivateForMe(
   [in] DWORD dwCompRole,
   [in] REFCLSID rclsidActive,
   [in] IOleInPlaceActiveObject *pIPActObj,
   [in] IOleCommandTarget *pCmdTrgtActive,
   [in] ULONG cCmdGrpId,
   [in] LONG *rgnCmdGrpId
);

UIActivateForMeje primární metoda, která rozlišuje použití SOleComponentUIManager služba s tradiční místní aktivace OLE.Při volání objektu v místě VSPackage UIActivateForMe, SOleComponentUIManager služba převede všechny nezbytné kroky k integraci do prostředí nabídkami, panely nástrojů a příkazy na objekt.Objekt se nemusí účastnit vyjednávání pro ohraničení místo povolení slučování nabídky je nutné v aktivaci na místě OLE.

UIActivateForMelogickou náhradu za SetActiveObject metodu IOleInPlaceFrame rozhraní.Předá objekt VSPackage v místě jeho pIPActObj ukazatele životního prostředí v této metodě místo prostřednictvím kontejneru UIActivateForMe způsob, jak je tomu standard OLE místní aktivace.

K provedení UIActivateForMe, koordinovat tato metoda provádění UIActivateForMe metodu IOleInPlaceFrame rozhraní.Toto volání se podobně jako volání objektu OLE:

IOleInPlaceUIWindow::SetActiveObject(pActiveObj);

IOleInPlaceFrame::SetMenu(null);

IOleInPlaceUIWindow::SetBorderSpace(null);

Při VSPackage objekt v místě přebírá vstup voláním UIActivateForMe, SOleComponentUIManager služeb nahradí všechny vlastní nabídky a panely nástrojů zobrazí předchozí aktivní objekt s těmi nové aktivní objekt.Pokud vnořený objekt má fokus nový objekt ztratí fokus, jsou odebrány tyto nabídky a panely nástrojů.

Viz také

IOleInPlaceComponentUIManager – rozhraní
Microsoft.VisualStudio.Shell.Interop – obor názvů

Zpátky na začátek

Sdílet prostřednictvím