Поделиться через

структура MMC_LISTPAD_INFO (mmc.h)

  • Статья

Структура MMC_LISTPAD_INFO представлена в MMC 1.1.

Структура MMC_LISTPAD_INFO заполняется методом IExtendTaskPad::GetListPadInfo , чтобы указать следующие сведения для панели задач представления списка:

  • Текст заголовка для элемента управления "Список"
  • Текст для необязательной кнопки
  • Идентификатор команды, передаваемый в IExtendTaskPad::TaskNotify при нажатии этой кнопки.

Синтаксис

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

Члены

szTitle

Указатель на строку, завершающуюся null, которая содержит текст, расположенный непосредственно над элементом управления списком. Этот текст может быть меткой для объектов в элементе управления "Список" (например, "Принтеры", если список содержит принтеры) или инструкции (например, "Выберите принтер и щелкните действие для выполнения").

Если szTitle имеет значение NULL или пусто, заголовок для элемента управления списком не отображается.

Имейте в виду, что член szTitle отличается от параметра pszTitle для IExtendTaskPad::GetTitle. Метод IExtendTaskPad::GetTitle возвращает заголовок для всей панели задач, которая отображается в верхней части панели задач и отображается на каждой стандартной панели задач MMC. Элемент szTitleMMC_LISTPAD_INFO является меткой для элемента управления списком и отображается только на панели задач представления списка MMC.

szButtonText

Указатель на строку, завершающуюся null, которая содержит текст, размещенный на кнопке, которая находится непосредственно над элементом управления list и справа от текста szTitle .

Когда пользователь нажимает эту кнопку на панели задач, MMC вызывает метод IExtendTaskPad::TaskNotify оснастки и передает значение, указанное в nCommandID , в качестве структуры VARIANT в параметре arg. Variant, передаваемый в TaskNotify, имеет член vt, для которого задано значение VT_I4 и член lVal, содержащий идентификатор команды.

Чтобы кнопка отображалась без текста, задайте для szButtonText пустую строку.

Чтобы скрыть эту кнопку, отображаемую на панели задач, присвойте szButtonTextзначение NULL.

nCommandID

Значение, которое служит идентификатором для кнопки, указанной szButtonText. Рекомендуется сделать это значение уникальным для каждой панели задач, чтобы определить панель задач, на которую было отправлено уведомление о нажатии кнопки.

Когда пользователь нажимает эту кнопку, MMC вызывает метод IExtendTaskPad::TaskNotify оснастки и передает это значение в качестве VARIANT в параметре arg.

Это значение игнорируется, если szButtonText имеет значение NULL.

Комментарии

Выделите строки szTitle и szButtonText с помощью функции API COM CoTaskMemAlloc (или эквивалентной), и MMC выпустит ее.

Требования

   
Минимальная версия клиента Windows Vista
Минимальная версия сервера Windows Server 2008
Верхняя часть mmc.h

См. также раздел

IExtendTaskPad::GetListPadInfo

IExtendTaskPad::TaskNotify