WixUI_Advanced Dialog Set

WixUI_Advanced dialog set は、WixUI_Minimal のようにワンクリック インストールのオプションを 提供しますが、もしユーザーが advanced オプションをコンフィギュレーションするのを選べば 他のダイアログ セットのように ディレクトリーとフィーチャーの選択も 可能にします。

このダイアログ セットは、WiX ソースコードの WixUIExtension 中の WixUI_Advanced.wxs ファイル中で定義されています。

WixUI_Advanced の使用

WixUI_Advanced を使うには、セットアップ オーサリング中に 以下の情報を含めなければなりません:

  1. APPLICATIONFOLDER と名付けられた Id を持つディレクトリー。このディレクトリーは、 プロダクトの為のデフォルトのインストール場所になります。例えば:
      <Directory Id="TARGETDIR" Name="SourceDir">
        <Directory Id="ProgramFilesFolder" Name="PFiles">
          <Directory Id="APPLICATIONFOLDER" Name="My Application Folder">
            ...
          </Directory>
        </Directory>
      </Directory>
      
    
  2. ApplicationFolderName と名付けられた Id を持つプロパティと、デフォルト フォルダ名を 表す文字列にセットされた値。このプロパティは、デフォルトのインストール場所を形成するのに 使用されます。

    マシンごとのインストールに関しては、デフォルトのインストール場所は [ProgramFilesFolder][ApplicationFolderName] であり、ユーザーはセットアップ UI 中で それを 変更する事が可能です。 ユーザーごとのインストールに関しては、デフォルトのインストール場所は [LocalAppDataFolder]Apps\[ApplicationFolderName] であり、ユーザーはセットアップ UI 中で それを変更する事はできません。

    例えば:
      <Property Id="ApplicationFolderName" Value="My Application Folder" />
      
    
  3. WixAppFolder と名付けられた Id を持つプロパティと、WixPerMachineFolderWixPerUserFolder にセットされた値。このプロパティは、ユーザーがプロダクトを マシンごとにインストールするか ユーザーごとにインストールするかを 選ぶ事ができる セットアップ UI 中の インストール スコープ ダイアログにおける ラジオボタンのデフォルトの 選択値を セットします。例えば:
      <Property Id="WixAppFolder" Value="WixPerMachineFolder" />
      
    

WixUI_Advanced dialog set 中のインストール スコープ ダイアログを抑制する事が可能であり、 すると ユーザーはマシンごとのインストールか ユーザーごとのインストールかを 選ぶ事ができません。 こうするには、WixUISupportPerMachineWixUISupportPerUser WiX 変数を 0 に セットしなければなりません。これらの変数それぞれについてのデフォルト値は 1 で、同じ .msi 中で これらの値の両方を 0 にセットすべきではありません。例えば、インストール スコープ ダイアログを 削除して マシンごとのインストールだけをサポートするには、以下をセットする事ができます:

  <WixVariable Id="WixUISupportPerUser" Value="0" />
  

インストール スコープ ダイアログは、ユーザーの選択に基づいて インストール セッションに関する ALLUSERS プロパティを 自動的にセットします。もしこれらの WiX 変数値のどちらかをセットする事によって インストール スコープ ダイアログを抑制すると、ALLUSERS プロパティを マシンごとにインストール したいか ユーザーごとにインストールしたいかに基づいて 適切な値に 手動でセットしなければなりません。

WixUI_Advanced Dialogs

WixUI_Advanced は、以下のダイアログを含みます:

さらに、WixUI_Advanced は すべての WixUI dialog sets で現れる 以下のコモン ダイアログを 含みます:

上記のそれぞれのダイアログの詳細な説明に関しては、 WixUI dialogs リファレンスを見て下さい。