Controle DirectoryList
Um controle DirectoryList exibe uma parte do caminho que atualmente é exibida no controle PathEdit. O controle DirectoryList exibe as pastas abaixo do diretório exibido atualmente pelo controle DirectoryCombo.
Os controles PathEdit, DirectoryCombo e DirectoryList estão associados à mesma propriedade com valor de cadeia de caracteres. Essa propriedade é o caminho selecionado pelo usuário. Insira o nome da propriedade na coluna Propriedade da tabela controle . Essa propriedade deve ter um valor inicial contendo pelo menos um volume e um subnível. Especifique o valor inicial da propriedade na coluna Valor da tabela Property.
Esse controle destina-se a ser usado em uma caixa de diálogo procurar junto com o controle PathEdit e DirectoryList.
O controle DirectoryList publica os controlEvents a seguir.
| ControlEvent | Descrição |
|---|---|
| DirectoryListNew | Cria uma nova pasta e seleciona o campo de nome para edição. |
| IgnoreChange | Realça, mas não abre, uma pasta no diretório atual. |
| DirectoryListUp | Seleciona o pai do diretório atual. |
| DirectoryListOpen | Seleciona e realça um diretório. |
O conteúdo do campo Texto da tabela controle nunca é exibido pelo controle DirectoryList. 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 de 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 Control. Determina se a propriedade associada a esse controle é referenciada indiretamente. |
| 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. |
| de controle BiDi | 0x000000E0 | Defina esse valor para uma combinação dos atributos RTLRO, RightAligned e LeftScroll. |
Observações
Esse controle pode ser criado a partir da classe WC_LISTVIEW usando a funçãoCreateWindowEx. Tem os estilos LVS_LIST, LVS_EDITLABELS, WS_VSCROLL, LVS_SHAREIMAGELISTS, LVS_AUTOARRANGE, LVS_SINGLESEL, WS_BORDER, LVS_SORTASCENDING, WS_CHILD, WS_GROUPe WS_TABSTOP.
Esse controle permite que o usuário selecione uma subpasta da seleção atual. Com botões adicionais, ele também permite que o usuário selecione uma nova pasta na seleção atual ou suba um nível no caminho. Se o usuário escolher o botão Criar Nova Pasta em uma pasta em que uma nova pasta já existe, uma segunda nova pasta não será criada e o nome da nova pasta existente será selecionado para edição.