| ILIAS
    release_5-3 Revision v5.3.23-19-g915713cf615
    | 
Single choice question GUI representation. More...
 Inheritance diagram for assSingleChoiceGUI:
 Inheritance diagram for assSingleChoiceGUI: Collaboration diagram for assSingleChoiceGUI:
 Collaboration diagram for assSingleChoiceGUI:| Public Member Functions | |
| __construct ($id=-1) | |
| assSingleChoiceGUI constructor  More... | |
| editQuestion ($checkonly=false) | |
| Creates an output of the edit form for the question.  More... | |
| uploadchoice () | |
| Upload an image.  More... | |
| removeimagechoice () | |
| Remove an image.  More... | |
| addchoice () | |
| Add a new answer.  More... | |
| removechoice () | |
| Remove an answer.  More... | |
| getSolutionOutput ( $active_id, $pass=null, $graphicalOutput=false, $result_output=false, $show_question_only=true, $show_feedback=false, $show_correct_solution=false, $show_manual_scoring=false, $show_question_text=true) | |
| Get the question solution output.  More... | |
| getPreview ($show_question_only=false, $showInlineFeedback=false) | |
| getTestOutput ($active_id, $pass, $is_postponed=false, $use_post_solutions=false, $show_feedback=false) | |
| setQuestionTabs () | |
| Sets the ILIAS tabs for this question type.  More... | |
| getChoiceKeys () | |
| getSpecificFeedbackOutput ($active_id, $pass) | |
| Returns the answer specific feedback for the question.  More... | |
| writeQuestionSpecificPostData (ilPropertyFormGUI $form) | |
| Extracts the question specific values from $_POST and applies them to the data object.  More... | |
| populateQuestionSpecificFormPart (\ilPropertyFormGUI $form) | |
| getAfterParticipationSuppressionQuestionPostVars () | |
| Returns a list of postvars which will be suppressed in the form output when used in scoring adjustment.  More... | |
| writeAnswerSpecificPostData (ilPropertyFormGUI $form) | |
| Extracts the answer specific values from $_POST and applies them to the data object.  More... | |
| populateAnswerSpecificFormPart (\ilPropertyFormGUI $form) | |
| getAfterParticipationSuppressionAnswerPostVars () | |
| Returns a list of postvars which will be suppressed in the form output when used in scoring adjustment.  More... | |
| getAggregatedAnswersView ($relevant_answers) | |
| Returns an html string containing a question specific representation of the answers so far given in the test for use in the right column in the scoring adjustment user interface.  More... | |
| aggregateAnswers ($relevant_answers_chosen, $answers_defined_on_question) | |
| renderAggregateView ($aggregate) | |
|  Public Member Functions inherited from assQuestionGUI | |
| __construct () | |
| assQuestionGUI constructor  More... | |
| executeCommand () | |
| execute command  More... | |
| getCommand ($cmd) | |
| getType () | |
| needed for page editor compliance  More... | |
| getPresentationContext () | |
| setPresentationContext ($presentationContext) | |
| isTestPresentationContext () | |
| isPreviousSolutionPrefilled () | |
| setPreviousSolutionPrefilled ($previousSolutionPrefilled) | |
| getRenderPurpose () | |
| setRenderPurpose ($renderPurpose) | |
| isRenderPurposePrintPdf () | |
| isRenderPurposePreview () | |
| isRenderPurposeInputValue () | |
| isRenderPurposePlayback () | |
| isRenderPurposeDemoplay () | |
| renderPurposeSupportsFormHtml () | |
| getEditContext () | |
| setEditContext ($editContext) | |
| isAuthoringEditContext () | |
| isAdjustmentEditContext () | |
| setAdjustmentEditContext () | |
| getNavigationGUI () | |
| setNavigationGUI ($navigationGUI) | |
| setTaxonomyIds ($taxonomyIds) | |
| getTaxonomyIds () | |
| setTargetGui ($linkTargetGui) | |
| setTargetGuiClass ($targetGuiClass) | |
| getTargetGuiClass () | |
| setQuestionHeaderBlockBuilder ($questionHeaderBlockBuilder) | |
| getQuestionHeaderBlockBuilder () | |
| setQuestionActionCmd ($questionActionCmd) | |
| getQuestionActionCmd () | |
| & | createQuestionGUI ($question_type, $question_id=-1) | 
| Creates a question gui representation.  More... | |
| populateJavascriptFilesRequiredForWorkForm (ilTemplate $tpl) | |
| getQuestionTemplate () | |
| get question template  More... | |
| getILIASPage ($html="") | |
| Returns the ILIAS Page around a question.  More... | |
| outQuestionPage ($a_temp_var, $a_postponed=false, $active_id="", $html="") | |
| output question page  More... | |
| cancel () | |
| cancel action  More... | |
| originalSyncForm ($return_to="", $return_to_feedback='') | |
| sync () | |
| cancelSync () | |
| saveEdit () | |
| save question  More... | |
| save () | |
| save question  More... | |
| saveReturn () | |
| save question  More... | |
| apply () | |
| apply changes  More... | |
| getContextPath ($cont_obj, $a_endnode_id, $a_startnode_id=1) | |
| get context path in content object tree  More... | |
| setSequenceNumber ($nr) | |
| getSequenceNumber () | |
| setQuestionCount ($a_question_count) | |
| getQuestionCount () | |
| getErrorMessage () | |
| setErrorMessage ($errormessage) | |
| addErrorMessage ($errormessage) | |
| outAdditionalOutput () | |
| getQuestionType () | |
| Returns the question type string.  More... | |
| getAsValueAttribute ($a_value) | |
| Returns a HTML value attribute.  More... | |
| addNewIdListener (&$a_object, $a_method, $a_parameters="") | |
| Add a listener that is notified with the new question ID, when a new question is saved.  More... | |
| callNewIdListeners ($a_new_id) | |
| Call the new id listeners.  More... | |
| addQuestionFormCommandButtons ($form) | |
| Add the command buttons of a question properties form.  More... | |
| addBasicQuestionFormProperties ($form) | |
| Add basic question form properties: assessment: title, author, description, question, working time.  More... | |
| getAnswerFeedbackOutput ($active_id, $pass) | |
| Returns the answer generic feedback depending on the results of the question.  More... | |
| getGenericFeedbackOutput ($active_id, $pass) | |
| Returns the answer specific feedback for the question.  More... | |
| getGenericFeedbackOutputForCorrectSolution () | |
| getGenericFeedbackOutputForIncorrectSolution () | |
| getSpecificFeedbackOutput ($active_id, $pass) | |
| Returns the answer specific feedback for the question.  More... | |
| outQuestionType () | |
| showSuggestedSolution () | |
| suggestedsolution () | |
| Allows to add suggested solutions for questions.  More... | |
| outSolutionExplorer () | |
| saveSuggestedSolution () | |
| cancelExplorer () | |
| outPageSelector () | |
| outChapterSelector () | |
| outGlossarySelector () | |
| linkChilds () | |
| addPG () | |
| addST () | |
| addGIT () | |
| isSaveCommand () | |
| setQuestionTabs () | |
| addTab_SuggestedSolution (ilTabsGUI $tabs, $classname) | |
| getEditQuestionTabCommands () | |
| getSolutionOutput ( $active_id, $pass=null, $graphicalOutput=false, $result_output=false, $show_question_only=true, $show_feedback=false, $show_correct_solution=false, $show_manual_scoring=false, $show_question_text=true) | |
| isAutosaveable () | |
| getPreview ($show_question_only=false, $showInlineFeedback=false) | |
| outQuestionForTest ( $formaction, $active_id, $pass, $is_question_postponed=false, $user_post_solutions=false, $show_specific_inline_feedback=false) | |
| magicAfterTestOutput () | |
| getTestOutput ( $active_id, $pass, $is_question_postponed, $user_post_solutions, $show_specific_inline_feedback) | |
| getFormEncodingType () | |
| setPreviewSession ($previewSession) | |
| getPreviewSession () | |
| showHints () | |
|  Public Member Functions inherited from ilGuiQuestionScoringAdjustable | |
| populateQuestionSpecificFormPart (ilPropertyFormGUI $form) | |
| Adds the question specific forms parts to a question property form gui.  More... | |
| writeQuestionSpecificPostData (ilPropertyFormGUI $form) | |
| Extracts the question specific values from $_POST and applies them to the data object.  More... | |
| getAfterParticipationSuppressionQuestionPostVars () | |
| Returns a list of postvars which will be suppressed in the form output when used in scoring adjustment.  More... | |
| getAggregatedAnswersView ($relevant_answers) | |
| Returns an html string containing a question specific representation of the answers so far given in the test for use in the right column in the scoring adjustment user interface.  More... | |
|  Public Member Functions inherited from ilGuiAnswerScoringAdjustable | |
| populateAnswerSpecificFormPart (ilPropertyFormGUI $form) | |
| Adds the answer specific form parts to a question property form gui.  More... | |
| writeAnswerSpecificPostData (ilPropertyFormGUI $form) | |
| Extracts the answer specific values from $_POST and applies them to the data object.  More... | |
| getAfterParticipationSuppressionAnswerPostVars () | |
| Returns a list of postvars which will be suppressed in the form output when used in scoring adjustment.  More... | |
| Protected Member Functions | |
| writePostData ($always=false) | |
| {Evaluates a posted edit form and writes the form data in the question object. 
 | |
| getEditAnswersSingleLine ($checkonly=false) | |
| Get the single/multiline editing of answers.  More... | |
|  Protected Member Functions inherited from assQuestionGUI | |
| writePostData ($always=false) | |
| Evaluates a posted edit form and writes the form data in the question object.  More... | |
| renderEditForm ($form) | |
| getUseUnchangedAnswerCheckboxHtml () | |
| getPreviousSolutionProvidedMessage () | |
| getPreviousSolutionConfirmationCheckboxHtml () | |
| saveTaxonomyAssignments () | |
| populateTaxonomyFormSection (ilPropertyFormGUI $form) | |
| getBasicEditQuestionTabCommands () | |
| getAdditionalEditQuestionCommands () | |
| addTab_QuestionFeedback (ilTabsGUI $tabs) | |
| adds the feedback tab to ilTabsGUI  More... | |
| addTab_QuestionHints (ilTabsGUI $tabs) | |
| adds the hints tab to ilTabsGUI  More... | |
| addTab_QuestionPreview (ilTabsGUI $tabsGUI) | |
| hasCorrectSolution ($activeId, $passIndex) | |
| writeQuestionGenericPostData () | |
| completeTestOutputFormAction ($formAction, $active_id, $pass) | |
| addBackTab (ilTabsGUI $ilTabs) | |
| buildBasicEditFormObject () | |
| buildEditForm () | |
| Private Member Functions | |
| populateInlineFeedback ($template, $answer_id, $user_solution) | |
| Additional Inherited Members | |
|  Static Public Member Functions inherited from assQuestionGUI | |
| static | _getQuestionGUI ($question_type, $question_id=-1) | 
| Creates a question gui representation and returns the alias to the question gui note: please do not use $this inside this method to allow static calls.  More... | |
| static | _getGUIClassNameForId ($a_q_id) | 
| static | _getClassNameForQType ($q_type) | 
| static | getCommandsFromClassConstants ($guiClassName, $cmdConstantNameBegin='CMD_') | 
| extracts values of all constants of given class with given prefix as array can be used to get all possible commands in case of these commands are defined as constants  More... | |
|  Data Fields inherited from assQuestionGUI | |
| const | FORM_MODE_EDIT = 'edit' | 
| const | FORM_MODE_ADJUST = 'adjust' | 
| const | FORM_ENCODING_URLENCODE = 'application/x-www-form-urlencoded' | 
| const | FORM_ENCODING_MULTIPART = 'multipart/form-data' | 
| const | SESSION_PREVIEW_DATA_BASE_INDEX = 'ilAssQuestionPreviewAnswers' | 
| $object | |
| $tpl | |
| $lng | |
| $error | |
| $errormessage | |
| $sequence_no | |
| sequence number in test  More... | |
| $question_count | |
| question count in test  More... | |
| const | PRESENTATION_CONTEXT_TEST = 'pContextTest' | 
| const | PRESENTATION_CONTEXT_RESULTS = 'pContextResults' | 
| const | RENDER_PURPOSE_PLAYBACK = 'renderPurposePlayback' | 
| const | RENDER_PURPOSE_DEMOPLAY = 'renderPurposeDemoplay' | 
| const | RENDER_PURPOSE_PREVIEW = 'renderPurposePreview' | 
| const | RENDER_PURPOSE_PRINT_PDF = 'renderPurposePrintPdf' | 
| const | RENDER_PURPOSE_INPUT_VALUE = 'renderPurposeInputValue' | 
| const | EDIT_CONTEXT_AUTHORING = 'authoring' | 
| const | EDIT_CONTEXT_ADJUSTMENT = 'adjustment' | 
|  Protected Attributes inherited from assQuestionGUI | |
| $editForm | |
Single choice question GUI representation.
The assSingleChoiceGUI class encapsulates the GUI representation for single choice questions.
@ilCtrl_Calls assSingleChoiceGUI: ilFormPropertyDispatchGUI
Definition at line 23 of file class.assSingleChoiceGUI.php.
| assSingleChoiceGUI::__construct | ( | $id = -1 | ) | 
assSingleChoiceGUI constructor
The constructor takes possible arguments an creates an instance of the assSingleChoiceGUI object.
| integer | $id | The database id of a single choice question object | 
Definition at line 32 of file class.assSingleChoiceGUI.php.
References $id.
| assSingleChoiceGUI::addchoice | ( | ) | 
Add a new answer.
Definition at line 158 of file class.assSingleChoiceGUI.php.
References $_POST, editQuestion(), and writePostData().
 Here is the call graph for this function:
 Here is the call graph for this function:| assSingleChoiceGUI::aggregateAnswers | ( | $relevant_answers_chosen, | |
| $answers_defined_on_question | |||
| ) | 
Definition at line 767 of file class.assSingleChoiceGUI.php.
Referenced by getAggregatedAnswersView().
 Here is the caller graph for this function:
 Here is the caller graph for this function:| assSingleChoiceGUI::editQuestion | ( | $checkonly = false | ) | 
Creates an output of the edit form for the question.
Definition at line 87 of file class.assSingleChoiceGUI.php.
References $errors, $form, assQuestionGUI\addBasicQuestionFormProperties(), assQuestionGUI\addQuestionFormCommandButtons(), getEditAnswersSingleLine(), assQuestionGUI\getQuestionTemplate(), assQuestionGUI\isSaveCommand(), assQuestionGUI\outQuestionType(), populateAnswerSpecificFormPart(), populateQuestionSpecificFormPart(), and assQuestionGUI\populateTaxonomyFormSection().
Referenced by addchoice(), removechoice(), removeimagechoice(), uploadchoice(), and writePostData().
 Here is the call graph for this function:
 Here is the call graph for this function: Here is the caller graph for this function:
 Here is the caller graph for this function:| assSingleChoiceGUI::getAfterParticipationSuppressionAnswerPostVars | ( | ) | 
Returns a list of postvars which will be suppressed in the form output when used in scoring adjustment.
The form elements will be shown disabled, so the users see the usual form but can only edit the settings, which make sense in the given context.
E.g. array('cloze_type', 'image_filename')
Implements ilGuiAnswerScoringAdjustable.
Definition at line 747 of file class.assSingleChoiceGUI.php.
| assSingleChoiceGUI::getAfterParticipationSuppressionQuestionPostVars | ( | ) | 
Returns a list of postvars which will be suppressed in the form output when used in scoring adjustment.
The form elements will be shown disabled, so the users see the usual form but can only edit the settings, which make sense in the given context.
E.g. array('cloze_type', 'image_filename')
Implements ilGuiQuestionScoringAdjustable.
Definition at line 677 of file class.assSingleChoiceGUI.php.
| assSingleChoiceGUI::getAggregatedAnswersView | ( | $relevant_answers | ) | 
Returns an html string containing a question specific representation of the answers so far given in the test for use in the right column in the scoring adjustment user interface.
| array | $relevant_answers | 
Implements ilGuiQuestionScoringAdjustable.
Definition at line 760 of file class.assSingleChoiceGUI.php.
References aggregateAnswers(), and renderAggregateView().
 Here is the call graph for this function:
 Here is the call graph for this function:| assSingleChoiceGUI::getChoiceKeys | ( | ) | 
Definition at line 592 of file class.assSingleChoiceGUI.php.
Referenced by getPreview(), getSolutionOutput(), and getTestOutput().
 Here is the caller graph for this function:
 Here is the caller graph for this function:| 
 | protected | 
Get the single/multiline editing of answers.
| bool | $checkonly | get the setting for checking a POST | 
Definition at line 66 of file class.assSingleChoiceGUI.php.
References $_POST.
Referenced by editQuestion(), populateAnswerSpecificFormPart(), and populateQuestionSpecificFormPart().
 Here is the caller graph for this function:
 Here is the caller graph for this function:| assSingleChoiceGUI::getPreview | ( | $show_question_only = false, | |
| $showInlineFeedback = false | |||
| ) | 
Reimplemented from assQuestionGUI.
Definition at line 334 of file class.assSingleChoiceGUI.php.
References $keys, $template, $type, getChoiceKeys(), assQuestionGUI\getILIASPage(), ilUtil\getImagePath(), assQuestionGUI\getPreviewSession(), populateInlineFeedback(), and ilUtil\prepareFormOutput().
 Here is the call graph for this function:
 Here is the call graph for this function:| assSingleChoiceGUI::getSolutionOutput | ( | $active_id, | |
| $pass = null, | |||
| $graphicalOutput = false, | |||
| $result_output = false, | |||
| $show_question_only = true, | |||
| $show_feedback = false, | |||
| $show_correct_solution = false, | |||
| $show_manual_scoring = false, | |||
| $show_question_text = true | |||
| ) | 
Get the question solution output.
| integer | $active_id | The active user id | 
| integer | $pass | The test pass | 
| boolean | $graphicalOutput | Show visual feedback for right/wrong answers | 
| boolean | $result_output | Show the reached points for parts of the question | 
| boolean | $show_question_only | Show the question without the ILIAS content around | 
| boolean | $show_feedback | Show the question feedback | 
| boolean | $show_correct_solution | Show the correct solution instead of the user solution | 
| boolean | $show_manual_scoring | Show specific information for the manual scoring output | 
Reimplemented from assQuestionGUI.
Definition at line 190 of file class.assSingleChoiceGUI.php.
References $index, $keys, $ok, $pass, $template, ilAssQuestionFeedback\CSS_CLASS_FEEDBACK_CORRECT, ilAssQuestionFeedback\CSS_CLASS_FEEDBACK_WRONG, assQuestionGUI\getAnswerFeedbackOutput(), getChoiceKeys(), ilUtil\getHtmlPath(), assQuestionGUI\getILIASPage(), ilUtil\getImagePath(), assQuestionGUI\hasCorrectSolution(), assQuestionGUI\isRenderPurposePrintPdf(), assQuestionGUI\isTestPresentationContext(), populateInlineFeedback(), ilUtil\prepareFormOutput(), assQuestionGUI\renderPurposeSupportsFormHtml(), and sprintf.
 Here is the call graph for this function:
 Here is the call graph for this function:| assSingleChoiceGUI::getSpecificFeedbackOutput | ( | $active_id, | |
| $pass | |||
| ) | 
Returns the answer specific feedback for the question.
This method should be overwritten by the actual question.
| integer | $active_id | Active ID of the user | 
| integer | $pass | Active pass | 
Reimplemented from assQuestionGUI.
Definition at line 603 of file class.assSingleChoiceGUI.php.
References $output.
| assSingleChoiceGUI::getTestOutput | ( | $active_id, | |
| $pass, | |||
| $is_postponed = false, | |||
| $use_post_solutions = false, | |||
| $show_feedback = false | |||
| ) | 
Reimplemented from assQuestionGUI.
Definition at line 402 of file class.assSingleChoiceGUI.php.
References $keys, $pass, $template, $type, getChoiceKeys(), ilUtil\getImagePath(), assQuestionGUI\outQuestionPage(), and ilUtil\prepareFormOutput().
 Here is the call graph for this function:
 Here is the call graph for this function:| assSingleChoiceGUI::populateAnswerSpecificFormPart | ( | \ilPropertyFormGUI | $form | ) | 
Definition at line 716 of file class.assSingleChoiceGUI.php.
References $form, and getEditAnswersSingleLine().
Referenced by editQuestion().
 Here is the call graph for this function:
 Here is the call graph for this function: Here is the caller graph for this function:
 Here is the caller graph for this function:| 
 | private | 
Definition at line 815 of file class.assSingleChoiceGUI.php.
References $template.
Referenced by getPreview(), and getSolutionOutput().
 Here is the caller graph for this function:
 Here is the caller graph for this function:| assSingleChoiceGUI::populateQuestionSpecificFormPart | ( | \ilPropertyFormGUI | $form | ) | 
Definition at line 623 of file class.assSingleChoiceGUI.php.
References $form, and getEditAnswersSingleLine().
Referenced by editQuestion().
 Here is the call graph for this function:
 Here is the call graph for this function: Here is the caller graph for this function:
 Here is the caller graph for this function:| assSingleChoiceGUI::removechoice | ( | ) | 
Remove an answer.
Definition at line 169 of file class.assSingleChoiceGUI.php.
References $_POST, editQuestion(), and writePostData().
 Here is the call graph for this function:
 Here is the call graph for this function:| assSingleChoiceGUI::removeimagechoice | ( | ) | 
Remove an image.
Definition at line 146 of file class.assSingleChoiceGUI.php.
References $_POST, $filename, editQuestion(), and writePostData().
 Here is the call graph for this function:
 Here is the call graph for this function:| assSingleChoiceGUI::renderAggregateView | ( | $aggregate | ) | 
| $aggregate | 
Definition at line 794 of file class.assSingleChoiceGUI.php.
References assQuestionGUI\$tpl.
Referenced by getAggregatedAnswersView().
 Here is the caller graph for this function:
 Here is the caller graph for this function:| assSingleChoiceGUI::setQuestionTabs | ( | ) | 
Sets the ILIAS tabs for this question type.
@access public
Reimplemented from assQuestionGUI.
Definition at line 515 of file class.assSingleChoiceGUI.php.
References $_GET, $url, assQuestionGUI\addBackTab(), assQuestionGUI\addTab_QuestionFeedback(), assQuestionGUI\addTab_QuestionHints(), assQuestionGUI\addTab_QuestionPreview(), and assQuestionGUI\addTab_SuggestedSolution().
 Here is the call graph for this function:
 Here is the call graph for this function:| assSingleChoiceGUI::uploadchoice | ( | ) | 
Upload an image.
Definition at line 136 of file class.assSingleChoiceGUI.php.
References $_POST, editQuestion(), and writePostData().
 Here is the call graph for this function:
 Here is the call graph for this function:| assSingleChoiceGUI::writeAnswerSpecificPostData | ( | ilPropertyFormGUI | $form | ) | 
Extracts the answer specific values from $_POST and applies them to the data object.
| bool | $always | If true, a check for form validity is omitted. | 
Implements ilGuiAnswerScoringAdjustable.
Definition at line 682 of file class.assSingleChoiceGUI.php.
References $_POST, $filename, $index, and ilUtil\secureString().
Referenced by writePostData().
 Here is the call graph for this function:
 Here is the call graph for this function: Here is the caller graph for this function:
 Here is the caller graph for this function:| 
 | protected | 
{Evaluates a posted edit form and writes the form data in the question object.
Reimplemented from assQuestionGUI.
Definition at line 45 of file class.assSingleChoiceGUI.php.
References editQuestion(), assQuestionGUI\saveTaxonomyAssignments(), writeAnswerSpecificPostData(), assQuestionGUI\writeQuestionGenericPostData(), and writeQuestionSpecificPostData().
Referenced by addchoice(), removechoice(), removeimagechoice(), and uploadchoice().
 Here is the call graph for this function:
 Here is the call graph for this function: Here is the caller graph for this function:
 Here is the caller graph for this function:| assSingleChoiceGUI::writeQuestionSpecificPostData | ( | ilPropertyFormGUI | $form | ) | 
Extracts the question specific values from $_POST and applies them to the data object.
| bool | $always | If true, a check for form validity is omitted. | 
Implements ilGuiQuestionScoringAdjustable.
Definition at line 610 of file class.assSingleChoiceGUI.php.
References $_POST, and ilUtil\sendInfo().
Referenced by writePostData().
 Here is the call graph for this function:
 Here is the call graph for this function: Here is the caller graph for this function:
 Here is the caller graph for this function: