LVBKIMAGEA-Struktur (commctrl.h)

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

Syntax

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

Angehörige

ulFlags

Typ: ULONG-

Dieses Mitglied kann eine oder mehrere der folgenden Flags sein. Sie können den LVBKIF_SOURCE_MASK Wert verwenden, um alle Quellkennzeichnungen zu maskieren. Sie können den LVBKIF_STYLE_MASK Wert verwenden, um alle Formatvorlagenkennzeichnungen zu maskieren.

Wert	Bedeutung
LVBKIF_SOURCE_NONE	Das Listenansicht-Steuerelement hat kein Hintergrundbild.
LVBKIF_SOURCE_HBITMAP	Eine Hintergrundbitmap wird über das hbm Mitglied von LVBKIMAGEbereitgestellt. Wenn die Nachricht erfolgreich LVM_SETBKIMAGE, übernimmt die Listenansicht den Besitz der Bitmap.
LVBKIF_SOURCE_URL	Das pszImage Member enthält die URL des Hintergrundbilds.
LVBKIF_STYLE_NORMAL	Das Hintergrundbild wird normal angezeigt.
LVBKIF_STYLE_TILE	Das Hintergrundbild wird nebeneinander angeordnet, um den gesamten Hintergrund des Steuerelements auszufüllen.
LVBKIF_FLAG_TILEOFFSET	Geben Sie die Koordinaten der ersten Kachel an. Dieses Kennzeichen ist nur gültig, wenn auch das LVBKIF_STYLE_TILE Flag angegeben ist. Wenn diese Kennzeichnung nicht angegeben ist, beginnt die erste Kachel in der oberen linken Ecke des Clientbereichs. Wenn Sie ComCtl32.dll Version 6.0 die xOffsetPercent und yOffsetPercent Felder Pixel und keine Prozentwerte enthalten, um die Koordinaten der ersten Kachel anzugeben. Comctl32.dll Version 6 ist nicht weiterverteilbar, ist 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 Wasserzeichen-Hintergrundbitmap wird über das hbm- Mitglied von LVBKIMAGE-bereitgestellt. Wenn die LVM_SETBKIMAGE Nachricht erfolgreich ist, übernimmt das Listenansichtssteuerelement den Besitz der Bitmap.
LVBKIF_FLAG_ALPHABLEND	Nur gültig, wenn auch LVBKIF_TYPE_WATERMARK angegeben wird. Dieses Kennzeichen gibt an, dass die über LVBKIF_TYPE_WATERMARK bereitgestellte Bitmap einen gültigen Alphakanal enthält.

hbm

Typ: HBITMAP-

Das Handle der Hintergrundbitmap. Dieses Element ist nur gültig, wenn das LVBKIF_SOURCE_HBITMAP Flag in ulFlagsfestgelegt ist.

pszImage

Typ: LPTSTR-

Adresse einer MIT NULL beendeten Zeichenfolge, die die URL des Hintergrundbilds enthält. Dieses Element ist nur gültig, wenn das LVBKIF_SOURCE_URL Flag in ulFlags-festgelegt ist. Dieses Element 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. Dieses Element ist nur gültig, wenn LVBKIF_STYLE_NORMAL in ulFlags-angegeben wird. Wenn sowohl LVBKIF_FLAG_TILEOFFSET als auch LVBKIF_STYLE_TILE in ulFlagsangegeben werden, gibt der Wert das Pixel und nicht den Prozentualen Abstand 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. Dieses Element ist nur gültig, wenn LVBKIF_STYLE_NORMAL in ulFlags-angegeben wird. Wenn sowohl LVBKIF_FLAG_TILEOFFSET als auch LVBKIF_STYLE_TILE in ulFlagsangegeben werden, gibt der Wert das Pixel und nicht den Prozentualen Abstand der ersten Kachel an. Andernfalls wird der Wert ignoriert.

Bemerkungen

Diese Struktur wird mit den LVM_GETBKIMAGE und LVM_SETBKIMAGE Nachrichten verwendet.

Anmerkung

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
mindestens unterstützte Client-	Windows Vista [nur Desktop-Apps]
mindestens unterstützte Server-	Windows Server 2003 [Nur Desktop-Apps]
Header-	commctrl.h