=====StartQuestionnaire=====

====Summary====

This script will begin the questionnaire. Any questions loaded with [[addquestion]] will be sorted and presented to the user with multiple choice answers as clickable buttons.

The questionnaire can be sorted in order or with the questions and/or answers shuffled randomly.

====Parameters====

===ShuffleQuestions===

//Type: [[bool]]
Default: **False**//

If assigned a value of True, each of the questions will be shuffled into a random order before beginning the questionnaire.

===ShuffleAnswers===

//Type: [[bool]]
Default: **False**//

If assigned a value of True, each of the answers to every question will be shuffled into a random order before it is asked to the user.

===ShowScore===

//Type: [[bool]]
Default: **True**//

If assigned a value of True, the total score of all correct answers answered will be shown at the end of the questionnaire.

====Examples====

In order to use the Questionnaire, you must follow a strict order of:

  * Clear the Questionnaire - See [[clearquestions]]
  * Add Questions to the Questionnaire - See [[addquestion]]
  * Start the Questionnaire - (This script command)

<WRAP important>
Each Question added to the Questionnaire will be remembered and asked the next time you start the Questionnaire. You must call [[clearquestions]] first before starting a new one. 
</WRAP>

<code>
<clearquestions/>
<addquestion Question="How many fingers are on a single hand" Answers="3,5,6,2" CorrectAnswer="1" />
<addquestion Question="Solve the mathematical problem: 4+5 = ?" Answers="9,12,10,8" CorrectAnswer="0" />
<startquestionnaire/>
</code>

> The above code will clear the questionnaire first, then add 2 questions to the questionnaire, then start it.

Alternatively, you can also launch the Questionnaire in such a way that it will shuffle the order of the questions and/or the answers. Simply replace the <startquestionnaire/> line with any of the following:

<code>
<startquestionnaire ShuffleQuestions="True" />
</code>

> The above code will shuffle all of the questions into a random order, then begin the questionnaire.

<code>
<startquestionnaire ShuffleQuestions="True" ShuffleAnswers="true" />
</code>

> The above code will shuffle all of the questions into a random order, then shuffle all of the answers to each question in to a random order, then begin the questionnaire.



====See also====
[[addquestion]] [[clearquestions]]