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

設定または取得する情報を記述する、次のフラグの 1 つ以上の組み合わせ。

値 意味
LIF_ITEMINDEX
 数値項目インデックスを取得します。 アイテムは常にインデックスによってアクセスされるため、常にこのフラグを設定し、 iLink に値を割り当てる必要があります。 アイテム ID を取得するには、LIF_ITEMINDEXとLIF_ITEMIDの両方を設定する必要があります。
LIF_STATE
 stateMask を使用して、リンクの状態を取得または設定します。
LIF_ITEMID
 szID で指定された ID 値で項目を指定します。
LIF_URL
 このアイテムの URL を設定または取得します。

iLink

型: int

項目インデックスを含む int 型の値。 この数値インデックスは、SysLink コントロール リンクにアクセスするために使用されます。

state

型: UINT

項目の状態を記述する、次のフラグの 1 つ以上の組み合わせ。

値 意味
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 (デスクトップ アプリのみ)
Header commctrl.h