TVM _ GETITEMRECT-Nachricht

Ruft das umgrenzende Rechteck für ein Strukturansichtselement ab und gibt an, ob das Element sichtbar ist. Sie können diese Nachricht explizit oder mithilfe des TreeView _ GetItemRect-Makros senden.

Parameter

wParam

Wert, der den Teil des Elements angibt, für das das umgebende Rechteck abgerufen werden soll. Wenn dieser Parameter TRUE ist, enthält das umgrenzende Rechteck nur den Text des Elements. Andernfalls enthält sie die gesamte Zeile, die das Element im Strukturansichtssteuerelement einnimmt.

lParam

Zeiger auf eine RECT-Struktur, die beim Senden der Nachricht das Handle des Elements enthält, für das das Rechteck abgerufen werden soll. Im folgenden Beispiel finden Sie weitere Informationen zum Platzieren des Elementhandle in diesem Parameter. Nach der Rückgabe aus der Nachricht enthält dieser Parameter das umgrenzende Rechteck. Die Koordinaten sind relativ zur oberen linken Ecke des Strukturansichtssteuerelements.

Rückgabewert

Wenn das Element sichtbar ist und das umgebende Rechteck erfolgreich abgerufen wurde, lautet der Rückgabewert TRUE. Andernfalls gibt die Nachricht FALSE zurück und ruft das umgrenzende Rechteck nicht ab.

Bemerkungen

Beim Senden dieser Nachricht enthält der lParam-Parameter das Handle des Elements, für das das Rechteck abgerufen wird. Das Handle wird in lParam platziert, wie im folgenden Beispiel gezeigt:

RECT rc;

*(HTREEITEM*)&rc = hTreeItem;

SendMessage(hwndTreeView, TVM_GETITEMRECT, FALSE, (LPARAM)&rc);

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