Compartilhar via

Caixa de listagem

  • Artigo

Esta seção contém informações sobre os elementos de programação usados com caixas de listagem. Uma caixa de listagem é uma janela de controle que contém uma lista simples de itens dos quais o usuário pode escolher. Para listas mais complexas, use o de Exibição de Lista.

Súmulas

Tópico Conteúdo
sobre caixas de listagem Descreve os recursos da caixa de listagem.
usando caixas de listagem Explica como executar tarefas associadas a caixas de listagem.

Funções

Tópico Conteúdo
DlgDirList Substitui o conteúdo de uma caixa de listagem pelos nomes dos subdiretórios e arquivos em um diretório especificado.
DlgDirSelectEx Recupera a seleção atual de uma caixa de listagem de seleção única.
DrawInsert Desenha o ícone de inserção na janela pai da caixa de listagem de arrastar especificada.
GetListBoxInfo Recupera informações sobre a caixa de listagem especificada.
LBItemFromPt Recupera o índice do item no ponto especificado em uma caixa de listagem.
MakeDragList Altera a caixa de listagem de seleção única especificada para uma caixa de listagem de arrastar.

Mensagens

Tópico Conteúdo
LB_ADDFILE Adiciona o nome do arquivo especificado a uma caixa de listagem que contém uma listagem de diretório.
LB_ADDSTRING Adiciona uma cadeia de caracteres a uma caixa de listagem.
LB_DELETESTRING Exclui uma cadeia de caracteres em uma caixa de listagem.
LB_DIR Adiciona nomes à lista exibida por uma caixa de listagem.
LB_FINDSTRING Localiza a primeira cadeia de caracteres em uma caixa de listagem que começa com a cadeia de caracteres especificada.
LB_FINDSTRINGEXACT Localiza a primeira cadeia de caracteres de caixa de listagem que corresponde exatamente à cadeia de caracteres especificada, exceto que a pesquisa não diferencia maiúsculas de minúsculas.
LB_GETANCHORINDEX Obtém o índice do item de âncora, ou seja, o item do qual uma seleção múltipla é iniciada.
LB_GETCARETINDEX Recupera o índice do item que tem o retângulo de foco em uma caixa de listagem de seleção múltipla. O item pode ou não ser selecionado.
LB_GETCOUNT Obtém o número de itens em uma caixa de listagem.
LB_GETCURSEL Obtém o índice do item selecionado no momento, se houver, em uma caixa de listagem de seleção única.
LB_GETHORIZONTALEXTENT Obtém a largura, em pixels, de que uma caixa de listagem pode ser rolada horizontalmente (a largura rolável) se a caixa de listagem tiver uma barra de rolagem horizontal.
LB_GETITEMDATA Obtém o valor definido pelo aplicativo associado ao item da caixa de listagem especificado.
LB_GETITEMHEIGHT Obtém a altura dos itens em uma caixa de listagem.
LB_GETITEMRECT Obtém as dimensões do retângulo que associa um item de caixa de listagem como ele é exibido atualmente na caixa de listagem.
LB_GETLISTBOXINFO Obtém o número de itens por coluna em uma caixa de listagem especificada.
LB_GETLOCALE Obtém a localidade atual da caixa de listagem.
LB_GETSEL Obtém o estado de seleção de um item.
LB_GETSELCOUNT Obtém o número total de itens selecionados em uma caixa de listagem de seleção múltipla.
LB_GETSELITEMS Preenche um buffer com uma matriz de inteiros que especifica os números de item de itens selecionados em uma caixa de listagem de seleção múltipla.
LB_GETTEXT Obtém uma cadeia de caracteres de uma caixa de listagem.
LB_GETTEXTLEN Obtém o comprimento de uma cadeia de caracteres em uma caixa de listagem.
LB_GETTOPINDEX Obtém o índice do primeiro item visível em uma caixa de listagem.
LB_INITSTORAGE Aloca memória para armazenar itens de caixa de listagem. Essa mensagem é usada antes de um aplicativo adicionar um grande número de itens a uma caixa de listagem.
LB_INSERTSTRING Insere uma cadeia de caracteres ou dados de item em uma caixa de listagem. Ao contrário da mensagem LB_ADDSTRING, a mensagem LB_INSERTSTRING não faz com que uma lista com o estilo LBS_SORT seja classificada.
LB_ITEMFROMPOINT Obtém o índice baseado em zero do item mais próximo do ponto especificado em uma caixa de listagem.
LB_RESETCONTENT Remove todos os itens de uma caixa de listagem.
LB_SELECTSTRING Pesquisa uma caixa de listagem para um item que começa com os caracteres em uma cadeia de caracteres especificada.
LB_SELITEMRANGE Seleciona ou desmarca um ou mais itens consecutivos em uma caixa de listagem de seleção múltipla.
LB_SELITEMRANGEEX Seleciona um ou mais itens consecutivos em uma caixa de listagem de seleção múltipla.
LB_SETANCHORINDEX Define o item de âncora, ou seja, o item do qual uma seleção múltipla é iniciada. Uma seleção múltipla abrange todos os itens desde o item de âncora até o item de cursor.
LB_SETCARETINDEX Define o retângulo de foco para o item no índice especificado em uma caixa de listagem de seleção múltipla. Se o item não estiver visível, ele será rolado para exibição.
LB_SETCOLUMNWIDTH Define a largura, em pixels, de todas as colunas em uma caixa de listagem de várias colunas.
LB_SETCOUNT Define a contagem de itens em uma caixa de listagem criada com o estilo LBS_NODATA e não criada com o estilo LBS_HASSTRINGS.
LB_SETCURSEL Seleciona uma cadeia de caracteres e rola-a para exibição, se necessário.
LB_SETHORIZONTALEXTENT Define a largura, em pixels, pela qual uma caixa de listagem pode ser rolada horizontalmente (a largura rolável).
LB_SETITEMDATA Define um valor associado ao item especificado em uma caixa de listagem.
LB_SETITEMHEIGHT Define a altura, em pixels, de itens em uma caixa de listagem.
LB_SETLOCALE Define a localidade atual da caixa de listagem.
LB_SETSEL Seleciona uma cadeia de caracteres em uma caixa de listagem de seleção múltipla.
LB_SETTABSTOPS Define as posições de parada de tabulação em uma caixa de listagem.
LB_SETTOPINDEX Garante que o item especificado em uma caixa de listagem esteja visível.

