function overlay_set_regions_to_render

Sets the regions of the page that rendering will be limited to.

Parameters

$regions: (Optional) An array containing the names of the regions that should be rendered when drupal_render_page() is called. Pass in an empty array to remove all limits and cause drupal_render_page() to render all page regions (the default behavior). If this parameter is omitted, no change will be made to the current list of regions to render.

Return value

The current list of regions to render, or an empty array if the regions are not being limited.

See also

overlay_page_alter()

overlay_block_list_alter()

overlay_get_regions_to_render()

3 calls to overlay_set_regions_to_render()
overlay_get_regions_to_render in modules/overlay/overlay.module
Returns a list of page regions that rendering should be limited to.
overlay_overlay_child_initialize in modules/overlay/overlay.module
Implements hook_overlay_child_initialize().
overlay_render_region in modules/overlay/overlay.module
Renders an individual page region.

File

modules/overlay/overlay.module, line 853

Code

function overlay_set_regions_to_render($regions = NULL) {
    $regions_to_render =& drupal_static(__FUNCTION__, array());
    if (isset($regions)) {
        $regions_to_render = $regions;
    }
    return $regions_to_render;
}

Buggy or inaccurate documentation? Please file an issue. Need support? Need help programming? Connect with the Drupal community.