Partilhar via

Controle SelectionTree

  • Artigo

Esse controle permite que um usuário altere o estado de seleção dos recursos listados na tabela Recurso. O controle está associado a uma propriedade de 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 Control.

O controle SelectionTree publica automaticamente os seguintes eventos de controle no Windows XP ou 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 controlo Descrição
SelectionAction Publica uma cadeia de caracteres da tabela UIText descrevendo o item realçado.
SeleçãoProcurar Gera uma caixa de diálogo Procurar usada para modificar o caminho do item realçado.
SelectionDescrição Publica uma cadeia de caracteres da tabela Recurso descrevendo o item realçado.
SelectionNoItems Exclui o texto descritivo ou desativa os botões de um item obsoleto.
SelectionPath Publica o caminho para o 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 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 controlo Descrição
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 seguintes propriedades. Todas essas propriedades são limpas quando o controle SelectionTree é fechado.

Windows Installer 2.0: Não suportado. O controle SelectionTree não publica o evento e não define as seguintes propriedades.

Propriedade Descrição
MsiSelectionTreeSelectedFeature O nome do recurso selecionado no campo Recurso da tabela Recurso.
MsiSelectionTreeSelectedAction O estado da ação de instalação do recurso selecionado. O valor pode ser INSTALLSTATE_ABSENT, INSTALLSTATE_LOCAL, INSTALLSTATE_SOURCE ou INSTALLSTATE_ADVERTISED.
MsiSelectonTreeChildrenCount Número de nós filhos diretos.
MsiSelectionTreeInstallingChildrenCount Número de nós filho diretos que são INSTALLSTATE_LOCAL, INSTALLSTATE_SOURCE ou INSTALLSTATE_ADVERTISED.
MsiSelectionTreeSelectedCost Custo de instalação do recurso selecionado em unidades de 512 bytes.
MsiSelectionTreeChildrenCost Custo de instalação de todos os recursos infantis em unidades de 512 bytes.
MsiSelectionTreeSelectedPath Caminho onde o recurso selecionado está sendo instalado. Definido somente se o recurso estiver sendo instalado como INSTALLSTATE_LOCAL.

 

Observação

O conteúdo do campo Texto do de tabela de controle de 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 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 propriedade DefaultUIFont for definida como um estilo de texto válido, essa fonte será usada. As informações a seguir são lidas pelos utilitários de revisão de tela como a descrição do controle. Consulte de Acessibilidade .

 

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 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 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 Exibe texto em leitores de tela de acordo com o texto inserido na coluna Texto da tabela Control. Consulte de Acessibilidade .
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 um visual 3D afundado.
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.
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, RightAlignede LeftScroll.

 

Comentários

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ção CostFinalize tiverem sido chamadas.

A seqüência de caracteres a seguir na tabela UIText está relacionada a esse controle.

Vigência 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
  • SelParentCostPosPos
  • SelParentCostPosNeg
  • SelParentCostNegPos
  • SelParentCostNegNeg

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:

  • MenuAusente
  • MenuLocal
  • MenuCD
  • MenuNetwork
  • MenuAllLocal
  • MenuAllCD
  • MenuAllNetwork

As cadeias de caracteres a seguir são usadas para explicar a seleção presente 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
  • PT