%newgroup
+enum wxWindowVariant
+{
+ wxWINDOW_VARIANT_DEFAULT, // Default size (usually == normal, may be set by a wxSystemOptions entry)
+ wxWINDOW_VARIANT_NORMAL, // Normal size
+ wxWINDOW_VARIANT_SMALL, // Smaller size (about 25 % smaller than normal )
+ wxWINDOW_VARIANT_MINI, // Mini size (about 33 % smaller than normal )
+ wxWINDOW_VARIANT_LARGE, // Large size (about 25 % larger than normal )
+};
+
+
DocStr(wxWindow,
"
wx.Window is the base class for all windows and represents any visible
%pythonAppend wxWindow "self._setOORInfo(self)"
%pythonAppend wxWindow() ""
+ RefDoc(wxWindow, ""); // turn it off for the ctors
+
DocCtorStr(
wxWindow(wxWindow* parent, const wxWindowID id,
const wxPoint& pos = wxDefaultPosition,
DocDeclStr(
virtual wxString , GetLabel() const,
- "Generic way of getting a label from any window, for identification
-purposes. The interpretation of this function differs from class to
-class. For frames and dialogs, the value returned is the title. For
-buttons or static text controls, it is the button text. This function
-can be useful for meta-programs (such as testing tools or
-special-needs access programs) which need to identify windows by name.");
+ "Generic way of getting a label from any window, for
+identification purposes. The interpretation of this function
+differs from class to class. For frames and dialogs, the value
+returned is the title. For buttons or static text controls, it is
+the button text. This function can be useful for meta-programs
+(such as testing tools or special-needs access programs) which
+need to identify windows by name.");
// the window name is used for ressource setting in X, it is not the
// same as the window title/label
DocDeclStr(
virtual void , SetName( const wxString &name ),
- "Sets the window's name. The window name is used for ressource setting
-in X, it is not the same as the window title/label");
+ "Sets the window's name. The window name is used for ressource
+setting in X, it is not the same as the window title/label");
DocDeclStr(
virtual wxString , GetName() const,
- "Returns the window's name. This name is not guaranteed to be unique;
-it is up to the programmer to supply an appropriate name in the window
-constructor or via wx.Window.SetName.");
+ "Returns the window's name. This name is not guaranteed to be
+unique; it is up to the programmer to supply an appropriate name
+in the window constructor or via wx.Window.SetName.");
+
+
+
+ DocDeclStr(
+ void , SetWindowVariant( wxWindowVariant variant ),
+ "Sets the variant of the window/font size to use for this window,
+if the platform supports variants, (for example, wxMac.)");
+
+ DocDeclStr(
+ wxWindowVariant , GetWindowVariant() const,
+ "");
- // window id uniquely identifies the window among its siblings unless
- // it is -1 which means "don't care"
DocDeclStr(
void , SetId( wxWindowID winid ),
"Sets the identifier of the window. Each window has an integer
virtual bool , Show( bool show = True ),
"Shows or hides the window. You may need to call Raise for a top level
window if you want to bring it to top, although this is not needed if
-Show() is called immediately after the frame creation. Returns true
-if the window has been shown or hidden or false if nothing was done
+Show is called immediately after the frame creation. Returns True if
+the window has been shown or hidden or False if nothing was done
because it already was in the requested state.");
DocDeclStr(
DocDeclStr(
virtual long , GetWindowStyleFlag() const,
- "Gets the window style that was passed to the constructor or Create method.");
+ "Gets the window style that was passed to the constructor or Create
+method.");
%pythoncode { SetWindowStyle = SetWindowStyleFlag; GetWindowStyle = GetWindowStyleFlag }
virtual bool , AcceptsFocusFromKeyboard() const,
"Can this window be given focus by keyboard navigation? if not, the
only way to give it focus (provided it accepts it at all) is to click
-it.
-");
+it.");
DocDeclStr(
virtual wxWindow *, GetDefaultItem() const,
"Get the default child of this parent, i.e. the one which is activated
-by pressing <Enter> such as the OK button on a wx.Dialog.
-");
+by pressing <Enter> such as the OK button on a wx.Dialog.");
DocDeclStr(
virtual wxWindow *, SetDefaultItem(wxWindow * child),
// ---------------------------
DocStr(ConvertDialogToPixels,
- "Converts a point or size from dialog units to pixels. Dialog units are
-used for maintaining a dialog's proportions even if the font
+ "Converts a point or size from dialog units to pixels. Dialog units
+are used for maintaining a dialog's proportions even if the font
changes. For the x dimension, the dialog units are multiplied by the
average character width and then divided by 4. For the y dimension,
the dialog units are multiplied by the average character height and
DocDeclStr(
virtual void , Freeze(),
- "Freezes the window or, in other words, prevents any updates from
-taking place on screen, the window is not redrawn at all. Thaw must be
-called to reenable window redrawing.
+ "Freezes the window or, in other words, prevents any updates from taking place
+on screen, the window is not redrawn at all. Thaw must be called to reenable
+window redrawing. Calls to Freeze/Thaw may be nested, with the actual Thaw
+being delayed until all the nesting has been undone.
This method is useful for visual appearance optimization (for example,
it is a good idea to use it before inserting large amount of text into
DocDeclStr(
virtual void , Thaw(),
- "Reenables window updating after a previous call to Freeze.");
+ "Reenables window updating after a previous call to Freeze. Calls to
+Freeze/Thaw may be nested, so Thaw must be called the same number of times
+that Freeze was before the window will be updated.");
DocDeclStr(
exposed.");
bool IsExposed( int x, int y, int w=1, int h=1 ) const;
%name(IsExposedPoint) bool IsExposed( const wxPoint& pt ) const;
- %name(isExposedRect) bool IsExposed( const wxRect& rect ) const;
+ %name(IsExposedRect) bool IsExposed( const wxRect& rect ) const;
DocDeclStr(
wxFont& , GetFont(),
- "Returns a reference to the font for this window.");
+ "Returns the default font used for this window.");
+%{
+#ifdef __WXMSW__
+#include <wx/msw/private.h> // to get wxGetWindowId
+#endif
+%}
+
%inline %{
- wxWindow* wxWindow_FromHWND(unsigned long hWnd) {
+ wxWindow* wxWindow_FromHWND(wxWindow* parent, unsigned long _hWnd) {
#ifdef __WXMSW__
+ WXHWND hWnd = (WXHWND)_hWnd;
+ long id = wxGetWindowId(hWnd);
wxWindow* win = new wxWindow;
+ parent->AddChild(win);
+ win->SetEventHandler(win);
win->SetHWND(hWnd);
+ win->SetId(id);
win->SubclassWin(hWnd);
+ win->AdoptAttributesFromHWND();
+ win->SetupColours();
return win;
#else
wxPyRaiseNotImplemented();
projects / wxWidgets.git / blobdiff