Freigeben über


LVBKIMAGEA-Struktur (commctrl.h)

Enthält Informationen zum Hintergrundbild eines Listenansicht-Steuerelements. Diese Struktur wird sowohl zum Festlegen als auch zum Abrufen von Hintergrundbildinformationen verwendet.

Syntax

typedef struct tagLVBKIMAGEA {
  ULONG   ulFlags;
  HBITMAP hbm;
  LPSTR   pszImage;
  UINT    cchImageMax;
  int     xOffsetPercent;
  int     yOffsetPercent;
} LVBKIMAGEA, *LPLVBKIMAGEA;

Member

ulFlags

Typ: ULONG

Bei diesem Member kann es sich um ein oder mehrere der folgenden Flags handelt. Sie können den LVBKIF_SOURCE_MASK-Wert verwenden, um alle Quellflags außer den Quellflags zu maskieren. Sie können den LVBKIF_STYLE_MASK-Wert verwenden, um alle Stilflags außer den Stilflags zu maskieren.

Wert Bedeutung
LVBKIF_SOURCE_NONE
Das Listenansicht-Steuerelement verfügt über kein Hintergrundbild.
LVBKIF_SOURCE_HBITMAP
Eine Hintergrundbitmap wird über das hbm-Element von LVBKIMAGE bereitgestellt. Wenn die Meldung erfolgreich LVM_SETBKIMAGE , übernimmt die Listenansicht den Besitz der Bitmap.
LVBKIF_SOURCE_URL
Das pszImage-Element enthält die URL des Hintergrundbilds.
LVBKIF_STYLE_NORMAL
Das Hintergrundbild wird normal angezeigt.
LVBKIF_STYLE_TILE
Das Hintergrundbild wird so angeordnet, dass der gesamte Hintergrund des Steuerelements ausgefüllt wird.
LVBKIF_FLAG_TILEOFFSET
Geben Sie die Koordinaten der ersten Kachel an. Dieses Flag ist nur gültig, wenn auch das LVBKIF_STYLE_TILE-Flag angegeben ist. Wenn dieses Flag nicht angegeben ist, beginnt die erste Kachel in der oberen linken Ecke des Clientbereichs. Wenn Sie ComCtl32.dll Version 6.0 verwenden, enthalten die Felder xOffsetPercent und yOffsetPercent Pixel und keine Prozentwerte, um die Koordinaten der ersten Kachel anzugeben. Comctl32.dll Version 6 ist nicht verteilbar, aber in Windows oder höher enthalten. Außerdem müssen Sie Comctl32.dll Version 6 in einem Manifest angeben. Weitere Informationen zu Manifesten finden Sie unter Aktivieren von visuellen Formatvorlagen.
LVBKIF_TYPE_WATERMARK
Eine Bitmap im Wasserzeichenhintergrund wird über das hbm-Element von LVBKIMAGE bereitgestellt. Wenn die LVM_SETBKIMAGE Meldung erfolgreich ist, übernimmt das Listenansicht-Steuerelement den Besitz der Bitmap.
LVBKIF_FLAG_ALPHABLEND
Nur gültig, wenn auch LVBKIF_TYPE_WATERMARK angegeben ist. Dieses Flag gibt an, dass die über LVBKIF_TYPE_WATERMARK bereitgestellte Bitmap einen gültigen Alphakanal enthält.

hbm

Typ: HBITMAP

Das Handle der Hintergrundbit. Dieser Member ist nur gültig, wenn das flag LVBKIF_SOURCE_HBITMAP in ulFlags festgelegt ist.

pszImage

Typ: LPTSTR

Adresse einer NULL-beendeten Zeichenfolge, die die URL des Hintergrundbilds enthält. Dieser Member ist nur gültig, wenn das flag LVBKIF_SOURCE_URL in ulFlags festgelegt ist. Dieser Member muss initialisiert werden, um auf den Puffer zu verweisen, der den Text enthält oder empfängt, bevor die Nachricht gesendet wird.

cchImageMax

Typ: UINT

Größe des Puffers an der Adresse in pszImage. Wenn Informationen an das Steuerelement gesendet werden, wird dieses Element ignoriert.

xOffsetPercent

Typ: int

Prozentsatz des Clientbereichs des Steuerelements, in dem das Bild horizontal versetzt werden soll. Bei 0 Prozent wird das Bild beispielsweise am linken Rand des Clientbereichs des Steuerelements angezeigt. Bei 50 Prozent wird das Bild horizontal zentriert im Clientbereich des Steuerelements angezeigt. Bei 100 Prozent wird das Bild am rechten Rand des Clientbereichs des Steuerelements angezeigt. Dieser Member ist nur gültig, wenn LVBKIF_STYLE_NORMAL in ulFlags angegeben ist. Wenn sowohl LVBKIF_FLAG_TILEOFFSET als auch LVBKIF_STYLE_TILE in ulFlags angegeben sind, gibt der Wert das Pixel und nicht den Prozentualen Offset der ersten Kachel an. Andernfalls wird der Wert ignoriert.

yOffsetPercent

Typ: int

Prozentsatz des Clientbereichs des Steuerelements, in dem das Bild vertikal versetzt werden soll. Bei 0 Prozent wird das Bild beispielsweise am oberen Rand des Clientbereichs des Steuerelements angezeigt. Bei 50 Prozent wird das Bild vertikal zentriert im Clientbereich des Steuerelements angezeigt. Bei 100 Prozent wird das Bild am unteren Rand des Clientbereichs des Steuerelements angezeigt. Dieser Member ist nur gültig, wenn LVBKIF_STYLE_NORMAL in ulFlags angegeben ist. Wenn sowohl LVBKIF_FLAG_TILEOFFSET als auch LVBKIF_STYLE_TILE in ulFlags angegeben sind, gibt der Wert das Pixel und nicht den Prozentualen Offset der ersten Kachel an. Andernfalls wird der Wert ignoriert.

Hinweise

Diese Struktur wird mit den LVM_GETBKIMAGE - und LVM_SETBKIMAGE-Nachrichten verwendet.

Hinweis

Der commctrl.h-Header definiert LVBKIMAGE als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht Codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

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