Bagikan melalui

Struktur LITEM (commctrl.h)

  • Artikel

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