TTTOOLINFOW-Struktur (commctrl.h)

Artikel
02/26/2024

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

Syntax

typedef struct tagTOOLINFOW {
  UINT      cbSize;
  UINT      uFlags;
  HWND      hwnd;
  UINT_PTR  uId;
  RECT      rect;
  HINSTANCE hinst;
  LPWSTR    lpszText;
  LPARAM    lParam;
  void      *lpReserved;
} TTTOOLINFOW, *PTOOLINFOW, *LPTTTOOLINFOW;

Member

cbSize

Typ: UINT

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

uFlags

Typ: UINT

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

Wert	Bedeutung
TTF_ABSOLUTE	Positioniert das QuickInfo-Fenster an den gleichen Koordinaten, die von TTM_TRACKPOSITION bereitgestellt werden. Dieses Flag muss mit dem flag TTF_TRACK 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, aber 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 QuickInfo-Text in entgegengesetzter Richtung zum Text im übergeordneten Fenster angezeigt wird.
TTF_SUBCLASS	Gibt an, dass das QuickInfo-Steuerelement das Toolfenster 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 gesteuert werden, finden Sie unter TTM_RELAYEVENT.
TTF_TRACK	Positioniert das QuickInfo-Fenster neben dem Tool, dem es entspricht, und verschiebt das Fenster entsprechend den Koordinaten, die von den TTM_TRACKPOSITION Meldungen bereitgestellt werden. Sie müssen diesen Tooltyp mithilfe der TTM_TRACKACTIVATE-Meldung aktivieren.
TTF_TRANSPARENT	Bewirkt, dass das QuickInfo-Steuerelement Mausereignismeldungen an das übergeordnete Fenster weiterleite. Dies ist auf Mausereignisse beschränkt, die innerhalb der Grenzen des QuickInfofensters auftreten.

hwnd

Typ: HWND

Handle für das Fenster, das das Tool enthält. Wenn lpszText den LPSTR_TEXTCALLBACK Wert 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 durch hwnd identifizierten Fensters. Wenn uFlags das flag TTF_IDISHWND enthält, wird dieses Element ignoriert.

hinst

Typ: HINSTANCE

Verarbeiten 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 oder den Bezeichner der Zeichenfolgenressource enthält, 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 von der Anwendung definierter 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. Fenster können in Anzeigesprachen wie Hebräisch oder Arabisch gespiegelt werden, die von rechts nach links (RTL) gelesen werden. Normalerweise wird QuickInfo-Text in derselben Richtung wie der Text im übergeordneten Fenster angezeigt. Wenn TTF_RTLREADING festgelegt ist, wird der 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 Code, der nicht Codierungsneutral ist, 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

Share via