RESULTDATAITEM-Struktur (mmc.h)

Die RESULTDATAITEM-Struktur gibt die Attribute von Ergebniselementen im Ergebnisbereich des Snap-Ins an oder empfängt diese.

Syntax

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

Member

mask

Ein Satz von Flags, der Attribute dieser Datenstruktur angibt, oder einen Vorgang, der diese Struktur verwendet.

Die folgenden Flags geben die Member der RESULTDATAITEM-Struktur an, die gültige Daten enthalten oder mit Daten ausgefüllt werden müssen. Mindestens ein Flag kann festgelegt werden.

RDI_STR (0x0002)

Das str-Element ist gültig oder muss ausgefüllt werden.

RDI_IMAGE (0x0004)

Das nImage-Element ist gültig oder muss ausgefüllt werden.

RDI_STATE (0x0008)

Das nState-Element ist gültig oder muss ausgefüllt werden.

RDI_PARAM (0x0010)

Das lParam-Element ist gültig oder muss ausgefüllt werden.

RDI_INDEX (0x0020)

Das nIndex-Element ist gültig oder muss ausgefüllt werden.

RDI_INDENT (0x0040)

Das iIndent-Element ist gültig oder muss ausgefüllt werden.

bScopeItem

TRUE , wenn das lParam-Element auf ein Bereichselement verweist. FALSE , wenn der lParam-Member auf ein Ergebniselement verweist.

itemID

Ein -Wert, der einen von der Konsole bereitgestellten eindeutigen Elementbezeichner für das Ergebniselement angibt. Dieser Wert wird verwendet, um ein Element im Ergebnisbereich von Aufrufen einiger zu identifizieren.
IResultData-Schnittstellenmethoden .

Nachdem das Snap-In erfolgreich ein Element im Bereichsbereich eingefügt hat (mithilfe von IResultData::InsertItem), enthält das itemID-Element der RESULTDATAITEM-Struktur das HRESULTITEM-Handle des neu eingefügten Elements. Dieses Handle ist der eindeutige Bezeichner für das Ergebniselement.

Das Snap-In sollte diesen Wert speichern, um das eingefügte Element (später) durch Aufrufen von Methoden wie IResultData::GetItem zu bearbeiten. Wenn dieser Wert nicht gespeichert ist, kann er mithilfe von IResultData::FindItemByLParam gesucht werden.

nIndex

Ein -Wert, der den nullbasierten Index des Elements angibt, auf das diese Struktur verweist.

nCol

Ein -Wert, der die Spalte angibt, für die ein Vorgang ausgeführt werden soll. Wenn der Vorgang für ein Element und nicht für eine Spalte ausgeführt werden soll, ist der Wert null (0).

str

Ein Zeiger auf eine NULL-endende Zeichenfolge, die den Elementtext enthält, wenn die Struktur das RDI_STR Item-Attribut angibt. Wenn dieser Member der MMC_CALLBACK Wert ist, ist das Element ein Rückrufelement.

Beachten Sie, dass das Snap-In MMC_TEXTCALLBACK anstelle von MMC_CALLBACK verwenden kann. Der MMC_TEXTCALLBACK Wert ist eine typgerechte (keine Umwandlung erforderlich) Version von MMC_CALLBACK.

MMC_TEXTCALLBACK wird in MMC Version 1.2 eingeführt.

nImage

Virtueller Bildindex des Listenansichtselements symbol in den Bildlisten mit großen und kleinen Symbolen. Beachten Sie, dass der Index des virtuellen Bilds intern dem tatsächlichen Index zugeordnet wird. Dieses Element kann auch als Rückrufelement angegeben werden: MMC_CALLBACK oder MMC_IMAGECALLBACK. Der MMC_IMAGECALLBACK Wert ist eine typkorrekte (keine Umwandlung erforderlich) Version von MMC_CALLBACK.

MMC_IMAGECALLBACK wird in MMC Version 1.2 eingeführt.

nState

Ein -Wert, der die Zustandsmaske für das Element angibt. Dieses Argument einen der folgenden Werte annehmen.

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. Es können mehrere Elemente ausgewählt werden, aber nur ein Element kann den Fokus haben.

LVIS_SELECTED

Das Element ist ausgewählt. Das Aussehen eines ausgewählten Elements hängt davon ab, ob es den Fokus hat, und von den für die Auswahl verwendeten Systemfarben.

Hinweis Um die LVIS_*- Konstanten zu verwenden, schließen Sie CommCtrl.h in Ihre Quelldatei ein.

 

lParam

Ein -Wert, der einen vom Benutzer bereitgestellten 32-Bit-Wert angibt, der dem Element zugeordnet werden soll. Dieses Element, auch als Cookie bezeichnet, ist der Wert, der als erster Parameter an IComponent::QueryDataObject übergeben wird.

iIndent

Reserviert.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista
Unterstützte Mindestversion (Server)	Windows Server 2008
Kopfzeile	mmc.h

Weitere Informationen

Iresultdata