QListControl::AddItems PHP Method

AddItems() public method

Allows you to add an array of key/value pairs to the ListControl. Convenient especially for adding a list from a type table, e.g. by passing in SomeType::$NameArray. The list of seleted values can either be an array of values, or just a single value.
public AddItems ( array $mixItemArray, mixed $mixSelectedValues = null, string $strItemGroup = null, string $strOverrideParameters = null )
$mixItemArray array name/value pairs of QListItems to add to this QListControl
$mixSelectedValues mixed can be an array of selected values, or just an atomic value, that is selected (optional)
$strItemGroup string
$strOverrideParameters string
    public function AddItems($mixItemArray, $mixSelectedValues = null, $strItemGroup = null, $strOverrideParameters = null)
    {
        try {
            $mixItemArray = QType::Cast($mixItemArray, QType::ArrayType);
        } catch (QInvalidCastException $objExc) {
            $objExc->IncrementOffset();
            throw $objExc;
        }
        foreach ($mixItemArray as $strValue => $strName) {
            $blnSelected = false;
            // Check to See if we are "selected"
            if ($mixSelectedValues) {
                if (gettype($mixSelectedValues) == QType::ArrayType) {
                    $blnSelected = in_array($strValue, $mixSelectedValues);
                } else {
                    $blnSelected = $strValue == $mixSelectedValues;
                }
            }
            // Add It
            $this->AddItem($strName, $strValue, $blnSelected, $strItemGroup, $strOverrideParameters);
        }
    }