Condividi tramite


macro ListView_SetCallbackMask (commctrl.h)

Modifica la maschera di callback per un controllo visualizzazione elenco. È possibile utilizzare questa macro o inviare il messaggio di LVM_SETCALLBACKMASK in modo esplicito.

Sintassi

BOOL ListView_SetCallbackMask(
   HWND hwnd,
   UINT mask
);

Parametri

hwnd

Tipo: HWND

Handle per il controllo visualizzazione elenco.

mask

Tipo: UINT

Valore della maschera di callback. I bit della maschera indicano gli stati o le immagini dell'elemento per cui l'applicazione archivia i dati di stato correnti. Questo valore può essere qualsiasi combinazione delle costanti seguenti:

Valore Significato
LVIS_CUT
L'elemento è contrassegnato per un'operazione taglia e incolla.
LVIS_DROPHILITED
L'elemento è evidenziato come destinazione di trascinamento della selezione.
LVIS_FOCUSED
L'elemento ha lo stato attivo.
LVIS_SELECTED
L'elemento è selezionato.
LVIS_OVERLAYMASK
L'applicazione archivia l'indice dell'elenco di immagini dell'immagine di sovrimpressione corrente per ogni elemento.
LVIS_STATEIMAGEMASK
L'applicazione archivia l'indice dell'elenco di immagini dell'immagine di stato corrente per ogni elemento.

Valore restituito

Tipo: BOOL

Restituisce TRUE in caso di esito positivo oppure FALSE in caso contrario.

Osservazioni

La maschera di callback di un controllo visualizzazione elenco è un set di flag di bit che specificano gli stati dell'elemento per cui l'applicazione, anziché il controllo, archivia i dati correnti. La maschera di callback si applica a tutti gli elementi del controllo, a differenza della designazione dell'elemento di callback, che si applica a un elemento specifico. La maschera di callback è zero per impostazione predefinita, ovvero il controllo visualizzazione elenco archivia tutte le informazioni sullo stato dell'elemento. Dopo aver creato un controllo visualizzazione elenco e aver inizializzato gli elementi, è possibile utilizzare la macro ListView_SetCallbackMask o LVM_SETCALLBACKMASK messaggio per modificare la maschera di callback. Per recuperare la maschera di callback corrente, inviare il messaggio di LVM_GETCALLBACKMASK.

Per altre informazioni sulle immagini sovrapposte e sulle immagini di stato, vedere List-View Elenchi di immagini.

Per altre informazioni sui callback di visualizzazione elenco, vedere elementi di callback e la maschera di callback

Fabbisogno

Requisito Valore
client minimo supportato Windows Vista [solo app desktop]
server minimo supportato Windows Server 2003 [solo app desktop]
piattaforma di destinazione Finestre
intestazione commctrl.h

Vedere anche

LVN_GETDISPINFO