MMC_LISTPAD_INFO 結構 (mmc.h)
MMC_LISTPAD_INFO結構是在 MMC 1.1 中引進。
IExtendTaskPad::GetListPadInfo方法會填入MMC_LISTPAD_INFO結構,以指定清單檢視工作臺的下列資訊:
- 清單控制項的標題文字
- 選擇性按鈕的文字
- 按一下該按鈕時傳遞至 IExtendTaskPad::TaskNotify 的命令識別碼。
語法
typedef struct _MMC_LISTPAD_INFO {
LPOLESTR szTitle;
LPOLESTR szButtonText;
LONG_PTR nCommandID;
} MMC_LISTPAD_INFO;
成員
szTitle
以 Null 結束之字串的指標,其中包含直接放在清單控制項上方的文字。 如果清單包含印表機 () 或指令 (,例如[選取印表機並按一下要執行的動作],則此文字可以是清單控制項內物件的標籤,例如「選取印表機並按一下要執行的動作」。) 。
如果 szTitle 為 Null 或空白,則不會顯示清單控制項的標題。
請注意,szTitle成員與IExtendTaskPad::GetTitle的pszTitle參數不同。 IExtendTaskPad::GetTitle方法會傳回出現在任務板頂端之整個任務板的標題,並出現在每個標準 MMC 工作板上。 MMC_LISTPAD_INFO 的 szTitle成員是清單控制項的標籤,只會出現在 MMC 清單檢視工作臺上。
szButtonText
Null 終止字串的指標,其中包含放置在清單控制項正上方之按鈕上的文字,以及 szTitle 文字右邊的文字。
當使用者在任務板上按一下此按鈕時,MMC 會呼叫嵌入式管理 單元的 IExtendTaskPad::TaskNotify 方法,並將 nCommandID 中指定的值傳遞為 arg 參數中的 VARIANT 結構。 傳遞給TaskNotify的VARIANT已將vt成員設定為VT_I4,以及包含命令識別碼的lVal成員。
若要讓按鈕顯示為沒有文字,請將 szButtonText 設定為空字串。
若要隱藏此按鈕以顯示在任務板上,請將 szButtonText 設定為 Null。
nCommandID
值,做為 szButtonText所指定按鈕的識別碼。 建議您讓每一個工作板都有這個值唯一,以協助識別傳送按鈕點擊通知的工作臺。
當使用者按一下此按鈕時,MMC 會呼叫嵌入式管理 單元的 IExtendTaskPad::TaskNotify 方法,並在 arg 參數中以 VARIANT 形式傳遞此值。
如果 szButtonText 為 Null,則會忽略此值。
備註
使用 COM API 函式CoTaskMemAlloc (配置szTitle和szButtonText字串,或同等的) 和 MMC 會釋放它。
需求
最低支援的用戶端 | Windows Vista |
最低支援的伺服器 | Windows Server 2008 |
標頭 | mmc.h |