Struttura LVBKIMAGEA (commctrl.h)
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;
Membri
ulFlags
Questo membro può essere uno o più dei flag seguenti. È possibile usare il valore LVBKIF_SOURCE_MASK per mascherare tutti i flag di origine, ma i flag di origine. È possibile usare il valore LVBKIF_STYLE_MASK per mascherare tutti gli altri flag, ma i flag di stile.
| Valore | Significato |
|---|---|
|
Il controllo visualizzazione elenco non dispone di un'immagine di sfondo. |
|
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. |
|
Il membro pszImage contiene l'URL dell'immagine di sfondo. |
|
L'immagine di sfondo viene visualizzata normalmente. |
|
L'immagine di sfondo verrà affiancata per riempire l'intero sfondo del controllo. |
|
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 xOffsetPercent e campi 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. |
|
Una bitmap di sfondo filigrana viene fornita tramite il membro hbm |
|
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
Handle della bitmap di sfondo. Questo membro è valido solo se il flag di 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 di 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
Dimensioni del buffer in corrispondenza dell'indirizzo in pszImage. Se le informazioni vengono inviate al controllo, questo membro viene ignorato.
xOffsetPercent
Tipo: int
Percentuale dell'area client del controllo che l'immagine deve essere sfalstata 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 viene specificato in ulFlags. Se sia LVBKIF_FLAG_TILEOFFSET che LVBKIF_STYLE_TILE vengono 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 sfalstata verticalmente. Ad esempio, al 0% l'immagine verrà visualizzata sul bordo superiore dell'area client del controllo. Al 50% l'immagine verrà visualizzata in senso verticale 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 viene specificato in ulFlags. Se sia LVBKIF_FLAG_TILEOFFSET che LVBKIF_STYLE_TILE vengono specificati in ulFlags, il valore specifica il pixel, non l'offset percentuale, del primo riquadro. In caso contrario, il valore viene ignorato.
Osservazioni
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 non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Windows Vista [solo app desktop] |
| server minimo supportato | Windows Server 2003 [solo app desktop] |
| intestazione |
commctrl.h |