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 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_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 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.