| Beide Seiten der vorigen RevisionVorhergehende ÜberarbeitungNächste Überarbeitung | Vorhergehende Überarbeitung |
| de:create:functions:question [12.07.2016 20:13] – admin | de:create:functions:question [12.05.2023 06:23] (aktuell) – Funktionalität "show-residuals" zurückgerufen admin |
|---|
| ====== question() ====== | ====== question() ====== |
| |
| ''void **question**(string //FrageKennung//, array|string //Items//, [string //Optionen//])'' | ''void **question**(string|array //FrageKennung//, array|string //Items//, [string //Optionen//])'' |
| |
| Zeigt die Frage mit der angegebenen //FrageKennung// im Fragebogen an. Die Funktion ''question()'' wird vor allem in Verbindung mit [[:de:create:filters|Filtern und Filterfragen]] verwendet. | Zeigt die Frage mit der angegebenen //FrageKennung// im Fragebogen an. Die Funktion ''question()'' wird vor allem in Verbindung mit [[:de:create:filters|Filtern und Filterfragen]] verwendet. |
| |
| * //FrageKennung//\\ Die vierstellige Kennung setzt sich aus der Kennung von Rubrik und Frage zusammen (jeweils zweistellig) und muss in Anführungszeichen (einfache oder doppelte) angegeben werden, z.B. '''XY01'''. | * //FrageKennung// |
| * //Items//\\ Optional kann mit dem zweite Parameter angegeben werden, welche Items der Frage gezeigt werden sollen und/oder in welcher Reihenfolge dies geschieht. Die Kennungen der Items werden entweder als Array (''array(2,4,6,8)'') oder durch ein Komma getrennt als String ('''2,4,6,8''') angegeben. In der Itemliste können auch Zahlenbereiche angegeben werden, z.B. '''1,3,5-10''' oder ''array(1,3,'5-10')'', um die Items 1, 3, 5, 6, 7, 8, 9 und 10 zu beschreiben. | * (string) Die vierstellige Kennung setzt sich aus der Kennung von Rubrik und Frage zusammen (jeweils zweistellig) und muss in Anführungszeichen (einfache oder doppelte) angegeben werden, z.B. '''XY01'''. |
| | * (array) Es kann auch ein Array mit mehreren Frage-Kennungen angegeben werden. Diese werden dann als [[:de:create:combine|kombinierte Frage]] dargestellt, genauso wie bei der Verwendung des Parameters ''combine=...''. |
| | * //Items//\\ Optional kann mit dem zweiten Parameter angegeben werden, welche Items der Frage gezeigt werden sollen und/oder in welcher Reihenfolge dies geschieht. Die Kennungen der Items werden entweder als Array (''array(2,4,6,8)'') oder durch ein Komma getrennt als String ('''2,4,6,8''') angegeben. In der Itemliste können auch Zahlenbereiche angegeben werden, z.B. '''1,3,5-10''' oder ''array(1,3,'5-10')'', um die Items 1, 3, 5, 6, 7, 8, 9 und 10 zu beschreiben. |
| * //Optionen//\\ Für die Feinjustierung steht eine ganze Reihe von Optionen zur Verfügung. Für jeden ''question()''-Befehl können beliebig viele Optionen angegeben werden. Setzen Sie jede Option in Anführungszeichen (einfache oder doppelte) und trennen Sie mehrere Optionen durch Kommata (s. Beispiele unten). | * //Optionen//\\ Für die Feinjustierung steht eine ganze Reihe von Optionen zur Verfügung. Für jeden ''question()''-Befehl können beliebig viele Optionen angegeben werden. Setzen Sie jede Option in Anführungszeichen (einfache oder doppelte) und trennen Sie mehrere Optionen durch Kommata (s. Beispiele unten). |
| * '''show-title=no'''\\ Fragetext wird nicht angezeigt, die Nummerierung wird ausgesetzt. | * ''%%'show-title=no'%%''\\ Fragetext wird nicht angezeigt, die Nummerierung wird ausgesetzt. |
| * '''show-explanation=no'''\\ Die Erklärung/Anweisungen werden nicht angezeigt. | * ''%%'show-explanation=no'%%''\\ Die Erklärung/Anweisungen werden nicht angezeigt. |
| * '''show-items=no'''\\ Die Items werden nicht angezeigt. | * ''%%'show-items=no'%%''\\ Die Items oder Ausweichoptionen werden nicht angezeigt. |
| * '''spacing=<n>'''\\ Abstand unter der Frage in Pixel. | * ''%%'spacing=<n>'%%''\\ Abstand unter der Frage in Pixel. |
| * '''number=<n>'''\\ Zeigt vor der Frage die Nummer <n> an, statt automatisch hochzuzählen oder blendet die Nummer mit "number=no" ganz aus.\\ **Tipp:** Sie können die Nummerierung im Fragebogen (**Fragebogen zusammenstellen** -> //Einstellungen//) übrigens auch generell abschalten. Mit der Option ''number=<n>'' oder ''number=yes'' können Sie dann einzelne Frage mit einer Nummer versehen. | * ''%%'number=<n>'%%''\\ Zeigt vor der Frage die Nummer <n> an, statt automatisch hochzuzählen oder blendet die Nummer mit "number=no" ganz aus.\\ **Tipp:** Sie können die Nummerierung im Fragebogen (**Fragebogen zusammenstellen** -> //Einstellungen//) übrigens auch generell abschalten. Mit der Option ''number=<n>'' oder ''number=yes'' können Sie dann einzelne Frage mit einer Nummer versehen. |
| * '''anchor=<Anzahl>'''\\ Die Verankerung (Vorspann, grafische, numerische und verbale Verankerung) einer Skala oder eines Polartitätenprofils alle <Anzahl> Items wiederholen. Sinnvoll bei Fragen mit zahlreichen Items. | * '''anchor=<Anzahl>'''\\ Die Verankerung (Vorspann, grafische, numerische und verbale Verankerung) einer Skala oder eines Polartitätenprofils alle <Anzahl> Items wiederholen. Sinnvoll bei Fragen mit zahlreichen Items. |
| * '''anchor=none'''\\ Blendet die Verankerung (Vorspann, grafische, numerische und verbale Verankerung) einer Skala oder eines Polartitätenprofils komplett aus. | * '''anchor=none'''\\ Blendet die Verankerung (Vorspann, grafische, numerische und verbale Verankerung) einer Skala oder eines Polartitätenprofils komplett aus. |
| * '''align-labels=<center|inside|outside|eachline>'''\\ Ausrichtung der verbalen Verankerung in einer Skala anpassen, die nur die Extrema beschriftet. | * '''align-labels=<center|inside|outside|eachline>'''\\ Ausrichtung der verbalen Verankerung in einer Skala anpassen, die nur die Extrema beschriftet. |
| * '''shading=<auto|none|start-shaded|start-unshaded|all-shaded|all-unshaded>'''\\ Schattierung der Items. | * '''shading=<auto|none|start-shaded|start-unshaded|all-shaded|all-unshaded>'''\\ Schattierung der Items. |
| | * '''flip-inputs'''\\ In den meisten Fragen kann man einstellen, ob die Eingabefelder (z.B. Kästchen zum Ankreuzen) links oder rechts der Beschriftungen stehen sollen. Mit diesem Parameter können Sie die Einstellung invertieren. |
| |
| ===== Hinweise ===== | ===== Hinweise ===== |
