interface/wx/nonownedwnd.h

   1 ///////////////////////////////////////////////////////////////////////////////
   2 // Name:        interface/wx/nonownedwnd.h
   3 // Purpose:     wxNonOwnedWindow class documentation
   4 // Author:      Vadim Zeitlin
   5 // Created:     2011-10-09
   6 // RCS-ID:      $Id$
   7 // Copyright:   (c) 2011 Vadim Zeitlin <vadim@wxwidgets.org>
   8 // Licence:     wxWindows licence
   9 ///////////////////////////////////////////////////////////////////////////////
  10
  11 /**
  12     Common base class for all non-child windows.
  13
  14     This is the common base class of wxTopLevelWindow and wxPopupWindow and is
  15     not used directly.
  16
  17     Currently the only additional functionality it provides, compared to base
  18     wxWindow class, is the ability to set the window shape.
  19
  20     @since 2.9.3
  21  */
  22 class wxNonOwnedWindow : public wxWindow
  23 {
  24 public:
  25     /**
  26         If the platform supports it, sets the shape of the window to that
  27         depicted by @a region. The system will not display or respond to any
  28         mouse event for the pixels that lie outside of the region. To reset the
  29         window to the normal rectangular shape simply call SetShape() again with
  30         an empty wxRegion. Returns @true if the operation is successful.
  31
  32         This method is available in this class only since wxWidgets 2.9.3,
  33         previous versions only provided it in wxTopLevelWindow.
  34     */
  35     virtual bool SetShape(const wxRegion& region);
  36 };