From b58d5e2d952e2b3bb03de42098d1399ba23f53e8 Mon Sep 17 00:00:00 2001
From: Robin Dunn <robin@alldunn.com>
Date: Mon, 21 Aug 2006 18:30:34 +0000
Subject: [PATCH] Move CanSetTransparent and SetTransparent up to wxWindowBase
 since wxMac can handle transparency at that level.

git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@40730 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
---
 include/wx/toplevel.h  |  4 ----
 include/wx/window.h    |  6 ++++++
 wxPython/src/_toplvl.i | 11 ++++++-----
 wxPython/src/_window.i | 20 ++++++++++++++++++++
 4 files changed, 32 insertions(+), 9 deletions(-)

diff --git a/include/wx/toplevel.h b/include/wx/toplevel.h
index e9be5bb460..2c601c70c5 100644
--- a/include/wx/toplevel.h
+++ b/include/wx/toplevel.h
@@ -196,10 +196,6 @@ public:
     void CentreOnScreen(int dir = wxBOTH) { DoCentre(dir | wxCENTRE_ON_SCREEN); }
     void CenterOnScreen(int dir = wxBOTH) { CentreOnScreen(dir); }
 
-    // Set window transparency if the platform supports it
-    virtual bool SetTransparent(wxByte WXUNUSED(alpha)) { return false; }
-    virtual bool CanSetTransparent() { return false; }
-
 
     // default item access: we have a permanent default item which is the one
     // set by the user code but we may also have a temporary default item which
diff --git a/include/wx/window.h b/include/wx/window.h
index 6efb7a0249..00aac00518 100644
--- a/include/wx/window.h
+++ b/include/wx/window.h
@@ -1027,6 +1027,12 @@ public:
     wxAccessible* GetOrCreateAccessible() ;
 #endif
 
+    
+    // Set window transparency if the platform supports it
+    virtual bool SetTransparent(wxByte WXUNUSED(alpha)) { return false; }
+    virtual bool CanSetTransparent() { return false; }
+
+
     // implementation
     // --------------
 
diff --git a/wxPython/src/_toplvl.i b/wxPython/src/_toplvl.i
index 8bdbbb2a01..836b7dd90c 100644
--- a/wxPython/src/_toplvl.i
+++ b/wxPython/src/_toplvl.i
@@ -176,9 +176,6 @@ public:
     }
 #endif
 
-    virtual bool SetTransparent(byte alpha); 
-    virtual bool CanSetTransparent();
-
     
     
     DocDeclStr(
@@ -366,11 +363,15 @@ public:
     void SetReturnCode(int returnCode);
     int GetReturnCode() const;
 
-    // The identifier for the affirmative button
+    // Set the identifier for the affirmative button: this button will close
+    // the dialog after validating data and calling TransferDataFromWindow()
     void SetAffirmativeId(int affirmativeId);
     int GetAffirmativeId() const;
 
-    // Identifier for Esc key translation
+    // Set identifier for Esc key translation: the button with this id will
+    // close the dialog without doing anything else; special value wxID_NONE
+    // means to not handle Esc at all while wxID_ANY means to map Esc to
+    // wxID_CANCEL if present and GetAffirmativeId() otherwise
     void SetEscapeId(int escapeId);
     int GetEscapeId() const;
 
diff --git a/wxPython/src/_window.i b/wxPython/src/_window.i
index 2f0ebf8636..97d4150f96 100644
--- a/wxPython/src/_window.i
+++ b/wxPython/src/_window.i
@@ -1981,6 +1981,26 @@ from the parent window.
 The base class version returns false, but this method is overridden in
 wxControl where it returns true.", "");
     
+
+
+    DocDeclStr(
+        virtual bool , CanSetTransparent(),
+        "Returns ``True`` if the platform supports setting the transparency for
+this window.  Note that this method will err on the side of caution,
+so it is possible that this will return ``False`` when it is in fact
+possible to set the transparency.
+
+NOTE: On X-windows systems the X server must have the composite
+extension loaded, and there must be a composite manager program (such
+as xcompmgr) running.", "");
+
+    DocDeclStr(
+        virtual bool , SetTransparent(byte alpha),
+        "Attempt to set the transparency of this window to the ``alpha`` value,
+returns True on success.  The ``alpha`` value is an integer in the
+range of 0 to 255, where 0 is fully transparent and 255 is fully
+opaque.", "");
+    
     
 
     %pythoncode {
-- 
2.47.2