TTM_ADJUSTRECT Nachricht

Berechnet das Textanzeigerechteck eines QuickInfo-Steuerelements aus dem Fensterrechteck oder das QuickInfofensterrechteck, das zum Anzeigen eines angegebenen Textanzeigerechtecks erforderlich ist.

Parameter

wParam

Wert, der angibt, welcher Vorgang ausgeführt werden soll. Wenn TRUE, wird lParam verwendet, um ein Textanzeigerechteck anzugeben, und es empfängt das entsprechende Fensterrechteck. Bei FALSE wird lParam verwendet, um ein Fensterrechteck anzugeben, und es empfängt das entsprechende Textanzeigerechteck.

lParam

RECT-Struktur , um entweder ein QuickInfo-Fensterrechteck oder ein Textanzeigerechteck zu enthalten.

Rückgabewert

Gibt einen Wert ohne Zero zurück, wenn das Rechteck erfolgreich angepasst wurde, und gibt null zurück, wenn ein Fehler auftritt.

Bemerkungen

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

Das QuickInfofenster-Rechteck ist etwas größer als das Textanzeigerechteck, das die QuickInfo-Zeichenfolge umgrenzt. Der Fensterursprung ist auch vom Ursprung des Textanzeigerechtecks nach oben und links 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 QuickInfotext-Anzeigerechtecks und gibt die Größe und Position des QuickInfofensters 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 die Größe und Position des Textrechtecks zurückgeben.

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 QuickInfotext 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. Es gibt ein entsprechend großes und positioniertes Fensterrechteck zurück, das dann zum Positionieren des QuickInfofensters 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);
} 

Anforderungen

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