public class QuestionMatrix extends Question
addCellGroup()
method. A cellgroup includes all cells in rectangular
area from start cell (top-left cell) to end cell (bottom-right cell). A cellgroup cannot
intersect another group. Modifier and Type | Field and Description |
---|---|
static int |
CELL_CHECKBOX
Matrix cell of type checkbox.
|
static int |
CELL_DROPDOWN
Matrix cell of type dropdown.
|
static int |
CELL_EMPTY
Empty matrix cell.
|
static int |
CELL_IMAGE
Matrix cell of type image.
|
static int |
CELL_LABEL
Matrix cell of type label.
|
static int |
CELL_NUMERIC_DEC
Matrix cell of type numeric decimal.
|
static int |
CELL_NUMERIC_INT
Matrix cell of type numeric integer.
|
static int |
CELL_RADIO
Matrix cell of type radio button.
|
static int |
CELL_TEXT
Matrix cell of type text
|
static int |
CELLGROUP_ANY_CELL
Cellgroup type: The group contains cells of checkbox type.
|
static int |
CELLGROUP_CUSTOMIZED
Cellgroup type: The group contains cells of different types
|
static int |
CELLGROUP_INTERSECTION
Cellgroup type: The group contains cells of checkbox type, only one cell can be selected
|
static int |
CELLGROUP_ONE_PER_ROW
Cellgroup type: The group contains cells of radio type, one cell per row can be selected
|
static int |
CELLGROUP_RANKING
Cellgroup type: The group contains cells of checkbox type, one cell per column x row can be
selected
|
ESSAY_FIELD_CHECKBOX, ESSAY_FIELD_DROPDOWN, ESSAY_FIELD_NUMERIC_DEC, ESSAY_FIELD_NUMERIC_INT, ESSAY_FIELD_TEXT, ESSAYFIELD_LENGTH, INTEXT_TYPE_CHECKBOX, INTEXT_TYPE_DROPDOWN, INTEXT_TYPE_NUMERIC_DEC, INTEXT_TYPE_NUMERIC_INT, INTEXT_TYPE_TEXT, QUESTION_DROPDOWN, QUESTION_MATRIX, QUESTION_MULTIPLE, QUESTION_NO_TYPE, QUESTION_NUMERIC, QUESTION_RATING, TAG_END, TAG_START, UPLOAD_IMAGE, UPLOAD_NONE
Modifier and Type | Method and Description |
---|---|
void |
addCellGroup(java.lang.String cellGroupName,
int groupType,
int x1,
int y1,
int x2,
int y2)
Create a new cellgroup.
|
void |
deleteCellGroup(java.lang.String cellGroupName)
Delete the cellgroup.
|
void |
deleteColumn(int pos)
This method deletes a matrix column.
|
void |
deleteRow(int pos)
This method deletes a matrix row.
|
java.lang.String |
getCellBackgroundColor(int col,
int row)
Gets the background color of the cell .
|
java.lang.String |
getCellBackgroundColor(java.lang.String cellGroupName)
Gets the background color of the cellgroup.
|
java.lang.String[] |
getCellDropdownItems(int col,
int row)
Gets the dropdown items.
|
java.lang.String |
getCellDropdownLabel(int col,
int row)
Gets the dropdown label.
|
boolean |
getCellDropdownSortOn(int col,
int row)
Gets the dropdown sort on attribute.
|
int |
getCellFieldSize(int col,
int row)
Gets the cell input-field size.
|
int |
getCellGroupEndCol(java.lang.String cellGroupName)
Gets the end column of the cellgroup.
|
int |
getCellGroupEndRow(java.lang.String cellGroupName)
Gets the end row of the cellgroup.
|
java.lang.String |
getCellGroupHeading(java.lang.String cellGroupName)
Gets the heading of the cellgroup.
|
java.lang.String |
getCellGroupName(int col,
int row)
Gets a cellgroup by col/row position.
|
java.lang.String[] |
getCellGroupNames()
Gets all cellgroup names.
|
int |
getCellGroupStartCol(java.lang.String cellGroupName)
Gets the start column of the cellgroup.
|
int |
getCellGroupStartRow(java.lang.String cellGroupName)
Gets the start row of the cellgroup.
|
int |
getCellGroupType(java.lang.String cellGroupName)
Gets the type of the cellgroup.
|
java.lang.String |
getCellImageRelativeURL(int col,
int row)
Gets the image url.
|
java.lang.String |
getCellLabel(int col,
int row)
Gets the cell label.
|
java.lang.String |
getCellLabelColor(int col,
int row)
Gets the label text color.
|
int |
getCellType(int col,
int row)
Gets the cell type.
|
int |
getColumnCount()
Gets the number of matrix columns
|
int |
getRowCount()
Gets the number of matrix rows
|
void |
insertColumn(int pos)
This method insert a column before a particular column.
|
void |
insertRow(int pos)
This method inserts an empty row before a particular row.
|
void |
keepBusinessObject()
Get and keep business object.
|
void |
releaseBusinessObject()
Release business object.
|
void |
setCellBackgroundColor(int col,
int row,
java.lang.String bgColor)
Sets the background color of the cell.
|
void |
setCellCheckboxType(int col,
int row)
Sets the cell of type checkbox.
|
void |
setCellDecimalType(int col,
int row,
int fieldSize,
java.lang.String errorMsg)
Sets the cell of type numeric double.
|
void |
setCellDropdownType(int col,
int row,
java.lang.String label,
java.lang.String items,
boolean sortOn)
Sets the cell of type numeric double.
|
void |
setCellEmpty(int col,
int row)
Sets the empty cell.
|
void |
setCellGroupBackgroundColor(java.lang.String cellGroupName,
java.lang.String bgColor)
Sets the background color for the cellgroup
|
void |
setCellGroupHeading(java.lang.String cellGroupName,
java.lang.String heading)
Sets the heading of the cellgroup.
|
void |
setCellGroupName(java.lang.String cellGroupName,
java.lang.String newGroupName)
Sets the new cellgroup name.
|
void |
setCellGroupType(java.lang.String cellGroupName,
int newGroupType)
Sets the cellgroup type.
|
void |
setCellImageType(int col,
int row,
java.lang.String relativeUrl)
Sets the cell of type image.
|
void |
setCellIntegerType(int col,
int row,
int fieldSize,
java.lang.String errorMsg)
Sets the cell of type numeric integer.
|
void |
setCellLabelType(int col,
int row,
java.lang.String label,
java.lang.String textColor)
Sets the cell of type label (only text, not input of type text).
|
void |
setCellRadioType(int col,
int row)
Sets the cell of type radio button.
|
void |
setCellTextType(int col,
int row,
int fieldSize)
Sets the cell of type text.
|
void |
setSize(int newColumnCount,
int newRowCount)
Sets the matrix size.
|
addEssayFieldCheckbox, addEssayFieldDecimal, addEssayFieldDropdown, addEssayFieldInteger, addEssayFieldText, addIntextCheckbox, addIntextDecimal, addIntextDropdown, addIntextInteger, addIntextText, deleteEssayField, deleteIntext, deleteValidator, deleteValidator, deleteValidator, deleteValidator, getAnswerRotation, getCustomId, getDisplayNo, getEssayFieldCount, getEssayFieldDropdownItems, getEssayFieldDropdownLabel, getEssayFieldDropdownSortOn, getEssayFieldSize, getEssayFieldType, getFreeTextColumns, getFreeTextLabel, getFreeTextMaxLength, getFreeTextRows, getHiddenQuestion, getIntextCount, getIntextDropdownItems, getIntextDropdownLabel, getIntextDropdownSortOn, getIntextIndex, getIntextName, getIntextSize, getIntextType, getQuestionId, getQuestionLayout, getQuestionText, getQuestionType, getTextAfter, getTextBefore, getUploadType, getValidatorErrorMessage, getValidatorErrorMessage, getValidatorErrorMessage, getValidatorErrorMessage, getValidatorParameter, getValidatorParameter, getValidatorParameter, getValidatorParameter, getWeight, hasBusinessObject, isFreeTextOn, isValidatorOn, isValidatorOn, isValidatorOn, isValidatorOn, setAnswerRotation, setDisplayNo, setFreeTextColumns, setFreeTextLabel, setFreeTextMaxLength, setFreeTextOn, setFreeTextRows, setHiddenQuestion, setQuestionLayout, setQuestionText, setTextAfter, setTextBefore, setUploadType, setValidator, setValidator, setValidator, setValidator, setWeight, updateAttribute, validate
public static final int CELLGROUP_ANY_CELL
public static final int CELLGROUP_CUSTOMIZED
public static final int CELLGROUP_INTERSECTION
public static final int CELLGROUP_ONE_PER_ROW
public static final int CELLGROUP_RANKING
public static final int CELL_CHECKBOX
public static final int CELL_DROPDOWN
public static final int CELL_EMPTY
public static final int CELL_IMAGE
public static final int CELL_LABEL
public static final int CELL_NUMERIC_DEC
public static final int CELL_NUMERIC_INT
public static final int CELL_RADIO
public static final int CELL_TEXT
public void setCellBackgroundColor(int col, int row, java.lang.String bgColor) throws java.lang.IllegalArgumentException, LockException, RespondentsExistException, SurveySecurityException, SurveySystemException
col
- Column position, from 0 to column count -1row
- Row position, from 0 to row count -1bgColor
- The cell background color (Example: #CCCCFF)LockException
- Thrown if the survey is locked and can't be edited. Not yet
implemented. Use survey.isLocked()
to be sure that the survey
can be updated.RespondentsExistException
- Thrown if the survey has responses and can't be edited.
Not yet implemented. Use survey.hasRespondents()
to be sure
that the survey can be updated.SurveySecurityException
- Thrown if the user is not authorized to call this method.SurveySystemException
- If an error occurs in the system.java.lang.IllegalArgumentException
- If illegal parameters.public void setCellCheckboxType(int col, int row) throws LockException, RespondentsExistException, SurveySecurityException, SurveySystemException
col
- Column position, from 0 to column count -1row
- Row position, from 0 to row count -1LockException
- Thrown if the survey is locked and can't be edited. Not yet
implemented. Use survey.isLocked()
to be sure that the survey
can be updated.RespondentsExistException
- Thrown if the survey has responses and can't be edited.
Not yet implemented. Use survey.hasRespondents()
to be sure
that the survey can be updated.SurveySecurityException
- Thrown if the user is not authorized to call this method.SurveySystemException
- If an error occurs in the system.public void setCellDecimalType(int col, int row, int fieldSize, java.lang.String errorMsg) throws LockException, RespondentsExistException, SurveySecurityException, SurveySystemException
col
- Column position, from 0 to column count -1row
- Row position, from 0 to row count -1fieldSize
- The size of the text fielderrorMsg
- Error message to show to the respondent if the response is not a invalid
double.LockException
- Thrown if the survey is locked and can't be edited. Not yet
implemented. Use survey.isLocked()
to be sure that the survey
can be updated.RespondentsExistException
- Thrown if the survey has responses and can't be edited.
Not yet implemented. Use survey.hasRespondents()
to be sure
that the survey can be updated.SurveySecurityException
- Thrown if the user is not authorized to call this method.SurveySystemException
- If an error occurs in the system.public void setCellDropdownType(int col, int row, java.lang.String label, java.lang.String items, boolean sortOn) throws LockException, RespondentsExistException, SurveySecurityException, SurveySystemException
col
- Column position, from 0 to column count -1row
- Row position, from 0 to row count -1label
- Dropdown labelitems
- Dropdown items, one per linesortOn
- True if items should be alphabetically sorted.LockException
- Thrown if the survey is locked and can't be edited. Not yet
implemented. Use survey.isLocked()
to be sure that the survey
can be updated.RespondentsExistException
- Thrown if the survey has responses and can't be edited.
Not yet implemented. Use survey.hasRespondents()
to be sure
that the survey can be updated.SurveySecurityException
- Thrown if the user is not authorized to call this method.SurveySystemException
- If an error occurs in the system.public void setCellEmpty(int col, int row) throws java.lang.IllegalArgumentException, LockException, RespondentsExistException, SurveySecurityException, SurveySystemException
col
- Column position, from 0 to column count -1row
- Row position, from 0 to row count -1LockException
- Thrown if the survey is locked and can't be edited. Not yet
implemented. Use survey.isLocked()
to be sure that the survey
can be updated.RespondentsExistException
- Thrown if the survey has responses and can't be edited.
Not yet implemented. Use survey.hasRespondents()
to be sure
that the survey can be updated.SurveySecurityException
- Thrown if the user is not authorized to call this method.SurveySystemException
- If an error occurs in the system.java.lang.IllegalArgumentException
- If illegal parameters.public void setCellGroupBackgroundColor(java.lang.String cellGroupName, java.lang.String bgColor) throws LockException, RespondentsExistException, SurveySecurityException, SurveySystemException
cellGroupName
- The cellgroup to update.bgColor
- The new background colorLockException
- Thrown if the survey is locked and can't be edited. Not yet
implemented. Use survey.isLocked()
to be sure that the survey
can be updated.RespondentsExistException
- Thrown if the survey has responses and can't be edited.
Not yet implemented. Use survey.hasRespondents()
to be sure
that the survey can be updated.SurveySecurityException
- Thrown if the user is not authorized to call this method.SurveySystemException
- If an error occurs in the system.public void setCellGroupHeading(java.lang.String cellGroupName, java.lang.String heading) throws java.lang.IllegalArgumentException, LockException, RespondentsExistException, SurveySecurityException, SurveySystemException
cellGroupName
- The cellgroup to update.heading
- The new heading.LockException
- Thrown if the survey is locked and can't be edited. Not yet
implemented. Use survey.isLocked()
to be sure that the survey
can be updated.RespondentsExistException
- Thrown if the survey has responses and can't be edited.
Not yet implemented. Use survey.hasRespondents()
to be sure
that the survey can be updated.SurveySecurityException
- Thrown if the user is not authorized to call this method.SurveySystemException
- If an error occurs in the system.java.lang.IllegalArgumentException
- If illegal parameters.public void setCellGroupName(java.lang.String cellGroupName, java.lang.String newGroupName) throws LockException, RespondentsExistException, SurveySecurityException, SurveySystemException, java.lang.IllegalArgumentException
cellGroupName
- The cellgroup to update.newGroupName
- The new cellgroup nameLockException
- Thrown if the survey is locked and can't be edited. Not yet
implemented. Use survey.isLocked()
to be sure that the survey
can be updated.RespondentsExistException
- Thrown if the survey has responses and can't be edited.
Not yet implemented. Use survey.hasRespondents()
to be sure
that the survey can be updated.SurveySecurityException
- Thrown if the user is not authorized to call this method.SurveySystemException
- If an error occurs in the system.java.lang.IllegalArgumentException
- If cellgroup with newGroupName
already
exists.public void setCellGroupType(java.lang.String cellGroupName, int newGroupType) throws LockException, RespondentsExistException, SurveySecurityException, SurveySystemException
cellGroupName
- The cellgroup to update.newGroupType
- The new cellgroup type. One of the constants above.LockException
- Thrown if the survey is locked and can't be edited. Not yet
implemented. Use survey.isLocked()
to be sure that the survey
can be updated.RespondentsExistException
- Thrown if the survey has responses and can't be edited.
Not yet implemented. Use survey.hasRespondents()
to be sure
that the survey can be updated.SurveySecurityException
- Thrown if the user is not authorized to call this method.SurveySystemException
- If an error occurs in the system.public void setCellImageType(int col, int row, java.lang.String relativeUrl) throws java.lang.IllegalArgumentException, LockException, RespondentsExistException, SurveySecurityException, SurveySystemException
col
- Column position, from 0 to column count -1row
- Row position, from 0 to row count -1relativeUrl
- Relative image url (Example: upload/images/common/myImage.gif)LockException
- Thrown if the survey is locked and can't be edited. Not yet
implemented. Use survey.isLocked()
to be sure that the survey
can be updated.RespondentsExistException
- Thrown if the survey has responses and can't be edited.
Not yet implemented. Use survey.hasRespondents()
to be sure
that the survey can be updated.SurveySecurityException
- Thrown if the user is not authorized to call this method.java.lang.IllegalArgumentException
- If illegal parameters.SurveySystemException
- If an error occurs in the system.public void setCellIntegerType(int col, int row, int fieldSize, java.lang.String errorMsg) throws LockException, RespondentsExistException, SurveySecurityException, SurveySystemException
col
- Column position, from 0 to column count -1row
- Row position, from 0 to row count -1fieldSize
- The size of the text fielderrorMsg
- Error message to show to the respondent if the response is not a invalid
integer.LockException
- Thrown if the survey is locked and can't be edited. Not yet
implemented. Use survey.isLocked()
to be sure that the survey
can be updated.RespondentsExistException
- Thrown if the survey has responses and can't be edited.
Not yet implemented. Use survey.hasRespondents()
to be sure
that the survey can be updated.SurveySecurityException
- Thrown if the user is not authorized to call this method.SurveySystemException
- If an error occurs in the system.public void setCellLabelType(int col, int row, java.lang.String label, java.lang.String textColor) throws LockException, RespondentsExistException, SurveySecurityException, SurveySystemException
col
- Column position, from 0 to column count -1row
- Row position, from 0 to row count -1label
- Cell label.textColor
- Text color for the label.LockException
- Thrown if the survey is locked and can't be edited. Not yet
implemented. Use survey.isLocked()
to be sure that the survey
can be updated.RespondentsExistException
- Thrown if the survey has responses and can't be edited.
Not yet implemented. Use survey.hasRespondents()
to be sure
that the survey can be updated.SurveySecurityException
- Thrown if the user is not authorized to call this method.SurveySystemException
- If an error occurs in the system.public void setCellRadioType(int col, int row) throws java.lang.IllegalArgumentException, LockException, RespondentsExistException, SurveySecurityException, SurveySystemException
col
- Column position, from 0 to column count -1row
- Row position, from 0 to row count -1LockException
- Thrown if the survey is locked and can't be edited. Not yet
implemented. Use survey.isLocked()
to be sure that the survey
can be updated.RespondentsExistException
- Thrown if the survey has responses and can't be edited.
Not yet implemented. Use survey.hasRespondents()
to be sure
that the survey can be updated.SurveySecurityException
- Thrown if the user is not authorized to call this method.java.lang.IllegalArgumentException
- If illegal parameters.SurveySystemException
- If an error occurs in the system.public void setCellTextType(int col, int row, int fieldSize) throws LockException, RespondentsExistException, SurveySecurityException, SurveySystemException
col
- Column position, from 0 to column count -1row
- Row position, from 0 to row count -1fieldSize
- The size of the text fieldLockException
- Thrown if the survey is locked and can't be edited. Not yet
implemented. Use survey.isLocked()
to be sure that the survey
can be updated.RespondentsExistException
- Thrown if the survey has responses and can't be edited.
Not yet implemented. Use survey.hasRespondents()
to be sure
that the survey can be updated.SurveySecurityException
- Thrown if the user is not authorized to call this method.SurveySystemException
- If an error occurs in the system.public void setSize(int newColumnCount, int newRowCount) throws java.lang.IllegalArgumentException, LockException, RespondentsExistException, SurveySystemException, SurveySecurityException
newColumnCount
- The number of columnsnewRowCount
- The number of rowsLockException
- Thrown if the survey is locked and can't be edited. Not yet
implemented. Use survey.isLocked()
to be sure that the survey
can be updated.RespondentsExistException
- Thrown if the survey has responses and can't be edited.
Not yet implemented. Use survey.hasRespondents()
to be sure
that the survey can be updated.SurveySecurityException
- Thrown if the user is not authorized to call this method.java.lang.IllegalArgumentException
- If illegal parameters.SurveySystemException
- If an error occurs in the system.SurveySecurityException
public java.lang.String getCellBackgroundColor(int col, int row) throws java.lang.IllegalArgumentException, SurveySystemException
col
- Column position, from 0 to column count -1row
- Row position, from 0 to row count -1SurveySystemException
- If an error occurs in the system.java.lang.IllegalArgumentException
- If illegal parameters.public java.lang.String getCellBackgroundColor(java.lang.String cellGroupName) throws java.lang.IllegalArgumentException, SurveySystemException
cellGroupName
- The cellgroup name.SurveySystemException
- If an error occurs in the system.java.lang.IllegalArgumentException
- If illegal parameters.public java.lang.String[] getCellDropdownItems(int col, int row) throws java.lang.IllegalArgumentException, SurveySystemException
col
- Column position, from 0 to column count -1row
- Row position, from 0 to row count -1SurveySystemException
- If an error occurs in the system.java.lang.IllegalArgumentException
- If illegal parameters.public java.lang.String getCellDropdownLabel(int col, int row) throws java.lang.IllegalArgumentException, SurveySystemException
col
- Column position, from 0 to column count -1row
- Row position, from 0 to row count -1SurveySystemException
- If an error occurs in the system.java.lang.IllegalArgumentException
- If illegal parameters.public boolean getCellDropdownSortOn(int col, int row) throws java.lang.IllegalArgumentException, SurveySystemException
col
- Column position, from 0 to column count -1row
- Row position, from 0 to row count -1SurveySystemException
- If an error occurs in the system.java.lang.IllegalArgumentException
- If illegal parameters.public int getCellFieldSize(int col, int row) throws java.lang.IllegalArgumentException, SurveySystemException
col
- Column position, from 0 to column count -1row
- Row position, from 0 to row count -1SurveySystemException
- If an error occurs in the system.java.lang.IllegalArgumentException
- If illegal parameters.public int getCellGroupEndCol(java.lang.String cellGroupName) throws java.lang.IllegalArgumentException, SurveySystemException
cellGroupName
- The cellgroup name.SurveySystemException
- If an error occurs in the system.java.lang.IllegalArgumentException
- If illegal parameters.public int getCellGroupEndRow(java.lang.String cellGroupName) throws java.lang.IllegalArgumentException, SurveySystemException
cellGroupName
- The cellgroup name.SurveySystemException
- If an error occurs in the system.java.lang.IllegalArgumentException
- If illegal parameters.public java.lang.String getCellGroupHeading(java.lang.String cellGroupName) throws java.lang.IllegalArgumentException, SurveySystemException
cellGroupName
- The cellgroup name.SurveySystemException
- If an error occurs in the system.java.lang.IllegalArgumentException
- If illegal parameters.public java.lang.String getCellGroupName(int col, int row) throws SurveySystemException, java.lang.IllegalArgumentException
col
- Column position of the cell, from 0 to column count -1row
- Row position of the cell, from 0 to row count -1SurveySystemException
- If an error occurs in the system.java.lang.IllegalArgumentException
- If illegal positionspublic java.lang.String[] getCellGroupNames() throws SurveySystemException
SurveySystemException
- If an error occurs in the system.public int getCellGroupStartCol(java.lang.String cellGroupName) throws java.lang.IllegalArgumentException, SurveySystemException
cellGroupName
- The cellgroup name.SurveySystemException
- If an error occurs in the system.java.lang.IllegalArgumentException
- If illegal parameters.public int getCellGroupStartRow(java.lang.String cellGroupName) throws java.lang.IllegalArgumentException, SurveySystemException
cellGroupName
- The cellgroup name.SurveySystemException
- If an error occurs in the system.java.lang.IllegalArgumentException
- If illegal parameters.public int getCellGroupType(java.lang.String cellGroupName) throws java.lang.IllegalArgumentException, SurveySystemException
cellGroupName
- The cellgroup name.SurveySystemException
- If an error occurs in the system.java.lang.IllegalArgumentException
- If illegal parameters.public java.lang.String getCellImageRelativeURL(int col, int row) throws java.lang.IllegalArgumentException, SurveySystemException
col
- Column position, from 0 to column count -1row
- Row position, from 0 to row count -1SurveySystemException
- If an error occurs in the system.java.lang.IllegalArgumentException
- If illegal parameters.public java.lang.String getCellLabel(int col, int row) throws java.lang.IllegalArgumentException, SurveySystemException
col
- Column position, from 0 to column count -1row
- Row position, from 0 to row count -1SurveySystemException
- If an error occurs in the system.java.lang.IllegalArgumentException
- If illegal parameters.public java.lang.String getCellLabelColor(int col, int row) throws java.lang.IllegalArgumentException, SurveySystemException
col
- Column position, from 0 to column count -1row
- Row position, from 0 to row count -1SurveySystemException
- If an error occurs in the system.java.lang.IllegalArgumentException
- If illegal parameters.public int getCellType(int col, int row) throws java.lang.IllegalArgumentException, SurveySystemException
col
- Column position, from 0 to column count -1row
- Row position, from 0 to row count -1SurveySystemException
- If an error occurs in the system.java.lang.IllegalArgumentException
- If illegal parameters.public int getColumnCount() throws SurveySystemException
SurveySystemException
- If an error occurs in the system.public int getRowCount() throws SurveySystemException
SurveySystemException
- If an error occurs in the system.public void addCellGroup(java.lang.String cellGroupName, int groupType, int x1, int y1, int x2, int y2) throws LockException, RespondentsExistException, SurveySecurityException, SurveySystemException, java.lang.IllegalArgumentException
x1
- Start column for cellgroup (top-left cell), from 0 to column count -1y1
- Start row (top-left cell), from 0 to row count -1x2
- End column (bottom-right), from 0 to column count -1y2
- End row (bottom-right), from 0 to row count -1groupType
- Cellgroup type, one of the constants abovecellGroupName
- Unique cellgroup nameLockException
- Thrown if the survey is locked and can't be edited. Not yet
implemented. Use survey.isLocked()
to be sure that the survey
can be updated.RespondentsExistException
- Thrown if the survey has responses and can't be edited.
Not yet implemented. Use survey.hasRespondents()
to be sure
that the survey can be updated.SurveySecurityException
- Thrown if the user is not authorized to call this method.SurveySystemException
- If an error occurs in the system.java.lang.IllegalArgumentException
- If cellgroup with this name already exists or invalid
positions or intersection with another group.public void deleteCellGroup(java.lang.String cellGroupName) throws LockException, RespondentsExistException, SurveySecurityException, SurveySystemException, java.lang.IllegalArgumentException
cellGroupName
- The cellgroup to delete.LockException
- Thrown if the survey is locked and can't be edited. Not yet
implemented. Use survey.isLocked()
to be sure that the survey
can be updated.RespondentsExistException
- Thrown if the survey has responses and can't be edited.
Not yet implemented. Use survey.hasRespondents()
to be sure
that the survey can be updated.SurveySecurityException
- Thrown if the user is not authorized to call this method.SurveySystemException
- If an error occurs in the system.java.lang.IllegalArgumentException
- If illegal parameters.public void deleteColumn(int pos) throws LockException, RespondentsExistException, SurveySecurityException, SurveySystemException, java.lang.IllegalArgumentException
pos
- The index of the column to delete, from 0 to column count-1java.lang.IllegalArgumentException
- If illegal columnLockException
- Thrown if the survey is locked and can't be edited. Not yet
implemented. Use survey.isLocked()
to be sure that the survey
can be updated.RespondentsExistException
- Thrown if the survey has responses and can't be edited.
Not yet implemented. Use survey.hasRespondents()
to be sure
that the survey can be updated.SurveySecurityException
- Thrown if the user is not authorized to call this method.SurveySystemException
- If an error occurs in the system.public void deleteRow(int pos) throws LockException, RespondentsExistException, SurveySecurityException, SurveySystemException, java.lang.IllegalArgumentException
pos
- the index of the row to delete, from 0 to row count-1java.lang.IllegalArgumentException
- If illegal positionLockException
- Thrown if the survey is locked and can't be edited. Not yet
implemented. Use survey.isLocked()
to be sure that the survey
can be updated.RespondentsExistException
- Thrown if the survey has responses and can't be edited.
Not yet implemented. Use survey.hasRespondents()
to be sure
that the survey can be updated.SurveySecurityException
- Thrown if the user is not authorized to call this method.SurveySystemException
- If an error occurs in the system.public void insertColumn(int pos) throws LockException, RespondentsExistException, SurveySecurityException, SurveySystemException, java.lang.IllegalArgumentException
pos
- The index of the column before which the new column will be inserted, from 0 to
column count-1java.lang.IllegalArgumentException
- If illegal positionLockException
- Thrown if the survey is locked and can't be edited. Not yet
implemented. Use survey.isLocked()
to be sure that the survey
can be updated.RespondentsExistException
- Thrown if the survey has responses and can't be edited.
Not yet implemented. Use survey.hasRespondents()
to be sure
that the survey can be updated.SurveySecurityException
- Thrown if the user is not authorized to call this method.SurveySystemException
- If an error occurs in the system.public void insertRow(int pos) throws LockException, RespondentsExistException, SurveySecurityException, SurveySystemException, java.lang.IllegalArgumentException
pos
- The index of the row before which the new row will be inserted, from 0 to row
count-1java.lang.IllegalArgumentException
- If illegal positionLockException
- Thrown if the survey is locked and can't be edited. Not yet
implemented. Use survey.isLocked()
to be sure that the survey
can be updated.RespondentsExistException
- Thrown if the survey has responses and can't be edited.
Not yet implemented. Use survey.hasRespondents()
to be sure
that the survey can be updated.SurveySecurityException
- Thrown if the user is not authorized to call this method.SurveySystemException
- If an error occurs in the system.public void keepBusinessObject() throws SurveySystemException
keepBusinessObject
in class Question
SurveySystemException
- If an error occurs in the system.public void releaseBusinessObject()
releaseBusinessObject
in class Question
Built on October 18 2017