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 |
|---|---|
|
Das Listenansicht-Steuerelement verfügt über kein Hintergrundbild. |
|
Eine Hintergrundbitmap wird über das hbm-Element von LVBKIMAGE bereitgestellt. Wenn die Meldung erfolgreich LVM_SETBKIMAGE , übernimmt die Listenansicht den Besitz der Bitmap. |
|
Das pszImage-Element enthält die URL des Hintergrundbilds. |
|
Das Hintergrundbild wird normal angezeigt. |
|
Das Hintergrundbild wird so angeordnet, dass der gesamte Hintergrund des Steuerelements ausgefüllt wird. |
|
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. |
|
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. |
|
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 |