====== UTU-käyttöliittymäpaketti ======

UI-UTU tarjoaa kolme valmista dialogia, joita tarvitaan asennuksissa.

===== Käyttö =====

Lataa ui-utu.zip tästä: {{ohjeet:wix:ui-utu.zip}}.
Paketti sisältää ui-utu.wxs -määrittelyn, yhden kuvan ja kolme ikonia.

Ota WiX-määrittelytiedostossasi paketti käyttöön käskyllä
<code xml>
<FragmentRef Id='ui-utu' />
</code>

Ikkunat pitää näyttää InstallUISequence-elementin sisältä. Esimerkissä varoitusikkunat näytetään vain tietyn ehdon käytyä toteen.
<code xml>
    <InstallUISequence>
      <FindRelatedProducts Sequence="200" />
      <Show Dialog="UI_Obsolete" Sequence="201">NEWFOUND</Show>
      <Show Dialog="UI_Updateprompt" Sequence="202">OLDFOUND</Show>
      <Show Dialog="UI_Progressbar" Sequence="203" />
    </InstallUISequence>
</code>

Uuden ikkunan näyttäminen hävittää edellisen ikkunan. Siksi tämä aiheuttaa ongelmia:
<code xml>
    <InstallUISequence>
      <Show Dialog="UI_Progressbar" Sequence="202" />
      <Show Dialog="UI_Updateprompt" Sequence="203">OLDFOUND</Show>
      <!-- Updateprompt hävittää Progressbarin, joten varsinaisen asennuksen aikana ei näy yhtään ikkunaa -->
    </InstallUISequence>
</code>

===== UI_Progressbar =====

Näyttää asennuksen etenemisen. Ikkunan nimessä lukee **[ProductName] -asennus**. Asennetaan -tekstin jälkeen lukee myös [ProductName] uudelleen. [ProductName] on Product-elementissä määritelty Name-attribuutti. UI_Progressbar on ns. **modeless**-ikkuna, joka ei pysäytä asennuksen etenemistä.

{{ohjeet:wix:progress.png}}

===== UI_Obsolete =====

Näyttää dialogin, jossa käyttäjälle kerrotaan uudemman version olevan jo asennettu koneelle. OK-nappula keskeyttää asennuksen. Ikkunan nimessä lukee **[ProductName] -asennus**.

{{ohjeet:wix:obsolete.jpg}}

===== UI_Updateprompt =====

Näyttää dialogin, jossa käyttäjää varoitetaan asentamisen jatkamisen poistavan vanhan version. OK-nappula jatkaa asennusta. Peruuta-nappula keskeyttää asennuksen. Ikkunan nimessä lukee **[ProductName] -asennus**.

{{ohjeet:wix:upgrade.png}}

===== Skaalautuminen =====

Koska Windows Installer skaalaa käyttöliittymää Windowsin fonttikoon mukaan, kuvat skaalautuvat ikävästi näillä käyttäjillä. Siksi ui-utu paketissa on käytetty vain valkoista taustakuvaa, jonka skaalautuminen ei haittaa. Kaikki muut kuvat ovat ikoneita, jotka eivät skaalaudu. Tämä tosin aiheuttaa sen, että kuvat näyttävät hassun pieniltä isommilla fonttikoilla.

=== Normaali fonttikoko ===
{{ohjeet:wix:progress.png}}

=== Isot fontit ===
{{ohjeet:wix:large_fonts.png}}