IOleInPlaceComponent.GetCntrContextMenu – metoda (UInt32, Guid, Int32, POINTS[], Guid, OLEMENUID , UInt32)

Článek
08/05/2016

Umožňuje VSPackage objekt v místě za předpokladu, že role hlavních potlačit požaduje objektu za předpokladu, že podsoučást místní nabídky nebo součást řízení roli.

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

Syntaxe

int GetCntrContextMenu(
    uint dwRoleActiveObj,
    [InAttribute] ref Guid rclsidActiveObj,
    int nMenuIdActiveObj,
    POINTS[] pos,
    out Guid pclsidCntr,
    OLEMENUID[] menuid,
    out uint pgrf
)

int GetCntrContextMenu(
    unsigned int dwRoleActiveObj,
    [InAttribute] Guid% rclsidActiveObj,
    int nMenuIdActiveObj,
    array<POINTS>^ pos,
    [OutAttribute] Guid% pclsidCntr,
    array<OLEMENUID>^ menuid,
    [OutAttribute] unsigned int% pgrf
)

abstract GetCntrContextMenu : 
        dwRoleActiveObj:uint32 *
        rclsidActiveObj:Guid byref *
        nMenuIdActiveObj:int *
        pos:POINTS[] *
        pclsidCntr:Guid byref *
        menuid:OLEMENUID[] *
        pgrf:uint32 byref -> int

Function GetCntrContextMenu (
    dwRoleActiveObj As UInteger,
    <InAttribute> ByRef rclsidActiveObj As Guid,
    nMenuIdActiveObj As Integer,
    pos As POINTS(),
    <OutAttribute> ByRef pclsidCntr As Guid,
    menuid As OLEMENUID(),
    <OutAttribute> ByRef pgrf As UInteger
) As Integer

Parametry

dwRoleActiveObj
[v] Určuje roli nejvnitřnější uživatelského rozhraní aktivní objekt, který přispívá v kontextové nabídce.Seznam platných dwRoleActiveObj hodnoty, viz OLEROLE.

rclsidActiveObj
[v] Identifikátor (třídy CLSID) vnitřní uživatelského rozhraní aktivní objekt, který přispívá v kontextové nabídce třídy.

nMenuIdActiveObj
[v] Identifikátor nabídky přispějí.Identifikátor nabídky je kombinací identifikátor CLSID a OLEMENUID struktury.

pos
[v] Pozice v obrazovkových souřadnicích pro kontextové nabídky.

pclsidCntr
[výstup] Identifikátor (třídy CLSID) místní nabídka, kterou přispějí třídy.Pokud není žádná nabídka přispět, tento parametr by měl být null.

menuid
[výstup] Identifikátor kontextové nabídky, kterou přispějí.Identifikátor je OLEMENUID struktura tvořena nabídky číselný identifikátor, znak vyrovnávací paměť pro název nabídky a ukazatel do nabídky.V nabídce může být zadána s řetězec názvu nabídky nebo s ID vestavěné nabídky objekt v místě za předpokladu, že role hlavní součást.Název nabídky, který je známý prostředí by měl být řetězec.Pokud řetězec nezjistí název platné nabídky, se žádná místní nabídka zobrazí.Prostředí se můžete vrátit seznam názvů platné nabídky až IPerPropertyBrowsing metoda.

pgrf
[výstup] Příznaky, které řídí použití nabídky.Seznam platných pgrf hodnoty, viz OLEMENU.

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 IOleInPlaceComponent::GetCntrContextMenu(
   [in] DWORD dwRoleActiveObj,
   [in] REFCLSID rclsidActiveObj,
   [in] LONG nMenuIdActiveObj,
   [in] REFPOINTS pos,
   [out] CLSID *pclsidCntr,
   [out] OLEMENUID *menuid,
   [out] DWORD *pgrf
);

menuid Parametru lze nastavit pouze OLEMENU_CNTRMENUONLY; OLEMENU_MENUMERGE hodnota není podporována.

Místní objekty můžete požadovat zobrazení kontextové nabídky voláním ShowContextMenu.Pokud volající ShowContextMenu je objekt za předpokladu, že role podsoučásti nebo součást řízení volání prostředí GetCntrContextMenu hlavní součást přímo v objektu.Toto volání umožňuje přímo v objektu hlavní součást získat kontrolu zobrazení konečné kontextové nabídky.Hlavní součást lze provést jednu z následujících akcí v jeho provádění GetCntrContextMenu:

Povolte vnitřní objekt kontextové nabídky zobrazit.
Nepovolit žádné místní nabídka zobrazení.
Contribute kontextové nabídky kontejneru, který zcela změní, vnitřní objekt.
Contribute sloučený s, vnitřní objekt místní nabídky kontejneru.Nabídka na kontejner musí obsahovat zvláštní značku v místě, kde je vložena nabídka objektu.

Pokud objekt v místě nastaví OLEMENU_MENUMERGE bit v pgrf parametr, kontejner a aktivní objekt nabídky budou sloučeny.Pokud OLEMENU_MENUMERGE bit není zapnutá, nabídky kontejneru přepíše nabídky pro aktivní objekt.Je kontejner kontextové nabídky se zobrazí bez sloučení v nabídce aktivní objekt.

Viz také

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

Zpátky na začátek

Sdílet prostřednictvím