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