activate-pane Function

Summary

Gives a pane the input focus and raises the window containing it.

Package

capi

Signature

activate-pane pane

Arguments

pane⇩

An element or a pinboard-object or a toolbar-object.

Description

The function activate-pane gives the focus to the pane pane and brings the window containing pane to the front.

If pane cannot accept the focus then activate-pane chooses a sensible alternative inside the same interface.

Examples

This example demonstrates how to swap the focus from one window to another.

(setq text-input-pane
      (capi:contain (make-instance 
                     'capi:text-input-pane)))

(setq button
      (capi:contain (make-instance
                     'capi:push-button
                     :text "Press Me")))

(capi:activate-pane text-input-pane)

(capi:activate-pane button)

See also

hide-interface
raise-interface
set-pane-focus
show-interface
quit-interface
simple-pane
7.7 Manipulating top-level windows