TTTOOLINFOA-Struktur (commctrl.h)

Die TOOLINFO-Struktur enthält Informationen zu einem Tool in einem QuickInfo-Steuerelement.

Syntax

typedef struct tagTOOLINFOA {
  UINT      cbSize;
  UINT      uFlags;
  HWND      hwnd;
  UINT_PTR  uId;
  RECT      rect;
  HINSTANCE hinst;
  LPSTR     lpszText;
  LPARAM    lParam;
  void      *lpReserved;
} TTTOOLINFOA, *PTOOLINFOA, *LPTTTOOLINFOA;

Member

cbSize

Typ: UINT

Größe dieser Struktur in Bytes. Dieser Member muss angegeben werden.

uFlags

Typ: UINT

Flags, die die QuickInfo-Anzeige steuern. Dieses Element kann eine Kombination der folgenden Werte sein:

Wert	Bedeutung
TTF_ABSOLUTE	Positioniert das QuickInfofenster an den gleichen Koordinaten, die von TTM_TRACKPOSITION bereitgestellt werden. Dieses Flag muss mit dem TTF_TRACK-Flag verwendet werden.
TTF_CENTERTIP	Zentriert das QuickInfo-Fenster unterhalb des vom uId-Member angegebenen Tools.
TTF_IDISHWND	Gibt an, dass das uId-Element das Fensterhandle für das Tool ist. Wenn dieses Flag nicht festgelegt ist, ist uId der Bezeichner des Tools.
TTF_PARSELINKS	Version 6.0 und höher. Gibt an, dass Links im QuickInfotext analysiert werden sollen. Beachten Sie, dass Comctl32.dll Version 6 nicht verteilbar ist, sondern in Windows oder höher enthalten ist. Um Comctl32.dll Version 6 zu verwenden, geben Sie sie in einem Manifest an. Weitere Informationen zu Manifesten finden Sie unter Aktivieren von visuellen Formatvorlagen.
TTF_RTLREADING	Gibt an, dass der QuickInfotext in der entgegengesetzten Richtung zum Text im übergeordneten Fenster angezeigt wird.
TTF_SUBCLASS	Gibt an, dass das QuickInfo-Steuerelement das Fenster des Tools unterklassieren soll, um Nachrichten abzufangen, z. B. WM_MOUSEMOVE. Wenn dieses Flag nicht festgelegt ist, müssen Sie die TTM_RELAYEVENT Nachricht verwenden, um Nachrichten an das QuickInfo-Steuerelement weiterzuleiten. Eine Liste der Nachrichten, die von einer QuickInfo-Steuerung verarbeitet werden, finden Sie unter TTM_RELAYEVENT.
TTF_TRACK	Positioniert das QuickInfofenster neben dem Tool, dem es entspricht, und verschiebt das Fenster entsprechend den Koordinaten, die von den TTM_TRACKPOSITION Meldungen angegeben werden. Sie müssen diesen Tooltyp mithilfe der TTM_TRACKACTIVATE-Nachricht aktivieren.
TTF_TRANSPARENT	Bewirkt, dass das QuickInfo-Steuerelement Mausereignismeldungen an das übergeordnete Fenster weiterleitt. Dies ist auf Mausereignisse beschränkt, die innerhalb der Grenzen des QuickInfofensters auftreten.

hwnd

Typ: HWND

Handle mit dem Fenster, das das Tool enthält. Wenn lpszText den wert LPSTR_TEXTCALLBACK enthält, identifiziert dieses Element das Fenster, das die TTN_GETDISPINFO Benachrichtigungscodes empfängt.

uId

Typ: UINT_PTR

Anwendungsdefinierter Bezeichner des Tools. Wenn uFlags das flag TTF_IDISHWND enthält, muss uId das Fensterhandle für das Tool angeben.

rect

Typ: RECT

Die begrenzungsenden Rechteckkoordinaten des Tools. Die Koordinaten sind relativ zur oberen linken Ecke des Clientbereichs des von hwnd identifizierten Fensters. Wenn uFlags das TTF_IDISHWND-Flag enthält, wird dieses Element ignoriert.

hinst

Typ: HINSTANCE

Behandeln Sie den instance, der die Zeichenfolgenressource für das Tool enthält. Wenn lpszText den Bezeichner einer Zeichenfolgenressource angibt, wird dieser Member verwendet.

lpszText

Typ: LPTSTR

Zeiger auf den Puffer, der den Text für das Tool enthält, oder den Bezeichner der Zeichenfolgenressource, die den Text enthält. Dieser Member wird manchmal verwendet, um Werte zurückzugeben. Wenn Sie den zurückgegebenen Wert untersuchen müssen, muss auf einen gültigen Puffer mit ausreichender Größe verweisen. Andernfalls kann er auf NULL festgelegt werden. Wenn lpszText auf LPSTR_TEXTCALLBACK festgelegt ist, sendet das Steuerelement den TTN_GETDISPINFO Benachrichtigungscode an das Besitzerfenster, um den Text abzurufen.

lParam

Typ: LPARAM

Version 4.70 und höher. Ein anwendungsdefinierter 32-Bit-Wert, der dem Tool zugeordnet ist.

lpReserved

Typ: void*

Reserviert. Muss auf NULL festgelegt werden.

Hinweise

Normale Fenster zeigen Text von links nach rechts (LTR) an. Windows kann gespiegelt werden, um Sprachen wie Hebräisch oder Arabisch anzuzeigen, die von rechts nach links (RTL) gelesen werden. Normalerweise wird QuickInfo-Text in der gleichen Richtung wie der Text im übergeordneten Fenster angezeigt. Wenn TTF_RTLREADING festgelegt ist, wird QuickInfo-Text in entgegengesetzter Richtung vom Text im übergeordneten Fenster gelesen.

Hinweis

Der commctrl.h-Header definiert TTTOOLINFO als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit nicht codierungsneutralem Code kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

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