Lägga till ett guidegränssnitt

I själva verket behöver vi inte definiera något ytterligare guidegränssnitt med <wizard>, men så här är hur man skulle göra det. Man lägger till taggen <wizard> på samma nivå som taggen <dialog>:

<wizard label="Two Variable t-Test">
                        <page id="firstpage">
                                <text>As a first step, select the two variables you want to compare against
                                        each other. And specify, which one you theorize to be greater. Select two-sided,
                                        if your theory does not tell you, which variable is greater.</text>
                                <copy id="main_settings_row"/>
                        </page>
        

En del av det här är rätt självförklarligt: Vi lägger till taggen <wizard> med en label för guiden. Eftersom en guide kan innehålla flera sidor som visas en i taget, definierar vi därefter den första sidan, <page>, och lägger till en förklarande anmärkning där med <text>. Därefter använder vi taggen <copy>. Vad den gör är att vi slipper att återigen definiera vad vi redan gjorde för dialogrutan <dialog>: Taggen letar efter en annan tagg med samma id tidigare i XML-koden. Den råkar vara definierad i sektionen <dialog>, och är raden <row> där det finns en <varselector>, <varslots> och hypotesen med alternativknapparna <radio>. Allt det kopieras ett-till-ett och infogas direkt vid elementet <copy>.

Nu till den andra sidan:

<page id="secondpage">
                                <text>Below are some advanced options. It's generally safe not to assume the
                                        variables have equal variances. An appropriate correction will be applied then.
                                        Choosing "assume equal variances" may increase test-strength, however.</text>
                                <copy id="varequal"/>
                                <text>Sometimes it's helpful to get an estimate of the confidence interval of
                                        the difference in means. Below you can specify whether one should be shown, and
                                        which confidence-level should be applied (95% corresponds to a 5% level of
                                        significance).</text>
                                <copy id="frame_conf_int"/>
                        </page>
                </wizard>
        

I stort sett samma sak här. Vi lägger till en del texter, och däremellan kopierar ytterligare sektioner från dialoggränssnittet med <copy>.

Du kan förstås låta guidegränssnittet se mycket annorlunda ut än den enkla dialogrutan, och inte använda taggen <copy> alls. Försäkra dig dock om att motsvarande element tilldelas samma id i båda gränssnitten. Det används inte bara för att överföra inställningarna från dialoggränssnittet till guidegränssnittet och tillbaka, när användaren byter gränssnitt (vilket inte sker ännu i den nuvarande versionen av RKWard), men förenklar också att skriva kodmallen (se nedan).