]> git.saurik.com Git - wxWidgets.git/blob - include/wx/os2/window.h
Committing in .
[wxWidgets.git] / include / wx / os2 / window.h
1 /////////////////////////////////////////////////////////////////////////////
2 // Name: window.h
3 // Purpose: wxWindow class
4 // Author: David Webster
5 // Modified by:
6 // Created: 10/12/99
7 // RCS-ID: $Id$
8 // Copyright: (c) David Webster
9 // Licence: wxWindows licence
10 /////////////////////////////////////////////////////////////////////////////
11
12 #ifndef _WX_WINDOW_H_
13 #define _WX_WINDOW_H_
14
15 #define wxUSE_MOUSEEVENT_HACK 0
16
17 // ---------------------------------------------------------------------------
18 // headers
19 // ---------------------------------------------------------------------------
20 #define INCL_DOS
21 #define INCL_PM
22 #define INCL_GPI
23 #include <os2.h>
24
25
26 // ---------------------------------------------------------------------------
27 // forward declarations
28 // ---------------------------------------------------------------------------
29 #ifndef CW_USEDEFAULT
30 # define CW_USEDEFAULT ((int)0x80000000)
31 #endif
32
33 // ---------------------------------------------------------------------------
34 // forward declarations
35 // ---------------------------------------------------------------------------
36
37 class WXDLLEXPORT wxButton;
38
39 // ---------------------------------------------------------------------------
40 // constants
41 // ---------------------------------------------------------------------------
42
43 // FIXME does anybody use those? they're unused by wxWindows...
44 enum
45 {
46 wxKEY_SHIFT = 1,
47 wxKEY_CTRL = 2
48 };
49
50 // ---------------------------------------------------------------------------
51 // wxWindow declaration for OS/2 PM
52 // ---------------------------------------------------------------------------
53
54 class WXDLLEXPORT wxWindowOS2 : public wxWindowBase
55 {
56 public:
57 wxWindowOS2()
58 {
59 Init();
60 }
61
62 wxWindowOS2( wxWindow* pParent
63 ,wxWindowID vId
64 ,const wxPoint& rPos = wxDefaultPosition
65 ,const wxSize& rSize = wxDefaultSize
66 ,long lStyle = 0
67 ,const wxString& rName = wxPanelNameStr
68 )
69 {
70 Init();
71 Create( pParent
72 ,vId
73 ,rPos
74 ,rSize
75 ,lStyle
76 ,rName
77 );
78 }
79
80 virtual ~wxWindowOS2();
81
82 bool Create( wxWindow* pParent
83 ,wxWindowID vId
84 ,const wxPoint& rPos = wxDefaultPosition
85 ,const wxSize& rSize = wxDefaultSize
86 ,long lStyle = 0
87 ,const wxString& rName = wxPanelNameStr
88 );
89
90 // implement base class pure virtuals
91 virtual void SetTitle(const wxString& rTitle);
92 virtual wxString GetTitle(void) const;
93 virtual void Raise(void);
94 virtual void Lower(void);
95 virtual bool Show(bool bShow = TRUE);
96 virtual bool Enable(bool bEnable = TRUE);
97 virtual void SetFocus(void);
98 virtual bool Reparent(wxWindow* pNewParent);
99 virtual void WarpPointer( int x
100 ,int y
101 );
102 virtual void CaptureMouse(void);
103 virtual void ReleaseMouse(void);
104 virtual void Refresh( bool bEraseBackground = TRUE
105 ,const wxRect* pRect = (const wxRect *)NULL
106 );
107 virtual void Clear(void);
108 virtual void Freeze(void);
109 virtual void Update(void);
110 virtual void Thaw(void);
111 virtual bool SetCursor(const wxCursor& rCursor);
112 virtual bool SetFont(const wxFont& rFont);
113 virtual int GetCharHeight(void) const;
114 virtual int GetCharWidth(void) const;
115 virtual void GetTextExtent( const wxString& rString
116 ,int* pX
117 ,int* pY
118 ,int* pDescent = (int *)NULL
119 ,int* pExternalLeading = (int *)NULL
120 ,const wxFont* pTheFont = (const wxFont *)NULL
121 ) const;
122 #if wxUSE_MENUS_NATIVE
123 virtual bool DoPopupMenu( wxMenu* pMenu
124 ,int nX
125 ,int nY
126 );
127 #endif // wxUSE_MENUS_NATIVE
128
129 virtual void SetScrollbar( int nOrient
130 ,int nPos
131 ,int nThumbVisible
132 ,int nRange
133 ,bool bRefresh = TRUE
134 );
135 virtual void SetScrollPos( int nOrient
136 ,int nPos
137 ,bool bRefresh = TRUE
138 );
139 virtual int GetScrollPos(int nOrient) const;
140 virtual int GetScrollThumb(int nOrient) const;
141 virtual int GetScrollRange(int nOrient) const;
142 virtual void ScrollWindow( int nDx
143 ,int nDy
144 ,const wxRect* pRect = (wxRect *)NULL
145 );
146
147 #if wxUSE_DRAG_AND_DROP
148 virtual void SetDropTarget(wxDropTarget* pDropTarget);
149 #endif // wxUSE_DRAG_AND_DROP
150
151 // Accept files for dragging
152 virtual void DragAcceptFiles(bool bAccept);
153
154 #if WXWIN_COMPATIBILITY
155 // Set/get scroll attributes
156 virtual void SetScrollRange( int nOrient
157 ,int nRange
158 ,bool bRefresh = TRUE
159 );
160 virtual void SetScrollPage( int nOrient
161 ,int nPage
162 ,bool bRefresh = TRUE
163 );
164 virtual int OldGetScrollRange(int nOrient) const;
165 virtual int GetScrollPage(int nOrient) const;
166
167 //
168 // event handlers
169 //
170 // Handle a control command
171 virtual void OnCommand( wxWindow& rWin
172 ,wxCommandEvent& rEvent
173 );
174
175 // Override to define new behaviour for default action (e.g. double
176 // clicking on a listbox)
177 virtual void OnDefaultAction(wxControl* WXUNUSED(pInitiatingItem)) { }
178 #endif // WXWIN_COMPATIBILITY
179
180 #if wxUSE_CARET && WXWIN_COMPATIBILITY
181 void CreateCaret( int nWidth
182 ,int nHeight
183 );
184 void CreateCaret(const wxBitmap* pBitmap);
185 void DestroyCaret(void);
186 void ShowCaret(bool bShow);
187 void SetCaretPos( int nX
188 ,int nY
189 );
190 void GetCaretPos( int* pX
191 ,int* pY
192 ) const;
193 #endif // wxUSE_CARET
194
195 #ifndef __WXUNIVERSAL__
196 // Native resource loading (implemented in src/os2/nativdlg.cpp)
197 // FIXME: should they really be all virtual?
198 virtual bool LoadNativeDialog( wxWindow* pParent
199 ,wxWindowID& vId
200 );
201 virtual bool LoadNativeDialog( wxWindow* pParent
202 ,const wxString& rName
203 );
204 wxWindow* GetWindowChild1(wxWindowID vId);
205 wxWindow* GetWindowChild(wxWindowID vId);
206 #endif //__WXUNIVERSAL__
207
208 // implementation from now on
209 // --------------------------
210
211 // simple accessors
212 // ----------------
213
214 WXHWND GetHWND(void) const { return m_hWnd; }
215 void SetHWND(WXHWND hWnd) { m_hWnd = hWnd; }
216 virtual WXWidget GetHandle(void) const { return GetHWND(); }
217 bool GetUseCtl3D(void) const { return m_bUseCtl3D; }
218 bool GetTransparentBackground(void) const { return m_bBackgroundTransparent; }
219 void SetTransparent(bool bT = TRUE) { m_bBackgroundTransparent = bT; }
220
221 // event handlers
222 // --------------
223 void OnSetFocus(wxFocusEvent& rEvent);
224 void OnEraseBackground(wxEraseEvent& rEvent);
225 void OnIdle(wxIdleEvent& rEvent);
226
227 public:
228 // For implementation purposes - sometimes decorations make the client area
229 // smaller
230 virtual wxPoint GetClientAreaOrigin(void) const;
231
232 // Windows subclassing
233 void SubclassWin(WXHWND hWnd);
234 void UnsubclassWin(void);
235
236 WXFARPROC OS2GetOldWndProc(void) const { return m_fnOldWndProc; }
237 void OS2SetOldWndProc(WXFARPROC fnProc) { m_fnOldWndProc = fnProc; }
238
239 wxWindow* FindItem(long lId) const;
240 wxWindow* FindItemByHWND( WXHWND hWnd
241 ,bool bControlOnly = FALSE
242 ) const;
243
244 // Make a Windows extended style from the given wxWindows window style ?? applicable to OS/2??
245 static WXDWORD MakeExtendedStyle( long lStyle
246 ,bool bEliminateBorders = TRUE
247 );
248 // Determine whether 3D effects are wanted
249 WXDWORD Determine3DEffects( WXDWORD dwDefaultBorderStyle
250 ,bool* pbWant3D
251 ) const;
252
253 // PM only: TRUE if this control is part of the main control
254 virtual bool ContainsHWND(WXHWND WXUNUSED(hWnd)) const { return FALSE; };
255
256 // returns TRUE if the window has been created
257 bool OS2Create( PSZ zClass
258 ,const char* zTitle
259 ,WXDWORD dwStyle
260 ,const wxPoint& rPos
261 ,const wxSize& rSize
262 ,void* pCtlData
263 ,WXDWORD dwExStyle
264 ,bool bIsChild
265 );
266 virtual bool OS2Command( WXUINT uParam
267 ,WXWORD nId
268 );
269
270 #if WXWIN_COMPATIBILITY
271 wxObject* GetChild(int nNumber) const;
272 virtual void OS2DeviceToLogical( float* pfX
273 ,float* pfY
274 ) const;
275 #endif // WXWIN_COMPATIBILITY
276
277 #ifndef __WXUNIVERSAL__
278 // Create an appropriate wxWindow from a HWND
279 virtual wxWindow* CreateWindowFromHWND( wxWindow* pParent
280 ,WXHWND hWnd
281 );
282
283 // Make sure the window style reflects the HWND style (roughly)
284 virtual void AdoptAttributesFromHWND(void);
285 #endif
286
287 // Setup background and foreground colours correctly
288 virtual void SetupColours(void);
289
290 // ------------------------------------------------------------------------
291 // helpers for message handlers: these perform the same function as the
292 // message crackers from <windowsx.h> - they unpack WPARAM and LPARAM into
293 // the correct parameters
294 // ------------------------------------------------------------------------
295
296 void UnpackCommand( WXWPARAM wParam
297 ,WXLPARAM lParam,
298 WXWORD* pId
299 ,WXHWND* pHwnd
300 ,WXWORD* pCmd
301 );
302 void UnpackActivate( WXWPARAM wParam
303 ,WXLPARAM lParam
304 ,WXWORD* pState
305 ,WXHWND* pHwnd
306 );
307 void UnpackScroll( WXWPARAM wParam
308 ,WXLPARAM lParam
309 ,WXWORD* pCode
310 ,WXWORD* pPos
311 ,WXHWND* pHwnd
312 );
313 void UnpackMenuSelect( WXWPARAM wParam
314 ,WXLPARAM lParam
315 ,WXWORD* pTtem
316 ,WXWORD* pFlags
317 ,WXHMENU* pHmenu
318 );
319
320 // ------------------------------------------------------------------------
321 // internal handlers for OS2 messages: all handlers return a boolen value:
322 // TRUE means that the handler processed the event and FALSE that it didn't
323 // ------------------------------------------------------------------------
324
325 // there are several cases where we have virtual functions for PM
326 // message processing: this is because these messages often require to be
327 // processed in a different manner in the derived classes. For all other
328 // messages, however, we do *not* have corresponding OS2OnXXX() function
329 // and if the derived class wants to process them, it should override
330 // OS2WindowProc() directly.
331
332 // scroll event (both horizontal and vertical)
333 virtual bool OS2OnScroll( int nOrientation
334 ,WXWORD nSBCode
335 ,WXWORD pos
336 ,WXHWND control
337 );
338
339 // owner-drawn controls need to process these messages
340 virtual bool OS2OnDrawItem( int nId
341 ,WXDRAWITEMSTRUCT* pItem
342 );
343 virtual bool OS2OnMeasureItem( int nId
344 ,WXMEASUREITEMSTRUCT* pItem
345 );
346
347 // the rest are not virtual
348 bool HandleCreate( WXLPCREATESTRUCT vCs
349 ,bool* pMayCreate
350 );
351 bool HandleInitDialog(WXHWND hWndFocus);
352 bool HandleDestroy(void);
353 bool HandlePaint(void);
354 bool HandleEraseBkgnd(WXHDC vDC);
355 bool HandleMinimize(void);
356 bool HandleMaximize(void);
357 bool HandleSize( int nX
358 ,int nY
359 ,WXUINT uFlag
360 );
361 bool HandleGetMinMaxInfo(PSWP pMmInfo);
362 bool HandleShow( bool bShow
363 ,int nStatus
364 );
365 bool HandleActivate( int nFlag
366 ,WXHWND hActivate
367 );
368 bool HandleCommand( WXWORD nId
369 ,WXWORD nCmd
370 ,WXHWND hControl
371 );
372 bool HandleSysCommand( WXWPARAM wParam
373 ,WXLPARAM lParam
374 );
375 bool HandlePaletteChanged();
376 bool HandleSysColorChange(void);
377 bool HandleCtlColor(WXHBRUSH* hBrush);
378 bool HandleSetFocus(WXHWND hWnd);
379 bool HandleKillFocus(WXHWND hWnd);
380 bool HandleEndDrag(WXWPARAM wParam);
381 bool HandleMouseEvent( WXUINT uMsg
382 ,int nX
383 ,int nY
384 ,WXUINT uFlags
385 );
386 bool HandleMouseMove( int nX
387 ,int nY
388 ,WXUINT uFlags
389 );
390 bool HandleChar( WXDWORD wParam
391 ,WXLPARAM lParam
392 ,bool bIsASCII = FALSE
393 );
394 bool HandleKeyDown( WXWORD wParam
395 ,WXLPARAM lParam
396 );
397 bool HandleKeyUp( WXDWORD wParam
398 ,WXLPARAM lParam
399 );
400 bool HandleQueryDragIcon(WXHICON* phIcon);
401 bool HandleSetCursor( USHORT vId
402 ,WXHWND hWnd
403 );
404
405 bool IsMouseInWindow(void) const;
406 bool OS2GetCreateWindowCoords( const wxPoint& rPos
407 ,const wxSize& rSize
408 ,int& rnX
409 ,int& rnY
410 ,int& rnWidth
411 ,int& rnHeight
412 ) const;
413
414 // Window procedure
415 virtual MRESULT OS2WindowProc( WXUINT uMsg
416 ,WXWPARAM wParam
417 ,WXLPARAM lParam
418 );
419
420 // Calls an appropriate default window procedure
421 virtual MRESULT OS2DefWindowProc( WXUINT uMsg
422 ,WXWPARAM wParam
423 ,WXLPARAM lParam
424 );
425 virtual bool OS2ProcessMessage(WXMSG* pMsg);
426 virtual bool OS2TranslateMessage(WXMSG* pMsg);
427 virtual void OS2DestroyWindow(void);
428
429 // Detach "Window" menu from menu bar so it doesn't get deleted
430 void OS2DetachWindowMenu(void);
431
432 // this function should return the brush to paint the window background
433 // with or 0 for the default brush
434 virtual WXHBRUSH OnCtlColor( WXHDC hDC
435 ,WXHWND hWnd
436 ,WXUINT uCtlColor
437 ,WXUINT uMessage
438 ,WXWPARAM wParam
439 ,WXLPARAM lParam
440 );
441
442 #if WXWIN_COMPATIBILITY
443 void SetShowing(bool bShow) { (void)Show(show); }
444 bool IsUserEnabled(void) const { return IsEnabled(); }
445 #endif // WXWIN_COMPATIBILITY
446
447 // Responds to colour changes: passes event on to children.
448 void OnSysColourChanged(wxSysColourChangedEvent& rEvent);
449
450 // initialize various fields of wxMouseEvent (common part of OS2OnMouseXXX)
451 void InitMouseEvent( wxMouseEvent& rEvent
452 ,int nX
453 ,int nY
454 ,WXUINT uFlags
455 );
456
457 void MoveChildren(int nDiff);
458
459 protected:
460 // PM can't create some MSW styles natively but can perform these after
461 // creation by sending messages
462 typedef enum extra_flags { kFrameToolWindow = 0x0001
463 ,kVertCaption = 0x0002
464 ,kHorzCaption = 0x0004
465 } EExtraFlags;
466 // Some internal sizeing id's to make it easy for event handlers
467 typedef enum size_types { kSizeNormal
468 ,kSizeMax
469 ,kSizeMin
470 } ESizeTypes;
471 // the window handle
472 WXHWND m_hWnd;
473
474 // the old window proc (we subclass all windows)
475 WXFARPROC m_fnOldWndProc;
476
477 // additional (OS2 specific) flags
478 bool m_bUseCtl3D:1; // Using CTL3D for this control
479 bool m_bBackgroundTransparent:1;
480 bool m_bMouseInWindow:1;
481 bool m_bDoubleClickAllowed:1;
482 bool m_bWinCaptured:1;
483 WXDWORD m_dwExStyle;
484
485 // the size of one page for scrolling
486 int m_nXThumbSize;
487 int m_nYThumbSize;
488
489 #if wxUSE_MOUSEEVENT_HACK
490 // the coordinates of the last mouse event and the type of it
491 long m_lLastMouseX,
492 long m_lLastMouseY;
493 int m_nLastMouseEvent;
494 #endif // wxUSE_MOUSEEVENT_HACK
495
496 WXHMENU m_hMenu; // Menu, if any
497 unsigned long m_ulMenubarId; // it's Id, if any
498
499 // the return value of WM_GETDLGCODE handler
500 long m_lDlgCode;
501
502 // implement the base class pure virtuals
503 virtual void DoClientToScreen( int* pX
504 ,int* pY
505 ) const;
506 virtual void DoScreenToClient( int* pX
507 ,int* pY
508 ) const;
509 virtual void DoGetPosition( int* pX
510 ,int* pY
511 ) const;
512 virtual void DoGetSize( int* pWidth
513 ,int* pHeight
514 ) const;
515 virtual void DoGetClientSize( int* pWidth
516 ,int* pHeight
517 ) const;
518 virtual void DoSetSize( int nX
519 ,int nY
520 ,int nWidth
521 ,int nHeight
522 ,int nSizeFlags = wxSIZE_AUTO
523 );
524 virtual void DoSetClientSize( int nWidth
525 ,int nHeight
526 );
527
528 // move the window to the specified location and resize it: this is called
529 // from both DoSetSize() and DoSetClientSize() and would usually just call
530 // ::WinSetWindowPos() except for composite controls which will want to arrange
531 // themselves inside the given rectangle
532 virtual void DoMoveWindow( int nX
533 ,int nY
534 ,int nWidth
535 ,int nHeight
536 );
537
538 #if wxUSE_TOOLTIPS
539 virtual void DoSetToolTip(wxToolTip* pTip);
540 #endif // wxUSE_TOOLTIPS
541
542 int GetOS2ParentHeight(wxWindowOS2* pParent);
543
544 private:
545 // common part of all ctors
546 void Init(void);
547
548 // the (non-virtual) handlers for the events
549 bool HandleMove( int nX
550 ,int nY
551 );
552 bool HandleJoystickEvent( WXUINT uMsg
553 ,int pX
554 ,int pY
555 ,WXUINT uFlags
556 );
557
558 bool HandleNotify( int nIdCtrl
559 ,WXLPARAM lParam
560 ,WXLPARAM* pResult
561 );
562 // the helper functions used by HandleChar/KeyXXX methods
563 wxKeyEvent CreateKeyEvent(wxEventType evType, int id, WXLPARAM lp) const;
564
565 DECLARE_DYNAMIC_CLASS(wxWindowOS2);
566 DECLARE_NO_COPY_CLASS(wxWindowOS2)
567 DECLARE_EVENT_TABLE()
568 private:
569 HWND m_hWndScrollBarHorz;
570 HWND m_hWndScrollBarVert;
571
572 // Virtual function hiding supression
573 inline virtual bool Reparent(wxWindowBase* pNewParent)
574 { return(wxWindowBase::Reparent(pNewParent));};
575 }; // end of wxWindow
576
577 class wxWindowCreationHook
578 {
579 public:
580 wxWindowCreationHook(wxWindow* pWinBeingCreated);
581 ~wxWindowCreationHook();
582 }; // end of CLASS wxWindowCreationHook
583
584 // ---------------------------------------------------------------------------
585 // global functions
586 // ---------------------------------------------------------------------------
587
588 // kbd code translation
589 WXDLLEXPORT int wxCharCodeOS2ToWX(int nKeySym);
590 WXDLLEXPORT int wxCharCodeWXToOS2( int nId
591 ,bool* pbIsVirtual
592 );
593 #endif
594 // _WX_WINDOW_H_