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 suporta a inserção do nome da pasta selecionada ou o caminho inteiro no campo de edição. Um usuário também pode inserir um caminho UNC (Convenção de Nomenclatura Universal) para uma unidade que não tenha letra de unidade. Se o usuário inserir um segmento final para o caminho que é inválido para o volume atual, o controle PathEdit não poderá transferir o foco para o próximo controle.
O controle PathEdit, DirectoryCombo e controles DirectoryList estão associados à mesma propriedade de valor de cadeia de caracteres. Essa propriedade é o caminho selecionado pelo usuário. Insira o nome da propriedade na coluna Propriedade da tabela Control. Esta propriedade deve ter um valor inicial contendo pelo menos um volume e um subnível. Especifique o valor inicial para a propriedade na coluna Valor da tabela Property.
Esse controle destina-se a ser usado em um Browse Dialog juntamente com os controles de PathEdit e DirectoryList.
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 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. Para especificar o número de caracteres que o usuário pode inserir, acrescente {n} após qualquer especificação de fonte, onde n é um inteiro positivo. |
|
| 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. |
| 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 Edit.
Para compatibilidade com leitores de tela, ao criar uma caixa de diálogo com um controle PathEdit 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; Isso garante que os leitores de tela mostrem as informações corretas.