Compartilhar via


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 de Controles. Essa propriedade deve ter um valor inicial contendo pelo menos um volume e um subnível. Especifique o valor inicial da propriedade na coluna Value da Tabela de Propriedades.

Esse controle destina-se a ser usado em umaCaixa de Diálogo de Navegação 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 de Controles nunca é exibido pelo controle DirectoryList. Em vez disso, esse campo especifica o estilo do 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 da fonte de uma cadeia de texto, acrescente à cadeia de caracteres exibidos o prefixo {\style} ou {&style}. Sendo que Style é um identificador listado na coluna TextStyle da tabela TextStyle. Caso nenhum deles esteja presente, mas a propriedade DefaultUIFont seja 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. Confira Acessibilidade.

Atributos de Controle

É possível 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 Event.

Identificador de atributo Bit hexadecimal Descrição
IndirectPropertyName Esse é o nome de uma propriedade indireta associada ao controle. Se o bit do atributo Indirect estiver definido, o controle vai exibir ou alterar o valor da propriedade que tem esse nome. Se o bit do atributo Indirect estiver definido, esse nome também será o valor da propriedade listada na coluna Property da tabela Control.
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 Control. Use Unidades do instalador para definir o comprimento e a 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 Property da tabela Control.
PropertyValue Valor atual da propriedade exibida ou alterada por esse controle. Se o bit do atributo Indirect não for 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.
Texto Para exibir texto em leitores de tela, insira o texto na coluna Texto da Tabela de Controles. Confira Acessibilidade.
Visível 0x00000000 0x00000001
Controle oculto. Controle visível.
Inclua esse bit na palavra de bit da coluna Atributos na tabela de Controles para tornar o controle visível ou oculto na criação.
Você também pode ocultar ou exibir um controle usando a Tabela ControlCondition.
Enabled 0x00000000 0x00000002
Controle em um estado desabilitado. Controle em um estado habilitado.
Inclua esse bit na palavra de bit na coluna Attributes do Controle para habilitar o controle na criação.
Você também pode habilitar ou desabilitar um controle usando a tabela ControlCondition.
Sunken 0x00000000 0x00000004
Exibe o estilo visual padrão. Exibe o controle com uma aparência 3D em baixo-relevo.
Inclua esses bits na palavra de bit da coluna Attributes da tabela Control.
Indireto. 0x00000000 0x00000008
O controle exibe ou altera o valor da propriedade na coluna Property da tabela Control. O controle exibe ou altera o valor da propriedade que tem o Identificador listado na coluna Property da tabela Control.
Determina se a propriedade associada a esse controle é indiretamente referenciada.
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.
Controle BiDi 0x000000E0 Defina esse valor para uma combinação dos atributos RTLRO, RightAligned e LeftScroll.

Comentários

Esse controle pode ser criado a partir da classe WC_LISTVIEW usando a função CreateWindowEx . Ele tem os estilos LVS_LIST, LVS_EDITLABELS, WS_VSCROLL, LVS_SHAREIMAGELISTS, LVS_AUTOARRANGE, LVS_SINGLESEL, WS_BORDER, LVS_SORTASCENDING, WS_CHILD, WS_GROUP e 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 avance um nível no caminho. Caso o usuário escolha o botão Criar Nova Pasta em uma pasta onde 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.