Структура RESULTDATAITEM (mmc.h)

Статья
08/24/2023

Структура RESULTDATAITEM задает или получает атрибуты элементов результатов в области результатов оснастки.

Синтаксис

typedef struct _RESULTDATAITEM {
  DWORD       mask;
  BOOL        bScopeItem;
  HRESULTITEM itemID;
  int         nIndex;
  int         nCol;
  LPOLESTR    str;
  int         nImage;
  UINT        nState;
  LPARAM      lParam;
  int         iIndent;
} RESULTDATAITEM;

Члены

mask

Набор флагов, указывающих атрибуты данной структуры данных, или операция, использующая эту структуру.

Следующие флаги указывают элементы структуры RESULTDATAITEM , которые содержат допустимые данные или должны быть заполнены данными. Можно задать один или несколько флагов.

RDI_STR (0x0002)

Член str является допустимым или должен быть заполнен.

RDI_IMAGE (0x0004)

Элемент nImage является допустимым или должен быть заполнен.

RDI_STATE (0x0008)

Член nState является допустимым или должен быть заполнен.

RDI_PARAM (0x0010)

Член lParam является допустимым или должен быть заполнен.

RDI_INDEX (0x0020)

Элемент nIndex является допустимым или должен быть заполнен.

RDI_INDENT (0x0040)

Элемент iIndent является допустимым или должен быть заполнен.

bScopeItem

Значение TRUE, если элемент lParam ссылается на элемент область. FALSE , если элемент lParam ссылается на результирующий элемент.

itemID

Значение типа , указывающее предоставленный консолью уникальный идентификатор элемента для элемента результата. Это значение используется для идентификации элемента в области результатов вызовов некоторых
Методы интерфейса IResultData.

После успешной вставки элемента в область область (с помощью IResultData::InsertItem) элемент itemID структуры RESULTDATAITEM содержит дескриптор HRESULTITEM добавленного элемента. Этот дескриптор является уникальным идентификатором элемента результата.

Оснастка должна хранить это значение для управления вставленным элементом (позже), вызывая такие методы, как IResultData::GetItem. Если это значение не хранится, его можно найти с помощью IResultData::FindItemByLParam.

nIndex

Значение типа , указывающее отсчитываемый от нуля индекс элемента, на который ссылается эта структура.

nCol

Значение типа , указывающее столбец, в котором выполняется операция. Если операция выполняется с элементом, а не со столбцом, значение равно нулю (0).

str

Указатель на строку, завершающуюся null, которая содержит текст элемента, если структура задает атрибут элемента RDI_STR . Если этот элемент является значением MMC_CALLBACK , элемент является элементом обратного вызова.

Имейте в виду, что оснастка может использовать MMC_TEXTCALLBACK вместо MMC_CALLBACK. Значение MMC_TEXTCALLBACK является версией MMC_CALLBACK с правильным типом (приведение не требуется).

MMC_TEXTCALLBACK появилась в MMC версии 1.2.

nImage

Индекс виртуального изображения значка элемента представления списка в списках изображений больших и маленьких значков. Имейте в виду, что индекс виртуального образа внутренне сопоставляется с фактическим индексом. Этот элемент также можно указать как элемент обратного вызова: MMC_CALLBACK или MMC_IMAGECALLBACK. Значение MMC_IMAGECALLBACK является версией MMC_CALLBACK с правильным типом (приведение не требуется).

MMC_IMAGECALLBACK появилась в MMC версии 1.2.

nState

Значение типа , указывающее маску состояния для элемента. Может быть одним из указанных далее.

LVIS_CUT

Элемент помечается для операции выреза и вставки.

LVIS_DROPHILITED

Элемент выделяется как целевой объект перетаскивания.

LVIS_FOCUSED

Элемент имеет фокус, поэтому он окружен стандартным прямоугольником фокуса. Можно выбрать несколько элементов, но фокус может быть только у одного элемента.

LVIS_SELECTED

Элемент выбран. Внешний вид выбранного элемента зависит от того, имеет ли он фокус, и от системных цветов, используемых для выделения.

Примечание Чтобы использовать константы LVIS_* , включите CommCtrl.h в исходный файл.

lParam

Значение типа , указывающее предоставленное пользователем 32-разрядное значение, которое необходимо связать с элементом. Этот элемент, также называемый файлом cookie, представляет собой значение, которое передается в качестве первого параметра в IComponent::QueryDataObject.

iIndent

Зарезервировано.

Требования

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

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

IResultData

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