| ILIAS
    release_5-2 Revision v5.2.25-18-g3f80b828510
    | 
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 () | |
| 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) | |
| 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.
| assSingleChoiceGUI::addchoice | ( | ) | 
Add a new answer.
Definition at line 164 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 841 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 93 of file class.assSingleChoiceGUI.php.
References $errors, 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 822 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 744 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 835 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 653 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 68 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 377 of file class.assSingleChoiceGUI.php.
References 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 196 of file class.assSingleChoiceGUI.php.
References $ok, $pass, 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 665 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 456 of file class.assSingleChoiceGUI.php.
References $pass, 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 791 of file class.assSingleChoiceGUI.php.
References ilPropertyFormGUI\addItem(), 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 893 of file class.assSingleChoiceGUI.php.
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 688 of file class.assSingleChoiceGUI.php.
References ilPropertyFormGUI\addItem(), 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 175 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 152 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 871 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 584 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 142 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 749 of file class.assSingleChoiceGUI.php.
References $_POST, $filename, 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 46 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 672 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: