virtual void FitInside();
/**
- 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 these two functions may be
- nested but to ensure that the window is properly repainted again, you must thaw
- it exactly as many times as you froze it.
- This method is useful for visual appearance optimization (for example, it
- is a good idea to use it before doing many large text insertions in a row into
- a wxTextCtrl under wxGTK) but is not implemented on all platforms nor for all
- controls so it is mostly just a hint to wxWidgets and not a mandatory
- directive.
-
- @see wxWindowUpdateLocker
+ 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 these two
+ functions may be nested but to ensure that the window is properly
+ repainted again, you must thaw it exactly as many times as you froze
+ it.
+
+ If the window has any children, they are recursively frozen too.
+
+ This method is useful for visual appearance optimization (for example,
+ it is a good idea to use it before doing many large text insertions in
+ a row into a wxTextCtrl under wxGTK) but is not implemented on all
+ platforms nor for all controls so it is mostly just a hint to wxWidgets
+ and not a mandatory directive.
+
+ @see wxWindowUpdateLocker, Thaw(), IsFrozen()
*/
virtual void Freeze();
ignore under other platforms. Under Mac, it will change the size of the
returned font. See SetWindowVariant()
for more about this.
- This static method is "overridden'' in many derived classes and so calling,
+ This static method is "overridden" in many derived classes and so calling,
for example, wxButton::GetClassDefaultAttributes() will typically
return the values appropriate for a button which will be normally different
from those returned by, say, wxListCtrl::GetClassDefaultAttributes().
the call is automatically dispatched to the correct class (as usual with
virtual functions) and you don't have to specify the class name explicitly.
The other one is that in the future this function could return different
- results, for example it might return a different font for an "Ok'' button
+ results, for example it might return a different font for an "Ok" button
than for a generic button if the users GUI is configured to show such buttons
in bold font. Of course, the down side is that it is impossible to call this
function without actually having an object to apply it to whereas the static
This function is (or should be, in case of custom controls) called during
window creation to intelligently set up the window visual attributes, that is
the font and the foreground and background colours.
- By "intelligently'' the following is meant: by default, all windows use their
+ By "intelligently" the following is meant: by default, all windows use their
own @ref getclassdefaultattributes() default attributes. However
if some of the parents attributes are explicitly (that is, using
SetFont() and not
Returns @true if the window is currently frozen by a call to
Freeze().
- @see Thaw()
+ @see Freeze(), Thaw()
*/
virtual bool IsFrozen() const;
*/
void Layout();
- /**
- This is just a wrapper for wxWindow::ScrollLines(1).
- */
-
-
- /**
- This is just a wrapper for wxWindow::ScrollLines(-1).
- */
-
-
/**
Lowers the window to the bottom of the window hierarchy (Z-order).
virtual void OnInternalIdle();
/**
- This is just a wrapper for wxWindow::ScrollPages(1).
+ Same as #ScrollLines (-1).
*/
+ bool LineUp();
+ /**
+ Same as #ScrollLines (1).
+ */
+ bool LineDown();
/**
- This is just a wrapper for wxWindow::ScrollPages(-1).
+ Same as #ScrollPages (-1).
*/
+ bool PageUp();
+
+ /**
+ Same as #ScrollPages (1).
+ */
+ bool PageDown();
/**
implementation,
and not in the window object itself.
- @see GetHelpText(), wxHelpProvider
+ @see GetHelpText(), wxHelpProvider::AddHelp()
*/
virtual void SetHelpText(const wxString& helpText);
wxDirection dir = wxBOTTOM);
/**
- Reenables window updating after a previous call to
- Freeze(). To really thaw the control, it must be called
- exactly the same number of times as Freeze().
+ Reenables window updating after a previous call to Freeze().
+
+ To really thaw the control, it must be called exactly the same number
+ of times as Freeze().
+
+ If the window has any children, they are recursively thawn too.
- @see wxWindowUpdateLocker
+ @see wxWindowUpdateLocker, Freeze(), IsFrozen()
*/
virtual void Thaw();
/**
Moves the pointer to the given position on the window.
- @b NB: This function is not supported under Mac because Apple Human
+ @note This function is not supported under Mac because Apple Human
Interface Guidelines forbid moving the mouse cursor programmatically.
@param x
// Global functions/macros
// ============================================================================
-/**
- Find the deepest window at the given mouse position in screen coordinates,
- returning the window if found, or @NULL if not.
-*/
-wxWindow* wxFindWindowAtPoint(const wxPoint& pt);
+/** @ingroup group_funcmacro_misc */
+//@{
/**
Find the deepest window at the mouse pointer position, returning the window
and current pointer position in screen coordinates.
+
+ @header{wx/window.h}
*/
wxWindow* wxFindWindowAtPointer(wxPoint& pt);
/**
- Gets the currently active window (implemented for MSW and GTK only currently,
- always returns @NULL in the other ports).
+ Gets the currently active window (implemented for MSW and GTK only
+ currently, always returns @NULL in the other ports).
+
+ @header{wx/window.h}
*/
wxWindow* wxGetActiveWindow();
/**
- Returns the first top level parent of the given window, or in other words, the
- frame or dialog containing it, or @NULL.
+ Returns the first top level parent of the given window, or in other words,
+ the frame or dialog containing it, or @NULL.
+
+ @header{wx/window.h}
*/
-wxWindow* wxGetTopLevelParent(wxWindow win);
+wxWindow* wxGetTopLevelParent(wxWindow* window);
+
+//@}
projects / wxWidgets.git / blobdiff