Controle ListView
O controle ListView que exibe uma única coluna de valores com um ícone ao lado de cada item. Ele permite que o usuário selecione uma única cadeia de caracteres ou valor inteiro para uma propriedade a partir de uma lista predeterminada. Os valores possíveis são lidos a partir do tabela ListView. Você pode associar o controle a um valor inteiro ou de cadeia de caracteres inserindo o nome da propriedade na coluna Propriedade da tabela Control.
O conteúdo do campo Texto da tabela Control nunca é exibido pelo controle ListView. Em vez disso, esse campo especifica o estilo de texto a ser exibido pelo controle e contém uma descrição do controle usado pelos utilitários de revisão de tela. Para definir a fonte e o estilo de fonte de uma cadeia de texto, prefixe a cadeia de caracteres exibidos com {\style} ou {&style}. Onde style é um identificador listado na coluna TextStyle da tabela TextStyle. Se nenhum deles estiver presente, mas a propriedadeDefaultUIFontfor definida como um estilo de texto válido, essa fonte será usada. As informações a seguir são lidas pelos utilitários de revisão de tela como a descrição do controle. Consulte de Acessibilidade .
Atributos de controle
Você pode usar os seguintes atributos com esse controle. Para alterar o valor de um atributo usando um evento, inscreva o controle em um ControlEvent na tabela EventMapping e liste o identificador do atributo na coluna Atributo. Insira o identificador do ControlEvent na coluna Evento.
| Identificador de atributo | Bit hexadecimal | Descrição |
|---|---|---|
| IndirectPropertyName | Este é o nome de uma propriedade indireta associada ao controle. Se o bit do atributo Indireto estiver definido, o controle exibirá ou alterará o valor da propriedade com esse nome. Se o bit do atributo Indireto estiver definido, esse nome também será o valor da propriedade listada na coluna Propriedade da tabela Controle . | |
| Posição | Posição do controle na caixa de diálogo. Insira a largura, altura e coordenadas do canto esquerdo do controle nas colunas Largura, Altura, X e Y da tabela Controle . Use unidades de instalação para comprimento e distância. |
|
| PropertyName | Este é o nome da propriedade associada a esse controle. Se o bit do atributo Indireto não estiver definido, o controle exibirá ou alterará o valor da propriedade com esse nome. Este atributo é especificado na coluna Propriedade da tabela Control. | |
| PropertyValue | Valor atual da propriedade exibida ou alterada por esse controle. Se o bit do atributo Indirect não estiver definido, esse será o valor de PropertyName. Se o bit do atributo Indirect estiver definido, esse será o valor de IndirectPropertyName. Se o atributo for alterado, o controle refletirá o novo valor. | |
| de texto | Para exibir texto em leitores de tela, insira o texto na coluna Texto da tabela Controle . Consulte de Acessibilidade . | |
| visível | 0x00000000 0x00000001 |
Controle oculto. Controlo visível. Inclua esse bit na palavra bit da coluna Atributos na tabela Controle para tornar o controle visível ou oculto após sua criação. Você também pode ocultar ou mostrar um controle usando a tabela ControlCondition. |
| ativado | 0x00000000 0x00000002 |
Controle em um estado desativado. Controle em um estado habilitado. Inclua esse bit na palavra bit na coluna Atributos do Controle de para habilitar o controle na criação. Você também pode habilitar ou desabilitar um controle usando a tabela ControlCondition. |
| afundado | 0x00000000 0x00000004 |
Exibe o estilo visual padrão. Exibe o controle com uma aparência 3D afundada. Inclua esses bits na palavra bit na coluna Atributos da tabela Controle de . |
| indireta | 0x00000000 0x00000008 |
O controle exibe ou altera o valor da propriedade na coluna Propriedade da tabela Control. O controle exibe ou altera o valor da propriedade que tem o identificador listado na coluna Propriedade da tabela Control. Determina se a propriedade associada a esse controle é referenciada indiretamente. |
| inteiro | 0x00000000 0x00000010 |
A propriedade associada ao controle é um valor de cadeia de caracteres. A propriedade associada ao controle é um valor inteiro. Inclua esse bit na palavra bit da coluna Atributos da tabela Control definir esse atributo na criação do controle. |
| RTLRO | 0x00000000 0x00000020 |
O texto no controle é exibido na ordem de leitura da esquerda para a direita. O texto no controle é exibido na ordem de leitura da direita para a esquerda. |
| RightAligned | 0x00000000 0x00000040 |
O texto no controle é alinhado à esquerda. O texto no controle é alinhado à direita. |
| LeftScroll | 0x00000000 0x00000080 |
A barra de rolagem está localizada no lado direito do controle. A barra de rolagem está localizada no lado esquerdo do controle. |
| BiDi | 0x000000E0 | Defina esse valor para uma combinação dos atributos RTLRO, RightAlignede LeftScroll. |
| Ordenado | 0x00000000 0x00010000 |
Itens exibidos em ordem alfabética. Itens exibidos na ordem especificada na tabela ListView . Inclua esse bit na palavra bit na coluna Atributos para exibir itens na ordem especificada pela coluna Ordem da tabela ListView. |
| FixedSize | 0x00000000 0x00100000 |
Estende a imagem do ícone para se ajustar ao controle. Corta ou centraliza a imagem do ícone no controle. Inclua esse bit na palavra de bit da coluna Atributos da tabela Control. |
| IconSize | 0x00000000 0x00200000 0x00400000 0x00600000 |
Carrega a primeira imagem. Carrega a primeira imagem 16x16. Carrega a primeira imagem 32x32. Carrega a primeira imagem 48x48. Um arquivo de ícone pode conter imagens de tamanhos diferentes do mesmo ícone. Inclua o valor da palavra de bit apropriada na coluna Atributos da tabela Controle de Se esses bits não estiverem definidos, o instalador ignorará o atributo FixedSize e a imagem será esticada para caber no retângulo de controle. Se os bits IconSize e FixedSize estiverem definidos, uma imagem menor que o controle será centralizada e uma imagem será maior do que o controle que ele será reduzido para ajustar. |
Comentários
Esse controle pode ser criado a partir da classe WC_LISTVIEW usando a funçãoCreateWindowEx. Tem os estilos LVS_REPORT, LVS_NOCOLUMNHEADER, WS_VSCROLL, WS_HSCROLL, LVS_SHAREIMAGELISTS, LVS_SINGLESEL, LVS_SHOWSELALWAYS, WS_BORDERe WS_TABSTOP. Se o bit de estilo Ordenado não estiver ativado, o controle também terá o estilo LVS_SORTASCENDING.
Para compatibilidade com leitores de tela, ao criar uma caixa de diálogo com um controle ListView como o primeiro controle ativo, você deve tornar o campo de texto pertencente ao campo de edição o primeiro controle ativo na tabela Dialog. Como o texto estático não pode ter foco, quando a caixa de diálogo é criada, o campo de edição terá o foco inicialmente como pretendido, mas fazer isso garante que os leitores de tela mostrem as informações corretas.