Controle VolumeCostList

O controle VolumeCostList apresenta informações sobre o custo associado à seleção nos diferentes volumes. O controle mostra todos os volumes envolvidos na instalação atual mais todos os volumes que são dos tipos especificados nos bits de atributo. Se o espaço em disco necessário exceder a quantidade disponível em alguma unidade, o volume será realçado na tabela. Clicar em um cabeçalho de coluna classifica os volumes de acordo com a coluna escolhida.

As seguintes cadeias de caracteres são usadas para os títulos de coluna no controle e devem ser especificadas na tabela UIText:

• VolumeCostAvailable
• VolumeCostDifference
• VolumeCostRequired
• VolumeCostSize
• VolumeCostVolume

As quatro cadeias de caracteres localizadas a seguir são usadas na formatação do tamanho de um arquivo:

• Bytes
• KB
• MB
• GB

Os autores podem definir as larguras de coluna no controle VolumeCostList, acrescentando larguras de coluna após qualquer especificação de fonte. As larguras das colunas são inseridas como uma série de inteiros positivos entre chaves. Chaves vazias ou {0} ocultam a coluna. Um número negativo ou uma cadeia de caracteres que não pode ser convertida em um inteiro positivo é uma largura de coluna inválida. Quando uma largura de coluna inválida é encontrada na série, as colunas restantes ficam ocultas. No máximo, cinco larguras de coluna podem ser especificadas.

O conteúdo do campo Text da Tabela Control nunca é exibido pelo controle VolumeCostList. 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 seu estilo em 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.

Observe que o instalador não atualiza o conteúdo do VolumeCostControl, quando um usuário insere um caminho diferente em um controle PathEdit, uma caixa de diálogo Browse, controle DirectoryList ou controle DirectoryCombo, pois não há propriedades associadas ao controle VolumeCostList.

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
Posição		Posição do controle na caixa de diálogo. Insira a largura, a altura e as coordenadas 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.
Texto		Para exibir texto em leitores de tela, insira o texto na coluna Texto da Tabela de Controles. Confira Acessibilidade. Para definir as larguras de coluna no controle VolumeCostList, acrescente as larguras de coluna a qualquer especificação de fonte. As larguras das colunas são inseridas como uma série de inteiros positivos entre chaves. Chaves vazias ou {0} ocultam a coluna. Um número negativo ou uma cadeia de caracteres que não pode ser convertida em um inteiro positivo é uma largura de coluna inválida. Quando uma largura de coluna inválida é encontrada na série, as colunas restantes ficam ocultas. No máximo, cinco larguras de coluna podem ser especificadas.
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.
RTLRO	0x00000000 0x00000020	O texto no controle é exibido em uma ordem de leitura da esquerda para a direita. O texto no controle é exibido em uma 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, RightAligned e LeftScroll.
RemovableVolume	0x00010000	O controle lista as unidades removíveis. Inclua esse bit na palavra de bit da coluna Attributes da tabela Control.
FixedVolume	0x00020000	O controle lista os discos rígidos internos fixos. Inclua esse bit na palavra de bit da coluna Attributes da tabela Control.
RemoteVolume	0x00040000	O controle lista os volumes remotos. Inclua esse bit na palavra de bit da coluna Attributes da tabela Control.
CDROMVolume	0x00080000	O controle lista os volumes de CD-ROM. Inclua esse bit na palavra de bit da coluna Attributes da tabela Control.
RAMDiskVolume	0x00100000	O controle lista os discos de RAM. Inclua esse bit na palavra de bit da coluna Attributes da tabela Control.
FloppyVolume	0x00200000	O controle lista as unidades de disquete. Inclua esse bit na palavra de bit da coluna Attributes da tabela Control.
ControlShowRollbackCost	0x00000000 0x00400000	Se PROMPTROLLBACKCOST = P e esse atributo não foi definido, os arquivos de backup de reversão não serão incluídos no custo exibido pelo controle VolumeCostList. Se PROMPTROLLBACKCOST = P e esse atributo foi definido, os arquivos de backup de reversão serão incluídos no custo exibido pelo controle VolumeCostList. Esse atributo de controle será ignorado se PROMPTROLLBACKCOST = D ou F. Se PROMPTROLLBACKCOST = F, o custo dos arquivos de backup de reversão será incluído. Se PROMPTROLLBACKCOST = D ou DISABLEROLLBACK = 1, o custo dos arquivos de backup de reversão não será incluído.

 

Comentários

Esse controle pode ser criado a partir da classe WC_LISTVIEW usando a função CreateWindowEx. Ele tem os estilos LVS_REPORT, WS_VSCROLL, WS_HSCROLL, LVS_SHAREIMAGELISTS, LVS_AUTOARRANGE, LVS_SINGLESEL, WS_BORDER, WS_CHILD, WS_TABSTOP e WS_GROUP.