ListView_GetItemIndexRect Makro (commctrl.h)

  • Artikel

Ruft das umschließende Rechteck für das gesamte oder einen Teil eines Unterelements in der aktuellen Ansicht eines angegebenen Listenansicht-Steuerelements ab. Verwenden Sie dieses Makro, oder senden Sie die LVM_GETITEMINDEXRECT Nachricht explizit.

Syntax

void ListView_GetItemIndexRect(
  [in]       hwnd,
  [in]       plvii,
  [in]       iSubItem,
  [in]       code,
  [in, out]  prc
);

Parameter

[in] hwnd

Typ: HWND

Ein Handle für das Listenansichtssteuerelement.

[in] plvii

Typ: LVITEMINDEX*

Ein Zeiger auf eine LVITEMINDEX-Struktur für das übergeordnete Element des Unterelements. Der Aufrufer ist für die Zuweisung dieser Struktur und das Festlegen der Member verantwortlich. plvii darf nicht NULL sein.

[in] iSubItem

Typ: LONG

Der Index des Unterelements.

[in] code

Typ: LONG

Der Teil des Listenansicht-Unterelements, für den das umgebende Rechteck abgerufen werden soll. Dieser Parameter muss einen der folgenden Werte aufweisen.

Wert Bedeutung
LVIR_BOUNDS
 Gibt das umgebende Rechteck des gesamten Unterelements zurück, einschließlich des Symbols und der Bezeichnung.
LVIR_ICON
 Gibt das umgebende Rechteck des Symbols oder des kleinen Symbols des Unterelements zurück.
LVIR_LABEL
 Gibt das umgebende Rechteck des Unterelementtexts zurück.

[in, out] prc

Typ: LPRECT

Ein Zeiger auf eine RECT-Struktur , um die Koordinaten zu empfangen. Der Aufrufer ist für die Zuweisung dieser Struktur verantwortlich. prc darf nicht NULL sein.

Rückgabewert

Keine

Bemerkungen

Wenn iSubItem null ist, gibt dieses Makro die Koordinaten des Rechtecks an das Element zurück, auf das von plvii verwiesen wird. Der Wert LVIR_SELECTBOUNDS für den Parametercode wird nicht unterstützt.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile commctrl.h