DlgSelectPackages.UpdateDisplay

DlgSelectPackages.UpdateDisplay (

Example 1

DlgSelectPackages.UpdateDisplay(CTRL_SELECT_PACKAGE_TREE);

Updates the packages control.

Example 2

-- Get the properties of the first catagory
tProps = DlgSelectPackages.GetCategoryProperties(CTRL_SELECT_PACKAGE_TREE, CTRL_CATEGORY_001);

-- If it was expanded, collapse it, otherwise expand it
DlgSelectPackages.SetCategoryProperties(CTRL_SELECT_PACKAGE_TREE, CTRL_CATEGORY_001, {Expanded = not tProps.Expanded});

-- Update the display
DlgSelectPackages.UpdateDisplay(CTRL_SELECT_PACKAGE_TREE);

This example toggles the expanded state of a package category.

Example 3

if(e_CtrlID == CTRL_SELECT_PACKAGE_TREE) then
    -- the control message is from the select packages tree...
    -- if an item's state changed (i.e. a package was turned on or off),
    if(e_MsgID == MSGID_ONSTATECHANGED) and (e_Details.nCtrlID == CTRL_CATEGORY_001 or e_Details.nCtrlID == CTRL_CATEGORY_002) then
        -- an item's state has changed, and the item is either the first or the second package category
        if e_Details.nCtrlID == CTRL_CATEGORY_001 then
            -- the first package category's state changed
            tProps = DlgSelectPackages.GetCategoryProperties(CTRL_SELECT_PACKAGE_TREE, CTRL_CATEGORY_001);
                if tProps.State > 1 then
                    -- state is indeterminate or unchecked. Set state to unchecked, set other category's state to checked
                    DlgSelectPackages.SetCategoryProperties(CTRL_SELECT_PACKAGE_TREE, CTRL_CATEGORY_001, {State=2});
                    DlgSelectPackages.SetCategoryProperties(CTRL_SELECT_PACKAGE_TREE, CTRL_CATEGORY_002, {State=1});
                else
                    -- is checked, uncheck other one
                    DlgSelectPackages.SetCategoryProperties(CTRL_SELECT_PACKAGE_TREE, CTRL_CATEGORY_001, {State=1});
                    DlgSelectPackages.SetCategoryProperties(CTRL_SELECT_PACKAGE_TREE, CTRL_CATEGORY_002, {State=2});
                end
        elseif e_Details.nCtrlID == CTRL_CATEGORY_002 then
            -- the second package category's state changed
            tProps = DlgSelectPackages.GetCategoryProperties(CTRL_SELECT_PACKAGE_TREE, CTRL_CATEGORY_001);
            if tProps.State > 1 then
                -- state is indeterminate or unchecked. set state to unchecked, set other category's state to checked
                DlgSelectPackages.SetCategoryProperties(CTRL_SELECT_PACKAGE_TREE, CTRL_CATEGORY_002, {State=2});
                DlgSelectPackages.SetCategoryProperties(CTRL_SELECT_PACKAGE_TREE, CTRL_CATEGORY_001, {State=1});
            else
                -- is checked, uncheck other one
                DlgSelectPackages.SetCategoryProperties(CTRL_SELECT_PACKAGE_TREE, CTRL_CATEGORY_002, {State=1});
                DlgSelectPackages.SetCategoryProperties(CTRL_SELECT_PACKAGE_TREE, CTRL_CATEGORY_001, {State=2});
            end
        end
        -- update the package display
        DlgSelectPackages.UpdateDisplay(CTRL_SELECT_PACKAGE_TREE);
    end
end

In a packages control with two categories, if the first category is checked, the second will be unchecked. If the first is unchecked, the second will be checked. This action script is meant to be located on the On Ctrl Message event.

Note: Please note that this example does not take into account categories which are indeterminate. The first two categories will either be set to checked, or unchecked.