Структура LITEM (commctrl.h)

Используется для задания и получения сведений об элементе ссылки.

Синтаксис

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

Члены

mask

Тип: UINT

Сочетание одного или нескольких следующих флагов, описывающих сведения для задания или извлечения:

Значение	Значение
LIF_ITEMINDEX	Получение индекса числового элемента. Доступ к элементам всегда выполняется по индексу, поэтому необходимо всегда устанавливать этот флаг и присваивать значение iLink. Чтобы получить идентификатор элемента, необходимо задать LIF_ITEMINDEX и LIF_ITEMID.
LIF_STATE	Используйте stateMask , чтобы получить или задать состояние ссылки.
LIF_ITEMID	Укажите элемент по значению идентификатора, указанному в szID.
LIF_URL	Задайте или получите URL-адрес для этого элемента.

iLink

Тип: int

Значение типа int , содержащего индекс элемента. Этот числовой индекс используется для доступа к ссылке элемента управления SysLink.

state

Тип: UINT

Сочетание одного или нескольких следующих флагов, описывающих состояние элемента:

Значение	Значение
LIS_ENABLED	Ссылка может отвечать на введенные пользователем данные. Это значение по умолчанию, если только весь элемент управления не был создан с помощью WS_DISABLED. В этом случае все ссылки отключены.
LIS_FOCUSED	Ссылка содержит фокус клавиатуры. При нажатии клавиши ВВОД отправляется уведомление NM_CLICK.
LIS_VISITED	Пользователь посетил ссылку. Изменение URL-адреса на не посещенный приведет к снятию этого флага.
LIS_HOTTRACK	Указывает, что элемент управления syslink будет выделяться другим цветом (COLOR_HIGHLIGHT) при наведении указателя мыши на элемент управления.
LIS_DEFAULTCOLORS	Включите пользовательские цвета текста.

stateMask

Тип: UINT

Сочетание флагов, описывающих, какой элемент состояния следует получить или задать. Допустимые элементы идентичны разрешенным в состоянии.

szID[MAX_LINKID_TEXT]

Тип: WCHAR[MAX_LINKID_TEXT]

Строка WCHAR, содержащая имя идентификатора. Максимальное количество символов в массиве равно MAX_LINKID_TEXT. Имя идентификатора не может использоваться для доступа к ссылке элемента управления SysLink. Для доступа к элементу используется индекс элемента.

szUrl[L_MAX_URL_LENGTH]

Тип: WCHAR[L_MAX_URL_LENGTH]

Строка WCHAR, содержащая URL-адрес, представленный ссылкой. Максимальное количество символов в массиве — L_MAX_URL_LENGTH.

Требования

Минимальная версия клиента	Windows Vista [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Верхняя часть	commctrl.h