允许充当主要组件角色的一就地 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] 指向消息的标题。
- pszTextIn
类型: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 参数是指向用于显示信息的帮助上下文标识符。
- pmsgbtn
类型:array<Microsoft.VisualStudio.Shell.Interop.OLEMSGBUTTON[]
[in][out] 在输入,要显示的按钮类型的指针与消息。在输出, pmsgbtn 参数是指向该类型按钮实际显示的消息。有关有效的 pmsgbtn 值列表,请参见 OLEMSGBUTTON。
- pmsgdefbtn
类型:array<Microsoft.VisualStudio.Shell.Interop.OLEMSGDEFBUTTON[]
[in][out] 在输入,对默认按钮的请求的位置的指针消息中的按钮组中。在输出, pmsgdefbtn 参数是指向默认按钮的物理位置。有关有效的 pmsgdefbtn 值列表,请参见 OLEMSGDEFBUTTON。
- pmsgicon
类型:array<Microsoft.VisualStudio.Shell.Interop.OLEMSGICON[]
[in][out] 在输入,为要显示的消息类型的指针。在输出, pmsgicon 参数是指向显示消息的类型。有关有效的 pmsgicon 值列表,请参见 OLEMSGICON。
- 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 安全性
- 对直接调用方的完全信任。此成员不能由部分信任的代码使用。有关更多信息,请参见通过部分受信任的代码使用库。