TTM _ ADJUSTRECT-Nachricht

Berechnet das Textanzeigerechteck eines QuickInfo-Steuerelements aus seinem Fensterrechteck oder das QuickInfo-Fensterrechteck, das zum Anzeigen eines angegebenen Textanzeigerechtecks benötigt wird.

Parameter

wParam

Wert, der angibt, welcher Vorgang ausgeführt werden soll. True gibt an, dass lParam zum Angeben eines Textanzeigerechtecks verwendet wird und das entsprechende Fensterrechteck empfängt. False gibt an, dass lParam zum Angeben eines Fensterrechtecks verwendet wird und das entsprechende Textanzeigerechteck empfängt.

lParam

RECT-Struktur zum Speichern eines QuickInfo-Fensterrechtecks oder eines Rechtecks für die Textanzeige.

Rückgabewert

Gibt einen Wert ungleich 0 (null) zurück, wenn das Rechteck erfolgreich angepasst wurde, und gibt 0 (null) zurück, wenn ein Fehler auftritt.

Bemerkungen

Diese Meldung ist besonders nützlich, wenn Sie ein QuickInfo-Steuerelement verwenden möchten, um den Volltext einer Zeichenfolge anzuzeigen, die normalerweise abgeschnitten wird. Es wird häufig mit Listview- und Treeview-Steuerelementen verwendet. In der Regel senden Sie diese Nachricht als Reaktion auf einen TTN _ SHOW-Benachrichtigungscode, damit Sie das QuickInfo-Steuerelement ordnungsgemäß positionieren können.

Das QuickInfo-Fensterrechteck ist etwas größer als das Textanzeigerechteck, das die QuickInfo-Zeichenfolge umgrenzt. Der Fensterursprung wird auch nach oben und links vom Ursprung des Rechtecks für die Textanzeige versetzt. Um das Textanzeigerechteck zu positionieren, müssen Sie das entsprechende Fensterrechteck berechnen und dieses Rechteck verwenden, um die QuickInfo zu positionieren. TTM _ ADJUSTRECT übernimmt diese Berechnung für Sie.

Wenn Sie wParam auf TRUE festlegen, übernimmt TTM _ ADJUSTRECT die Größe und Position des gewünschten QuickInfo-Textanzeigerechtecks und übergibt die Größe und Position des QuickInfo-Fensters zurück, das zum Anzeigen des Texts an der angegebenen Position erforderlich ist. Wenn Sie wParam auf FALSE festlegen, können Sie ein QuickInfo-Fensterrechteck angeben, und TTM _ ADJUSTRECT gibt die Größe und Position des Textrechtecks zurück.

Das folgende Codefragment veranschaulicht die Verwendung der TTM _ ADJUSTRECT-Nachricht zum Positionieren eines QuickInfo-Steuerelements, um den Volltext der Zeichenfolge eines Steuerelements anstelle einer abgeschnittenen Zeichenfolge anzuzeigen. Die anwendungsdefinierte GetMyItemRect-Funktion gibt das Textrechteck zurück, das benötigt wird, um den QuickInfo-Text direkt über der abgeschnittenen Zeichenfolge anzuzeigen. Die Details der Implementierung dieser Funktion hängen vom jeweiligen Steuerelement ab. TTM _ ADJUSTRECT wird verwendet, um dieses Textrechteck an das QuickInfo-Steuerelement zu senden. Sie gibt ein entsprechend dimensioniertes und positioniertes Fensterrechteck zurück, das dann zum Positionieren des QuickInfo-Fensters verwendet wird.

case TTN_SHOW:

if (MyStringIsTruncated) {
    RECT rc;
    
    GetMyItemRect(&rc);
    SendMessage(hwndToolTip, TTM_ADJUSTRECT, TRUE, (LPARAM)&rc);
    SetWindowPos(hwndToolTip,
                 NULL,
                 rc.left, rc.top,
                 0, 0,
                 SWP_NOSIZE|SWP_NOZORDER|SWP_NOACTIVATE);
} 

Requirements (Anforderungen)

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows [Nur Vista-Desktop-Apps]
Unterstützte Mindestversion (Server)
Windows Nur Server [ 2003-Desktop-Apps]
Header
Commctrl.h