modal_dialog_scope Class Reference

The purpose of modal_dialog_scope is to help to avoid the modal dialog recursion problem. Current toplevel modal dialog handle is stored globally, so when creation of a new modal dialog is blocked, it can be activated to indicate the reason for the task being blocked. More...

#include <shared.h>

List of all members.

Public Member Functions

 modal_dialog_scope (HWND p_wnd) throw ()
 This constructor initializes the modal dialog scope with specified dialog handle.
 modal_dialog_scope () throw ()
 This constructor leaves the scope uninitialized (you can call initialize() later with your window handle).
 ~modal_dialog_scope () throw ()
void initialize (HWND p_wnd) throw ()
 Initializes the scope with specified window handle.
void deinitialize () throw ()

Static Public Member Functions

static bool can_create () throw ()
static void poke_existing () throw ()
 Activates the top-level modal dialog existing, if one exists.

Detailed Description

The purpose of modal_dialog_scope is to help to avoid the modal dialog recursion problem. Current toplevel modal dialog handle is stored globally, so when creation of a new modal dialog is blocked, it can be activated to indicate the reason for the task being blocked.


Constructor & Destructor Documentation

modal_dialog_scope::modal_dialog_scope ( HWND  p_wnd  )  throw () [inline]

This constructor initializes the modal dialog scope with specified dialog handle.

modal_dialog_scope::modal_dialog_scope (  )  throw () [inline]

This constructor leaves the scope uninitialized (you can call initialize() later with your window handle).

modal_dialog_scope::~modal_dialog_scope (  )  throw () [inline]

Member Function Documentation

static bool modal_dialog_scope::can_create (  )  throw () [inline, static]

Returns whether creation of a new modal dialog is allowed (false when there's another one active).
NOTE: when calling context is already inside a modal dialog that you own, you should not be checking this before creating a new modal dialog.

void modal_dialog_scope::deinitialize (  )  throw () [inline]
void modal_dialog_scope::initialize ( HWND  p_wnd  )  throw () [inline]

Initializes the scope with specified window handle.

static void modal_dialog_scope::poke_existing (  )  throw () [inline, static]

Activates the top-level modal dialog existing, if one exists.


The documentation for this class was generated from the following file:
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Defines

Generated by  doxygen 1.6.2