Reference » Window classes » MScreen

Elgrint::MScreen class

Declared in MScreen.h

Description

The system's topmost window, which serves as a container for MMainFrame windows.

MScreen

Base class: MWindow

Properties:

Name Description
StatusIcon Specifies the screen's status icon, associated with this app.

Revealers:

Name Description
getWindowAt(p) Returns the front-most window, which contains the specified point (in screen coordinates).
getWorkRect() Returns the working area of the screen.

Handlers:

Name Description
OnKeysEntered

Passes the keys to the system or to the focus window.

Details: All the keys between kbPrintScreen and kbUnknown are passed to the system for default system processing. For example, kbCalculator key may launch the "calc.exe" program, kbMyComputer may open the file browser, and so on.
All the mouse wheel keys (from kbWheelUp through kbWheelRight) are passed to the current focus window (unless the focus is the screen itself).
All other keys are ignored. All the key modifiers (see kbXXXX) are ignored in any case.

Remarks:

  • The screen receives this message only via propagation from its descendants, except when the user clicks the app's status icon (see StatusIcon) - only then the screen is the origin of the message (see digOrigin)
  • Some special keys and combinations like Alt+Shift, Alt+Tab, PrintScreen, etc. are handled by the system directly, and are not received by apps at all

Details

The screen window is a special, predefined window object - a sole instance of this MScreen class. The sole screen object is accessed via MApp::screen function, and no other screen object can be created (MScreen has no public constructors). Needless to say, MPtr, which requires a public standard-form constructor, does not work with this class.

The screen window has two purposes: it serves as the root of the app's window hierarchy, and it represents the external environment, e.g. the screen and other apps (in particular, it receives remote messages from other apps).

'MScreen' class defines a few methods of its own, but also changes the meaning of some of the MWindow methods, as follows:

On the other hand, in the following cases the screen window behaves in accordance with other windows, but it is still worth mentioning that:

In all other respects the screen window is just a regular Elgrint window.

Let us know

Please Contact us to report any errors on this page, or to suggest any improvements.

Miranor Home | About Miranor | About Elgrint | Create account | Login | Account settings | Contact Us | Privacy Policy | Site map

© Copyright 2014 by Miranor. All rights reserved. By using this site you agree to the Terms of Use.

Page last updated on August 10th, 2014.