Selected[]

Characteristic Description

Icon


Folder icon

Availability

Available for items with multi-select codelists.

Return type

Boolean.

Description

For the codelist item that is specified in the brackets, returns a value that indicates if the checkbox for the codelist item is selected.

You can also use this property to select or deselect the checkbox for a codelist item.

Purpose

Use this property to determine whether a checkbox has been selected. For example, to disqualify subjects who are using aspirin, you can create a list of common OTC drugs with a checkbox next to each.

value = this.itmOTCMeds.Selected[this.itmOTCMeds.clOTCMeds.Aspirin]
when value is true
    issue query on this.itmOTCMeds:
    Subjects on an aspirin regimen are not eligible for the study.

You can also use the property to programmatically select items. To select an item, use a SetValue action, setting the value to True for a selected checkbox or False for a deselected checkbox.