Struktur LITEM (commctrl.h)

Digunakan untuk mengatur dan mengambil informasi tentang item tautan.

Sintaks

typedef struct tagLITEM {
  UINT  mask;
  int   iLink;
  UINT  state;
  UINT  stateMask;
  WCHAR szID[MAX_LINKID_TEXT];
  WCHAR szUrl[L_MAX_URL_LENGTH];
} LITEM, *PLITEM;

Anggota

mask

Jenis: UINT

Kombinasi satu atau beberapa bendera berikut, yang menjelaskan informasi untuk mengatur atau mengambil:

Nilai	Makna
LIF_ITEMINDEX	Ambil indeks item numerik. Item selalu diakses oleh indeks, oleh karena itu Anda harus selalu mengatur bendera ini dan menetapkan nilai ke iLink. Untuk mendapatkan ID item, Anda harus mengatur LIF_ITEMINDEX dan LIF_ITEMID.
LIF_STATE	Gunakan stateMask untuk mendapatkan atau mengatur status tautan.
LIF_ITEMID	Tentukan item menurut nilai ID yang diberikan dalam szID.
LIF_URL	Atur atau dapatkan URL untuk item ini.

iLink

Jenis: int

Nilai tipe int yang berisi indeks item. Indeks numerik ini digunakan untuk mengakses tautan kontrol SysLink.

state

Jenis: UINT

Kombinasi satu atau beberapa bendera berikut, yang menjelaskan status item:

Nilai	Makna
LIS_ENABLED	Tautan dapat merespons input pengguna. Ini adalah default kecuali seluruh kontrol dibuat dengan WS_DISABLED. Dalam hal ini, semua tautan dinonaktifkan.
LIS_FOCUSED	Tautan memiliki fokus keyboard. Menekan ENTER mengirimkan pemberitahuan NM_CLICK.
LIS_VISITED	Tautan telah dikunjungi oleh pengguna. Mengubah URL menjadi URL yang belum dikunjungi menyebabkan bendera ini dibersihkan.
LIS_HOTTRACK	Menunjukkan bahwa kontrol syslink akan disorot dengan warna yang berbeda (COLOR_HIGHLIGHT) saat mouse mengarah ke kontrol.
LIS_DEFAULTCOLORS	Aktifkan warna teks kustom yang akan digunakan.

stateMask

Jenis: UINT

Kombinasi bendera yang menjelaskan item status mana yang akan diperoleh atau diatur. Item yang diizinkan identik dengan item yang diizinkan dalam status.

szID[MAX_LINKID_TEXT]

Jenis: WCHAR[MAX_LINKID_TEXT]

String WCHAR yang berisi nama ID. Jumlah maksimum karakter dalam array adalah MAX_LINKID_TEXT. Nama ID tidak dapat digunakan untuk mengakses tautan kontrol SysLink. Anda menggunakan indeks item untuk mengakses item.

szUrl[L_MAX_URL_LENGTH]

Jenis: WCHAR[L_MAX_URL_LENGTH]

String WCHAR yang berisi URL yang diwakili oleh tautan. Jumlah maksimum karakter dalam array adalah L_MAX_URL_LENGTH.

Persyaratan

Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Header	commctrl.h