IResultData::ModifyItemState-Methode (mmc.h)

Mit der IResultData::ModifyItemState-Methode kann das Snap-In den Zustand eines Elements ändern.

Syntax

HRESULT ModifyItemState(
  [in] int         nIndex,
  [in] HRESULTITEM itemID,
  [in] UINT        uAdd,
  [in] UINT        uRemove
);

Parameter

[in] nIndex

Ein Wert, der den Index des Elements angibt, dessen Zustand geändert werden soll. Dieser Parameter wird nur verwendet, wenn der itemID-Parameter 0 ist. Wenn Sie auf virtuelle Listen angewendet werden, müssen Sie nIndex verwenden und itemID auf Null festlegen.

[in] itemID

Eindeutiger Bezeichner des Elements, dessen Zustand geändert werden soll. Legen Sie bei Anwendung auf virtuelle Listen itemID = 0 fest.

[in] uAdd

Ein Wert, der angibt, welche Windows-Listenansichtsstatusflags festgelegt werden können. Wenn sie auf virtuelle Listen angewendet werden, können nur fokus- und ausgewählte Zustände geändert werden. Dieser Wert kann eine beliebige gültige Kombination der folgenden Sein:

LVIS_CUT

Das Element wird für einen Ausschneiden- und Einfügevorgang markiert.

LVIS_DROPHILITED

Das Element wird als Drag-and-Drop-Ziel hervorgehoben.

LVIS_FOCUSED

Das Element hat den Fokus, sodass es von einem Standard-Fokusrechteck umgeben ist. Obwohl mehrere Elemente ausgewählt werden können, kann nur ein Element den Fokus haben.

LVIS_SELECTED

Das Element ist ausgewählt. Die Darstellung eines ausgewählten Elements hängt davon ab, ob es den Fokus hat und von den systemfarben, die für die Auswahl verwendet werden.

[in] uRemove

Ein Wert, der die Statusflags des Listenansichtelements angibt, die entfernt werden können. Dieser Wert kann eine beliebige gültige Kombination der vorherigen Win32-LVIS_*-Flags sein, die für den uAdd-Parameter angezeigt werden.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Anforderungen

Weitere Informationen

Iresultdata

IResultData2