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 um valor inteiro para uma propriedade de uma lista predeterminada. Os valores possíveis são lidos da 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 controle .
O conteúdo do campo Texto da tabela controle 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 caracteres de texto, prefixe a cadeia de caracteres exibida com {\style} ou {&estilo}. Onde o estilo é um identificador listado na coluna TextStyle da tabela TextStyle. Se nenhum deles estiver presente, mas a propriedade DefaultUIFont for definida como um estilo de texto válido, essa fonte será usada. As informações a seguir são lidas por utilitários de revisão de tela como a descrição do controle. Consulte de Acessibilidade.
Atributos de controle
Você pode usar os atributos a seguir com esse controle. Para alterar o valor de um atributo usando um evento, assine o controle em um ControlEvent na tabela EventMapping e liste o identificador do atributo na coluna Attribute. Insira o identificador do ControlEvent na coluna Evento.
| Identificador de atributo | Bit hexadecimal | Descrição |
|---|---|---|
| indirectPropertyName | Esse é o nome de uma propriedade indireta associada ao controle. Se o bit de atributo indireto for definido, o controle exibirá ou alterará o valor da propriedade que tem esse nome. Se o bit de atributo indireto estiver definido, esse nome também será o valor da propriedade listada na coluna Propriedade da tabela controle . | |
| de Posição | Posição do controle na caixa de diálogo. Insira a largura, a altura e as coordenadas do controle do canto esquerdo do controle nas colunas Width, Height, X e Y da tabela controle . Use unidades do instalador para comprimento e distância. |
|
| PropertyName | Esse é o nome da propriedade associada a esse controle. Se o bit de atributo indireto não estiver definido, o controle exibirá ou alterará o valor da propriedade que tem esse nome. Esse atributo é especificado na coluna Propriedade da tabela controle . | |
| PropertyValue | Valor atual da propriedade exibida ou alterada por esse controle. Se o bit de atributo indireto não estiver definido, esse será o valor de PropertyName. Se o bit de atributo indireto estiver definido, esse será o valor de IndirectPropertyName. Se o atributo for alterado, o controle refletirá o novo valor. | |
| de Texto | Para exibir o texto em leitores de tela, insira o texto na coluna Texto da tabela controle . Consulte de Acessibilidade. | |
| Visíveis | 0x00000000 0x00000001 |
Controle oculto. Controle 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. |
| habilitado | 0x00000000 0x00000002 |
Controlar em um estado desabilitado. Controlar em um estado habilitado. Inclua esse bit na palavra bit na coluna Atributos do controle para habilitar o controle na criação. Você também pode habilitar ou desabilitar um controle usando a tabela ControlCondition. |
| submersa | 0x00000000 0x00000004 |
Exibe o estilo visual padrão. Exibe o controle com uma aparência submersa, 3D. Inclua esses bits na palavra bit na coluna Atributos da tabela controle . |
| Indireto | 0x00000000 0x00000008 |
O controle exibe ou altera o valor da propriedade na coluna Propriedade da tabela controle . O controle exibe ou altera o valor da propriedade que tem o identificador listado na coluna Propriedade da tabela Controle. 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 de bit da coluna Atributos da tabela controle para 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 está 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, RightAligned e LeftScroll. |
| classificação | 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 Order da tabela ListView. |
| FixedSize | 0x00000000 0x00100000 |
Alonga a imagem do ícone para ajustar o controle. Corta ou centraliza a imagem do ícone no controle. Inclua esse bit na palavra de bit da coluna Atributos da tabela controle . |
| 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 tamanho diferente do mesmo ícone. Inclua o valor da palavra de bit apropriada na coluna Atributos da tabela controle Se esses bits não estiverem definidos, o instalador ignorará o atributo FixedSize e a imagem será ampliada para se ajustar ao retângulo de controle. Se os bits IconSize e os bits FixedSize forem definidos, uma imagem menor que o controle será centralizada e uma imagem será maior do que o controle que ela será reduzida para ajustar. |
Observações
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 classificado 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 de diálogo . Como o texto estático não pode se concentrar, 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.