Metoda IOleInPlaceComponent.GetCntrMessage — (UInt32, Guid, String, String, String, String, String, String, UInt32, OLEMSGBUTTON[], OLEMSGDEFBUTTON[], OLEMSGICON , Int32)

Artykuł
08/06/2016

Umożliwia obiektu VSPackage w miejscu przy założeniu rolę głównego składnika do zastąpienia wiadomości należące do obiektu, zakładając, że rola kontroli podskładnika lub składnika.

Przestrzeń nazw: Microsoft.VisualStudio.Shell.Interop
Zestaw: Microsoft.VisualStudio.Shell.Interop (w Microsoft.VisualStudio.Shell.Interop.dll)

Składnia

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
Type: System.UInt32

[in] [out] W danych wejściowych, wskaźnik do roli obiektu w miejscu wyświetlania komunikatów żądania. Produkcja pdwRole parametr jest wskaźnikiem do roli obiektu w miejscu odpowiada za wyświetlanie komunikatów. Nieprawidłowa lista pdwRole wartości, zobacz OLEROLE.

pclsid
Type: System.Guid

[in] Określa identyfikator klasy (CLSID) obiektu w miejscu żądanie wyświetlania komunikatów.

pszTitleIn
Type: System.String

[in] Wskazuje tytuł wiadomości.

pszTextIn
Type: System.String

[in] Wskazuje tekst wiadomości.

pszHelpFileIn
Type: System.String

[in] Wskazuje plik Pomocy zawierający wiadomość.

ppszTitleOut
Type: System.String

[out] Wskaźnik do nazwy wyświetlanej.

ppszTextOut
Type: System.String

[out] Wskaźnik do tekstu, który został wyświetlony.

ppszHelpFileOut
Type: System.String

[out] Wskaźnik do pliku pomocy, który był wyświetlany.

pdwHelpContextID
Type: System.UInt32

[in] [out] W danych wejściowych, wskaźnik do żądanej pomocy identyfikator kontekstu. Produkcja pdwHelpContextId parametr jest wskaźnikiem do identyfikatora kontekstu Pomocy używanego do wyświetlania komunikatów.

pmsgbtn
Type: Microsoft.VisualStudio.Shell.Interop.OLEMSGBUTTON[]

[in] [out] W danych wejściowych, wskaźnik do typu przycisków, które mają być wyświetlane z komunikatem. Produkcja pmsgbtn parametr jest wskaźnikiem do typu przyciski wyświetlane i zostanie wyświetlony komunikat. Nieprawidłowa lista pmsgbtn wartości, zobacz OLEMSGBUTTON.

pmsgdefbtn
Type: Microsoft.VisualStudio.Shell.Interop.OLEMSGDEFBUTTON[]

[in] [out] W danych wejściowych, wskaźnik do żądanego położenia przycisk domyślny w Grupa przycisków wiadomości. Produkcja pmsgdefbtn parametr jest wskaźnikiem do rzeczywistego pozycji przycisku domyślnego. Nieprawidłowa lista pmsgdefbtn wartości, zobacz OLEMSGDEFBUTTON.

pmsgicon
Type: Microsoft.VisualStudio.Shell.Interop.OLEMSGICON[]

[in] [out] W danych wejściowych, wskaźnik do typu komunikatu do wyświetlenia. Produkcja pmsgicon parametr jest wskaźnikiem do typu komunikatu, który został wyświetlony. Nieprawidłowa lista pmsgicon wartości, zobacz OLEMSGICON.

pfSysAlert
Type: System.Int32

[in] [out] Jeśli true, ta flaga powoduje, że MB_SYSTEMMODALustawienie flagi w przypadku wyświetlania wiadomości. Jeśli false, nie system flagę podczas wyświetlania komunikatów.

Wartość zwracana

Type: System.Int32

Jeśli metoda zakończy się pomyślnie, zwraca S_OK. Jeśli nie, zwraca kod błędu.

Uwagi

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
);

Zakładając, że rola składnika głównego obiektu w miejscu znajduje się możliwość zastąpienia dowolnego aspektu komunikat przyjmować podskładnik lub składnik kontrolki, łącznie z nazwą pliku pomocy, tekst komunikatu i typ wiadomości. Główny składnik chce się zastąpić tekst komunikatu lub nazwę pliku pomocy, należy przydzielić ciągów za pomocą active alokatora IMalloc dostarczone przez OLE. Środowisko spowoduje zwolnienie tych ciągów za pomocą IMalloc.

Zobacz też

Interfejs IOleInPlaceComponent
Przestrzeń nazw Microsoft.VisualStudio.Shell.Interop

Powrót do początku

Udostępnij za pośrednictwem