MMC_LISTPAD_INFO構造体 (mmc.h)

MMC_LISTPAD_INFO構造は MMC 1.1 で導入されています。

MMC_LISTPAD_INFO構造体は IExtendTaskPad::GetListPadInfo メソッドによって入力され、リスト ビュー タスクパッドに対して次の情報を指定します。

• リスト コントロールのタイトル テキスト
• 省略可能なボタンのテキスト
• ボタンがクリックされたときに IExtendTaskPad::TaskNotify に渡されるコマンド ID。

構文

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

メンバー

szTitle

リスト コントロールのすぐ上に配置されたテキストを含む null で終わる文字列へのポインター。 このテキストには、リスト コントロール内のオブジェクトのラベル (リストにプリンターが含まれている場合は "Printers" など) や命令 ("プリンターを選択して実行するアクションをクリックする" など) を指定できます。

szTitle が NULL または空の場合、リスト コントロールのタイトルは表示されません。

szTitle メンバーは、IExtendTaskPad::GetTitle の pszTitle パラメーターと同じではないことに注意してください。 IExtendTaskPad::GetTitle メソッドは、タスクパッドの上部に表示され、すべての標準 MMC タスクパッドに表示されるタスクパッド全体のタイトルを返します。 MMC_LISTPAD_INFO の szTitle メンバーはリスト コントロールのラベルであり、MMC リスト ビュー のタスクパッドにのみ表示されます。

szButtonText

リスト コントロールのすぐ上にあるボタンと szTitle テキストの右側に配置されたテキストを含む null で終わる文字列へのポインター。

ユーザーがタスクパッドでこのボタンをクリックすると、MMC はスナップインの IExtendTaskPad::TaskNotify メソッドを呼び出し、 nCommandID で指定された値を arg パラメーターの VARIANT 構造体として渡します。 TaskNotify に渡される VARIANT には、VT_I4に設定された vt メンバーと、コマンド ID を含む lVal メンバーがあります。

ボタンをテキストなしで表示するには、 szButtonText を空の文字列に設定します。

タスクパッドに表示されるこのボタンを非表示にするには、 szButtonText を NULL に設定 します。

nCommandID

szButtonText で指定されたボタンの識別子として機能する値。 ボタンクリック通知を送信したタスクパッドを識別するために、この値を各タスクパッドに対して一意にすることをお勧めします。

ユーザーがこのボタンをクリックすると、MMC はスナップインの IExtendTaskPad::TaskNotify メソッドを呼び出し、この値を arg パラメーターに VARIANT として渡します。

szButtonText が NULL の場合、この値は無視されます。

解説

COM API 関数 CoTaskMemAlloc (またはそれに相当する) を使用して szTitle 文字列と szButtonText 文字列を割り当てると、MMC によって解放されます。

要件

関連項目

IExtendTaskPad::GetListPadInfo

IExtendTaskPad::TaskNotify