ListView_SetCallbackMask macro (commctrl.h)

Altera a máscara de retorno de chamada para um controle de exibição de lista. Você pode usar essa macro ou enviar a mensagem LVM_SETCALLBACKMASK explicitamente.

Sintaxe

BOOL ListView_SetCallbackMask(
   HWND hwnd,
   UINT mask
);

Parâmetros

hwnd

Tipo: HWND

Um identificador para o controle de exibição de lista.

mask

Tipo: UINT

O valor da máscara de retorno de chamada. Os bits da máscara indicam os estados ou imagens do item para os quais o aplicativo armazena os dados de estado atuais. Esse valor pode ser qualquer combinação das seguintes constantes:

Valor Significado
LVIS_CUT
O item é marcado para uma operação de recortar e colar.
LVIS_DROPHILITED
O item é realçado como um destino de arrastar e soltar.
LVIS_FOCUSED
O item tem o foco.
LVIS_SELECTED
O item está selecionado.
LVIS_OVERLAYMASK
O aplicativo armazena o índice de lista de imagens da imagem de sobreposição atual para cada item.
LVIS_STATEIMAGEMASK
O aplicativo armazena o índice de lista de imagens da imagem de estado atual para cada item.

Valor de retorno

Tipo: BOOL

Retorna TRUE se tiver êxito ou false caso contrário.

Observações

O máscara de retorno de chamada de um controle de exibição de lista é um conjunto de sinalizadores de bits que especificam os estados de item para os quais o aplicativo, em vez do controle, armazena os dados atuais. A máscara de retorno de chamada se aplica a todos os itens do controle, ao contrário da designação do item de retorno de chamada, que se aplica a um item específico. A máscara de retorno de chamada é zero por padrão, o que significa que o controle de exibição de lista armazena todas as informações de estado do item. Depois de criar um controle de exibição de lista e inicializar seus itens, você pode usar a macro ListView_SetCallbackMask ou LVM_SETCALLBACKMASK mensagem para alterar a máscara de retorno de chamada. Para recuperar a máscara de retorno de chamada atual, envie a mensagem LVM_GETCALLBACKMASK.

Para obter mais informações sobre imagens de sobreposição e imagens de estado, consulte List-View Listas de Imagens.

Para obter mais informações sobre retornos de chamada de exibição de lista, consulte Itens de Retorno de Chamada e a Máscara de Retorno de Chamada

Requisitos

Requisito Valor
de cliente com suporte mínimo Windows Vista [somente aplicativos da área de trabalho]
servidor com suporte mínimo Windows Server 2003 [somente aplicativos da área de trabalho]
da Plataforma de Destino Windows
cabeçalho commctrl.h

Consulte também

LVN_GETDISPINFO