共用方式為

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
 連結具有鍵盤焦點。 按 ENTER 會傳送NM_CLICK通知。
LIS_VISITED
 使用者已流覽連結。 將 URL 變更為尚未流覽的 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]

包含連結所表示 URL 的WCHAR字串。 陣列中的字元數上限為 L_MAX_URL_LENGTH。

規格需求

   
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限桌面應用程式]
標頭 commctrl.h