X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/3c69a2ec864e94f58243500ca6d41c980b0fa4fe..26ee65c723cf55822c540506f064ec11d9b26858:/wxPython/src/_window.i diff --git a/wxPython/src/_window.i b/wxPython/src/_window.i index 450d476f26..2935cb31c1 100644 --- a/wxPython/src/_window.i +++ b/wxPython/src/_window.i @@ -34,15 +34,27 @@ struct wxVisualAttributes ~wxVisualAttributes() { delete self; } } - // the font used for control label/text inside it - wxFont font; - - // the foreground colour - wxColour colFg; +// // the font used for control label/text inside it +// wxFont font; +// // the foreground colour +// wxColour colFg; +// // the background colour, may be wxNullColour if the controls background +// // colour is not solid +// wxColour colBg; + + // Use our own getters and properties instead of the ones that SWIG will + // generate, so copies of the attributes will be made when they are + // accessed, instead of using a pointer to the one in the object which may + // be temporary. + %extend { + wxFont _get_font() { return self->font; } + wxColour _get_colFg() { return self->colFg; } + wxColour _get_colBg() { return self->colBg; } + } - // the background colour, may be wxNullColour if the controls background - // colour is not solid - wxColour colBg; + %property(font, _get_font) + %property(colFg, _get_colFg) + %property(colBg, _get_colBg) }; @@ -775,7 +787,16 @@ window had already been in the specified state.", ""); DocDeclStr( bool , IsEnabled() const, - "Returns true if the window is enabled for input, false otherwise.", ""); + "Returns true if the window is enabled for input, false otherwise. +This method takes into account the enabled state of parent windows up +to the top-level window.", ""); + + DocDeclStr( + bool , IsThisEnabled() const, + "Returns the internal enabled state independent of the parent(s) state, +i.e. the state in which the window would be if all of its parents are +enabled. Use `IsEnabled` to get the effective window state.", ""); + DocDeclStr( virtual bool , IsShownOnScreen() const, @@ -892,6 +913,12 @@ or None.", ""); "Can this window have focus?", ""); + DocDeclStr( + bool , CanAcceptFocus() const, + "Can this window have focus right now?", ""); + + + DocDeclStr( virtual bool , AcceptsFocusFromKeyboard() const, "Can this window be given focus by keyboard navigation? if not, the @@ -899,13 +926,24 @@ only way to give it focus (provided it accepts it at all) is to click it.", ""); + + DocDeclStr( + bool , CanAcceptFocusFromKeyboard() const, + "Can this window be assigned focus from keyboard right now?", ""); + + + + DocDeclAStr( + virtual bool , NavigateIn(int flags = wxNavigationKeyEvent::IsForward), + "NavigateIn(self, int flags=NavigationKeyEvent.IsForward) -> bool", + "Navigates inside this window.", ""); DocDeclAStr( virtual bool , Navigate(int flags = wxNavigationKeyEvent::IsForward), "Navigate(self, int flags=NavigationKeyEvent.IsForward) -> bool", - "Does keyboard navigation from this window to another, by sending a -`wx.NavigationKeyEvent`.", " + "Does keyboard navigation starting from this window to another. This is +equivalient to self.GetParent().NavigateIn().", " :param flags: A combination of the ``IsForward`` or ``IsBackward`` and the ``WinChange`` values in the `wx.NavigationKeyEvent` @@ -973,8 +1011,16 @@ do not change.", ""); wxWindow *, GetGrandParent() const, "Returns the parent of the parent of this window, or None if there isn't one.", ""); - + + %extend { + DocDeclStr(wxWindow *, GetTopLevelParent(), + "Returns the first frame or dialog in this window's parental hierarchy.", "") + { + return wxGetTopLevelParent(self); + } + } + DocDeclStr( virtual bool , IsTopLevel() const, @@ -2114,6 +2160,7 @@ opaque.", ""); %property(Font, GetFont, SetFont, doc="See `GetFont` and `SetFont`"); %property(ForegroundColour, GetForegroundColour, SetForegroundColour, doc="See `GetForegroundColour` and `SetForegroundColour`"); %property(GrandParent, GetGrandParent, doc="See `GetGrandParent`"); + %property(TopLevelParent, GetTopLevelParent, doc="See `GetTopLevelParent`"); %property(Handle, GetHandle, doc="See `GetHandle`"); %property(HelpText, GetHelpText, SetHelpText, doc="See `GetHelpText` and `SetHelpText`"); %property(Id, GetId, SetId, doc="See `GetId` and `SetId`");