class TopWindow : public Ctrl

TopWindow represents top-level independent window of host OS, usually decorated with caption, close/zoom/restore buttons etc.

Important fact to note is that window-rectangle (as defined by Ctrl::SetRect and Ctrl::GetRect methods) does not include any host GUI specific decorations (caption, thick border for resizing), just the area that is "controlled" by U++.

When TopWindow is opened, it is by default centered w.r.t. to its owner (if there is any). This behaviour can be altered by NoCenter or CenterScreen methods.

Derived from Ctrl

virtual void Reject()

This virtual method is overloaded to perform Restore operation if there was any previous call to Backup method.

virtual void Close()

This virtual method is implemented in TopWindow so that it breaks modal loop if TopWindow runs it. If there is Breaker with IDCANCEL defined, performs RejectBreak(IDCANCEL). Otherwise, if there is Breaker with IDYES (as assigned to exit Ctrl by CtrlLayoutExit), performs AcceptBreak(IDYES). If none if that is true, AcceptBreak(IDOK) is performed.

If TopWindow does not run modal loop, it is closed - in this case, any state backup created by Backup method is scratched. Override in descendant class is allowed to call 'delete this' as the very last thing it does (as long as the instance is allocated on the heap).

Event<> WhenClose

This callback is by default invoked when Close button of host GUI window is pushed. Default assigned action is to perform Close virtual method. Assigned event is allowed to call 'delete this' as the very last thing it does (as long as the instance is allocated on the heap).

void Backup()

Serializes the content of all contained Ctrls (using Serialize virtual method) into internal storage of TopWindow. Useful when implementing Cancel buttons.

void Restore()

Restores content of all contained Ctrls from internal storage. If internal storage is empty, does nothing.

void Break(int ID = IDEXIT)

If TopWindow is running its loop (see Run or RunAppModal methods), breaks the loop with specified exit code.

bool AcceptBreak(int ID)

Tries to accept all contained Ctrls by calling Accept for all child Ctrls, until some returns false - in such case this method returns false. If all child Ctrls return true, calls Break with specified ID and returns true.

void RejectBreak(int ID)

Rejects all contained widgets by calling Reject for all child Ctrls, then calls Break with specified ID.

void WorkAreaTrim()

Adjusts window position so that it does not exceeds desktop workspace. Exceeding parts are trimmed (decreasing window size).

Callback Breaker(int ID = IDEXIT)

Returns Callback that, when invoked, invokes Break with the specified exit code. Note that Callback as return value is used for backward compatibility with pre-C++11 U++ and for practical purposes, you could consider Event<> being returned.

Callback Acceptor(int ID)

Returns Callback that, when invoked, invokes AcceptBreak with the specified exit code. Note that Callback as return value is used for backward compatibility with pre-C++11 U++ and for practical purposes, you could consider Event<> being returned.

Callback Rejector(int ID)

Returns Callback that, when invoked, invokes RejectBreak with the specified exit code. Note that Callback as return value is used for backward compatibility with pre-C++11 U++ and for practical purposes, you could consider Event<> being returned.

TopWindow& Breaker(Ctrl& m, int ID = -1)

Same as m <<= Breaker(ID) - assigns Breaker callback to WhenAction method of specified Ctrl.

TopWindow& Acceptor(Ctrl& m, int ID)

Same as m <<= Acceptor(ID) - assigns Acceptor callback to WhenAction method of specified Ctrl.

TopWindow& Rejector(Ctrl& m, int ID)

Same as m <<= Rejector(ID) - assigns Rejector callback to WhenAction method of specified Ctrl.

TopWindow& NoCenter()

Sets TopWindow not to be centered when being created on the screen. Returns *this.

TopWindow& CenterOwner()

Sets TopWindow to be centered w.r.t. its owner when being created on the screen. This is default. Returns *this.

TopWindow& CenterScreen()

Sets TopWindow to be desktop centered when being created on the screen. Returns *this.

virtual void SetMinSize(Size sz)

Sets the minimal size for window. This size is then returned by GetMinSize virtual method. If window is resizable, it cannot be made smaller than this size.

void Open(HWND ownerhwnd)

Opens window with owner specified as Win32 handle.

Win32 specific.

TopWindow& Style(dword _style)

Sets Win32 window style.

Win32 specific.

dword GetStyle() const

Sets Win32 window extended style.

Win32 specific.

TopWindow& ExStyle(dword _exstyle)

Win32 specific.

dword GetExStyle() const

Win32 specific.

void Open(Ctrl *owner)

Opens TopWindow as window in host GUI with specified owner. Window can be open as hidden is visibility flag is set to false (Hide()), however on closing, window is set to visible.

void Open()

Opens TopWindow with owner equal to current active window if it is owned by the process.

void OpenMain()

Opens window without owner.

