| Beide Seiten der vorigen RevisionVorhergehende ÜberarbeitungNächste Überarbeitung | Vorhergehende ÜberarbeitungNächste ÜberarbeitungBeide Seiten der Revision |
| de:create:functions:question [12.07.2016 14:24] – admin | de:create:functions:question [25.06.2018 09:56] – [question()] Neu: flip-inputs 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// |
| | * (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 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. | * //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. |
| * //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). |
| * '''gap=line'''\\ Eine Linie zwischen den kombinierten Fragen anzeigen. Der Abstand oder die Linie wird zwischen allen kombinierten Fragen gleichermaßen angezeigt. | * '''gap=line'''\\ Eine Linie zwischen den kombinierten Fragen anzeigen. Der Abstand oder die Linie wird zwischen allen kombinierten Fragen gleichermaßen angezeigt. |
| * //Optionen//\\ Einige Optionen erlauben es, dynamisch Einstellungen in der Frage zu überschreiben: | * //Optionen//\\ Einige Optionen erlauben es, dynamisch Einstellungen in der Frage zu überschreiben: |
| * '''filter=<Angabe>'''\\ Präfix für Datenbank-Schlüssel in einer Frage vom Typ "erweiterte Auswahl" oder "Texteingabe mit Auswahlempfehlung" (z.B. '''filter=country''' zur Anzeige aller Datenbank-Einträge, deren Schlüssel mit "country" beginnt). | * '''filter=<Angabe>'''\\ Präfix für Datenbank-Schlüssel in einer Frage vom Typ "erweiterte Auswahl" oder "Texteingabe mit Auswahlempfehlung" (z.B. '''filter=country''' zur Anzeige aller Datenbank-Einträge, deren Schlüssel mit "country" beginnt). Damit die Kodierung einer Antwort bei der Auswahlempfehlung korrekt funktioniert, muss in der Frage selbst zumindest ein Teil des Präfixes als //Präfix für Datenbank-Schlüssel// eingetragen werden. Mittels ''question()'' kann dann eine Eingrenzung vorgenommen werden. |
| * '''direction=<up|down>'''\\ Auswahloptionen einer Skala oder einer horizontalen Auswahl aufsteigend (''up'') oder absteigend (''down'') anordnen. | * '''direction=<up|down>'''\\ Auswahloptionen einer Skala oder einer horizontalen Auswahl aufsteigend (''up'') oder absteigend (''down'') anordnen. |
| * '''composition=<default|extended|dense>'''\\ Einstellung zur //Anordnung einer Frage// anpassen. Dieser Parameter überschreibt dynamisch die entsprechende Einstellung in der Frage. | * '''composition=<default|extended|dense>'''\\ Einstellung zur //Anordnung einer Frage// anpassen. Dieser Parameter überschreibt dynamisch die entsprechende Einstellung in der Frage. |
| * '''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 meissten 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 ===== |
