Mensagens para caixas de listagem

Um procedimento caixa de diálogo pode enviar mensagens para uma caixa de listagem para adicionar, excluir, examinar e alterar itens de caixa de lista. Por exemplo, um procedimento de caixa de diálogo poderia enviar uma LB_ADDSTRING mensagem para uma caixa de listagem para adicionar um item e uma mensagem de LB_GETSEL para determinar se o item é selecionado. Outras mensagens de definir e recuperar informações sobre o tamanho, a aparência e o comportamento da caixa de lista. Por exemplo, a mensagem LB_SETHORIZONTALEXTENT define o rolável largura de uma caixa de listagem. Um procedimento caixa de diálogo pode enviar qualquer mensagem para uma caixa de listagem usando a função SendMessage ou SendDlgItemMessage.

Um item de caixa de lista é frequentemente referenciado por seu índice, um número inteiro que representa a posição do item na caixa de listagem. O índice do primeiro item em uma caixa de listagem é 0, o índice do item segundo é 1 e assim por diante.

A tabela a seguir descreve como o procedimento de caixa de lista predefinidos responde à caixa de listagem mensagens.

Mensagem Resposta
LB_ADDFILE Insere um arquivo em uma caixa de listagem de diretório preenchida pela função DlgDirList e recupera o índice de caixa de lista do item inserido.
LB_ADDSTRING Adiciona uma Cadeia de caracteres para uma caixa de listagem e retorna seu índice.
LB_DELETESTRING Remove uma Cadeia de caracteres de uma caixa de listagem e retorna o número de seqüências de caracteres restantes na lista.
LB_DIR Adiciona uma lista de nomes de arquivo para uma caixa de listagem e retorna o índice do último nome do arquivo adicionado.
LB_FINDSTRING Retorna o índice da primeira seqüência de caracteres na caixa de lista que corresponde a um determinado prefixo.
LB_FINDSTRINGEXACT Retorna o índice da string que é equivalente a ou prefixadas por um determinado prefixo.
LB_GETANCHORINDEX Retorna o índice do item que o mouse última seleccionado.
LB_GETCARETINDEX Retorna o índice do item que tenha o retângulo de foco.
LB_GETCOUNT Retorna o número de itens na caixa de listagem.
LB_GETCURSEL Retorna o índice do item atualmente selecionado.
LB_GETHORIZONTALEXTENT Retorna o rolável largura, em pixels, de uma caixa de listagem.
LB_GETITEMDATA Retorna o valor de 32 bits associado ao item de determinado.
LB_GETITEMHEIGHT Retorna a altura, em pixels, de um item em uma caixa de listagem.
LB_GETITEMRECT Recupera as coordenadas do cliente do item da caixa lista de determinado.
LB_GETLOCALE Recupera a localidade da caixa de lista. O alto-ordem palavra contém o código do país e a baixa-ordem palavra contém o identificador de idioma.
LB_GETSEL Retorna o estado seleção de um item de caixa de lista.
LB_GETSELCOUNT Retorna o número de itens selecionados em um múltiplo caixa lista seleção.
LB_GETSELITEMS Cria uma matriz de índices de Tudo itens selecionados em um múltiplo caixa lista seleção e retorna o número total de itens selecionados.
LB_GETTEXT Recupera a Cadeia de caracteres associada com um determinado item e o comprimento da seqüência de caracteres.
LB_GETTEXTLEN Retorna o comprimento, em caracteres, da seqüência de caracteres associado com um determinado item.
LB_GETTOPINDEX Retorna o índice do primeiro item visível em uma caixa de listagem.
LB_INITSTORAGE Aloca memória para o número especificado de itens e suas seqüências de caracteres associadas.
LB_INSERTSTRING Insere uma Cadeia de caracteres em um determinado índice em uma caixa de listagem.
LB_ITEMFROMPOINT Recupera o índice baseado em zero do item mais próximo a apontar especificado em uma caixa de listagem.
LB_RESETCONTENT Remove todos os itens de uma caixa de listagem.
LB_SELECTSTRING Seleciona a primeira seqüência de caracteres que ele perceber que corresponde a um determinado prefixo.
LB_SELITEMRANGE Seleciona um intervalo determinado de itens em uma caixa de listagem.
LB_SELITEMRANGEEX Seleciona um intervalo determinado de itens se o índice do primeiro item no intervalo for menor que o índice do último item no intervalo. Cancela a seleção do intervalo se o índice do primeiro item é maior do que o último.
LB_SETANCHORINDEX Define o item que o mouse última seleccionado para um determinado item.
LB_SETCARETINDEX Define o retângulo de foco para um item da caixa lista determinada.
LB_SETCOLUMNWIDTH Define a largura, em pixels, de todas as colunas em uma caixa de listagem.
LB_SETCOUNT Define o número de itens em uma caixa de listagem.
LB_SETCURSEL Seleciona um item da caixa lista determinada.
LB_SETHORIZONTALEXTENT Define o rolável largura, em pixels, de uma caixa de listagem.
LB_SETITEMDATA Associa um valor de 32 bits com um item de caixa de lista.
LB_SETITEMHEIGHT Define a altura, em pixels, de um item ou itens em uma caixa de listagem.
LB_SETLOCALE Define a localidade de uma caixa de lista e retorna o identificador localidade anterior.
LB_SETSEL Seleciona um item em uma caixa de listagem de seleção múltipla.
LB_SETTABSTOPS Define a guia paradas dos especificados em uma matriz de determinado.
LB_SETTOPINDEX Rola a caixa lista para que o item especificado está na parte superior do intervalo visível.

Index