question_manually_gradable Interface Reference

Inheritance diagram for question_manually_gradable:

Public Member Functions
	is_complete_response (array $response)
	is_same_response (array $prevresponse, array $newresponse)
	summarise_response (array $response)
	classify_response (array $response)

---

Detailed Description

Interface that a question_definition must implement to be usable by the manual graded behaviour.

Copyright:

2009 The Open University http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later

Definition at line 384 of file questionbase.php.

---

Member Function Documentation

classify_response

(

array $

response

)

Categorise the student's response according to the categories defined by get_possible_responses.

Parameters:

$response

a response, as might be passed to grade_response().

Returns:

array subpartid => question_classified_response objects. returns an empty array if no analysis is possible.

Implemented in question_graded_by_strategy, question_with_responses, qtype_multichoice_multi_question, qtype_numerical_question, qtype_multichoice_single_question, qtype_match_question, qtype_missingtype_question, and qtype_truefalse_question.

is_complete_response

(

array $

response

)

Used by many of the behaviours, to work out whether the student's response to the question is complete. That is, whether the question attempt should move to the COMPLETE or INCOMPLETE state.

Parameters:

array

$response

responses, as returned by question_attempt_step::get_qt_data().

Returns:

bool whether this response is a complete answer to this question.

Implemented in qtype_multichoice_multi_question, qtype_multichoice_single_question, qtype_match_question, qtype_multianswer_question, qtype_numerical_question, qtype_essay_question, qtype_truefalse_question, qtype_shortanswer_question, and qtype_missingtype_question.

Here is the caller graph for this function:

is_same_response	(	array $	prevresponse,
		array $	newresponse
	)

Use by many of the behaviours to determine whether the student's response has changed. This is normally used to determine that a new set of responses can safely be discarded.

Parameters:

array	$prevresponse	the responses previously recorded for this question, as returned by question_attempt_step::get_qt_data()
array	$newresponse	the new responses, in the same format.

Returns:

bool whether the two sets of responses are the same - that is whether the new set of responses can safely be discarded.

Implemented in qtype_multichoice_multi_question, qtype_match_question, qtype_multichoice_single_question, qtype_multianswer_question, qtype_numerical_question, qtype_essay_question, qtype_truefalse_question, qtype_shortanswer_question, and qtype_missingtype_question.

summarise_response

(

array $

response

)

Produce a plain text summary of a response.

Parameters:

$response

a response, as might be passed to grade_response().

Returns:

string a plain text summary of that response, that could be used in reports.

Implemented in qtype_multichoice_multi_question, qtype_multianswer_question, qtype_multichoice_single_question, qtype_match_question, qtype_numerical_question, qtype_missingtype_question, qtype_essay_question, qtype_shortanswer_question, and qtype_truefalse_question.

Here is the caller graph for this function:

---

The documentation for this interface was generated from the following file:

• C:/xampp/htdocs/moodle/question/type/questionbase.php