Partilhar via


Controle PathEdit

O controle PathEdit exibe um campo de edição que permite que um usuário selecione a seção final de um caminho. Esse controle dá suporte à inserção do nome da pasta selecionada ou de todo o caminho no campo de edição. Um usuário também pode inserir um caminho UNC para uma unidade que não tenha letra da unidade. Se o usuário inserir um segmento final para o caminho inválido para o volume atual, o controle PathEdit não poderá transferir o foco para o próximo controle.

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 os controles PathEdit e DirectoryList.

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 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 estilo é 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. Para especificar o número de caracteres que o usuário pode inserir, acrescente {n} após as especificações de fonte, onde n é um inteiro positivo.
Visível 0x00000000 0x00000001
Controle oculto. Controle visível.
Inclua esse bit na palavra de bit da coluna Attributes na tabela Control para tornar o controle visível ou oculto após a criação.
Você também pode ocultar ou mostrar 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.

 

Comentários

O controle PathEdit é derivado do controle Editar.

Para compatibilidade com os leitores de tela, ao criar uma caixa de diálogo com um controle PathEdit como o primeiro controle ativo, você precisa tornar o campo de texto parte do campo de edição o primeiro controle ativo na tabela Dialog. Como o texto estático não consegue focar, quando a caixa de diálogo é criada, o campo de edição terá o foco inicialmente conforme o esperado. Isso garante que os leitores de tela mostrem as informações corretas.