macro ListView_SetCallbackMask (commctrl.h)

  • Artigo

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

void ListView_SetCallbackMask(
   hwnd,
   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.

Retornar valor

Nenhum

Comentários

A 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, diferente 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 Image Listas.

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
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho commctrl.h

Confira também

LVN_GETDISPINFO