int Run(bool appmodal = false)

Execute modal loop for TopWindow. If TopWindow is not open, it calls Open before starting loop, but it does not close it.

int RunAppModal()

Same as Run(true).

int Execute()

Similar to Run, but closes TopWindow when loop exits.

bool ExecuteOK()

Same as Execute but return true if button OK was pressed.

bool ExecuteCancel()

Same as Execute but return true if button Cancel was pressed.

int GetExitCode() const

Returns the result code of last Execute or Run methods.

void Minimize(bool effect = false)

Minimize window.

void Maximize(bool effect = false)

Maximize window.

void Overlap(bool effect = false)

Put window to normal overlapped state.

bool IsMaximized() const

bool IsMinimized() const

bool IsOverlapped() const

TopWindow& ActiveFocus(Ctrl& ctrl)

Sets the ActiveFocus Ctrl. This Ctrl gets focus when TopWindow is activated. If there is no Ctrl with active focus, first Ctrl is activated. When TopWindow is deactivated, Ctrl that has focus is stored as new ActiveFocus Ctrl and gets focus once TopWindow is activated again (unless this method changes ActiveFocus meanwhile). When this, method is called while TopWindow is active, it is equivalent to ctrl.SetFocus().

TopWindow& Title(const WString& _title)

TopWindow& Title(const char *_title)

Sets the title of the window.

const WString& GetTitle() const

TopWindow& Sizeable(bool b = true)

Indicates whether TopWindow should be resizeable by user.

TopWindow& NoSizeable()

Same as Sizeable(false).

bool IsSizeable() const

TopWindow& MinimizeBox(bool b = true)

Sets TopWindow to have a minimize box.

TopWindow& MaximizeBox(bool b = true)

Sets TopWindow to have a maximize box.

TopWindow& Zoomable(bool b = true)

Sets TopWindow to be Zoomable - to have maximize/minimize flags, if supported by host platform. Same as MinimizeBox(b).MaximizeBox(b).

TopWindow& NoZoomable()

Same as Zoomable(false).

bool IsZoomable() const

TopWindow& Background(const PaintRect& prect)

Sets PaintRect that will be used to paint TopWindow background. Default PaintRect paints background with SColorFace.

const PaintRect& GetBackground() const

Returns active PaintRect used to paint TopWindow background.

TopWindow& ToolWindow(bool b = true)

Makes TopWindow appear with thin caption, if supported by host platform. Must be set before opening.

TopWindow& NoToolWindow()

Same as ToolWindow(false).

bool IsToolWindow() const

TopWindow& TopMost(bool b = true, bool stay_top = true)

Makes window stay over any other window. Returns *this.

TopWindow& NoTopMost()

Same as TopMost(false).

bool IsTopMost() const

Value of TopMost flag.

TopWindow& FullScreen(bool b = true)

Sets window to fullscreen if b is true, otherwise sets window to regular state. Returns *this.

bool IsFullScreen() const

Return value    True if window is in fullscreen mode.

TopWindow& FrameLess(bool b = true)

Creates window without border decorations (like windows title var or any resizing borders).

bool IsFrameLess() const

Returns FrameLess status.

TopWindow& Urgent(bool b = true)

Calling Urgent(true) causes title of inactive window and its item in taskbar to flash to catch users attention. The effect lasts until either Urgent(false) is called or the window is taken to foreground. If Urgent(true) is called on currently active window then it has no effect.

Note: Most of the window managers on X11 do support this feature, but there still might be some obscure ones that simply ignore this setting.

bool IsUrgent() const

Return value    True if window tries to catch users attention by flashing.

TopWindow& NoAccessKeysDistribution()

Disables distribution of access keys. Normally, TopWindow tries to assign access-keys (also known as "hot-keys") to all of its child windows before opening. This method disables this behaviour.

TopWindow& CloseBoxRejects(bool b = true)

When active, pressing window title close button always rejects the dialog. When not active, the action depends on Acceptors/Rejectors present, performing first of IDCANCEL -> reject, IDNO -> reject, IDEXIT -> accept, IDYES -> Accept, and IDOK -> Accept as default action if nothing else is present.

TopWindow& Icon(const Image& m)

Defines icon for TopWindow that is usually displayed in window caption (platform specif).

TopWindow& LargeIcon(const Image& m)

Defines "large" icon for TopWindow. It can be displayed e.g. in task switcher and other places (platform specific).

TopWindow& Icon(const Image& smallicon, const Image& largeicon)

Defines both "small" and "large" icons for TopWindow.

void SerializePlacement(Stream& s, bool reminimize = false)

Serializes current placement of TopWindow. It is platform specific, however information can include screen position in "normal" state and current status (maximized, minimized, normal).

TopWindow()

Constructor.

~TopWindow()

Destructor.

Do you want to contribute?