IOleInPlaceComponent.GetCntrMessage – metoda (UInt32, Guid, String, String, String, String, String, String, UInt32, OLEMSGBUTTON[], OLEMSGDEFBUTTON[], OLEMSGICON , Int32)

Článek
08/05/2016

Umožňuje převzetí role hlavních potlačit zprávy náležející k objektu rolí podsoučásti nebo součást řízení za předpokladu, že objekt v místě VSPackage.

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

Syntaxe

int GetCntrMessage(
    ref uint pdwRole,
    ref Guid pclsid,
    string pszTitleIn,
    string pszTextIn,
    string pszHelpFileIn,
    out string ppszTitleOut,
    out string ppszTextOut,
    out string ppszHelpFileOut,
    ref uint pdwHelpContextID,
    OLEMSGBUTTON[] pmsgbtn,
    OLEMSGDEFBUTTON[] pmsgdefbtn,
    OLEMSGICON[] pmsgicon,
    ref int pfSysAlert
)

int GetCntrMessage(
    unsigned int% pdwRole,
    Guid% pclsid,
    String^ pszTitleIn,
    String^ pszTextIn,
    String^ pszHelpFileIn,
    [OutAttribute] String^% ppszTitleOut,
    [OutAttribute] String^% ppszTextOut,
    [OutAttribute] String^% ppszHelpFileOut,
    unsigned int% pdwHelpContextID,
    array<OLEMSGBUTTON>^ pmsgbtn,
    array<OLEMSGDEFBUTTON>^ pmsgdefbtn,
    array<OLEMSGICON>^ pmsgicon,
    int% pfSysAlert
)

abstract GetCntrMessage : 
        pdwRole:uint32 byref *
        pclsid:Guid byref *
        pszTitleIn:string *
        pszTextIn:string *
        pszHelpFileIn:string *
        ppszTitleOut:string byref *
        ppszTextOut:string byref *
        ppszHelpFileOut:string byref *
        pdwHelpContextID:uint32 byref *
        pmsgbtn:OLEMSGBUTTON[] *
        pmsgdefbtn:OLEMSGDEFBUTTON[] *
        pmsgicon:OLEMSGICON[] *
        pfSysAlert:int byref -> int

Function GetCntrMessage (
    ByRef pdwRole As UInteger,
    ByRef pclsid As Guid,
    pszTitleIn As String,
    pszTextIn As String,
    pszHelpFileIn As String,
    <OutAttribute> ByRef ppszTitleOut As String,
    <OutAttribute> ByRef ppszTextOut As String,
    <OutAttribute> ByRef ppszHelpFileOut As String,
    ByRef pdwHelpContextID As UInteger,
    pmsgbtn As OLEMSGBUTTON(),
    pmsgdefbtn As OLEMSGDEFBUTTON(),
    pmsgicon As OLEMSGICON(),
    ByRef pfSysAlert As Integer
) As Integer

Parametry

pdwRole
[v][výstup] Na vstupu, ukazatel do role zobrazit zpráva žádající objekt v místě.Na výstupu pdwRole parametr je ukazatel na roli v místě objektu, který je odpovědný za zobrazení zprávy.Seznam platných pdwRole hodnoty, viz OLEROLE.

pclsid
[v] Určuje identifikátor třídy (CLSID) přímo v objektu zobrazení zprávy požadující.

pszTitleIn
[v] Odkazuje na název zprávy.

pszTextIn
[v] Body v textu zprávy.

pszHelpFileIn
[v] Odkazuje na soubor nápovědy obsahující zprávu.

ppszTitleOut
[výstup] Ukazatel na nadpis, který byl zobrazen.

ppszTextOut
[výstup] Chcete-li ukazatel myši na text, který byl zobrazen.

ppszHelpFileOut
[výstup] Ukazatel na soubor nápovědy, který byl zobrazen.

pdwHelpContextID
[v][výstup] Na vstupu, ukazatel na kontext identifikátoru požadované nápovědy.Na výstupu pdwHelpContextId parametr je ukazatel na identifikátor kontextové nápovědy pro zobrazení zprávy.

pmsgbtn
[v][výstup] Na vstupu, ukazatel na typ tlačítka pro zobrazení zprávy.Na výstupu pmsgbtn parametr je ukazatel na typ tlačítka zobrazena se zprávou.Seznam platných pmsgbtn hodnoty, viz OLEMSGBUTTON.

pmsgdefbtn
[v][výstup] Na vstupu, ukazatel na požadované umístění výchozí tlačítko ve skupině tlačítka na zprávu.Na výstupu pmsgdefbtn parametr je ukazatel na výchozí tlačítko skutečnou polohu.Seznam platných pmsgdefbtn hodnoty, viz OLEMSGDEFBUTTON.

pmsgicon
[v][výstup] Na vstupu, ukazatel na typ zprávy, které chcete zobrazit.Na výstupu pmsgicon parametr je ukazatel na typ zprávy, která byla zobrazena.Seznam platných pmsgicon hodnoty, viz OLEMSGICON.

pfSysAlert
[v][výstup] Pokud true, tento příznak způsobí, že MB_SYSTEMMODAL nastaven příznak při zobrazení zprávy.Pokud false, během zobrazení zprávy je nastaven příznak systému.

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::GetCntrMessage(
   [in][out] DWORD *pdwRole,
   [in][out] CLSID *pclsid,
   [in] LPOLESTR pszTitleIn,
   [in] LPOLESTR pszTextIn,
   [in] LPOLESTR pszHelpFileIn,
   [out] LPOLESTR *ppszTitleOut,
   [out] LPOLESTR *ppszTextOut,
   [out] LPOLESTR *ppszHelpFileOut,
   [in][out] DWORD *pdwHelpContextID,
   [in][out] OLEMSGBUTTON *pmsgbtn,
   [in][out] OLEMSGDEFBUTTON *pmsgdefbtn,
   [in][out] OLEMSGICON *pmsgicon,
   [in][out] BOOL *pfSysAlert
);

Objekt přímo v roli Hlavní součást za předpokladu, že je uvedena možnost potlačit jakýkoli aspekt zprávy poskytované podsoučásti nebo součást řízení, včetně názvu souboru nápovědy, text zprávy a typ zprávy.Pokud hlavní součást chce přepsat text zprávy nebo název souboru nápovědy, jej musíte přidělit řetězce pomocí active IMalloc přidělování poskytnutých OLE.Prostředí bude bez těchto řetězců pomocí IMalloc.

Viz také

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

Zpátky na začátek

Sdílet prostřednictvím