Controle SelectionTree
Esse controle permite que um usuário altere o estado de seleção dos recursos listados no da tabela de recursos. O controle é associado a uma propriedade com valor de cadeia de caracteres que o usuário pode definir por uma caixa de diálogo procurar . Você pode associar o controle a uma propriedade inserindo o nome da propriedade na coluna Propriedade da tabela controle .
O controle SelectionTree publica automaticamente os seguintes eventos de controle de no Windows XP ou em sistemas operacionais anteriores. O controle SelectionTree publica esses eventos quando o item selecionado é alterado de um nó para outro. Se a árvore de seleção não tiver nós, o controle publicará esses eventos e apagará o conteúdo dos controles que assinam o evento. Esses ControlEvents não precisam ser listados na tabela ControlEvent.
| Evento de controle | Descrição |
|---|---|
| SelectionAction | Publica uma cadeia de caracteres da tabela UIText descrevendo o item realçado. |
| SelectionBrowse | Gera uma caixa de diálogo Procurar usada para modificar o caminho do item realçado. |
| SelectionDescription | Publica uma cadeia de caracteres da tabela de recursos descrevendo o item realçado. |
| SelectionNoItems | Exclui o texto descritivo ou desabilita os botões de um item obsoleto. |
| SelectionPath | Publica o caminho do item realçado. |
| SelectionPathOn | Publica se há ou não um caminho de seleção associado ao recurso selecionado no momento. |
| SelectionSize | Publica o tamanho do item realçado. |
A partir dos sistemas do Windows Server 2003, os controles SelectionTree publicam todos os eventos na tabela acima e, além disso, publicam um DoAction ControlEvent ou um SetProperty ControlEvent. Os registros devem ser adicionados à tabela ControlEvent para publicar DoAction ou SetProperty ControlEvents.
| Evento de controle | Descrição |
|---|---|
| do DoAction | Notifica o instalador para executar uma ação personalizada. |
| SetProperty | Define uma propriedade como um novo valor. |
A partir do Windows Installer versão 3.0, os controles SelectionTree publicam um evento que executa ações personalizadas listadas na tabela ControlEvent. O controle SelectionTree publica esse evento sempre que a seleção de recursos é alterada no controle ou sempre que um estado de seleção diferente é escolhido para o recurso atual. As ações personalizadas são executadas sempre que o evento é publicado. O controle SelectionTree envia informações para a ação personalizada definindo os valores das propriedades a seguir. Todas essas propriedades são desmarcadas quando o controle SelectionTree é fechado.
Windows Installer 2.0: Sem suporte. O controle SelectionTree não publica o evento e não define as propriedades a seguir.
Nota
O conteúdo do campo Texto da tabela controle nunca é exibido pelo controle SelectionTree. 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 | 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 | 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 | Exibe texto em screenreaders de acordo com o texto inserido 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 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. |
| 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_TREEVIEW usando a funçãoCreateWindowEx. Tem os estilos WS_BORDER, TVS_HASLINES, TVS_HASBUTTONS, TVS_LINESATROOT, TVS_DISABLEDRAGDROP, TVS_SHOWSELALWAYS, WS_CHILD, WS_TABSTOPe WS_GROUP.
A árvore de seleção só será preenchida se a ação CostInitialize e a ação CostFinalize tiverem sido chamadas.
A cadeia de caracteres a seguir na tabela UIText está relacionada a esse controle.
| Prazo | Descrição |
|---|---|
|
AbsentPath |
O caminho exibido para um item no estado ausente. |
As seis cadeias de caracteres a seguir são usadas para exibir o número de filhos selecionados e o tamanho associado ao item realçado:
- SelChildCostPos
- SelChildCostNeg
- SelParentCostPosPosPos
- SelParentCostPosNeg
- SelParentCostNegPos
- SelParentCostNegNegNeg
As seguintes cadeias de caracteres são usadas para exibir as opções de seleção disponíveis para um item em um menu pop-up:
- MenuAbsent
- MenuLocal
- MenuCD
- MenuNetwork
- MenuAllLocal
- MenuAllCD
- MenuAllNetwork
As cadeias de caracteres a seguir são usadas para explicar a seleção atual no SelectionDescription ControlEvent.
- SelAbsentAbsent
- SelAbsentLocal
- SelAbsentCD
- SelAbsentNetwork
- SelLocalAbsent
- SelLocalLocal
- SelLocalCD
- SelLocalNetwork
- SelCDAbsent
- SelNetworkAbsent
- SelCDLocal
- SelNetworkLocal
- SelCDCD
- SelNetworkNetwork
As quatro cadeias de caracteres localizadas a seguir são usadas na formatação do tamanho de um arquivo:
- Bytes
- KB
- MB
- GB