Compartilhar via


Caixa de Diálogo de Interface de usuário de botões de opção

RadioButtons caixas de diálogo são usadas para apresentar a até quatro opções mutuamente exclusivas para um usuário e retornar o valor da opção selecionada durante a instalação. Três RadioButtons caixas de diálogo estão disponíveis: Botões de opção (2 botões), RadioButtons (3 botões), e RadioButtons (4 botões). Essas três caixas de diálogo são idênticas exceto para o número de botões de opção (rádio); cada um pode ser adicionada apenas uma vez para cada projeto de implantação.

As caixas de diálogo contém duas, três ou quatro botões de opção com rótulos associados, além de rótulos adicionais para apresentar informações para o usuário. O texto para esses rótulos é especificado em tempo de design do Propriedades janela. Propriedades adicionais são fornecidas para cada botão de opção para definir um valor padrão e definir o botão de opção padrão.

A ilustração a seguir mostra uma típica RadioButtons (2 botões) caixa de diálogo, como ela seria exibida durante a instalação.

Caixa de diálogo RadioButtons (2 botões)

Tela inicial da IU de implantação

Propriedades

As propriedades a seguir estão disponíveis para o RadioButtons caixa de diálogo.

Propriedade

Descrição

BannerBitmap

Especifica um bitmap ou uma imagem JPEG a ser exibido na área de faixa. Na ilustração acima, o bitmap padrão é mostrado. Para obter mais informações, consulte Propriedade de BannerBitmap.

BannerText

Especifica o texto a ser exibido na área de faixa. Na ilustração acima, isso corresponde "Este é o texto da faixa".

Corpo do texto

Especifica o texto a ser exibido acima dos botões de opção. Na ilustração acima, isso corresponde "Este é o corpo de texto".

Button1Label

Especifica o texto a ser exibido ao lado do botão de opção primeiro. Na ilustração acima, isso corresponde a "Primeira opção".

Button1Value

Especifica um valor para o primeiro botão de opção. Esse é o valor que será retornado pela ButtonProperty propriedade se o primeiro botão de opção está selecionado.

Button2Label

Especifica o texto a ser exibido ao lado do segundo botão de opção. Na ilustração acima, isso corresponde a "Segunda opção".

Button2Value

Especifica um valor para o segundo botão de opção. Esse é o valor que será retornado pela ButtonProperty propriedade se o segundo botão de opção está selecionado.

Button3Label

Especifica o texto a ser exibido ao lado do botão de opção de terceiro. Não disponível para o RadioButtons (2 botões) caixa de diálogo.

Button3Value

Especifica um valor para o terceiro botão de opção. Esse é o valor que será retornado pela ButtonProperty propriedade se o terceiro botão de opção está selecionado. Não disponível para o RadioButtons (2 botões) caixa de diálogo.

Button4Label

Especifica o texto a ser exibido ao lado do quarto botão de opção. Não disponível para o RadioButtons (2 botões) ou RadioButtons (3 botões) caixas de diálogo.

Button4Value

Especifica um valor para o quarto botão de opção. Esse é o valor que será retornado pela ButtonProperty propriedade se o quarto botão de opção está selecionado. Não disponível para o RadioButtons (2 botões) ou RadioButtons (3 botões) caixas de diálogo.

ButtonProperty

Especifica um nome de propriedade usado para recuperar o valor do botão de opção selecionada. Esta propriedade pode ser usada em condições.

DefaultValue

Especifica qual botão de opção será selecionada inicialmente quando a caixa de diálogo é exibida.

Controlar a aparência da caixa de diálogo de botões de opção

Várias controle de propriedades como o RadioButtons caixa de diálogo será exibida para o usuário durante a instalação.

  • O BannerBitmap propriedade controla a imagem que aparece no canto superior direito da caixa de diálogo. A posição e tamanho da imagem são corrigidos.

    Dica

    Para uma interface de usuário consistente, a mesma imagem deve ser usada para todas as caixas de diálogo em um instalador.

  • O BannerText propriedade controla o texto que é exibido na faixa na parte superior da caixa de diálogo. A posição, tamanho e o tamanho de fonte são corrigidos. O texto será quebrado, mas não pode ser mais de duas linhas.

  • O corpodetexto propriedade controla o texto que aparece logo abaixo do banner da caixa de diálogo. A posição, tamanho e o tamanho de fonte são corrigidos. O texto será quebrado, mas não pode ser mais de quatro linhas.

  • O botãonrótulo o texto nos rótulos de botão de opção de controle de propriedades. A posição e tamanho de fonte são fixos e o texto não será ajustado.

    Dica

    Para caixas de diálogo que podem ser localizadas, permitir espaço extra para a expansão de texto. Uma palavra em um idioma pode traduzir em uma palavra muito maior em outro idioma, fazendo com que o texto a ser cortado.

Recuperando opções de usuário com propriedades de caixa de diálogo de botões de opção

Quando o instalador que contém o RadioButtons caixa de diálogo é executada, o usuário pode escolher uma opção; Você pode usar essa opção para controlar outra fase da instalação.

Por exemplo, você pode criar um RadioButtons (2 botões) caixa de diálogo que dá ao usuário uma opção de instalação de um arquivo opcional. Nesse caso, você definiria a Button1Label propriedade para "Arquivo opcional da instalação" e o Button2Label a propriedade "Não instalar o arquivo opcional". Você deixaria o Button1Value e Button2Value propriedades em seus valores padrão de 1 e 2, respectivamente.

Se você pensou que os usuários geralmente não deseja instalar o arquivo opcional, você poderia definir a ValorPadrão propriedade para 2 para que ele seria selecionado por padrão.

No File System Editor, você definiria a condição propriedade para o arquivo opcional para o valor padrão da ButtonProperty (BUTTON2) da propriedade plus a Button1Value (1) de propriedade: BUTTON2 = 1.

Durante a instalação, o condição propriedade para o arquivo será avaliada. Se o usuário seleciona o primeiro botão de opção, o ButtonProperty propriedade retornará a Button1Value e o arquivo serão instalados. Caso contrário, a condição será avaliado para false e o arquivo não será instalado.

Consulte também

Conceitos

Restrições de caixa de Diálogo de instalação

Outros recursos

Gerenciamento de Interface de usuário na implantação

Caixas de Diálogo de implantação

Gerenciamento de lançamento de condição na implantação