| 1 | /////////////////////////////////////////////////////////////////////////////// |
| 2 | // Name: wx/window.h |
| 3 | // Purpose: wxWindowBase class - the interface of wxWindow |
| 4 | // Author: Vadim Zeitlin |
| 5 | // Modified by: Ron Lee |
| 6 | // Created: 01/02/97 |
| 7 | // RCS-ID: $Id$ |
| 8 | // Copyright: (c) Vadim Zeitlin |
| 9 | // Licence: wxWindows licence |
| 10 | /////////////////////////////////////////////////////////////////////////////// |
| 11 | |
| 12 | #ifndef _WX_WINDOW_H_BASE_ |
| 13 | #define _WX_WINDOW_H_BASE_ |
| 14 | |
| 15 | // ---------------------------------------------------------------------------- |
| 16 | // headers which we must include here |
| 17 | // ---------------------------------------------------------------------------- |
| 18 | |
| 19 | #include "wx/event.h" // the base class |
| 20 | |
| 21 | #include "wx/list.h" // defines wxWindowList |
| 22 | |
| 23 | #include "wx/cursor.h" // we have member variables of these classes |
| 24 | #include "wx/font.h" // so we can't do without them |
| 25 | #include "wx/colour.h" |
| 26 | #include "wx/region.h" |
| 27 | #include "wx/utils.h" |
| 28 | #include "wx/intl.h" |
| 29 | |
| 30 | #include "wx/validate.h" // for wxDefaultValidator (always include it) |
| 31 | |
| 32 | #if wxUSE_PALETTE |
| 33 | #include "wx/palette.h" |
| 34 | #endif // wxUSE_PALETTE |
| 35 | |
| 36 | #if wxUSE_ACCEL |
| 37 | #include "wx/accel.h" |
| 38 | #endif // wxUSE_ACCEL |
| 39 | |
| 40 | #if wxUSE_ACCESSIBILITY |
| 41 | #include "wx/access.h" |
| 42 | #endif |
| 43 | |
| 44 | // when building wxUniv/Foo we don't want the code for native menu use to be |
| 45 | // compiled in - it should only be used when building real wxFoo |
| 46 | #ifdef __WXUNIVERSAL__ |
| 47 | #define wxUSE_MENUS_NATIVE 0 |
| 48 | #else // !__WXUNIVERSAL__ |
| 49 | #define wxUSE_MENUS_NATIVE wxUSE_MENUS |
| 50 | #endif // __WXUNIVERSAL__/!__WXUNIVERSAL__ |
| 51 | |
| 52 | |
| 53 | // Define this macro if the corresponding operating system handles the state |
| 54 | // of children windows automatically when the parent is enabled/disabled. |
| 55 | // Otherwise wx itself must ensure that when the parent is disabled its |
| 56 | // children are disabled too, and their initial state is restored when the |
| 57 | // parent is enabled back. |
| 58 | #if defined(__WXMSW__) || defined(__WXPM__) |
| 59 | // must do everything ourselves |
| 60 | #undef wxHAS_NATIVE_ENABLED_MANAGEMENT |
| 61 | #else |
| 62 | #define wxHAS_NATIVE_ENABLED_MANAGEMENT |
| 63 | #endif |
| 64 | |
| 65 | // ---------------------------------------------------------------------------- |
| 66 | // forward declarations |
| 67 | // ---------------------------------------------------------------------------- |
| 68 | |
| 69 | class WXDLLIMPEXP_FWD_CORE wxCaret; |
| 70 | class WXDLLIMPEXP_FWD_CORE wxControl; |
| 71 | class WXDLLIMPEXP_FWD_CORE wxCursor; |
| 72 | class WXDLLIMPEXP_FWD_CORE wxDC; |
| 73 | class WXDLLIMPEXP_FWD_CORE wxDropTarget; |
| 74 | class WXDLLIMPEXP_FWD_CORE wxItemResource; |
| 75 | class WXDLLIMPEXP_FWD_CORE wxLayoutConstraints; |
| 76 | class WXDLLIMPEXP_FWD_CORE wxResourceTable; |
| 77 | class WXDLLIMPEXP_FWD_CORE wxSizer; |
| 78 | class WXDLLIMPEXP_FWD_CORE wxToolTip; |
| 79 | class WXDLLIMPEXP_FWD_CORE wxWindowBase; |
| 80 | class WXDLLIMPEXP_FWD_CORE wxWindow; |
| 81 | class WXDLLIMPEXP_FWD_CORE wxScrollHelper; |
| 82 | |
| 83 | #if wxUSE_ACCESSIBILITY |
| 84 | class WXDLLIMPEXP_FWD_CORE wxAccessible; |
| 85 | #endif |
| 86 | |
| 87 | // ---------------------------------------------------------------------------- |
| 88 | // helper stuff used by wxWindow |
| 89 | // ---------------------------------------------------------------------------- |
| 90 | |
| 91 | // struct containing all the visual attributes of a control |
| 92 | struct WXDLLEXPORT wxVisualAttributes |
| 93 | { |
| 94 | // the font used for control label/text inside it |
| 95 | wxFont font; |
| 96 | |
| 97 | // the foreground colour |
| 98 | wxColour colFg; |
| 99 | |
| 100 | // the background colour, may be wxNullColour if the controls background |
| 101 | // colour is not solid |
| 102 | wxColour colBg; |
| 103 | }; |
| 104 | |
| 105 | // different window variants, on platforms like eg mac uses different |
| 106 | // rendering sizes |
| 107 | enum wxWindowVariant |
| 108 | { |
| 109 | wxWINDOW_VARIANT_NORMAL, // Normal size |
| 110 | wxWINDOW_VARIANT_SMALL, // Smaller size (about 25 % smaller than normal) |
| 111 | wxWINDOW_VARIANT_MINI, // Mini size (about 33 % smaller than normal) |
| 112 | wxWINDOW_VARIANT_LARGE, // Large size (about 25 % larger than normal) |
| 113 | wxWINDOW_VARIANT_MAX |
| 114 | }; |
| 115 | |
| 116 | #if wxUSE_SYSTEM_OPTIONS |
| 117 | #define wxWINDOW_DEFAULT_VARIANT wxT("window-default-variant") |
| 118 | #endif |
| 119 | |
| 120 | // ---------------------------------------------------------------------------- |
| 121 | // (pseudo)template list classes |
| 122 | // ---------------------------------------------------------------------------- |
| 123 | |
| 124 | WX_DECLARE_LIST_3(wxWindow, wxWindowBase, wxWindowList, wxWindowListNode, class WXDLLEXPORT); |
| 125 | |
| 126 | // ---------------------------------------------------------------------------- |
| 127 | // global variables |
| 128 | // ---------------------------------------------------------------------------- |
| 129 | |
| 130 | extern WXDLLEXPORT_DATA(wxWindowList) wxTopLevelWindows; |
| 131 | extern WXDLLIMPEXP_DATA_CORE(wxList) wxPendingDelete; |
| 132 | |
| 133 | // ---------------------------------------------------------------------------- |
| 134 | // wxWindowBase is the base class for all GUI controls/widgets, this is the public |
| 135 | // interface of this class. |
| 136 | // |
| 137 | // Event handler: windows have themselves as their event handlers by default, |
| 138 | // but their event handlers could be set to another object entirely. This |
| 139 | // separation can reduce the amount of derivation required, and allow |
| 140 | // alteration of a window's functionality (e.g. by a resource editor that |
| 141 | // temporarily switches event handlers). |
| 142 | // ---------------------------------------------------------------------------- |
| 143 | |
| 144 | class WXDLLEXPORT wxWindowBase : public wxEvtHandler |
| 145 | { |
| 146 | public: |
| 147 | // creating the window |
| 148 | // ------------------- |
| 149 | |
| 150 | // default ctor, initializes everything which can be initialized before |
| 151 | // Create() |
| 152 | wxWindowBase() ; |
| 153 | |
| 154 | // pseudo ctor (can't be virtual, called from ctor) |
| 155 | bool CreateBase(wxWindowBase *parent, |
| 156 | wxWindowID winid, |
| 157 | const wxPoint& pos = wxDefaultPosition, |
| 158 | const wxSize& size = wxDefaultSize, |
| 159 | long style = 0, |
| 160 | const wxValidator& validator = wxDefaultValidator, |
| 161 | const wxString& name = wxPanelNameStr); |
| 162 | |
| 163 | virtual ~wxWindowBase(); |
| 164 | |
| 165 | // deleting the window |
| 166 | // ------------------- |
| 167 | |
| 168 | // ask the window to close itself, return true if the event handler |
| 169 | // honoured our request |
| 170 | bool Close( bool force = false ); |
| 171 | |
| 172 | // the following functions delete the C++ objects (the window itself |
| 173 | // or its children) as well as the GUI windows and normally should |
| 174 | // never be used directly |
| 175 | |
| 176 | // delete window unconditionally (dangerous!), returns true if ok |
| 177 | virtual bool Destroy(); |
| 178 | // delete all children of this window, returns true if ok |
| 179 | bool DestroyChildren(); |
| 180 | |
| 181 | // is the window being deleted? |
| 182 | bool IsBeingDeleted() const { return m_isBeingDeleted; } |
| 183 | |
| 184 | // window attributes |
| 185 | // ----------------- |
| 186 | |
| 187 | // label is just the same as the title (but for, e.g., buttons it |
| 188 | // makes more sense to speak about labels), title access |
| 189 | // is available from wxTLW classes only (frames, dialogs) |
| 190 | virtual void SetLabel(const wxString& label) = 0; |
| 191 | virtual wxString GetLabel() const = 0; |
| 192 | |
| 193 | // the window name is used for ressource setting in X, it is not the |
| 194 | // same as the window title/label |
| 195 | virtual void SetName( const wxString &name ) { m_windowName = name; } |
| 196 | virtual wxString GetName() const { return m_windowName; } |
| 197 | |
| 198 | // sets the window variant, calls internally DoSetVariant if variant |
| 199 | // has changed |
| 200 | void SetWindowVariant(wxWindowVariant variant); |
| 201 | wxWindowVariant GetWindowVariant() const { return m_windowVariant; } |
| 202 | |
| 203 | |
| 204 | // window id uniquely identifies the window among its siblings unless |
| 205 | // it is wxID_ANY which means "don't care" |
| 206 | void SetId( wxWindowID winid ) { m_windowId = winid; } |
| 207 | wxWindowID GetId() const { return m_windowId; } |
| 208 | |
| 209 | // get or change the layout direction (LTR or RTL) for this window, |
| 210 | // wxLayout_Default is returned if layout direction is not supported |
| 211 | virtual wxLayoutDirection GetLayoutDirection() const |
| 212 | { return wxLayout_Default; } |
| 213 | virtual void SetLayoutDirection(wxLayoutDirection WXUNUSED(dir)) |
| 214 | { } |
| 215 | |
| 216 | // mirror coordinates for RTL layout if this window uses it and if the |
| 217 | // mirroring is not done automatically like Win32 |
| 218 | virtual wxCoord AdjustForLayoutDirection(wxCoord x, |
| 219 | wxCoord width, |
| 220 | wxCoord widthTotal) const; |
| 221 | |
| 222 | // generate a control id for the controls which were not given one by |
| 223 | // user |
| 224 | static int NewControlId() { return --ms_lastControlId; } |
| 225 | // get the id of the control following the one with the given |
| 226 | // (autogenerated) id |
| 227 | static int NextControlId(int winid) { return winid - 1; } |
| 228 | // get the id of the control preceding the one with the given |
| 229 | // (autogenerated) id |
| 230 | static int PrevControlId(int winid) { return winid + 1; } |
| 231 | |
| 232 | // moving/resizing |
| 233 | // --------------- |
| 234 | |
| 235 | // set the window size and/or position |
| 236 | void SetSize( int x, int y, int width, int height, |
| 237 | int sizeFlags = wxSIZE_AUTO ) |
| 238 | { DoSetSize(x, y, width, height, sizeFlags); } |
| 239 | |
| 240 | void SetSize( int width, int height ) |
| 241 | { DoSetSize( wxDefaultCoord, wxDefaultCoord, width, height, wxSIZE_USE_EXISTING ); } |
| 242 | |
| 243 | void SetSize( const wxSize& size ) |
| 244 | { SetSize( size.x, size.y); } |
| 245 | |
| 246 | void SetSize(const wxRect& rect, int sizeFlags = wxSIZE_AUTO) |
| 247 | { DoSetSize(rect.x, rect.y, rect.width, rect.height, sizeFlags); } |
| 248 | |
| 249 | void Move(int x, int y, int flags = wxSIZE_USE_EXISTING) |
| 250 | { DoSetSize(x, y, wxDefaultCoord, wxDefaultCoord, flags); } |
| 251 | |
| 252 | void Move(const wxPoint& pt, int flags = wxSIZE_USE_EXISTING) |
| 253 | { Move(pt.x, pt.y, flags); } |
| 254 | |
| 255 | void SetPosition(const wxPoint& pt) { Move(pt); } |
| 256 | |
| 257 | // Z-order |
| 258 | virtual void Raise() = 0; |
| 259 | virtual void Lower() = 0; |
| 260 | |
| 261 | // client size is the size of area available for subwindows |
| 262 | void SetClientSize( int width, int height ) |
| 263 | { DoSetClientSize(width, height); } |
| 264 | |
| 265 | void SetClientSize( const wxSize& size ) |
| 266 | { DoSetClientSize(size.x, size.y); } |
| 267 | |
| 268 | void SetClientSize(const wxRect& rect) |
| 269 | { SetClientSize( rect.width, rect.height ); } |
| 270 | |
| 271 | // get the window position (pointers may be NULL): notice that it is in |
| 272 | // client coordinates for child windows and screen coordinates for the |
| 273 | // top level ones, use GetScreenPosition() if you need screen |
| 274 | // coordinates for all kinds of windows |
| 275 | void GetPosition( int *x, int *y ) const { DoGetPosition(x, y); } |
| 276 | wxPoint GetPosition() const |
| 277 | { |
| 278 | int x, y; |
| 279 | DoGetPosition(&x, &y); |
| 280 | |
| 281 | return wxPoint(x, y); |
| 282 | } |
| 283 | |
| 284 | // get the window position in screen coordinates |
| 285 | void GetScreenPosition(int *x, int *y) const { DoGetScreenPosition(x, y); } |
| 286 | wxPoint GetScreenPosition() const |
| 287 | { |
| 288 | int x, y; |
| 289 | DoGetScreenPosition(&x, &y); |
| 290 | |
| 291 | return wxPoint(x, y); |
| 292 | } |
| 293 | |
| 294 | // get the window size (pointers may be NULL) |
| 295 | void GetSize( int *w, int *h ) const { DoGetSize(w, h); } |
| 296 | wxSize GetSize() const |
| 297 | { |
| 298 | int w, h; |
| 299 | DoGetSize(& w, & h); |
| 300 | return wxSize(w, h); |
| 301 | } |
| 302 | |
| 303 | void GetClientSize( int *w, int *h ) const { DoGetClientSize(w, h); } |
| 304 | wxSize GetClientSize() const |
| 305 | { |
| 306 | int w, h; |
| 307 | DoGetClientSize(&w, &h); |
| 308 | |
| 309 | return wxSize(w, h); |
| 310 | } |
| 311 | |
| 312 | // get the position and size at once |
| 313 | wxRect GetRect() const |
| 314 | { |
| 315 | int x, y, w, h; |
| 316 | GetPosition(&x, &y); |
| 317 | GetSize(&w, &h); |
| 318 | |
| 319 | return wxRect(x, y, w, h); |
| 320 | } |
| 321 | |
| 322 | wxRect GetScreenRect() const |
| 323 | { |
| 324 | int x, y, w, h; |
| 325 | GetScreenPosition(&x, &y); |
| 326 | GetSize(&w, &h); |
| 327 | |
| 328 | return wxRect(x, y, w, h); |
| 329 | } |
| 330 | |
| 331 | // get the origin of the client area of the window relative to the |
| 332 | // window top left corner (the client area may be shifted because of |
| 333 | // the borders, scrollbars, other decorations...) |
| 334 | virtual wxPoint GetClientAreaOrigin() const; |
| 335 | |
| 336 | // get the client rectangle in window (i.e. client) coordinates |
| 337 | wxRect GetClientRect() const |
| 338 | { |
| 339 | return wxRect(GetClientAreaOrigin(), GetClientSize()); |
| 340 | } |
| 341 | |
| 342 | // get the size best suited for the window (in fact, minimal |
| 343 | // acceptable size using which it will still look "nice" in |
| 344 | // most situations) |
| 345 | wxSize GetBestSize() const |
| 346 | { |
| 347 | if (m_bestSizeCache.IsFullySpecified()) |
| 348 | return m_bestSizeCache; |
| 349 | return DoGetBestSize(); |
| 350 | } |
| 351 | void GetBestSize(int *w, int *h) const |
| 352 | { |
| 353 | wxSize s = GetBestSize(); |
| 354 | if ( w ) |
| 355 | *w = s.x; |
| 356 | if ( h ) |
| 357 | *h = s.y; |
| 358 | } |
| 359 | |
| 360 | void SetScrollHelper( wxScrollHelper *sh ) { m_scrollHelper = sh; } |
| 361 | wxScrollHelper *GetScrollHelper() { return m_scrollHelper; } |
| 362 | |
| 363 | // reset the cached best size value so it will be recalculated the |
| 364 | // next time it is needed. |
| 365 | void InvalidateBestSize(); |
| 366 | void CacheBestSize(const wxSize& size) const |
| 367 | { wxConstCast(this, wxWindowBase)->m_bestSizeCache = size; } |
| 368 | |
| 369 | |
| 370 | // This function will merge the window's best size into the window's |
| 371 | // minimum size, giving priority to the min size components, and |
| 372 | // returns the results. |
| 373 | wxSize GetEffectiveMinSize() const; |
| 374 | wxDEPRECATED( wxSize GetBestFittingSize() const ); // replaced by GetEffectiveMinSize |
| 375 | wxDEPRECATED( wxSize GetAdjustedMinSize() const ); // replaced by GetEffectiveMinSize |
| 376 | |
| 377 | // A 'Smart' SetSize that will fill in default size values with 'best' |
| 378 | // size. Sets the minsize to what was passed in. |
| 379 | void SetInitialSize(const wxSize& size=wxDefaultSize); |
| 380 | wxDEPRECATED( void SetBestFittingSize(const wxSize& size=wxDefaultSize) ); // replaced by SetInitialSize |
| 381 | |
| 382 | |
| 383 | // the generic centre function - centers the window on parent by` |
| 384 | // default or on screen if it doesn't have parent or |
| 385 | // wxCENTER_ON_SCREEN flag is given |
| 386 | void Centre(int dir = wxBOTH) { DoCentre(dir); } |
| 387 | void Center(int dir = wxBOTH) { DoCentre(dir); } |
| 388 | |
| 389 | // centre with respect to the the parent window |
| 390 | void CentreOnParent(int dir = wxBOTH) { DoCentre(dir); } |
| 391 | void CenterOnParent(int dir = wxBOTH) { CentreOnParent(dir); } |
| 392 | |
| 393 | // set window size to wrap around its children |
| 394 | virtual void Fit(); |
| 395 | |
| 396 | // set virtual size to satisfy children |
| 397 | virtual void FitInside(); |
| 398 | |
| 399 | |
| 400 | // SetSizeHints is actually for setting the size hints |
| 401 | // for the wxTLW for a Window Manager - hence the name - |
| 402 | // and it is therefore overridden in wxTLW to do that. |
| 403 | // In wxWindow(Base), it has (unfortunately) been abused |
| 404 | // to mean the same as SetMinSize() and SetMaxSize(). |
| 405 | |
| 406 | virtual void SetSizeHints( int minW, int minH, |
| 407 | int maxW = wxDefaultCoord, int maxH = wxDefaultCoord, |
| 408 | int incW = wxDefaultCoord, int incH = wxDefaultCoord ) |
| 409 | { DoSetSizeHints(minW, minH, maxW, maxH, incW, incH); } |
| 410 | |
| 411 | void SetSizeHints( const wxSize& minSize, |
| 412 | const wxSize& maxSize=wxDefaultSize, |
| 413 | const wxSize& incSize=wxDefaultSize) |
| 414 | { DoSetSizeHints(minSize.x, minSize.y, maxSize.x, maxSize.y, incSize.x, incSize.y); } |
| 415 | |
| 416 | virtual void DoSetSizeHints( int minW, int minH, |
| 417 | int maxW, int maxH, |
| 418 | int incW, int incH ); |
| 419 | |
| 420 | // Methods for setting virtual size hints |
| 421 | // FIXME: What are virtual size hints? |
| 422 | |
| 423 | virtual void SetVirtualSizeHints( int minW, int minH, |
| 424 | int maxW = wxDefaultCoord, int maxH = wxDefaultCoord ); |
| 425 | void SetVirtualSizeHints( const wxSize& minSize, |
| 426 | const wxSize& maxSize=wxDefaultSize) |
| 427 | { |
| 428 | SetVirtualSizeHints(minSize.x, minSize.y, maxSize.x, maxSize.y); |
| 429 | } |
| 430 | |
| 431 | |
| 432 | // Call these to override what GetBestSize() returns. This |
| 433 | // method is only virtual because it is overriden in wxTLW |
| 434 | // as a different API for SetSizeHints(). |
| 435 | virtual void SetMinSize(const wxSize& minSize) { m_minWidth = minSize.x; m_minHeight = minSize.y; } |
| 436 | virtual void SetMaxSize(const wxSize& maxSize) { m_maxWidth = maxSize.x; m_maxHeight = maxSize.y; } |
| 437 | |
| 438 | // Override these methods to impose restrictions on min/max size. |
| 439 | // The easier way is to call SetMinSize() and SetMaxSize() which |
| 440 | // will have the same effect. Doing both is non-sense. |
| 441 | virtual wxSize GetMinSize() const { return wxSize(m_minWidth, m_minHeight); } |
| 442 | virtual wxSize GetMaxSize() const { return wxSize(m_maxWidth, m_maxHeight); } |
| 443 | |
| 444 | // Get the min and max values one by one |
| 445 | int GetMinWidth() const { return GetMinSize().x; } |
| 446 | int GetMinHeight() const { return GetMinSize().y; } |
| 447 | int GetMaxWidth() const { return GetMaxSize().x; } |
| 448 | int GetMaxHeight() const { return GetMaxSize().y; } |
| 449 | |
| 450 | |
| 451 | // Methods for accessing the virtual size of a window. For most |
| 452 | // windows this is just the client area of the window, but for |
| 453 | // some like scrolled windows it is more or less independent of |
| 454 | // the screen window size. You may override the DoXXXVirtual |
| 455 | // methods below for classes where that is is the case. |
| 456 | |
| 457 | void SetVirtualSize( const wxSize &size ) { DoSetVirtualSize( size.x, size.y ); } |
| 458 | void SetVirtualSize( int x, int y ) { DoSetVirtualSize( x, y ); } |
| 459 | |
| 460 | wxSize GetVirtualSize() const { return DoGetVirtualSize(); } |
| 461 | void GetVirtualSize( int *x, int *y ) const |
| 462 | { |
| 463 | wxSize s( DoGetVirtualSize() ); |
| 464 | |
| 465 | if( x ) |
| 466 | *x = s.GetWidth(); |
| 467 | if( y ) |
| 468 | *y = s.GetHeight(); |
| 469 | } |
| 470 | |
| 471 | // Override these methods for windows that have a virtual size |
| 472 | // independent of their client size. eg. the virtual area of a |
| 473 | // wxScrolledWindow. |
| 474 | |
| 475 | virtual void DoSetVirtualSize( int x, int y ); |
| 476 | virtual wxSize DoGetVirtualSize() const; |
| 477 | |
| 478 | // Return the largest of ClientSize and BestSize (as determined |
| 479 | // by a sizer, interior children, or other means) |
| 480 | |
| 481 | virtual wxSize GetBestVirtualSize() const |
| 482 | { |
| 483 | wxSize client( GetClientSize() ); |
| 484 | wxSize best( GetBestSize() ); |
| 485 | |
| 486 | return wxSize( wxMax( client.x, best.x ), wxMax( client.y, best.y ) ); |
| 487 | } |
| 488 | |
| 489 | // return the size of the left/right and top/bottom borders in x and y |
| 490 | // components of the result respectively |
| 491 | virtual wxSize GetWindowBorderSize() const; |
| 492 | |
| 493 | |
| 494 | // window state |
| 495 | // ------------ |
| 496 | |
| 497 | // returns true if window was shown/hidden, false if the nothing was |
| 498 | // done (window was already shown/hidden) |
| 499 | virtual bool Show( bool show = true ); |
| 500 | bool Hide() { return Show(false); } |
| 501 | |
| 502 | // returns true if window was enabled/disabled, false if nothing done |
| 503 | virtual bool Enable( bool enable = true ); |
| 504 | bool Disable() { return Enable(false); } |
| 505 | |
| 506 | virtual bool IsShown() const { return m_isShown; } |
| 507 | // returns true if the window is really enabled and false otherwise, |
| 508 | // whether because it had been explicitly disabled itself or because |
| 509 | // its parent is currently disabled -- then this method returns false |
| 510 | // whatever is the intrinsic state of this window, use IsThisEnabled(0 |
| 511 | // to retrieve it. In other words, this relation always holds: |
| 512 | // |
| 513 | // IsEnabled() == IsThisEnabled() && parent.IsEnabled() |
| 514 | // |
| 515 | bool IsEnabled() const; |
| 516 | |
| 517 | // returns the internal window state independently of the parent(s) |
| 518 | // state, i.e. the state in which the window would be if all its |
| 519 | // parents were enabled (use IsEnabled() above to get the effective |
| 520 | // window state) |
| 521 | bool IsThisEnabled() const { return m_isEnabled; } |
| 522 | |
| 523 | // returns true if the window is visible, i.e. IsShown() returns true |
| 524 | // if called on it and all its parents up to the first TLW |
| 525 | virtual bool IsShownOnScreen() const; |
| 526 | |
| 527 | // get/set window style (setting style won't update the window and so |
| 528 | // is only useful for internal usage) |
| 529 | virtual void SetWindowStyleFlag( long style ) { m_windowStyle = style; } |
| 530 | virtual long GetWindowStyleFlag() const { return m_windowStyle; } |
| 531 | |
| 532 | // just some (somewhat shorter) synonims |
| 533 | void SetWindowStyle( long style ) { SetWindowStyleFlag(style); } |
| 534 | long GetWindowStyle() const { return GetWindowStyleFlag(); } |
| 535 | |
| 536 | // check if the flag is set |
| 537 | bool HasFlag(int flag) const { return (m_windowStyle & flag) != 0; } |
| 538 | virtual bool IsRetained() const { return HasFlag(wxRETAINED); } |
| 539 | |
| 540 | // turn the flag on if it had been turned off before and vice versa, |
| 541 | // return true if the flag is currently turned on |
| 542 | bool ToggleWindowStyle(int flag); |
| 543 | |
| 544 | // extra style: the less often used style bits which can't be set with |
| 545 | // SetWindowStyleFlag() |
| 546 | virtual void SetExtraStyle(long exStyle) { m_exStyle = exStyle; } |
| 547 | long GetExtraStyle() const { return m_exStyle; } |
| 548 | |
| 549 | bool HasExtraStyle(int exFlag) const { return (m_exStyle & exFlag) != 0; } |
| 550 | |
| 551 | // make the window modal (all other windows unresponsive) |
| 552 | virtual void MakeModal(bool modal = true); |
| 553 | |
| 554 | |
| 555 | // (primitive) theming support |
| 556 | // --------------------------- |
| 557 | |
| 558 | virtual void SetThemeEnabled(bool enableTheme) { m_themeEnabled = enableTheme; } |
| 559 | virtual bool GetThemeEnabled() const { return m_themeEnabled; } |
| 560 | |
| 561 | |
| 562 | // focus and keyboard handling |
| 563 | // --------------------------- |
| 564 | |
| 565 | // set focus to this window |
| 566 | virtual void SetFocus() = 0; |
| 567 | |
| 568 | // set focus to this window as the result of a keyboard action |
| 569 | virtual void SetFocusFromKbd() { SetFocus(); } |
| 570 | |
| 571 | // return the window which currently has the focus or NULL |
| 572 | static wxWindow *FindFocus(); |
| 573 | |
| 574 | static wxWindow *DoFindFocus() /* = 0: implement in derived classes */; |
| 575 | |
| 576 | // can this window have focus in principle? |
| 577 | // |
| 578 | // the difference between AcceptsFocus[FromKeyboard]() and CanAcceptFocus |
| 579 | // [FromKeyboard]() is that the former functions are meant to be |
| 580 | // overridden in the derived classes to simply return false if the |
| 581 | // control can't have focus, while the latter are meant to be used by |
| 582 | // this class clients and take into account the current window state |
| 583 | virtual bool AcceptsFocus() const { return true; } |
| 584 | |
| 585 | // can this window or one of its children accept focus? |
| 586 | // |
| 587 | // usually it's the same as AcceptsFocus() but is overridden for |
| 588 | // container windows |
| 589 | virtual bool AcceptsFocusRecursively() const { return AcceptsFocus(); } |
| 590 | |
| 591 | // can this window be given focus by keyboard navigation? if not, the |
| 592 | // only way to give it focus (provided it accepts it at all) is to |
| 593 | // click it |
| 594 | virtual bool AcceptsFocusFromKeyboard() const { return AcceptsFocus(); } |
| 595 | |
| 596 | |
| 597 | // this is mostly a helper for the various functions using it below |
| 598 | bool CanBeFocused() const { return IsShown() && IsEnabled(); } |
| 599 | |
| 600 | // can this window itself have focus? |
| 601 | bool IsFocusable() const { return AcceptsFocus() && CanBeFocused(); } |
| 602 | |
| 603 | // can this window have focus right now? |
| 604 | // |
| 605 | // if this method returns true, it means that calling SetFocus() will |
| 606 | // put focus either to this window or one of its children, if you need |
| 607 | // to know whether this window accepts focus itself, use IsFocusable() |
| 608 | bool CanAcceptFocus() const |
| 609 | { return AcceptsFocusRecursively() && CanBeFocused(); } |
| 610 | |
| 611 | // can this window be assigned focus from keyboard right now? |
| 612 | bool CanAcceptFocusFromKeyboard() const |
| 613 | { return AcceptsFocusFromKeyboard() && CanBeFocused(); } |
| 614 | |
| 615 | // call this when the return value of AcceptsFocus() changes |
| 616 | virtual void SetCanFocus(bool WXUNUSED(canFocus)) { } |
| 617 | |
| 618 | // navigates inside this window |
| 619 | bool NavigateIn(int flags = wxNavigationKeyEvent::IsForward) |
| 620 | { return DoNavigateIn(flags); } |
| 621 | |
| 622 | // navigates in the specified direction from this window, this is |
| 623 | // equivalent to GetParent()->NavigateIn() |
| 624 | bool Navigate(int flags = wxNavigationKeyEvent::IsForward) |
| 625 | { return m_parent && ((wxWindowBase *)m_parent)->DoNavigateIn(flags); } |
| 626 | |
| 627 | // move this window just before/after the specified one in tab order |
| 628 | // (the other window must be our sibling!) |
| 629 | void MoveBeforeInTabOrder(wxWindow *win) |
| 630 | { DoMoveInTabOrder(win, MoveBefore); } |
| 631 | void MoveAfterInTabOrder(wxWindow *win) |
| 632 | { DoMoveInTabOrder(win, MoveAfter); } |
| 633 | |
| 634 | |
| 635 | // parent/children relations |
| 636 | // ------------------------- |
| 637 | |
| 638 | // get the list of children |
| 639 | const wxWindowList& GetChildren() const { return m_children; } |
| 640 | wxWindowList& GetChildren() { return m_children; } |
| 641 | |
| 642 | // needed just for extended runtime |
| 643 | const wxWindowList& GetWindowChildren() const { return GetChildren() ; } |
| 644 | |
| 645 | // get the parent or the parent of the parent |
| 646 | wxWindow *GetParent() const { return m_parent; } |
| 647 | inline wxWindow *GetGrandParent() const; |
| 648 | |
| 649 | // is this window a top level one? |
| 650 | virtual bool IsTopLevel() const; |
| 651 | |
| 652 | // it doesn't really change parent, use Reparent() instead |
| 653 | void SetParent( wxWindowBase *parent ) { m_parent = (wxWindow *)parent; } |
| 654 | // change the real parent of this window, return true if the parent |
| 655 | // was changed, false otherwise (error or newParent == oldParent) |
| 656 | virtual bool Reparent( wxWindowBase *newParent ); |
| 657 | |
| 658 | // implementation mostly |
| 659 | virtual void AddChild( wxWindowBase *child ); |
| 660 | virtual void RemoveChild( wxWindowBase *child ); |
| 661 | |
| 662 | // returns true if the child is in the client area of the window, i.e. is |
| 663 | // not scrollbar, toolbar etc. |
| 664 | virtual bool IsClientAreaChild(const wxWindow *WXUNUSED(child)) const |
| 665 | { return true; } |
| 666 | |
| 667 | // looking for windows |
| 668 | // ------------------- |
| 669 | |
| 670 | // find window among the descendants of this one either by id or by |
| 671 | // name (return NULL if not found) |
| 672 | wxWindow *FindWindow(long winid) const; |
| 673 | wxWindow *FindWindow(const wxString& name) const; |
| 674 | |
| 675 | // Find a window among any window (all return NULL if not found) |
| 676 | static wxWindow *FindWindowById( long winid, const wxWindow *parent = NULL ); |
| 677 | static wxWindow *FindWindowByName( const wxString& name, |
| 678 | const wxWindow *parent = NULL ); |
| 679 | static wxWindow *FindWindowByLabel( const wxString& label, |
| 680 | const wxWindow *parent = NULL ); |
| 681 | |
| 682 | // event handler stuff |
| 683 | // ------------------- |
| 684 | |
| 685 | // get the current event handler |
| 686 | wxEvtHandler *GetEventHandler() const { return m_eventHandler; } |
| 687 | |
| 688 | // replace the event handler (allows to completely subclass the |
| 689 | // window) |
| 690 | void SetEventHandler( wxEvtHandler *handler ) { m_eventHandler = handler; } |
| 691 | |
| 692 | // push/pop event handler: allows to chain a custom event handler to |
| 693 | // alreasy existing ones |
| 694 | void PushEventHandler( wxEvtHandler *handler ); |
| 695 | wxEvtHandler *PopEventHandler( bool deleteHandler = false ); |
| 696 | |
| 697 | // find the given handler in the event handler chain and remove (but |
| 698 | // not delete) it from the event handler chain, return true if it was |
| 699 | // found and false otherwise (this also results in an assert failure so |
| 700 | // this function should only be called when the handler is supposed to |
| 701 | // be there) |
| 702 | bool RemoveEventHandler(wxEvtHandler *handler); |
| 703 | |
| 704 | // validators |
| 705 | // ---------- |
| 706 | |
| 707 | #if wxUSE_VALIDATORS |
| 708 | // a window may have an associated validator which is used to control |
| 709 | // user input |
| 710 | virtual void SetValidator( const wxValidator &validator ); |
| 711 | virtual wxValidator *GetValidator() { return m_windowValidator; } |
| 712 | #endif // wxUSE_VALIDATORS |
| 713 | |
| 714 | |
| 715 | // dialog oriented functions |
| 716 | // ------------------------- |
| 717 | |
| 718 | // validate the correctness of input, return true if ok |
| 719 | virtual bool Validate(); |
| 720 | |
| 721 | // transfer data between internal and GUI representations |
| 722 | virtual bool TransferDataToWindow(); |
| 723 | virtual bool TransferDataFromWindow(); |
| 724 | |
| 725 | virtual void InitDialog(); |
| 726 | |
| 727 | #if wxUSE_ACCEL |
| 728 | // accelerators |
| 729 | // ------------ |
| 730 | virtual void SetAcceleratorTable( const wxAcceleratorTable& accel ) |
| 731 | { m_acceleratorTable = accel; } |
| 732 | wxAcceleratorTable *GetAcceleratorTable() |
| 733 | { return &m_acceleratorTable; } |
| 734 | |
| 735 | #endif // wxUSE_ACCEL |
| 736 | |
| 737 | #if wxUSE_HOTKEY |
| 738 | // hot keys (system wide accelerators) |
| 739 | // ----------------------------------- |
| 740 | |
| 741 | virtual bool RegisterHotKey(int hotkeyId, int modifiers, int keycode); |
| 742 | virtual bool UnregisterHotKey(int hotkeyId); |
| 743 | #endif // wxUSE_HOTKEY |
| 744 | |
| 745 | |
| 746 | // dialog units translations |
| 747 | // ------------------------- |
| 748 | |
| 749 | wxPoint ConvertPixelsToDialog( const wxPoint& pt ); |
| 750 | wxPoint ConvertDialogToPixels( const wxPoint& pt ); |
| 751 | wxSize ConvertPixelsToDialog( const wxSize& sz ) |
| 752 | { |
| 753 | wxPoint pt(ConvertPixelsToDialog(wxPoint(sz.x, sz.y))); |
| 754 | |
| 755 | return wxSize(pt.x, pt.y); |
| 756 | } |
| 757 | |
| 758 | wxSize ConvertDialogToPixels( const wxSize& sz ) |
| 759 | { |
| 760 | wxPoint pt(ConvertDialogToPixels(wxPoint(sz.x, sz.y))); |
| 761 | |
| 762 | return wxSize(pt.x, pt.y); |
| 763 | } |
| 764 | |
| 765 | // mouse functions |
| 766 | // --------------- |
| 767 | |
| 768 | // move the mouse to the specified position |
| 769 | virtual void WarpPointer(int x, int y) = 0; |
| 770 | |
| 771 | // start or end mouse capture, these functions maintain the stack of |
| 772 | // windows having captured the mouse and after calling ReleaseMouse() |
| 773 | // the mouse is not released but returns to the window which had had |
| 774 | // captured it previously (if any) |
| 775 | void CaptureMouse(); |
| 776 | void ReleaseMouse(); |
| 777 | |
| 778 | // get the window which currently captures the mouse or NULL |
| 779 | static wxWindow *GetCapture(); |
| 780 | |
| 781 | // does this window have the capture? |
| 782 | virtual bool HasCapture() const |
| 783 | { return (wxWindow *)this == GetCapture(); } |
| 784 | |
| 785 | // painting the window |
| 786 | // ------------------- |
| 787 | |
| 788 | // mark the specified rectangle (or the whole window) as "dirty" so it |
| 789 | // will be repainted |
| 790 | virtual void Refresh( bool eraseBackground = true, |
| 791 | const wxRect *rect = (const wxRect *) NULL ) = 0; |
| 792 | |
| 793 | // a less awkward wrapper for Refresh |
| 794 | void RefreshRect(const wxRect& rect, bool eraseBackground = true) |
| 795 | { |
| 796 | Refresh(eraseBackground, &rect); |
| 797 | } |
| 798 | |
| 799 | // repaint all invalid areas of the window immediately |
| 800 | virtual void Update() { } |
| 801 | |
| 802 | // clear the window background |
| 803 | virtual void ClearBackground(); |
| 804 | |
| 805 | // freeze the window: don't redraw it until it is thawed |
| 806 | virtual void Freeze() { } |
| 807 | |
| 808 | // thaw the window: redraw it after it had been frozen |
| 809 | virtual void Thaw() { } |
| 810 | |
| 811 | // return true if window had been frozen and not unthawed yet |
| 812 | virtual bool IsFrozen() const { return false; } |
| 813 | |
| 814 | // adjust DC for drawing on this window |
| 815 | virtual void PrepareDC( wxDC & WXUNUSED(dc) ) { } |
| 816 | |
| 817 | // return true if the window contents is double buffered by the system |
| 818 | virtual bool IsDoubleBuffered() const { return false; } |
| 819 | |
| 820 | // the update region of the window contains the areas which must be |
| 821 | // repainted by the program |
| 822 | const wxRegion& GetUpdateRegion() const { return m_updateRegion; } |
| 823 | wxRegion& GetUpdateRegion() { return m_updateRegion; } |
| 824 | |
| 825 | // get the update rectangleregion bounding box in client coords |
| 826 | wxRect GetUpdateClientRect() const; |
| 827 | |
| 828 | // these functions verify whether the given point/rectangle belongs to |
| 829 | // (or at least intersects with) the update region |
| 830 | virtual bool DoIsExposed( int x, int y ) const; |
| 831 | virtual bool DoIsExposed( int x, int y, int w, int h ) const; |
| 832 | |
| 833 | bool IsExposed( int x, int y ) const |
| 834 | { return DoIsExposed(x, y); } |
| 835 | bool IsExposed( int x, int y, int w, int h ) const |
| 836 | { return DoIsExposed(x, y, w, h); } |
| 837 | bool IsExposed( const wxPoint& pt ) const |
| 838 | { return DoIsExposed(pt.x, pt.y); } |
| 839 | bool IsExposed( const wxRect& rect ) const |
| 840 | { return DoIsExposed(rect.x, rect.y, rect.width, rect.height); } |
| 841 | |
| 842 | // colours, fonts and cursors |
| 843 | // -------------------------- |
| 844 | |
| 845 | // get the default attributes for the controls of this class: we |
| 846 | // provide a virtual function which can be used to query the default |
| 847 | // attributes of an existing control and a static function which can |
| 848 | // be used even when no existing object of the given class is |
| 849 | // available, but which won't return any styles specific to this |
| 850 | // particular control, of course (e.g. "Ok" button might have |
| 851 | // different -- bold for example -- font) |
| 852 | virtual wxVisualAttributes GetDefaultAttributes() const |
| 853 | { |
| 854 | return GetClassDefaultAttributes(GetWindowVariant()); |
| 855 | } |
| 856 | |
| 857 | static wxVisualAttributes |
| 858 | GetClassDefaultAttributes(wxWindowVariant variant = wxWINDOW_VARIANT_NORMAL); |
| 859 | |
| 860 | // set/retrieve the window colours (system defaults are used by |
| 861 | // default): SetXXX() functions return true if colour was changed, |
| 862 | // SetDefaultXXX() reset the "m_inheritXXX" flag after setting the |
| 863 | // value to prevent it from being inherited by our children |
| 864 | virtual bool SetBackgroundColour(const wxColour& colour); |
| 865 | void SetOwnBackgroundColour(const wxColour& colour) |
| 866 | { |
| 867 | if ( SetBackgroundColour(colour) ) |
| 868 | m_inheritBgCol = false; |
| 869 | } |
| 870 | wxColour GetBackgroundColour() const; |
| 871 | bool InheritsBackgroundColour() const |
| 872 | { |
| 873 | return m_inheritBgCol; |
| 874 | } |
| 875 | bool UseBgCol() const |
| 876 | { |
| 877 | return m_hasBgCol; |
| 878 | } |
| 879 | |
| 880 | virtual bool SetForegroundColour(const wxColour& colour); |
| 881 | void SetOwnForegroundColour(const wxColour& colour) |
| 882 | { |
| 883 | if ( SetForegroundColour(colour) ) |
| 884 | m_inheritFgCol = false; |
| 885 | } |
| 886 | wxColour GetForegroundColour() const; |
| 887 | |
| 888 | // Set/get the background style. |
| 889 | // Pass one of wxBG_STYLE_SYSTEM, wxBG_STYLE_COLOUR, wxBG_STYLE_CUSTOM |
| 890 | virtual bool SetBackgroundStyle(wxBackgroundStyle style) { m_backgroundStyle = style; return true; } |
| 891 | virtual wxBackgroundStyle GetBackgroundStyle() const { return m_backgroundStyle; } |
| 892 | |
| 893 | // returns true if the control has "transparent" areas such as a |
| 894 | // wxStaticText and wxCheckBox and the background should be adapted |
| 895 | // from a parent window |
| 896 | virtual bool HasTransparentBackground() { return false; } |
| 897 | |
| 898 | // set/retrieve the font for the window (SetFont() returns true if the |
| 899 | // font really changed) |
| 900 | virtual bool SetFont(const wxFont& font) = 0; |
| 901 | void SetOwnFont(const wxFont& font) |
| 902 | { |
| 903 | if ( SetFont(font) ) |
| 904 | m_inheritFont = false; |
| 905 | } |
| 906 | wxFont GetFont() const; |
| 907 | |
| 908 | // set/retrieve the cursor for this window (SetCursor() returns true |
| 909 | // if the cursor was really changed) |
| 910 | virtual bool SetCursor( const wxCursor &cursor ); |
| 911 | const wxCursor& GetCursor() const { return m_cursor; } |
| 912 | |
| 913 | #if wxUSE_CARET |
| 914 | // associate a caret with the window |
| 915 | void SetCaret(wxCaret *caret); |
| 916 | // get the current caret (may be NULL) |
| 917 | wxCaret *GetCaret() const { return m_caret; } |
| 918 | #endif // wxUSE_CARET |
| 919 | |
| 920 | // get the (average) character size for the current font |
| 921 | virtual int GetCharHeight() const = 0; |
| 922 | virtual int GetCharWidth() const = 0; |
| 923 | |
| 924 | // get the width/height/... of the text using current or specified |
| 925 | // font |
| 926 | virtual void GetTextExtent(const wxString& string, |
| 927 | int *x, int *y, |
| 928 | int *descent = (int *) NULL, |
| 929 | int *externalLeading = (int *) NULL, |
| 930 | const wxFont *theFont = (const wxFont *) NULL) |
| 931 | const = 0; |
| 932 | |
| 933 | wxSize GetTextExtent(const wxString& string) const |
| 934 | { |
| 935 | wxCoord w, h; |
| 936 | GetTextExtent(string, &w, &h); |
| 937 | return wxSize(w, h); |
| 938 | } |
| 939 | |
| 940 | // client <-> screen coords |
| 941 | // ------------------------ |
| 942 | |
| 943 | // translate to/from screen/client coordinates (pointers may be NULL) |
| 944 | void ClientToScreen( int *x, int *y ) const |
| 945 | { DoClientToScreen(x, y); } |
| 946 | void ScreenToClient( int *x, int *y ) const |
| 947 | { DoScreenToClient(x, y); } |
| 948 | |
| 949 | // wxPoint interface to do the same thing |
| 950 | wxPoint ClientToScreen(const wxPoint& pt) const |
| 951 | { |
| 952 | int x = pt.x, y = pt.y; |
| 953 | DoClientToScreen(&x, &y); |
| 954 | |
| 955 | return wxPoint(x, y); |
| 956 | } |
| 957 | |
| 958 | wxPoint ScreenToClient(const wxPoint& pt) const |
| 959 | { |
| 960 | int x = pt.x, y = pt.y; |
| 961 | DoScreenToClient(&x, &y); |
| 962 | |
| 963 | return wxPoint(x, y); |
| 964 | } |
| 965 | |
| 966 | // test where the given (in client coords) point lies |
| 967 | wxHitTest HitTest(wxCoord x, wxCoord y) const |
| 968 | { return DoHitTest(x, y); } |
| 969 | |
| 970 | wxHitTest HitTest(const wxPoint& pt) const |
| 971 | { return DoHitTest(pt.x, pt.y); } |
| 972 | |
| 973 | // misc |
| 974 | // ---- |
| 975 | |
| 976 | // get the window border style from the given flags: this is different from |
| 977 | // simply doing flags & wxBORDER_MASK because it uses GetDefaultBorder() to |
| 978 | // translate wxBORDER_DEFAULT to something reasonable |
| 979 | wxBorder GetBorder(long flags) const; |
| 980 | |
| 981 | // get border for the flags of this window |
| 982 | wxBorder GetBorder() const { return GetBorder(GetWindowStyleFlag()); } |
| 983 | |
| 984 | // send wxUpdateUIEvents to this window, and children if recurse is true |
| 985 | virtual void UpdateWindowUI(long flags = wxUPDATE_UI_NONE); |
| 986 | |
| 987 | // do the window-specific processing after processing the update event |
| 988 | virtual void DoUpdateWindowUI(wxUpdateUIEvent& event) ; |
| 989 | |
| 990 | #if wxUSE_MENUS |
| 991 | // show popup menu at the given position, generate events for the items |
| 992 | // selected in it |
| 993 | bool PopupMenu(wxMenu *menu, const wxPoint& pos = wxDefaultPosition) |
| 994 | { return DoPopupMenu(menu, pos.x, pos.y); } |
| 995 | bool PopupMenu(wxMenu *menu, int x, int y) |
| 996 | { return DoPopupMenu(menu, x, y); } |
| 997 | |
| 998 | // simply return the id of the selected item or wxID_NONE without |
| 999 | // generating any events |
| 1000 | int GetPopupMenuSelectionFromUser(wxMenu& menu, const wxPoint& pos) |
| 1001 | { return DoGetPopupMenuSelectionFromUser(menu, pos.x, pos.y); } |
| 1002 | int GetPopupMenuSelectionFromUser(wxMenu& menu, int x, int y) |
| 1003 | { return DoGetPopupMenuSelectionFromUser(menu, x, y); } |
| 1004 | #endif // wxUSE_MENUS |
| 1005 | |
| 1006 | // override this method to return true for controls having multiple pages |
| 1007 | virtual bool HasMultiplePages() const { return false; } |
| 1008 | |
| 1009 | |
| 1010 | // scrollbars |
| 1011 | // ---------- |
| 1012 | |
| 1013 | // does the window have the scrollbar for this orientation? |
| 1014 | bool HasScrollbar(int orient) const |
| 1015 | { |
| 1016 | return (m_windowStyle & |
| 1017 | (orient == wxHORIZONTAL ? wxHSCROLL : wxVSCROLL)) != 0; |
| 1018 | } |
| 1019 | |
| 1020 | // configure the window scrollbars |
| 1021 | virtual void SetScrollbar( int orient, |
| 1022 | int pos, |
| 1023 | int thumbvisible, |
| 1024 | int range, |
| 1025 | bool refresh = true ) = 0; |
| 1026 | virtual void SetScrollPos( int orient, int pos, bool refresh = true ) = 0; |
| 1027 | virtual int GetScrollPos( int orient ) const = 0; |
| 1028 | virtual int GetScrollThumb( int orient ) const = 0; |
| 1029 | virtual int GetScrollRange( int orient ) const = 0; |
| 1030 | |
| 1031 | // scroll window to the specified position |
| 1032 | virtual void ScrollWindow( int dx, int dy, |
| 1033 | const wxRect* rect = (wxRect *) NULL ) = 0; |
| 1034 | |
| 1035 | // scrolls window by line/page: note that not all controls support this |
| 1036 | // |
| 1037 | // return true if the position changed, false otherwise |
| 1038 | virtual bool ScrollLines(int WXUNUSED(lines)) { return false; } |
| 1039 | virtual bool ScrollPages(int WXUNUSED(pages)) { return false; } |
| 1040 | |
| 1041 | // convenient wrappers for ScrollLines/Pages |
| 1042 | bool LineUp() { return ScrollLines(-1); } |
| 1043 | bool LineDown() { return ScrollLines(1); } |
| 1044 | bool PageUp() { return ScrollPages(-1); } |
| 1045 | bool PageDown() { return ScrollPages(1); } |
| 1046 | |
| 1047 | // context-sensitive help |
| 1048 | // ---------------------- |
| 1049 | |
| 1050 | // these are the convenience functions wrapping wxHelpProvider methods |
| 1051 | |
| 1052 | #if wxUSE_HELP |
| 1053 | // associate this help text with this window |
| 1054 | void SetHelpText(const wxString& text); |
| 1055 | // associate this help text with all windows with the same id as this |
| 1056 | // one |
| 1057 | void SetHelpTextForId(const wxString& text); |
| 1058 | // get the help string associated with the given position in this window |
| 1059 | // |
| 1060 | // notice that pt may be invalid if event origin is keyboard or unknown |
| 1061 | // and this method should return the global window help text then |
| 1062 | virtual wxString GetHelpTextAtPoint(const wxPoint& pt, |
| 1063 | wxHelpEvent::Origin origin) const; |
| 1064 | // returns the position-independent help text |
| 1065 | wxString GetHelpText() const |
| 1066 | { |
| 1067 | return GetHelpTextAtPoint(wxDefaultPosition, wxHelpEvent::Origin_Unknown); |
| 1068 | } |
| 1069 | |
| 1070 | #else // !wxUSE_HELP |
| 1071 | // silently ignore SetHelpText() calls |
| 1072 | void SetHelpText(const wxString& WXUNUSED(text)) { } |
| 1073 | void SetHelpTextForId(const wxString& WXUNUSED(text)) { } |
| 1074 | #endif // wxUSE_HELP |
| 1075 | |
| 1076 | // tooltips |
| 1077 | // -------- |
| 1078 | |
| 1079 | #if wxUSE_TOOLTIPS |
| 1080 | // the easiest way to set a tooltip for a window is to use this method |
| 1081 | void SetToolTip( const wxString &tip ); |
| 1082 | // attach a tooltip to the window |
| 1083 | void SetToolTip( wxToolTip *tip ) { DoSetToolTip(tip); } |
| 1084 | // get the associated tooltip or NULL if none |
| 1085 | wxToolTip* GetToolTip() const { return m_tooltip; } |
| 1086 | wxString GetToolTipText() const ; |
| 1087 | #else |
| 1088 | // make it much easier to compile apps in an environment |
| 1089 | // that doesn't support tooltips, such as PocketPC |
| 1090 | inline void SetToolTip( const wxString & WXUNUSED(tip) ) {} |
| 1091 | #endif // wxUSE_TOOLTIPS |
| 1092 | |
| 1093 | // drag and drop |
| 1094 | // ------------- |
| 1095 | #if wxUSE_DRAG_AND_DROP |
| 1096 | // set/retrieve the drop target associated with this window (may be |
| 1097 | // NULL; it's owned by the window and will be deleted by it) |
| 1098 | virtual void SetDropTarget( wxDropTarget *dropTarget ) = 0; |
| 1099 | virtual wxDropTarget *GetDropTarget() const { return m_dropTarget; } |
| 1100 | #endif // wxUSE_DRAG_AND_DROP |
| 1101 | |
| 1102 | // constraints and sizers |
| 1103 | // ---------------------- |
| 1104 | #if wxUSE_CONSTRAINTS |
| 1105 | // set the constraints for this window or retrieve them (may be NULL) |
| 1106 | void SetConstraints( wxLayoutConstraints *constraints ); |
| 1107 | wxLayoutConstraints *GetConstraints() const { return m_constraints; } |
| 1108 | |
| 1109 | // implementation only |
| 1110 | void UnsetConstraints(wxLayoutConstraints *c); |
| 1111 | wxWindowList *GetConstraintsInvolvedIn() const |
| 1112 | { return m_constraintsInvolvedIn; } |
| 1113 | void AddConstraintReference(wxWindowBase *otherWin); |
| 1114 | void RemoveConstraintReference(wxWindowBase *otherWin); |
| 1115 | void DeleteRelatedConstraints(); |
| 1116 | void ResetConstraints(); |
| 1117 | |
| 1118 | // these methods may be overridden for special layout algorithms |
| 1119 | virtual void SetConstraintSizes(bool recurse = true); |
| 1120 | virtual bool LayoutPhase1(int *noChanges); |
| 1121 | virtual bool LayoutPhase2(int *noChanges); |
| 1122 | virtual bool DoPhase(int phase); |
| 1123 | |
| 1124 | // these methods are virtual but normally won't be overridden |
| 1125 | virtual void SetSizeConstraint(int x, int y, int w, int h); |
| 1126 | virtual void MoveConstraint(int x, int y); |
| 1127 | virtual void GetSizeConstraint(int *w, int *h) const ; |
| 1128 | virtual void GetClientSizeConstraint(int *w, int *h) const ; |
| 1129 | virtual void GetPositionConstraint(int *x, int *y) const ; |
| 1130 | |
| 1131 | #endif // wxUSE_CONSTRAINTS |
| 1132 | |
| 1133 | // when using constraints or sizers, it makes sense to update |
| 1134 | // children positions automatically whenever the window is resized |
| 1135 | // - this is done if autoLayout is on |
| 1136 | void SetAutoLayout( bool autoLayout ) { m_autoLayout = autoLayout; } |
| 1137 | bool GetAutoLayout() const { return m_autoLayout; } |
| 1138 | |
| 1139 | // lay out the window and its children |
| 1140 | virtual bool Layout(); |
| 1141 | |
| 1142 | // sizers |
| 1143 | void SetSizer(wxSizer *sizer, bool deleteOld = true ); |
| 1144 | void SetSizerAndFit( wxSizer *sizer, bool deleteOld = true ); |
| 1145 | |
| 1146 | wxSizer *GetSizer() const { return m_windowSizer; } |
| 1147 | |
| 1148 | // Track if this window is a member of a sizer |
| 1149 | void SetContainingSizer(wxSizer* sizer); |
| 1150 | wxSizer *GetContainingSizer() const { return m_containingSizer; } |
| 1151 | |
| 1152 | // accessibility |
| 1153 | // ---------------------- |
| 1154 | #if wxUSE_ACCESSIBILITY |
| 1155 | // Override to create a specific accessible object. |
| 1156 | virtual wxAccessible* CreateAccessible(); |
| 1157 | |
| 1158 | // Sets the accessible object. |
| 1159 | void SetAccessible(wxAccessible* accessible) ; |
| 1160 | |
| 1161 | // Returns the accessible object. |
| 1162 | wxAccessible* GetAccessible() { return m_accessible; } |
| 1163 | |
| 1164 | // Returns the accessible object, creating if necessary. |
| 1165 | wxAccessible* GetOrCreateAccessible() ; |
| 1166 | #endif |
| 1167 | |
| 1168 | |
| 1169 | // Set window transparency if the platform supports it |
| 1170 | virtual bool SetTransparent(wxByte WXUNUSED(alpha)) { return false; } |
| 1171 | virtual bool CanSetTransparent() { return false; } |
| 1172 | |
| 1173 | |
| 1174 | // implementation |
| 1175 | // -------------- |
| 1176 | |
| 1177 | // event handlers |
| 1178 | void OnSysColourChanged( wxSysColourChangedEvent& event ); |
| 1179 | void OnInitDialog( wxInitDialogEvent &event ); |
| 1180 | void OnMiddleClick( wxMouseEvent& event ); |
| 1181 | #if wxUSE_HELP |
| 1182 | void OnHelp(wxHelpEvent& event); |
| 1183 | #endif // wxUSE_HELP |
| 1184 | |
| 1185 | // virtual function for implementing internal idle |
| 1186 | // behaviour |
| 1187 | virtual void OnInternalIdle() {} |
| 1188 | |
| 1189 | // call internal idle recursively |
| 1190 | // void ProcessInternalIdle() ; |
| 1191 | |
| 1192 | // get the handle of the window for the underlying window system: this |
| 1193 | // is only used for wxWin itself or for user code which wants to call |
| 1194 | // platform-specific APIs |
| 1195 | virtual WXWidget GetHandle() const = 0; |
| 1196 | // associate the window with a new native handle |
| 1197 | virtual void AssociateHandle(WXWidget WXUNUSED(handle)) { } |
| 1198 | // dissociate the current native handle from the window |
| 1199 | virtual void DissociateHandle() { } |
| 1200 | |
| 1201 | #if wxUSE_PALETTE |
| 1202 | // Store the palette used by DCs in wxWindow so that the dcs can share |
| 1203 | // a palette. And we can respond to palette messages. |
| 1204 | wxPalette GetPalette() const { return m_palette; } |
| 1205 | |
| 1206 | // When palette is changed tell the DC to set the system palette to the |
| 1207 | // new one. |
| 1208 | void SetPalette(const wxPalette& pal); |
| 1209 | |
| 1210 | // return true if we have a specific palette |
| 1211 | bool HasCustomPalette() const { return m_hasCustomPalette; } |
| 1212 | |
| 1213 | // return the first parent window with a custom palette or NULL |
| 1214 | wxWindow *GetAncestorWithCustomPalette() const; |
| 1215 | #endif // wxUSE_PALETTE |
| 1216 | |
| 1217 | // inherit the parents visual attributes if they had been explicitly set |
| 1218 | // by the user (i.e. we don't inherit default attributes) and if we don't |
| 1219 | // have our own explicitly set |
| 1220 | virtual void InheritAttributes(); |
| 1221 | |
| 1222 | // returns false from here if this window doesn't want to inherit the |
| 1223 | // parents colours even if InheritAttributes() would normally do it |
| 1224 | // |
| 1225 | // this just provides a simple way to customize InheritAttributes() |
| 1226 | // behaviour in the most common case |
| 1227 | virtual bool ShouldInheritColours() const { return false; } |
| 1228 | |
| 1229 | // returns true if the window can be positioned outside of parent's client |
| 1230 | // area (normal windows can't, but e.g. menubar or statusbar can): |
| 1231 | virtual bool CanBeOutsideClientArea() const { return false; } |
| 1232 | |
| 1233 | // returns true if the platform should explicitly apply a theme border |
| 1234 | virtual bool CanApplyThemeBorder() const { return true; } |
| 1235 | |
| 1236 | protected: |
| 1237 | // event handling specific to wxWindow |
| 1238 | virtual bool TryValidator(wxEvent& event); |
| 1239 | virtual bool TryParent(wxEvent& event); |
| 1240 | |
| 1241 | // common part of MoveBefore/AfterInTabOrder() |
| 1242 | enum MoveKind |
| 1243 | { |
| 1244 | MoveBefore, // insert before the given window |
| 1245 | MoveAfter // insert after the given window |
| 1246 | }; |
| 1247 | virtual void DoMoveInTabOrder(wxWindow *win, MoveKind move); |
| 1248 | |
| 1249 | // implementation of Navigate() and NavigateIn() |
| 1250 | virtual bool DoNavigateIn(int flags); |
| 1251 | |
| 1252 | |
| 1253 | #if wxUSE_CONSTRAINTS |
| 1254 | // satisfy the constraints for the windows but don't set the window sizes |
| 1255 | void SatisfyConstraints(); |
| 1256 | #endif // wxUSE_CONSTRAINTS |
| 1257 | |
| 1258 | // Send the wxWindowDestroyEvent |
| 1259 | void SendDestroyEvent(); |
| 1260 | |
| 1261 | // returns the main window of composite control; this is the window |
| 1262 | // that FindFocus returns if the focus is in one of composite control's |
| 1263 | // windows |
| 1264 | virtual wxWindow *GetMainWindowOfCompositeControl() |
| 1265 | { return (wxWindow*)this; } |
| 1266 | |
| 1267 | // this method should be implemented to use operating system specific code |
| 1268 | // to really enable/disable the widget, it will only be called when we |
| 1269 | // really need to enable/disable window and so no additional checks on the |
| 1270 | // widgets state are necessary |
| 1271 | virtual void DoEnable(bool WXUNUSED(enable)) { } |
| 1272 | |
| 1273 | // called when the on-screen widget state changes and provides an |
| 1274 | // an opportunity for the widget to update its visual state (colours, |
| 1275 | // fonts, anything else) as necessary |
| 1276 | virtual void OnEnabled(bool WXUNUSED(enabled)) { } |
| 1277 | |
| 1278 | |
| 1279 | // the window id - a number which uniquely identifies a window among |
| 1280 | // its siblings unless it is wxID_ANY |
| 1281 | wxWindowID m_windowId; |
| 1282 | |
| 1283 | // the parent window of this window (or NULL) and the list of the children |
| 1284 | // of this window |
| 1285 | wxWindow *m_parent; |
| 1286 | wxWindowList m_children; |
| 1287 | |
| 1288 | // the minimal allowed size for the window (no minimal size if variable(s) |
| 1289 | // contain(s) wxDefaultCoord) |
| 1290 | int m_minWidth, |
| 1291 | m_minHeight, |
| 1292 | m_maxWidth, |
| 1293 | m_maxHeight; |
| 1294 | |
| 1295 | // event handler for this window: usually is just 'this' but may be |
| 1296 | // changed with SetEventHandler() |
| 1297 | wxEvtHandler *m_eventHandler; |
| 1298 | |
| 1299 | #if wxUSE_VALIDATORS |
| 1300 | // associated validator or NULL if none |
| 1301 | wxValidator *m_windowValidator; |
| 1302 | #endif // wxUSE_VALIDATORS |
| 1303 | |
| 1304 | #if wxUSE_DRAG_AND_DROP |
| 1305 | wxDropTarget *m_dropTarget; |
| 1306 | #endif // wxUSE_DRAG_AND_DROP |
| 1307 | |
| 1308 | // visual window attributes |
| 1309 | wxCursor m_cursor; |
| 1310 | wxFont m_font; // see m_hasFont |
| 1311 | wxColour m_backgroundColour, // m_hasBgCol |
| 1312 | m_foregroundColour; // m_hasFgCol |
| 1313 | |
| 1314 | #if wxUSE_CARET |
| 1315 | wxCaret *m_caret; |
| 1316 | #endif // wxUSE_CARET |
| 1317 | |
| 1318 | // the region which should be repainted in response to paint event |
| 1319 | wxRegion m_updateRegion; |
| 1320 | |
| 1321 | #if wxUSE_ACCEL |
| 1322 | // the accelerator table for the window which translates key strokes into |
| 1323 | // command events |
| 1324 | wxAcceleratorTable m_acceleratorTable; |
| 1325 | #endif // wxUSE_ACCEL |
| 1326 | |
| 1327 | // the tooltip for this window (may be NULL) |
| 1328 | #if wxUSE_TOOLTIPS |
| 1329 | wxToolTip *m_tooltip; |
| 1330 | #endif // wxUSE_TOOLTIPS |
| 1331 | |
| 1332 | // constraints and sizers |
| 1333 | #if wxUSE_CONSTRAINTS |
| 1334 | // the constraints for this window or NULL |
| 1335 | wxLayoutConstraints *m_constraints; |
| 1336 | |
| 1337 | // constraints this window is involved in |
| 1338 | wxWindowList *m_constraintsInvolvedIn; |
| 1339 | #endif // wxUSE_CONSTRAINTS |
| 1340 | |
| 1341 | // this window's sizer |
| 1342 | wxSizer *m_windowSizer; |
| 1343 | |
| 1344 | // The sizer this window is a member of, if any |
| 1345 | wxSizer *m_containingSizer; |
| 1346 | |
| 1347 | // Layout() window automatically when its size changes? |
| 1348 | bool m_autoLayout:1; |
| 1349 | |
| 1350 | // window state |
| 1351 | bool m_isShown:1; |
| 1352 | bool m_isEnabled:1; |
| 1353 | bool m_isBeingDeleted:1; |
| 1354 | |
| 1355 | // was the window colours/font explicitly changed by user? |
| 1356 | bool m_hasBgCol:1; |
| 1357 | bool m_hasFgCol:1; |
| 1358 | bool m_hasFont:1; |
| 1359 | |
| 1360 | // and should it be inherited by children? |
| 1361 | bool m_inheritBgCol:1; |
| 1362 | bool m_inheritFgCol:1; |
| 1363 | bool m_inheritFont:1; |
| 1364 | |
| 1365 | // window attributes |
| 1366 | long m_windowStyle, |
| 1367 | m_exStyle; |
| 1368 | wxString m_windowName; |
| 1369 | bool m_themeEnabled; |
| 1370 | wxBackgroundStyle m_backgroundStyle; |
| 1371 | #if wxUSE_PALETTE |
| 1372 | wxPalette m_palette; |
| 1373 | bool m_hasCustomPalette; |
| 1374 | #endif // wxUSE_PALETTE |
| 1375 | |
| 1376 | #if wxUSE_ACCESSIBILITY |
| 1377 | wxAccessible* m_accessible; |
| 1378 | #endif |
| 1379 | |
| 1380 | // Virtual size (scrolling) |
| 1381 | wxSize m_virtualSize; |
| 1382 | |
| 1383 | wxScrollHelper *m_scrollHelper; |
| 1384 | |
| 1385 | int m_minVirtualWidth; // VirtualSizeHints |
| 1386 | int m_minVirtualHeight; |
| 1387 | int m_maxVirtualWidth; |
| 1388 | int m_maxVirtualHeight; |
| 1389 | |
| 1390 | wxWindowVariant m_windowVariant ; |
| 1391 | |
| 1392 | // override this to change the default (i.e. used when no style is |
| 1393 | // specified) border for the window class |
| 1394 | virtual wxBorder GetDefaultBorder() const; |
| 1395 | |
| 1396 | // this allows you to implement standard control borders without |
| 1397 | // repeating the code in different classes that are not derived from |
| 1398 | // wxControl |
| 1399 | virtual wxBorder GetDefaultBorderForControl() const { return wxBORDER_SUNKEN; } |
| 1400 | |
| 1401 | // Get the default size for the new window if no explicit size given. TLWs |
| 1402 | // have their own default size so this is just for non top-level windows. |
| 1403 | static int WidthDefault(int w) { return w == wxDefaultCoord ? 20 : w; } |
| 1404 | static int HeightDefault(int h) { return h == wxDefaultCoord ? 20 : h; } |
| 1405 | |
| 1406 | |
| 1407 | // Used to save the results of DoGetBestSize so it doesn't need to be |
| 1408 | // recalculated each time the value is needed. |
| 1409 | wxSize m_bestSizeCache; |
| 1410 | |
| 1411 | wxDEPRECATED( void SetBestSize(const wxSize& size) ); // use SetInitialSize |
| 1412 | wxDEPRECATED( virtual void SetInitialBestSize(const wxSize& size) ); // use SetInitialSize |
| 1413 | |
| 1414 | |
| 1415 | |
| 1416 | // more pure virtual functions |
| 1417 | // --------------------------- |
| 1418 | |
| 1419 | // NB: we must have DoSomething() function when Something() is an overloaded |
| 1420 | // method: indeed, we can't just have "virtual Something()" in case when |
| 1421 | // the function is overloaded because then we'd have to make virtual all |
| 1422 | // the variants (otherwise only the virtual function may be called on a |
| 1423 | // pointer to derived class according to C++ rules) which is, in |
| 1424 | // general, absolutely not needed. So instead we implement all |
| 1425 | // overloaded Something()s in terms of DoSomething() which will be the |
| 1426 | // only one to be virtual. |
| 1427 | |
| 1428 | // coordinates translation |
| 1429 | virtual void DoClientToScreen( int *x, int *y ) const = 0; |
| 1430 | virtual void DoScreenToClient( int *x, int *y ) const = 0; |
| 1431 | |
| 1432 | virtual wxHitTest DoHitTest(wxCoord x, wxCoord y) const; |
| 1433 | |
| 1434 | // capture/release the mouse, used by Capture/ReleaseMouse() |
| 1435 | virtual void DoCaptureMouse() = 0; |
| 1436 | virtual void DoReleaseMouse() = 0; |
| 1437 | |
| 1438 | // retrieve the position/size of the window |
| 1439 | virtual void DoGetPosition(int *x, int *y) const = 0; |
| 1440 | virtual void DoGetScreenPosition(int *x, int *y) const; |
| 1441 | virtual void DoGetSize(int *width, int *height) const = 0; |
| 1442 | virtual void DoGetClientSize(int *width, int *height) const = 0; |
| 1443 | |
| 1444 | // get the size which best suits the window: for a control, it would be |
| 1445 | // the minimal size which doesn't truncate the control, for a panel - the |
| 1446 | // same size as it would have after a call to Fit() |
| 1447 | virtual wxSize DoGetBestSize() const; |
| 1448 | |
| 1449 | // called from DoGetBestSize() to convert best virtual size (returned by |
| 1450 | // the window sizer) to the best size for the window itself; this is |
| 1451 | // overridden at wxScrolledWindow level to clump down virtual size to real |
| 1452 | virtual wxSize GetWindowSizeForVirtualSize(const wxSize& size) const |
| 1453 | { |
| 1454 | return size; |
| 1455 | } |
| 1456 | |
| 1457 | // this is the virtual function to be overriden in any derived class which |
| 1458 | // wants to change how SetSize() or Move() works - it is called by all |
| 1459 | // versions of these functions in the base class |
| 1460 | virtual void DoSetSize(int x, int y, |
| 1461 | int width, int height, |
| 1462 | int sizeFlags = wxSIZE_AUTO) = 0; |
| 1463 | |
| 1464 | // same as DoSetSize() for the client size |
| 1465 | virtual void DoSetClientSize(int width, int height) = 0; |
| 1466 | |
| 1467 | // move the window to the specified location and resize it: this is called |
| 1468 | // from both DoSetSize() and DoSetClientSize() and would usually just |
| 1469 | // reposition this window except for composite controls which will want to |
| 1470 | // arrange themselves inside the given rectangle |
| 1471 | // |
| 1472 | // Important note: the coordinates passed to this method are in parent's |
| 1473 | // *window* coordinates and not parent's client coordinates (as the values |
| 1474 | // passed to DoSetSize and returned by DoGetPosition are)! |
| 1475 | virtual void DoMoveWindow(int x, int y, int width, int height) = 0; |
| 1476 | |
| 1477 | // centre the window in the specified direction on parent, note that |
| 1478 | // wxCENTRE_ON_SCREEN shouldn't be specified here, it only makes sense for |
| 1479 | // TLWs |
| 1480 | virtual void DoCentre(int dir); |
| 1481 | |
| 1482 | #if wxUSE_TOOLTIPS |
| 1483 | virtual void DoSetToolTip( wxToolTip *tip ); |
| 1484 | #endif // wxUSE_TOOLTIPS |
| 1485 | |
| 1486 | #if wxUSE_MENUS |
| 1487 | virtual bool DoPopupMenu(wxMenu *menu, int x, int y) = 0; |
| 1488 | #endif // wxUSE_MENUS |
| 1489 | |
| 1490 | // Makes an adjustment to the window position to make it relative to the |
| 1491 | // parents client area, e.g. if the parent is a frame with a toolbar, its |
| 1492 | // (0, 0) is just below the toolbar |
| 1493 | virtual void AdjustForParentClientOrigin(int& x, int& y, |
| 1494 | int sizeFlags = 0) const; |
| 1495 | |
| 1496 | // implements the window variants |
| 1497 | virtual void DoSetWindowVariant( wxWindowVariant variant ) ; |
| 1498 | |
| 1499 | // Must be called when mouse capture is lost to send |
| 1500 | // wxMouseCaptureLostEvent to windows on capture stack. |
| 1501 | static void NotifyCaptureLost(); |
| 1502 | |
| 1503 | private: |
| 1504 | // recursively call our own and our children OnEnabled() when the |
| 1505 | // enabled/disabled status changed because a parent window had been |
| 1506 | // enabled/disabled |
| 1507 | void NotifyWindowOnEnableChange(bool enabled); |
| 1508 | |
| 1509 | #if wxUSE_MENUS |
| 1510 | // temporary event handler used by GetPopupMenuSelectionFromUser() |
| 1511 | void InternalOnPopupMenu(wxCommandEvent& event); |
| 1512 | |
| 1513 | // implementation of the public GetPopupMenuSelectionFromUser() method |
| 1514 | int DoGetPopupMenuSelectionFromUser(wxMenu& menu, int x, int y); |
| 1515 | #endif // wxUSE_MENUS |
| 1516 | |
| 1517 | // contains the last id generated by NewControlId |
| 1518 | static int ms_lastControlId; |
| 1519 | |
| 1520 | // the stack of windows which have captured the mouse |
| 1521 | static struct WXDLLIMPEXP_FWD_CORE wxWindowNext *ms_winCaptureNext; |
| 1522 | // the window that currently has mouse capture |
| 1523 | static wxWindow *ms_winCaptureCurrent; |
| 1524 | // indicates if execution is inside CaptureMouse/ReleaseMouse |
| 1525 | static bool ms_winCaptureChanging; |
| 1526 | |
| 1527 | DECLARE_ABSTRACT_CLASS(wxWindowBase) |
| 1528 | DECLARE_NO_COPY_CLASS(wxWindowBase) |
| 1529 | DECLARE_EVENT_TABLE() |
| 1530 | }; |
| 1531 | |
| 1532 | |
| 1533 | |
| 1534 | // Inlines for some deprecated methods |
| 1535 | inline wxSize wxWindowBase::GetBestFittingSize() const |
| 1536 | { |
| 1537 | return GetEffectiveMinSize(); |
| 1538 | } |
| 1539 | |
| 1540 | inline void wxWindowBase::SetBestFittingSize(const wxSize& size) |
| 1541 | { |
| 1542 | SetInitialSize(size); |
| 1543 | } |
| 1544 | |
| 1545 | inline void wxWindowBase::SetBestSize(const wxSize& size) |
| 1546 | { |
| 1547 | SetInitialSize(size); |
| 1548 | } |
| 1549 | |
| 1550 | inline void wxWindowBase::SetInitialBestSize(const wxSize& size) |
| 1551 | { |
| 1552 | SetInitialSize(size); |
| 1553 | } |
| 1554 | |
| 1555 | |
| 1556 | // ---------------------------------------------------------------------------- |
| 1557 | // now include the declaration of wxWindow class |
| 1558 | // ---------------------------------------------------------------------------- |
| 1559 | |
| 1560 | // include the declaration of the platform-specific class |
| 1561 | #if defined(__WXPALMOS__) |
| 1562 | #ifdef __WXUNIVERSAL__ |
| 1563 | #define wxWindowNative wxWindowPalm |
| 1564 | #else // !wxUniv |
| 1565 | #define wxWindowPalm wxWindow |
| 1566 | #endif // wxUniv/!wxUniv |
| 1567 | #include "wx/palmos/window.h" |
| 1568 | #elif defined(__WXMSW__) |
| 1569 | #ifdef __WXUNIVERSAL__ |
| 1570 | #define wxWindowNative wxWindowMSW |
| 1571 | #else // !wxUniv |
| 1572 | #define wxWindowMSW wxWindow |
| 1573 | #endif // wxUniv/!wxUniv |
| 1574 | #include "wx/msw/window.h" |
| 1575 | #elif defined(__WXMOTIF__) |
| 1576 | #include "wx/motif/window.h" |
| 1577 | #elif defined(__WXGTK20__) |
| 1578 | #ifdef __WXUNIVERSAL__ |
| 1579 | #define wxWindowNative wxWindowGTK |
| 1580 | #else // !wxUniv |
| 1581 | #define wxWindowGTK wxWindow |
| 1582 | #endif // wxUniv |
| 1583 | #include "wx/gtk/window.h" |
| 1584 | #elif defined(__WXGTK__) |
| 1585 | #ifdef __WXUNIVERSAL__ |
| 1586 | #define wxWindowNative wxWindowGTK |
| 1587 | #else // !wxUniv |
| 1588 | #define wxWindowGTK wxWindow |
| 1589 | #endif // wxUniv |
| 1590 | #include "wx/gtk1/window.h" |
| 1591 | #elif defined(__WXX11__) |
| 1592 | #ifdef __WXUNIVERSAL__ |
| 1593 | #define wxWindowNative wxWindowX11 |
| 1594 | #else // !wxUniv |
| 1595 | #define wxWindowX11 wxWindow |
| 1596 | #endif // wxUniv |
| 1597 | #include "wx/x11/window.h" |
| 1598 | #elif defined(__WXMGL__) |
| 1599 | #define wxWindowNative wxWindowMGL |
| 1600 | #include "wx/mgl/window.h" |
| 1601 | #elif defined(__WXDFB__) |
| 1602 | #define wxWindowNative wxWindowDFB |
| 1603 | #include "wx/dfb/window.h" |
| 1604 | #elif defined(__WXMAC__) |
| 1605 | #ifdef __WXUNIVERSAL__ |
| 1606 | #define wxWindowNative wxWindowMac |
| 1607 | #else // !wxUniv |
| 1608 | #define wxWindowMac wxWindow |
| 1609 | #endif // wxUniv |
| 1610 | #include "wx/mac/window.h" |
| 1611 | #elif defined(__WXCOCOA__) |
| 1612 | #ifdef __WXUNIVERSAL__ |
| 1613 | #define wxWindowNative wxWindowCocoa |
| 1614 | #else // !wxUniv |
| 1615 | #define wxWindowCocoa wxWindow |
| 1616 | #endif // wxUniv |
| 1617 | #include "wx/cocoa/window.h" |
| 1618 | #elif defined(__WXPM__) |
| 1619 | #ifdef __WXUNIVERSAL__ |
| 1620 | #define wxWindowNative wxWindowOS2 |
| 1621 | #else // !wxUniv |
| 1622 | #define wxWindowOS2 wxWindow |
| 1623 | #endif // wxUniv/!wxUniv |
| 1624 | #include "wx/os2/window.h" |
| 1625 | #endif |
| 1626 | |
| 1627 | // for wxUniversal, we now derive the real wxWindow from wxWindow<platform>, |
| 1628 | // for the native ports we already have defined it above |
| 1629 | #if defined(__WXUNIVERSAL__) |
| 1630 | #ifndef wxWindowNative |
| 1631 | #error "wxWindowNative must be defined above!" |
| 1632 | #endif |
| 1633 | |
| 1634 | #include "wx/univ/window.h" |
| 1635 | #endif // wxUniv |
| 1636 | |
| 1637 | // ---------------------------------------------------------------------------- |
| 1638 | // inline functions which couldn't be declared in the class body because of |
| 1639 | // forward dependencies |
| 1640 | // ---------------------------------------------------------------------------- |
| 1641 | |
| 1642 | inline wxWindow *wxWindowBase::GetGrandParent() const |
| 1643 | { |
| 1644 | return m_parent ? m_parent->GetParent() : (wxWindow *)NULL; |
| 1645 | } |
| 1646 | |
| 1647 | // ---------------------------------------------------------------------------- |
| 1648 | // global functions |
| 1649 | // ---------------------------------------------------------------------------- |
| 1650 | |
| 1651 | // Find the wxWindow at the current mouse position, also returning the mouse |
| 1652 | // position. |
| 1653 | extern WXDLLEXPORT wxWindow* wxFindWindowAtPointer(wxPoint& pt); |
| 1654 | |
| 1655 | // Get the current mouse position. |
| 1656 | extern WXDLLEXPORT wxPoint wxGetMousePosition(); |
| 1657 | |
| 1658 | // get the currently active window of this application or NULL |
| 1659 | extern WXDLLEXPORT wxWindow *wxGetActiveWindow(); |
| 1660 | |
| 1661 | // get the (first) top level parent window |
| 1662 | WXDLLEXPORT wxWindow* wxGetTopLevelParent(wxWindow *win); |
| 1663 | |
| 1664 | #if WXWIN_COMPATIBILITY_2_6 |
| 1665 | // deprecated (doesn't start with 'wx' prefix), use wxWindow::NewControlId() |
| 1666 | wxDEPRECATED( int NewControlId() ); |
| 1667 | inline int NewControlId() { return wxWindowBase::NewControlId(); } |
| 1668 | #endif // WXWIN_COMPATIBILITY_2_6 |
| 1669 | |
| 1670 | #if wxUSE_ACCESSIBILITY |
| 1671 | // ---------------------------------------------------------------------------- |
| 1672 | // accessible object for windows |
| 1673 | // ---------------------------------------------------------------------------- |
| 1674 | |
| 1675 | class WXDLLEXPORT wxWindowAccessible: public wxAccessible |
| 1676 | { |
| 1677 | public: |
| 1678 | wxWindowAccessible(wxWindow* win): wxAccessible(win) { if (win) win->SetAccessible(this); } |
| 1679 | virtual ~wxWindowAccessible() {} |
| 1680 | |
| 1681 | // Overridables |
| 1682 | |
| 1683 | // Can return either a child object, or an integer |
| 1684 | // representing the child element, starting from 1. |
| 1685 | virtual wxAccStatus HitTest(const wxPoint& pt, int* childId, wxAccessible** childObject); |
| 1686 | |
| 1687 | // Returns the rectangle for this object (id = 0) or a child element (id > 0). |
| 1688 | virtual wxAccStatus GetLocation(wxRect& rect, int elementId); |
| 1689 | |
| 1690 | // Navigates from fromId to toId/toObject. |
| 1691 | virtual wxAccStatus Navigate(wxNavDir navDir, int fromId, |
| 1692 | int* toId, wxAccessible** toObject); |
| 1693 | |
| 1694 | // Gets the name of the specified object. |
| 1695 | virtual wxAccStatus GetName(int childId, wxString* name); |
| 1696 | |
| 1697 | // Gets the number of children. |
| 1698 | virtual wxAccStatus GetChildCount(int* childCount); |
| 1699 | |
| 1700 | // Gets the specified child (starting from 1). |
| 1701 | // If *child is NULL and return value is wxACC_OK, |
| 1702 | // this means that the child is a simple element and |
| 1703 | // not an accessible object. |
| 1704 | virtual wxAccStatus GetChild(int childId, wxAccessible** child); |
| 1705 | |
| 1706 | // Gets the parent, or NULL. |
| 1707 | virtual wxAccStatus GetParent(wxAccessible** parent); |
| 1708 | |
| 1709 | // Performs the default action. childId is 0 (the action for this object) |
| 1710 | // or > 0 (the action for a child). |
| 1711 | // Return wxACC_NOT_SUPPORTED if there is no default action for this |
| 1712 | // window (e.g. an edit control). |
| 1713 | virtual wxAccStatus DoDefaultAction(int childId); |
| 1714 | |
| 1715 | // Gets the default action for this object (0) or > 0 (the action for a child). |
| 1716 | // Return wxACC_OK even if there is no action. actionName is the action, or the empty |
| 1717 | // string if there is no action. |
| 1718 | // The retrieved string describes the action that is performed on an object, |
| 1719 | // not what the object does as a result. For example, a toolbar button that prints |
| 1720 | // a document has a default action of "Press" rather than "Prints the current document." |
| 1721 | virtual wxAccStatus GetDefaultAction(int childId, wxString* actionName); |
| 1722 | |
| 1723 | // Returns the description for this object or a child. |
| 1724 | virtual wxAccStatus GetDescription(int childId, wxString* description); |
| 1725 | |
| 1726 | // Returns help text for this object or a child, similar to tooltip text. |
| 1727 | virtual wxAccStatus GetHelpText(int childId, wxString* helpText); |
| 1728 | |
| 1729 | // Returns the keyboard shortcut for this object or child. |
| 1730 | // Return e.g. ALT+K |
| 1731 | virtual wxAccStatus GetKeyboardShortcut(int childId, wxString* shortcut); |
| 1732 | |
| 1733 | // Returns a role constant. |
| 1734 | virtual wxAccStatus GetRole(int childId, wxAccRole* role); |
| 1735 | |
| 1736 | // Returns a state constant. |
| 1737 | virtual wxAccStatus GetState(int childId, long* state); |
| 1738 | |
| 1739 | // Returns a localized string representing the value for the object |
| 1740 | // or child. |
| 1741 | virtual wxAccStatus GetValue(int childId, wxString* strValue); |
| 1742 | |
| 1743 | // Selects the object or child. |
| 1744 | virtual wxAccStatus Select(int childId, wxAccSelectionFlags selectFlags); |
| 1745 | |
| 1746 | // Gets the window with the keyboard focus. |
| 1747 | // If childId is 0 and child is NULL, no object in |
| 1748 | // this subhierarchy has the focus. |
| 1749 | // If this object has the focus, child should be 'this'. |
| 1750 | virtual wxAccStatus GetFocus(int* childId, wxAccessible** child); |
| 1751 | |
| 1752 | #if wxUSE_VARIANT |
| 1753 | // Gets a variant representing the selected children |
| 1754 | // of this object. |
| 1755 | // Acceptable values: |
| 1756 | // - a null variant (IsNull() returns true) |
| 1757 | // - a list variant (GetType() == wxT("list") |
| 1758 | // - an integer representing the selected child element, |
| 1759 | // or 0 if this object is selected (GetType() == wxT("long") |
| 1760 | // - a "void*" pointer to a wxAccessible child object |
| 1761 | virtual wxAccStatus GetSelections(wxVariant* selections); |
| 1762 | #endif // wxUSE_VARIANT |
| 1763 | }; |
| 1764 | |
| 1765 | #endif // wxUSE_ACCESSIBILITY |
| 1766 | |
| 1767 | |
| 1768 | #endif // _WX_WINDOW_H_BASE_ |