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