Struktur RESULTDATAITEM (mmc.h)

Artikel
03/08/2023

Struktur RESULTDATAITEM menentukan atau menerima atribut item hasil di panel hasil snap-in.

Sintaks

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

Anggota

mask

Sekumpulan bendera yang menentukan atribut struktur data ini, atau operasi yang menggunakan struktur ini.

Bendera berikut menentukan anggota struktur RESULTDATAITEM yang berisi data yang valid, atau perlu diisi dengan data. Satu atau beberapa bendera dapat diatur.

RDI_STR (0x0002)

Anggota str valid atau harus diisi.

RDI_IMAGE (0x0004)

Anggota nImage valid atau harus diisi.

RDI_STATE (0x0008)

Anggota nState valid atau harus diisi.

RDI_PARAM (0x0010)

Anggota lParam valid atau harus diisi.

RDI_INDEX (0x0020)

Anggota nIndex valid atau harus diisi.

RDI_INDENT (0x0040)

Anggota iIndent valid atau harus diisi.

bScopeItem

TRUE jika anggota lParam mengacu pada item cakupan. FALSE jika anggota lParam mengacu pada item hasil.

itemID

Nilai yang menentukan pengidentifikasi item unik yang disediakan konsol untuk item hasil. Nilai ini digunakan untuk mengidentifikasi item di panel hasil panggilan ke beberapa
Metode antarmuka IResultData .

Setelah snap-in berhasil menyisipkan item di panel cakupan (dengan menggunakan IResultData::InsertItem), anggota itemID struktur RESULTDATAITEM berisi handel HRESULTITEM dari item yang baru disisipkan. Handel ini adalah pengidentifikasi unik untuk item hasil.

Snap-in harus menyimpan nilai ini untuk memanipulasi (nanti) item yang disisipkan dengan memanggil metode seperti IResultData::GetItem. Jika nilai ini tidak disimpan, nilai ini dapat dicari dengan menggunakan IResultData::FindItemByLParam.

nIndex

Nilai yang menentukan indeks berbasis nol dari item yang dirujuk struktur ini.

nCol

Nilai yang menentukan kolom tempat operasi akan dilakukan. Jika operasi akan dilakukan pada item dan bukan kolom, nilainya adalah nol (0).

str

Penunjuk ke string yang dihentikan null yang berisi teks item jika struktur menentukan atribut item RDI_STR . Jika anggota ini adalah nilai MMC_CALLBACK , item tersebut adalah item panggilan balik.

Ketahuilah bahwa snap-in dapat menggunakan MMC_TEXTCALLBACK alih-alih MMC_CALLBACK. Nilai MMC_TEXTCALLBACK adalah versi MMC_CALLBACK yang benar jenis (tidak perlu transmisi).

MMC_TEXTCALLBACK diperkenalkan dalam MMC versi 1.2.

nImage

Indeks gambar virtual ikon item tampilan daftar di daftar gambar ikon besar dan kecil. Ketahuilah bahwa indeks gambar virtual dipetakan secara internal ke indeks aktual. Anggota ini juga dapat ditentukan sebagai item panggilan balik: MMC_CALLBACK atau MMC_IMAGECALLBACK. Nilai MMC_IMAGECALLBACK adalah versi MMC_CALLBACK yang benar jenis (tidak perlu transmisi).

MMC_IMAGECALLBACK diperkenalkan dalam MMC versi 1.2.

nState

Nilai yang menentukan masker status untuk item. Ini bisa menjadi salah satu nilai berikut.

LVIS_CUT

Item ditandai untuk operasi potong dan tempel.

LVIS_DROPHILITED

Item disorot sebagai target seret dan letakkan.

LVIS_FOCUSED

Item memiliki fokus, sehingga dikelilingi oleh persegi panjang fokus standar. Lebih dari satu item dapat dipilih, tetapi hanya satu item yang dapat memiliki fokus.

LVIS_SELECTED

Item dipilih. Tampilan item yang dipilih tergantung pada apakah item tersebut memiliki fokus, dan pada warna sistem yang digunakan untuk pemilihan.

Catatan Untuk menggunakan konstanta LVIS_* , sertakan CommCtrl.h dalam file sumber Anda.

lParam

Nilai yang menentukan nilai 32-bit yang disediakan pengguna untuk dikaitkan dengan item. Item ini, juga disebut cookie, adalah nilai yang diteruskan sebagai parameter pertama ke IComponent::QueryDataObject.

iIndent

Dicadangkan.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista
Server minimum yang didukung	Windows Server 2008
Header	mmc.h

Lihat juga

IResultData

Bagikan melalui