Compartilhar via


Itens de retorno de chamada e a máscara de retorno de chamada

Para cada um de seus itens, um controle de exibição de lista normalmente armazena o texto do rótulo, o índice de lista de imagem de ícones do item, e um conjunto de bits sinalizadores para o estado do item.Você pode definir itens individuais como itens de retorno de chamada, que são úteis se seu aplicativo já armazena algumas informações para um item.

Definir um item como um item de retorno de chamada, especificando os valores apropriados para o pszText e iImage membros da LV_ITEM estrutura (consulte CListCtrl::GetItem).Se o aplicativo mantém o texto do item ou do subitem, especificar o LPSTR_TEXTCALLBACK valor para o pszText membro.Se o aplicativo mantém controle sobre o ícone do item, especificar o I_IMAGECALLBACK valor para o iImage membro.

Além de definir itens de retorno de chamada, você pode modificar máscara de retorno de chamada do controle.Essa máscara é um conjunto de sinalizadores de bit que especificam os estados de item para o qual o aplicativo, em vez de controle, armazena os dados atuais.A máscara de retorno de chamada se aplica a todos os itens do controle, ao contrário a designação de item de retorno de chamada, que se aplica a um item específico.A máscara de retorno de chamada é zero por padrão, significando que o controle controla todos os estados do item.Para alterar esse comportamento padrão, inicialize a máscara de qualquer combinação dos seguintes valores:

  • LVIS_CUTO item está marcado para uma operação recortar e colar.

  • LVIS_DROPHILITEDO item é realçado como um destino de arrastar e soltar.

  • LVIS_FOCUSEDO item tem o foco.

  • LVIS_SELECTEDO item é selecionado.

  • LVIS_OVERLAYMASK o aplicativo armazena o índice de lista de imagem da atual imagem de sobreposição para cada item.

  • LVIS_STATEIMAGEMASK o aplicativo armazena o índice de lista de imagem da atual imagem de estado para cada item.

Para obter mais informações sobre recuperação e configuração essa máscara, consulte CListCtrl::GetCallbackMask e CListCtrl::SetCallbackMask.

Consulte também

Referência

Usando CListCtrl

Conceitos

Controles (MFC)