Premultiply the alpha on wxMSW in the BitmapFromBuffer* functions so

[wxWidgets.git] / wxPython / src / _cshelp.i

diff --git a/wxPython/src/_cshelp.i b/wxPython/src/_cshelp.i
index 30a9ad44fd0167728dc4e3efb1c0205642246c7c..9db181dfde7e942e42efae5da7e4dc7b994be437 100644 (file)
--- a/wxPython/src/_cshelp.i
+++ b/wxPython/src/_cshelp.i
@@ -20,10 +20,6 @@
 
 //----------------------------------------------------------------------
 
 
 //----------------------------------------------------------------------
 

-enum {
-    wxFRAME_EX_CONTEXTHELP,
-    wxDIALOG_EX_CONTEXTHELP,
-};

 %constant wxEventType wxEVT_HELP;
 %constant wxEventType wxEVT_DETAILED_HELP;
 
 %constant wxEventType wxEVT_HELP;
 %constant wxEventType wxEVT_DETAILED_HELP;
 


@@ -70,10 +66,19 @@ Events
 class wxHelpEvent : public wxCommandEvent
 {
 public:
 class wxHelpEvent : public wxCommandEvent
 {
 public:

+    // how was this help event generated?
+    enum Origin
+    {
+        Origin_Unknown,    // unrecognized event source
+        Origin_Keyboard,   // event generated from F1 key press
+        Origin_HelpButton  // event from [?] button on the title bar (Windows)
+    };
+

     DocCtorStr(
         wxHelpEvent(wxEventType type = wxEVT_NULL,
                     wxWindowID winid = 0,
     DocCtorStr(
         wxHelpEvent(wxEventType type = wxEVT_NULL,
                     wxWindowID winid = 0,

-                    const wxPoint& pt = wxDefaultPosition),
+                    const wxPoint& pt = wxDefaultPosition,
+                    Origin origin = Origin_Unknown ),

         "", "");
     
 
         "", "");
     
 


@@ -104,7 +109,16 @@ appropriately.", "");
     DocDeclStr(
         void , SetTarget(const wxString& target),
         "Set an optional target to display help in. E.g. a window specification", "");
     DocDeclStr(
         void , SetTarget(const wxString& target),
         "Set an optional target to display help in. E.g. a window specification", "");

+
+    // optional indication of the event source
+    DocDeclStr(
+        Origin , GetOrigin() const,
+        "Optiononal indication of the source of the event.", "");

     
     

+    DocDeclStr(
+        void , SetOrigin(Origin origin),
+        "", "");
+        

 };
 
 //---------------------------------------------------------------------------
 };
 
 //---------------------------------------------------------------------------


@@ -119,7 +133,7 @@ help.
 
 There are a couple of ways to invoke this behaviour implicitly:
 
 
 There are a couple of ways to invoke this behaviour implicitly:
 

-    * Use the wx.DIALOG_EX_CONTEXTHELP extended style for a dialog
+    * Use the wx.WS_EX_CONTEXTHELP extended style for a dialog or frame

       (Windows only). This will put a question mark in the titlebar,
       and Windows will put the application into context-sensitive help
       mode automatically, with further programming.
       (Windows only). This will put a question mark in the titlebar,
       and Windows will put the application into context-sensitive help
       mode automatically, with further programming.


@@ -127,16 +141,18 @@ There are a couple of ways to invoke this behaviour implicitly:
     * Create a `wx.ContextHelpButton`, whose predefined behaviour is
       to create a context help object. Normally you will write your
       application so that this button is only added to a dialog for
     * Create a `wx.ContextHelpButton`, whose predefined behaviour is
       to create a context help object. Normally you will write your
       application so that this button is only added to a dialog for

-      non-Windows platforms (use ``wx.DIALOG_EX_CONTEXTHELP`` on
+      non-Windows platforms (use ``wx.WS_EX_CONTEXTHELP`` on

       Windows).
 
 :see: `wx.ContextHelpButton`
 ", "");       
 
       Windows).
 
 :see: `wx.ContextHelpButton`
 ", "");       
 

+MustHaveApp(wxContextHelp);
+

 class wxContextHelp : public wxObject {
 public:
     DocCtorStr(
 class wxContextHelp : public wxObject {
 public:
     DocCtorStr(

-        wxContextHelp(wxWindow* window = NULL, bool doNow = True),
+        wxContextHelp(wxWindow* window = NULL, bool doNow = true),

         "Constructs a context help object, calling BeginContextHelp if doNow is
 true (the default).
 
         "Constructs a context help object, calling BeginContextHelp if doNow is
 true (the default).
 


@@ -178,6 +194,8 @@ similar buttons.
 :see: `wx.ContextHelp`, `wx.ContextHelpButton`
 ", "");
 
 :see: `wx.ContextHelp`, `wx.ContextHelpButton`
 ", "");
 

+MustHaveApp(wxContextHelpButton);
+

 class wxContextHelpButton : public wxBitmapButton {
 public:
     %pythonAppend wxContextHelpButton "self._setOORInfo(self)"
 class wxContextHelpButton : public wxBitmapButton {
 public:
     %pythonAppend wxContextHelpButton "self._setOORInfo(self)"


@@ -204,11 +222,18 @@ application using wx.HelpProvider.Set().", "");
 class wxHelpProvider 
 {
 public:
 class wxHelpProvider 
 {
 public:

+    
+    ~wxHelpProvider();
+    
+    
+    %disownarg( wxHelpProvider *helpProvider );
+    %newobject Set;

     DocDeclStr(
         static wxHelpProvider *, Set(wxHelpProvider *helpProvider),
         "Sset the current, application-wide help provider. Returns the previous
 one.  Unlike some other classes, the help provider is not created on
 demand. This must be explicitly done by the application.", "");
     DocDeclStr(
         static wxHelpProvider *, Set(wxHelpProvider *helpProvider),
         "Sset the current, application-wide help provider. Returns the previous
 one.  Unlike some other classes, the help provider is not created on
 demand. This must be explicitly done by the application.", "");

+    %cleardisown( wxHelpProvider *helpProvider );

     
     DocDeclStr(
         static wxHelpProvider *, Get(),
     
     DocDeclStr(
         static wxHelpProvider *, Get(),


@@ -226,6 +251,16 @@ help is associated with the window.", "");
         "Shows help for the given window. Uses GetHelp internally if
 applicable. Returns True if it was done, or False if no help was
 available for this window.", "");
         "Shows help for the given window. Uses GetHelp internally if
 applicable. Returns True if it was done, or False if no help was
 available for this window.", "");

+
+    DocDeclStr(
+        virtual bool , ShowHelpAtPoint(wxWindowBase *window,
+                                       const wxPoint& pt,
+                                       wxHelpEvent::Origin origin),
+        "Show help for the given window (uses window.GetHelpAtPoint()
+internally if applicable), return true if it was done or false if no
+help available for this window.", "");
+    
+

     
     DocDeclStr(
         void , AddHelp(wxWindow *window, const wxString& text),
     
     DocDeclStr(
         void , AddHelp(wxWindow *window, const wxString& text),


@@ -246,6 +281,7 @@ table of help strings will fill up and when window pointers are
 reused, the wrong help string will be found.", "");
     
     
 reused, the wrong help string will be found.", "");
     
     

+    %pythonAppend Destroy "args[0].thisown = 0"

     %extend { void Destroy() { delete self; } }
 };
 
     %extend { void Destroy() { delete self; } }
 };