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。 若要获取项 ID，必须同时设置LIF_ITEMINDEX和LIF_ITEMID。
LIF_STATE
 使用 stateMask 获取或设置链接的状态。
LIF_ITEMID
 通过 szID 中给定的 ID 值指定项。
LIF_URL
 设置或获取此项的 URL。

iLink

类型： int

包含项索引的 int 类型的值。 此数字索引用于访问 SysLink 控件链接。

state

类型： UINT

以下一个或多个标志的组合，描述项的状态：

值 含义
LIS_ENABLED
 该链接可以响应用户输入。 这是默认值，除非使用 WS_DISABLED 创建了整个控件。 在这种情况下，将禁用所有链接。
LIS_FOCUSED
 链接具有键盘焦点。 按 Enter 发送NM_CLICK通知。
LIS_VISITED
 用户已访问该链接。 将 URL 更改为尚未访问的 URL 会导致清除此标志。
LIS_HOTTRACK
 指示当鼠标悬停在控件上时，syslink 控件将以不同的颜色突出显示 (COLOR_HIGHLIGHT) 。
LIS_DEFAULTCOLORS
 启用要使用的自定义文本颜色。

stateMask

类型： UINT

描述要获取或设置哪个状态项的标志组合。 允许项与 状态中允许的项相同。

szID[MAX_LINKID_TEXT]

类型： WCHAR[MAX_LINKID_TEXT]

包含 ID 名称的 WCHAR 字符串。 数组中的最大字符数MAX_LINKID_TEXT。 ID 名称不能用于访问 SysLink 控件链接。 使用项索引访问项。

szUrl[L_MAX_URL_LENGTH]

类型： WCHAR[L_MAX_URL_LENGTH]

包含链接表示的 URL 的 WCHAR 字符串。 数组中的最大字符数为L_MAX_URL_LENGTH。

要求

   
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
标头 commctrl.h