Notificações

Tópico Conteúdo
LBN_DBLCLK Notifica o aplicativo de que o usuário clicou duas vezes em um item em uma caixa de listagem.
LBN_ERRSPACE Notifica o aplicativo de que a caixa de listagem não pode alocar memória suficiente para atender a uma solicitação específica.
LBN_KILLFOCUS Notifica o aplicativo de que a caixa de listagem perdeu o foco do teclado.
LBN_SELCANCEL Notifica o aplicativo de que o usuário cancelou a seleção em uma caixa de listagem.
LBN_SELCHANGE Notifica o aplicativo de que a seleção em uma caixa de listagem foi alterada.
LBN_SETFOCUS Notifica o aplicativo de que a caixa de listagem recebeu o foco do teclado.
WM_CHARTOITEM Enviado por uma caixa de listagem com o estilo LBS_WANTKEYBOARDINPUT para seu proprietário em resposta a uma mensagem de WM_CHAR.
WM_CTLCOLORLISTBOX Enviado para a janela pai de uma caixa de listagem antes de o sistema desenhar a caixa de listagem. Ao responder a essa mensagem, a janela pai pode definir as cores de texto e plano de fundo da caixa de listagem usando o identificador de contexto do dispositivo de exibição especificado.
WM_DELETEITEM Enviado ao proprietário de uma caixa de listagem ou caixa de combinação quando a caixa de listagem ou caixa de combinação é destruída ou quando os itens são removidos pela mensagem LB_DELETESTRING, LB_RESETCONTENT, CB_DELETESTRINGou CB_RESETCONTENT.
WM_VKEYTOITEM Enviado por uma caixa de listagem com o estilo LBS_WANTKEYBOARDINPUT para seu proprietário em resposta a uma mensagem de WM_KEYDOWN.
DL_BEGINDRAG Notifica a janela pai da caixa de listagem de arrastar que o usuário clicou no botão esquerdo do mouse em um item.
DL_CANCELDRAG Sinaliza que o usuário cancelou uma operação de arrastar clicando no botão direito do mouse ou pressionando a tecla ESC.
DL_DRAGGING Sinaliza que o usuário moveu o mouse ao arrastar um item.
DL_DROPPED Sinaliza que o usuário concluiu uma operação de arrastar liberando o botão esquerdo do mouse.

Estruturas

Tópico Conteúdo
DELETEITEMSTRUCT Contém informações sobre uma caixa de listagem excluída ou um item de caixa de combinação.
DRAGLISTINFO Contém informações sobre um evento de arrastar. O ponteiro para DRAGLISTINFO é passado como o parâmetro lParam da mensagem de lista de arrastar.

Constantes

Tópico Conteúdo
estilos de caixa de listagem Descreve os estilos de janela que definem um controle de caixa de listagem.