IOleInPlaceComponent.GetCntrMessage 方法

允许充当主要组件角色的一就地 VSPackage 对象重写属于对象的消息充当 web 应用程序或组件控件角色。

命名空间:  Microsoft.VisualStudio.Shell.Interop
程序集:  Microsoft.VisualStudio.Shell.Interop(在 Microsoft.VisualStudio.Shell.Interop.dll 中)

语法

声明
Function GetCntrMessage ( _
    <OutAttribute> ByRef pdwRole As UInteger, _
    <OutAttribute> 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, _
    <OutAttribute> ByRef pdwHelpContextID As UInteger, _
    <OutAttribute> pmsgbtn As OLEMSGBUTTON(), _
    <OutAttribute> pmsgdefbtn As OLEMSGDEFBUTTON(), _
    <OutAttribute> pmsgicon As OLEMSGICON(), _
    <OutAttribute> ByRef pfSysAlert As Integer _
) As Integer
int GetCntrMessage(
    out uint pdwRole,
    out Guid pclsid,
    string pszTitleIn,
    string pszTextIn,
    string pszHelpFileIn,
    out string ppszTitleOut,
    out string ppszTextOut,
    out string ppszHelpFileOut,
    out uint pdwHelpContextID,
    OLEMSGBUTTON[] pmsgbtn,
    OLEMSGDEFBUTTON[] pmsgdefbtn,
    OLEMSGICON[] pmsgicon,
    out int pfSysAlert
)

参数

  • pdwRole
    类型:System.UInt32%
    [in][out] 在输入,对于就地对象角色的请求的指针显示的信息。在输出, pdwRole 参数是指向就地对象的角色负责显示的信息。有关有效的 pdwRole 值列表,请参见 OLEROLE
  • pclsid
    类型:System.Guid%
    [in] 指定类标识符 (CLSID 请求) 就地的对象显示的信息。
  • pszTitleIn
    类型:System.String
    [in] 指向消息的标题。
  • pszHelpFileIn
    类型:System.String
    [in] 指向包含消息的帮助文件。
  • ppszTitleOut
    类型:System.String%
    [out] 为上显示的标题的指针。
  • ppszTextOut
    类型:System.String%
    [out] 为显示文本的指针。
  • ppszHelpFileOut
    类型:System.String%
    [out] 对显示的帮助文件的指针。
  • pdwHelpContextID
    类型:System.UInt32%
    [in][out] 在输入时,所请求的帮助上下文标识符的指针。在输出, pdwHelpContextId 参数是指向用于显示信息的帮助上下文标识符。
  • pfSysAlert
    类型:System.Int32%
    [in][out] 如果 true,此标志使 MB_SYSTEMMODAL 设置了标志,当显示消息时返回。在显示的信息内,如果 false,不存在系统标志设置为。

返回值

类型:System.Int32
如果方法成功,则返回 S_OK。如果失败,它会返回一个错误代码。

备注

COM 签名

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

将充当主要组件的角色的一个就地对象机会重写个子组件或组件控件提供的消息的所有方面,包括帮助文件名、文本和消息类型。如果主要组件若要重写文本或帮助文件名,它必须指定一个字符串使用 OLE 提供的激活 IMalloc 分配器。使用 IMalloc,环境将释放这些字符串。

.NET Framework 安全性

请参见

参考

IOleInPlaceComponent 接口

Microsoft.VisualStudio.Shell.Interop 命名空间