Freigeben über

TTTOOLINFOA-Struktur (commctrl.h)

  • Artikel

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;

Angehörige

cbSize

Typ: UINT-

Größe dieser Struktur in Byte. Dieses Element muss angegeben werden.

uFlags

Typ: UINT-

Flags, die die QuickInfo-Anzeige steuern. Dieses Element kann eine Kombination aus den folgenden Werten sein:

Wert Bedeutung
TTF_ABSOLUTE
 Positioniert das QuickInfo-Fenster an den gleichen Koordinaten, die von TTM_TRACKPOSITIONbereitgestellt werden. Dieses Kennzeichen muss mit dem TTF_TRACK Flag verwendet werden.
TTF_CENTERTIP
 Zentriert das QuickInfo-Fenster unter dem tool, das durch das uId Mitglied angegeben wird.
TTF_IDISHWND
 Gibt an, dass das uId- Mitglied das Fensterhandle für das Tool ist. Wenn dieses Kennzeichen nicht festgelegt ist, ist uId- der Bezeichner des Tools.
TTF_PARSELINKS

Version 6.0 und höher. Gibt an, dass Links im QuickInfo-Text analysiert werden sollen.

Beachten Sie, dass Comctl32.dll Version 6 nicht weiterverteilt werden kann, aber in Windows oder höher enthalten ist. Wenn Sie Comctl32.dll Version 6 verwenden möchten, 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 Fenster des Tools unterklassen soll, um Nachrichten abzufangen, z. B. WM_MOUSEMOVE. Wenn dieses Kennzeichen nicht festgelegt ist, müssen Sie die TTM_RELAYEVENT Nachricht verwenden, um Nachrichten an das QuickInfo-Steuerelement weiterzuleiten. Eine Liste der Nachrichten, die von einem QuickInfo-Steuerelement verarbeitet 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 Nachrichten bereitgestellt werden. Sie müssen diesen Tooltyp mithilfe der TTM_TRACKACTIVATE Nachricht 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 QuickInfo-Fensters auftreten.

hwnd

Typ: HWND-

Behandeln Sie 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 TTF_IDISHWND Flag enthält, muss uId- den Fensterziehpunkt für das Tool angeben.

rect

Typ: RECT-

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

hinst

Typ: HINSTANCE-

Behandeln Sie die Instanz, die die Zeichenfolgenressource für das Tool enthält. Wenn lpszText- den Bezeichner einer Zeichenfolgenressource angibt, wird dieses Element verwendet.

lpszText

Typ: LPTSTR-

Zeigen Sie auf den Puffer, der den Text für das Tool enthält, oder den Bezeichner der Zeichenfolgenressource, die den Text enthält. Dieses Element wird manchmal verwendet, um Werte zurückzugeben. Wenn Sie den zurückgegebenen Wert untersuchen müssen, müssen Sie auf einen gültigen Puffer mit ausreichender Größe verweisen. Andernfalls kann sie 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 32-Bit-anwendungsdefinierter Wert, der dem Tool zugeordnet ist.

lpReserved

Typ: void*

Reserviert. Muss auf NULL-festgelegt sein.

Bemerkungen

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, liest QuickInfo-Text in entgegengesetzter Richtung aus dem Text im übergeordneten Fenster.

Anmerkung

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
mindestens unterstützte Client- Windows Vista [nur Desktop-Apps]
mindestens unterstützte Server- Windows Server 2003 [Nur Desktop-Apps]
Header- commctrl.h