function view::set_display

Same name in other branches
  1. 6.x-3.x includes/view.inc \view::set_display()

Set the display as current.

Parameters

string $display_id: The id of the display to mark as current.

8 calls to view::set_display()
view::build in includes/view.inc
Build the query for the view.
view::execute_display in includes/view.inc
Execute the given display, with the given arguments. To be called externally by whatever mechanism invokes the view, such as a page callback, hook_block, etc.
view::execute_hook_block_list in includes/view.inc
Called to get hook_block information from the view and the named display handler.
view::execute_hook_menu in includes/view.inc
Called to get hook_menu() info from the view and the named display handler.
view::get_path in includes/view.inc
Get the base path used for this view.

... See full list

File

includes/view.inc, line 563

Class

view
An object to contain all of the data to generate a view.

Code

public function set_display($display_id = NULL) {
    // If we have not already initialized the display, do so. But be careful.
    if (empty($this->current_display)) {
        $this->init_display();
        // If handlers were not initialized, and no argument was sent, set up
        // to the default display.
        if (empty($display_id)) {
            $display_id = 'default';
        }
    }
    $display_id = $this->choose_display($display_id);
    // If no display id sent in and one wasn't chosen above, we're finished.
    if (empty($display_id)) {
        return FALSE;
    }
    // Ensure the requested display exists.
    if (empty($this->display[$display_id])) {
        $display_id = 'default';
        if (empty($this->display[$display_id])) {
            vpr('set_display() called with invalid display id @display.', array(
                '@display' => $display_id,
            ));
            return FALSE;
        }
    }
    // Set the current display.
    $this->current_display = $display_id;
    // Ensure requested display has a working handler.
    if (empty($this->display[$display_id]->handler)) {
        return FALSE;
    }
    // Set a shortcut.
    $this->display_handler =& $this->display[$display_id]->handler;
    return TRUE;
}