include/wx/nonownedwnd.h

   1 ///////////////////////////////////////////////////////////////////////////////
   2 // Name:        wx/nonownedwnd.h
   3 // Purpose:     declares wxNonTopLevelWindow class
   4 // Author:      Vaclav Slavik
   5 // Modified by:
   6 // Created:     2006-12-24
   7 // RCS-ID:      $Id$
   8 // Copyright:   (c) 2006 TT-Solutions
   9 // Licence:     wxWindows licence
  10 ///////////////////////////////////////////////////////////////////////////////
  11
  12 #ifndef _WX_NONOWNEDWND_H_
  13 #define _WX_NONOWNEDWND_H_
  14
  15 #include "wx/window.h"
  16
  17 // Styles that can be used with any wxNonOwnedWindow:
  18 #define wxFRAME_SHAPED          0x0010  // Create a window that is able to be shaped
  19
  20 class WXDLLIMPEXP_FWD_CORE wxGraphicsPath;
  21
  22 // ----------------------------------------------------------------------------
  23 // wxNonOwnedWindow: a window that is not a child window of another one.
  24 // ----------------------------------------------------------------------------
  25
  26 class WXDLLIMPEXP_CORE wxNonOwnedWindowBase : public wxWindow
  27 {
  28 public:
  29     // Set the shape of the window to the given region.
  30     // Returns true if the platform supports this feature (and the
  31     // operation is successful.)
  32     bool SetShape(const wxRegion& region)
  33     {
  34         // This style is in fact only needed by wxOSX/Carbon so once we don't
  35         // use this port any more, we could get rid of this requirement, but
  36         // for now you must specify wxFRAME_SHAPED for SetShape() to work on
  37         // all platforms.
  38         wxCHECK_MSG
  39         (
  40             HasFlag(wxFRAME_SHAPED), false,
  41             wxS("Shaped windows must be created with the wxFRAME_SHAPED style.")
  42         );
  43
  44         return region.IsEmpty() ? DoClearShape() : DoSetRegionShape(region);
  45     }
  46
  47 #if wxUSE_GRAPHICS_CONTEXT
  48     // Set the shape using the specified path.
  49     bool SetShape(const wxGraphicsPath& path)
  50     {
  51         wxCHECK_MSG
  52         (
  53             HasFlag(wxFRAME_SHAPED), false,
  54             wxS("Shaped windows must be created with the wxFRAME_SHAPED style.")
  55         );
  56
  57         return DoSetPathShape(path);
  58     }
  59 #endif // wxUSE_GRAPHICS_CONTEXT
  60
  61 protected:
  62     virtual bool DoClearShape()
  63     {
  64         return false;
  65     }
  66
  67     virtual bool DoSetRegionShape(const wxRegion& WXUNUSED(region))
  68     {
  69         return false;
  70     }
  71
  72 #if wxUSE_GRAPHICS_CONTEXT
  73     virtual bool DoSetPathShape(const wxGraphicsPath& WXUNUSED(path))
  74     {
  75         return false;
  76     }
  77 #endif // wxUSE_GRAPHICS_CONTEXT
  78 };
  79
  80 #if defined(__WXDFB__)
  81     #include "wx/dfb/nonownedwnd.h"
  82 #elif defined(__WXGTK20__)
  83     #include "wx/gtk/nonownedwnd.h"
  84 #elif defined(__WXMAC__)
  85     #include "wx/osx/nonownedwnd.h"
  86 #elif defined(__WXMSW__) && !defined(__WXWINCE__)
  87     #include "wx/msw/nonownedwnd.h"
  88 #else
  89     // No special class needed in other ports, they can derive both wxTLW and
  90     // wxPopupWindow directly from wxWindow and don't implement SetShape().
  91     class wxNonOwnedWindow : public wxNonOwnedWindowBase
  92     {
  93     };
  94 #endif
  95
  96 #endif // _WX_NONOWNEDWND_H_