Struttura LVBKIMAGEA (commctrl.h)

Articolo
02/26/2024

Contiene informazioni sull'immagine di sfondo di un controllo visualizzazione elenco. Questa struttura viene usata sia per l'impostazione che per il recupero delle informazioni sull'immagine di sfondo.

Sintassi

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

Members

ulFlags

Tipo: ULONG

Questo membro può essere uno o più dei flag seguenti. È possibile usare il valore LVBKIF_SOURCE_MASK per mascherare tutti i flag di origine. È possibile usare il valore LVBKIF_STYLE_MASK per mascherare tutti i flag, ma i flag di stile.

Valore	Significato
LVBKIF_SOURCE_NONE	Il controllo visualizzazione elenco non ha un'immagine di sfondo.
LVBKIF_SOURCE_HBITMAP	Una bitmap di sfondo viene fornita tramite il membro hbm di LVBKIMAGE. Se il messaggio LVM_SETBKIMAGE ha esito positivo, la visualizzazione elenco assume la proprietà della bitmap.
LVBKIF_SOURCE_URL	Il membro pszImage contiene l'URL dell'immagine di sfondo.
LVBKIF_STYLE_NORMAL	L'immagine di sfondo viene visualizzata normalmente.
LVBKIF_STYLE_TILE	L'immagine di sfondo verrà affiancata per riempire l'intero sfondo del controllo.
LVBKIF_FLAG_TILEOFFSET	Specificare le coordinate del primo riquadro. Questo flag è valido solo se viene specificato anche il flag LVBKIF_STYLE_TILE . Se questo flag non viene specificato, il primo riquadro inizia nell'angolo superiore sinistro dell'area client. Se si usa ComCtl32.dll versione 6.0 i campi xOffsetPercent e yOffsetPercent contengono pixel, non valori percentuali, per specificare le coordinate del primo riquadro. Comctl32.dll versione 6 non è ridistribuibile, ma è incluso in Windows o versioni successive. Inoltre, è necessario specificare Comctl32.dll versione 6 in un manifesto. Per altre informazioni sui manifesti, vedere Abilitazione degli stili di visualizzazione.
LVBKIF_TYPE_WATERMARK	Una bitmap di sfondo filigrana viene fornita tramite il membro hbm di LVBKIMAGE. Se il messaggio di LVM_SETBKIMAGE ha esito positivo, il controllo visualizzazione elenco assume la proprietà della bitmap.
LVBKIF_FLAG_ALPHABLEND	Valido solo quando viene specificato anche LVBKIF_TYPE_WATERMARK. Questo flag indica la bitmap fornita tramite LVBKIF_TYPE_WATERMARK contiene un canale alfa valido.

hbm

Tipo: HBITMAP

Handle della bitmap di sfondo. Questo membro è valido solo se il flag LVBKIF_SOURCE_HBITMAP è impostato in ulFlags.

pszImage

Tipo: LPTSTR

Indirizzo di una stringa con terminazione NULL contenente l'URL dell'immagine di sfondo. Questo membro è valido solo se il flag LVBKIF_SOURCE_URL è impostato in ulFlags. Questo membro deve essere inizializzato per puntare al buffer che contiene o riceve il testo prima di inviare il messaggio.

cchImageMax

Tipo: UINT

Dimensioni del buffer in corrispondenza dell'indirizzo in pszImage. Se al controllo vengono inviate informazioni, questo membro viene ignorato.

xOffsetPercent

Tipo: int

Percentuale dell'area client del controllo che l'immagine deve essere spostata orizzontalmente. Ad esempio, al 0% l'immagine verrà visualizzata sul bordo sinistro dell'area client del controllo. Al 50%, l'immagine verrà visualizzata al centro orizzontalmente nell'area client del controllo. Al 100% l'immagine verrà visualizzata sul bordo destro dell'area client del controllo. Questo membro è valido solo quando LVBKIF_STYLE_NORMAL è specificato in ulFlags. Se sia LVBKIF_FLAG_TILEOFFSET cheLVBKIF_STYLE_TILE sono specificati in ulFlags, il valore specifica il pixel, non l'offset percentuale, del primo riquadro. In caso contrario, il valore viene ignorato.

yOffsetPercent

Tipo: int

Percentuale dell'area client del controllo che l'immagine deve essere spostata verticalmente. Ad esempio, al 0% l'immagine verrà visualizzata sul bordo superiore dell'area client del controllo. Al 50% l'immagine verrà visualizzata verticalmente al centro nell'area client del controllo. Al 100% l'immagine verrà visualizzata sul bordo inferiore dell'area client del controllo. Questo membro è valido solo quando LVBKIF_STYLE_NORMAL è specificato in ulFlags. Se sia LVBKIF_FLAG_TILEOFFSET cheLVBKIF_STYLE_TILE sono specificati in ulFlags, il valore specifica il pixel, non l'offset percentuale, del primo riquadro. In caso contrario, il valore viene ignorato.

Commenti

Questa struttura viene utilizzata con i messaggi LVM_GETBKIMAGE e LVM_SETBKIMAGE .

Nota

L'intestazione commctrl.h definisce LVBKIMAGE come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Intestazione	commctrl.h

Condividi tramite