LITEM-Struktur (commctrl.h)

  • Artikel

Dient zum Festlegen und Abrufen von Informationen zu einem Linkelement.

Syntax

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

Member

mask

Typ: UINT

Kombination aus mindestens einem der folgenden Flags, die die festzulegenden oder abzurufenden Informationen beschreiben:

Wert Bedeutung
LIF_ITEMINDEX
 Rufen Sie den numerischen Elementindex ab. Auf Elemente wird immer über den Index zugegriffen. Daher müssen Sie immer dieses Flag festlegen und iLink einen Wert zuweisen. Um die Element-ID zu erhalten, müssen Sie sowohl LIF_ITEMINDEX als auch LIF_ITEMID festlegen.
LIF_STATE
 Verwenden Sie stateMask , um den Status des Links abzurufen oder festzulegen.
LIF_ITEMID
 Geben Sie das Element anhand des in szID angegebenen ID-Werts an.
LIF_URL
 Legen Sie die URL für dieses Element fest oder rufen Sie sie ab.

iLink

Typ: int

Wert des Typs int , der den Elementindex enthält. Dieser numerische Index wird verwendet, um auf einen SysLink-Steuerelementlink zuzugreifen.

state

Typ: UINT

Kombination aus mindestens einem der folgenden Flags, die den Status des Elements beschreiben:

Wert Bedeutung
LIS_ENABLED
 Der Link kann auf Benutzereingaben reagieren. Dies ist die Standardeinstellung, es sei denn, das gesamte Steuerelement wurde mit WS_DISABLED erstellt. In diesem Fall sind alle Links deaktiviert.
LIS_FOCUSED
 Der Link hat den Tastaturfokus. Durch Drücken der EINGABETASTE wird eine NM_CLICK Benachrichtigung gesendet.
LIS_VISITED
 Der Link wurde vom Benutzer aufgerufen. Wenn Sie die URL in eine URL ändern, die nicht besucht wurde, wird dieses Flag gelöscht.
LIS_HOTTRACK
 Gibt an, dass das syslink-Steuerelement in einer anderen Farbe (COLOR_HIGHLIGHT) hervorgehoben wird, wenn die Maus über das Steuerelement bewegt wird.
LIS_DEFAULTCOLORS
 Aktivieren Sie die Verwendung von benutzerdefinierten Textfarben.

stateMask

Typ: UINT

Kombination von Flags, die beschreiben, welches Zustandselement abgerufen oder festgelegt werden soll. Zulässige Elemente sind mit den zulässigen Elementen im Zustand identisch.

szID[MAX_LINKID_TEXT]

Typ: WCHAR[MAX_LINKID_TEXT]

WCHAR-Zeichenfolge , die den ID-Namen enthält. Die maximale Anzahl von Zeichen im Array ist MAX_LINKID_TEXT. Der ID-Name kann nicht für den Zugriff auf einen SysLink-Steuerelementlink verwendet werden. Sie verwenden den Elementindex, um auf das Element zuzugreifen.

szUrl[L_MAX_URL_LENGTH]

Typ: WCHAR[L_MAX_URL_LENGTH]

WCHAR-Zeichenfolge , die die durch den Link dargestellte URL enthält. Die maximale Anzahl von Zeichen im Array ist L_MAX_URL_LENGTH.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Kopfzeile commctrl.h