TVM_GETITEMRECT Nachricht

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

Parameter

wParam

Wert, der den Teil des Elements angibt, für den das umgebende Rechteck abgerufen werden soll. Wenn dieser Parameter TRUE ist, enthält das umgebende Rechteck nur den Text des Elements. Andernfalls enthält es 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. Weitere Informationen zum Platzieren des Elementhandles in diesem Parameter finden Sie im folgenden Beispiel. Nach der Rückgabe aus der Nachricht enthält dieser Parameter das umgebende Rechteck. Die Koordinaten sind relativ zur oberen linken Ecke des Tree-View-Steuerelements.

Rückgabewert

Wenn das Element sichtbar ist und das umgebende Rechteck erfolgreich abgerufen wurde, ist der Rückgabewert TRUE. Andernfalls gibt die Nachricht FALSE zurück und ruft das umgebende 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);

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