Caixa de listagem

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 Modo de Exibição de Lista.

Visões gerais

Tópico	Contents
Sobre as 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	Contents
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 arraste.

Mensagens

Tópico	Contents
LB_ADDFILE	Adiciona o nome de 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 da 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 âncora, ou seja, o item a partir 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, 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 de 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 limita 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 especificam os números de item dos 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_SORTseja 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 da 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 âncora, ou seja, o item a partir do qual uma seleção múltipla é iniciada. Uma seleção múltipla abrange todos os itens, desde o item âncora até o item de acento circunflexo.
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 a 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, dos 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.

Notifications

Tópico	Contents
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 ao seu proprietário em resposta a uma mensagem WM_CHAR.
WM_CTLCOLORLISTBOX	Enviado para a janela pai de uma caixa de listagem antes que o sistema desenhe 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_DELETESTRING ou CB_RESETCONTENT.
WM_VKEYTOITEM	Enviado por uma caixa de listagem com o estilo LBS_WANTKEYBOARDINPUT ao seu proprietário em resposta a uma mensagem WM_KEYDOWN.
DL_BEGINDRAG	Notifica a janela pai da caixa de listagem de arrastar de 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 com o botão direito do mouse ou pressionando a tecla ESC.
DL_DRAGGING	Sinaliza que o usuário moveu o mouse enquanto arrasta 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	Contents
DELETEITEMSTRUCT	Contém informações sobre uma caixa de listagem excluída ou item de caixa de combinação.
DRAGLISTINFO	Contém informações sobre um evento de arraste. O ponteiro para DRAGLISTINFO é passado como o parâmetro lParam da mensagem da lista de arraste.

Constantes

Tópico	Contents
Estilos de caixa de listagem	Descreve os estilos de janela que definem um controle de caixa de listagem.