Интерфейс IResultData (mmc.h)
Интерфейс IResultData позволяет пользователю добавлять, удалять, находить и изменять элементы, связанные с областью представления результатов. Он также позволяет манипулировать стилем представления панели представления результатов.
Интерфейс IResultData был разработан таким образом, чтобы создать впечатление, что панель представления результатов будет использоваться только одним компонентом, но компоненты должны учитывать, что область представления результатов может быть, фактически, совместно использоваться несколькими компонентами. Все операции с элементами выполняются с помощью идентификатора элемента, назначенного при вставке элемента. Этот идентификатор гарантированно будет статическим и уникальным в течение всего жизненного срока действия элемента. При удалении элемента идентификатор освобождается и может использоваться другими новыми элементами в списке. Никогда не следует хранить идентификатор элемента после удаления связанного с ним элемента.
Интерфейс IResultData также обрабатывает виртуальные списки (данные владельца). Из-за характера виртуальных списков применяются не все методы, а некоторые из них имеют ограниченную функциональность. Эти различия подробно описаны в описаниях отдельных методов. Основное различие в обработке виртуальных списков заключается в том, что, поскольку консоль не поддерживает хранилище для виртуальных элементов, она не предоставляет идентификаторы элементов. Вместо этого виртуальные элементы списка идентифицируются по их положению в списке (индексу).
Наследование
Интерфейс IResultData наследуется от интерфейса IUnknown . IResultData также содержит следующие типы элементов:
Методы
Интерфейс IResultData содержит следующие методы.
| IResultData::D eleteAllRsltItems Метод IResultData::D eleteAllRsltItems позволяет оснастке удалять все вставленные пользователем элементы и подэлементы из области представления результатов. |
| IResultData::D eleteItem Позволяет оснастке удалить один элемент в области представления результатов. |
| IResultData::FindItemByLParam Метод IResultData::FindItemByLParam позволяет оснастке находить элемент или подэлемент на основе вставленного пользователем значения lParam. |
| IResultData::GetItem Позволяет пользователю получать параметры одного элемента. |
| IResultData::GetNextItem Метод IResultData::GetNextItem получает следующий элемент в представлении результатов с заданными флагами состояния. |
| IResultData::GetViewMode Позволяет оснастке получить режим просмотра для области представления результатов. |
| IResultData::InsertItem Метод IResultData::InsertItem позволяет оснастке добавить один новый элемент в представление области результатов. |
| IResultData::ModifyItemState Позволяет оснастке изменять состояние элемента. |
| IResultData::ModifyViewStyle Метод IResultData::ModifyViewStyle позволяет оснастке задать стиль представления области результатов. |
| IResultData::SetDescBarText Задает текст строки описания для области представления результатов. |
| IResultData::SetItem Метод IResultData::SetItem позволяет оснастке задать один элемент в области результатов. |
| IResultData::SetItemCount Задает количество элементов в виртуальном списке. |
| IResultData::SetViewMode Позволяет оснастке задать режим просмотра, в котором панель представления результатов отображает свои элементы. |
| IResultData::Sort Сортирует все элементы в области результатов. |
| IResultData::UpdateItem Вызывает перерисовку указанного элемента в области результатов. |
Требования
| Минимальная версия клиента | Windows Vista |
| Минимальная версия сервера | Windows Server 2008 |
| Целевая платформа | Windows |
| Header | mmc.h |