共用方式為


MMC_LISTPAD_INFO 結構 (mmc.h)

MMC_LISTPAD_INFO結構是在 MMC 1.1 中引進。

IExtendTaskPad::GetListPadInfo方法會填入MMC_LISTPAD_INFO結構,以指定清單檢視工作臺的下列資訊:

語法

typedef struct _MMC_LISTPAD_INFO {
  LPOLESTR szTitle;
  LPOLESTR szButtonText;
  LONG_PTR nCommandID;
} MMC_LISTPAD_INFO;

成員

szTitle

以 Null 結束之字串的指標,其中包含直接放在清單控制項上方的文字。 如果清單包含印表機 () 或指令 (,例如[選取印表機並按一下要執行的動作],則此文字可以是清單控制項內物件的標籤,例如「選取印表機並按一下要執行的動作」。) 。

如果 szTitleNull 或空白,則不會顯示清單控制項的標題。

請注意,szTitle成員與IExtendTaskPad::GetTitlepszTitle參數不同。 IExtendTaskPad::GetTitle方法會傳回出現在任務板頂端之整個任務板的標題,並出現在每個標準 MMC 工作板上。 MMC_LISTPAD_INFO 的 szTitle成員是清單控制項的標籤,只會出現在 MMC 清單檢視工作臺上。

szButtonText

Null 終止字串的指標,其中包含放置在清單控制項正上方之按鈕上的文字,以及 szTitle 文字右邊的文字。

當使用者在任務板上按一下此按鈕時,MMC 會呼叫嵌入式管理 單元的 IExtendTaskPad::TaskNotify 方法,並將 nCommandID 中指定的值傳遞為 arg 參數中的 VARIANT 結構。 傳遞給TaskNotifyVARIANT已將vt成員設定為VT_I4,以及包含命令識別碼的lVal成員。

若要讓按鈕顯示為沒有文字,請將 szButtonText 設定為空字串。

若要隱藏此按鈕以顯示在任務板上,請將 szButtonText 設定為 Null

nCommandID

值,做為 szButtonText所指定按鈕的識別碼。 建議您讓每一個工作板都有這個值唯一,以協助識別傳送按鈕點擊通知的工作臺。

當使用者按一下此按鈕時,MMC 會呼叫嵌入式管理 單元的 IExtendTaskPad::TaskNotify 方法,並在 arg 參數中以 VARIANT 形式傳遞此值。

如果 szButtonTextNull,則會忽略此值。

備註

使用 COM API 函式CoTaskMemAlloc (配置szTitleszButtonText字串,或同等的) 和 MMC 會釋放它。

需求

   
最低支援的用戶端 Windows Vista
最低支援的伺服器 Windows Server 2008
標頭 mmc.h

另請參閱

IExtendTaskPad::GetListPadInfo

IExtendTaskPad::TaskNotify