Nana - a C++ framework project  

The Programmer's Guide 
nana::gui::API::take_active

Description

Sets a window active state, if a window's active state is false, the window will not obtain the focus while a mouse clicks on it.

Prototype

void take_active(nana::gui::window wnd, bool active, nana::gui::window receiver);

Parameters

wnd:  handle to a window which will be set.
active: state.
receiver: forwards the focus to the receiver if active is false.

Return Value

None.

Remarks

If active is false, the window will not obtain the focus anymore. If the receiver is not NULL and active is false, the window will forward the focus to the receiver. For example, a textbox has a scrollbar and the active of scrollbar is false and receiver is textbox, and therefore the focus is always in the textbox and caret is always active while mouse is dragging on or clicking on the scrollbar, the focus does not change to the scrollbar.

See also

None.


Move to The Nana Programmer's Guide Application Programming Interface Overviews