Creating a List View Control
.gif "A hyphen indicates that the information in this topic is not relevant for this platform, or that the platform does not support the API that is listed.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
9/9/2008
A exibição de lista é comum um controle que exibe uma coleção de itens, such as arquivos ou pastas. Cada item tem um ícone e uma rotular. Um usuário pode escolher se os itens exibidos como ícones grandes, Ícones pequenos, uma lista ou uma lista detalhada. Você pode design lista Modos de exibição para que um usuário pode arrastar um item para uma nova localidade dentro do exibição de lista ou classificar a coleção tocando um cabeçalho de coluna. A seguinte ilustração mostra um lista de imagens em exibição de lista.
.gif)
Para criar um controle de exibição lista
Especifica a classe WC_LISTVIEW in a Boolean parâmetro da CreateWindowEx função.
Essa classe é registrado quando o DLL para a comum controle DLL é carregado. Use o InitCommonControls função para garantir que este DLL é carregado. Quando você registrar a classe exibição de lista usando o InitCommonControlsEx função, especificar o sinalizador ICC_LISTVIEW_CLASSES como o dwICC membro das INITCOMMONCONTROLSEX estrutura que você transmitir in a lpInitCtrls parâmetro.
Especificar um estilo exibição de lista in a dwStyle parâmetro da CreateWindowEx função.
Você pode acelerar a criação de modos de exibição lista grande, desativando a pintura do exibição de lista antes de adicionar os itens. Você desativar a pintura do exibição de lista enviando uma mensagem WM_SETREDRAW com o sinalizador redesenho de tela em wParam Defina como FALSE. Quando você terminar de adicionar itens, você poderá reabilitar pintura enviando WM_SETREDRAW com o wParam Reemitir sinalizador definido como TRUE. Antes de inserir itens, enviar a mensagem LVM_SETITEMCOUNT com o cItems parâmetro definido para o número de itens em questão. Quando você enviar esta mensagem, o exibição de lista será alocar a memória que ele precisa all at once, em vez de realocar mais memória de forma incremental como estruturas de dados interno crescer.
Você pode alteração de tipo exibição após um controle de exibição lista ter sido criado. Para recuperar e alteração a janela estilo, use o GetWindowLong e SetWindowLong funções. Para determinar a janela estilos que corresponder para o atual exibição, use o valor LVS_TYPEMASK.
Você pode controle a maneira na qual os itens são organizados em modo de exibição de ícones ou pequeno-modo de exibição de ícones, especificando o estilo de janela LVS_ALIGNTOP, que é o estilo usar como padrão, ou o estilo janela LVS_ALIGNLEFT. Você pode alteração o alinhamento após um controle de exibição lista ter sido criado. Para isolar a janela estilos que especificar o alinhamento dos itens, use o valor LVS_ALIGNMASK.
Quando um usuário clica em um controle exibição de lista que é editável, o exibição de lista controle notifica o aplicativo pai que ele é inserir em modo de edição enviando o LVN_BEGINLABELEDIT notificação. Se o aplicativo aceita a editar, o usuário poderá tornar as edições necessárias. Após o usuário deixe de usar do modo de edição, controle de exibição a lista enviará a LVN_ENDLABELEDIT notificação para o aplicativo pai.
Windows Embedded CE não suporte hot rastreamento, seleção focalizar, imagens segundo plano ou as dicas de ferramentas para um exibição de lista.