]> git.saurik.com Git - wxWidgets.git/blob - src/osx/cocoa/preferences.mm
Added ability to switch off more components of the size page UI
[wxWidgets.git] / src / osx / cocoa / preferences.mm
1 ///////////////////////////////////////////////////////////////////////////////
2 // Name: src/osx/cocoa/preferences.cpp
3 // Purpose: Native OS X implementation of wxPreferencesEditor.
4 // Author: Vaclav Slavik
5 // Created: 2013-02-19
6 // RCS-ID: $Id$
7 // Copyright: (c) 2013 Vaclav Slavik <vslavik@fastmail.fm>
8 // Licence: wxWindows licence
9 ///////////////////////////////////////////////////////////////////////////////
10
11 // ============================================================================
12 // declarations
13 // ============================================================================
14
15 // ----------------------------------------------------------------------------
16 // headers
17 // ----------------------------------------------------------------------------
18
19 // for compilers that support precompilation, includes "wx.h".
20 #include "wx/wxprec.h"
21
22 #ifdef __BORLANDC__
23 #pragma hdrstop
24 #endif
25
26 #include "wx/private/preferences.h"
27
28 #ifdef wxHAS_PREF_EDITOR_NATIVE
29
30 #include "wx/frame.h"
31 #include "wx/sharedptr.h"
32 #include "wx/toolbar.h"
33 #include "wx/vector.h"
34 #include "wx/weakref.h"
35 #include "wx/windowid.h"
36 #include "wx/osx/private.h"
37
38 #import <AppKit/NSWindow.h>
39
40
41 wxBitmap wxStockPreferencesPage::GetLargeIcon() const
42 {
43 switch ( m_kind )
44 {
45 case Kind_General:
46 return wxBitmap([NSImage imageNamed:NSImageNamePreferencesGeneral]);
47 case Kind_Advanced:
48 return wxBitmap([NSImage imageNamed:NSImageNameAdvanced]);
49 }
50 return wxBitmap(); // silence compiler warning
51 }
52
53
54 class wxCocoaPrefsWindow : public wxFrame
55 {
56 public:
57 wxCocoaPrefsWindow()
58 : wxFrame(NULL, wxID_ANY, _("Preferences"),
59 wxDefaultPosition, wxDefaultSize,
60 wxDEFAULT_FRAME_STYLE & ~(wxRESIZE_BORDER | wxMAXIMIZE_BOX | wxMINIMIZE_BOX)),
61 m_toolbarRealized(false),
62 m_visiblePage(NULL)
63 {
64 m_toolbar = new wxToolBar(this, wxID_ANY, wxDefaultPosition, wxDefaultSize,
65 wxTB_FLAT | wxTB_TEXT);
66 m_toolbar->SetToolBitmapSize(wxSize(32,32));
67 m_toolbar->OSXSetSelectableTools(true);
68 SetToolBar(m_toolbar);
69
70 m_toolbar->Bind(wxEVT_COMMAND_TOOL_CLICKED,
71 &wxCocoaPrefsWindow::OnPageChanged, this);
72 Bind(wxEVT_CLOSE_WINDOW, &wxCocoaPrefsWindow::OnClose, this);
73 }
74
75 void AddPage(wxPreferencesPage *page)
76 {
77 wxASSERT_MSG( !m_toolbarRealized,
78 "can't add more preferences pages after showing the window" );
79
80 const wxString title = page->GetName();
81 wxBitmap bmp(page->GetLargeIcon());
82 wxASSERT_MSG( bmp.IsOk(), "OS X requires valid bitmap for preference page" );
83
84 int toolId = wxIdManager::ReserveId();
85 wxToolBarToolBase *tool = m_toolbar->AddTool(toolId, title, bmp);
86
87 wxSharedPtr<PageInfo> info(new PageInfo(page));
88 m_pages.push_back(info);
89
90 tool->SetClientData(info.get());
91 }
92
93 virtual bool Show(bool show)
94 {
95 if ( show && !m_toolbarRealized )
96 {
97 m_toolbar->Realize();
98 m_toolbarRealized = true;
99
100 const wxToolBarToolBase *first = m_toolbar->GetToolByPos(0);
101 wxCHECK_MSG( first, false, "no preferences panels" );
102 OnSelectPageForTool(first);
103 m_toolbar->OSXSelectTool(first->GetId());
104 }
105
106 return wxFrame::Show(show);
107 }
108
109 virtual bool ShouldPreventAppExit() const { return false; }
110
111 protected:
112 // Native preferences windows resize when the selected panel changes and
113 // the resizing is animated, so we need to override DoMoveWindow.
114 virtual void DoMoveWindow(int x, int y, int width, int height)
115 {
116 NSRect r = wxToNSRect(NULL, wxRect(x, y, width, height));
117 NSWindow *win = (NSWindow*)GetWXWindow();
118 [win setFrame:r display:YES animate:YES];
119 }
120
121
122 private:
123 void OnSelectPageForTool(const wxToolBarToolBase *tool)
124 {
125 PageInfo *info = static_cast<PageInfo*>(tool->GetClientData());
126 wxCHECK_RET( info, "toolbar item lacks client data" );
127
128 if ( !info->win )
129 {
130 info->win = info->page->CreateWindow(this);
131 info->win->Hide();
132 // fill the page with data using wxEVT_INIT_DIALOG/TransferDataToWindow:
133 info->win->InitDialog();
134 }
135
136 // When the page changes in a native preferences dialog, the sequence
137 // of events is thus:
138
139 // 1. the old page is hidden, only gray background remains
140 if ( m_visiblePage )
141 m_visiblePage->Hide();
142 m_visiblePage = info->win;
143
144 // 2. window is resized to fix the new page, with animation
145 // (in our case, using overriden DoMoveWindow())
146 SetClientSize(info->win->GetSize());
147
148 // 3. new page is shown and the title updated.
149 info->win->Show();
150 SetTitle(info->page->GetName());
151
152 // TODO: Preferences window may have some pages resizeable and some
153 // non-resizable on OS X; the whole window is or is not resizable
154 // depending on which page is selected.
155 //
156 // We'll need to add wxPreferencesPage::IsResizable() virtual
157 // method to implement this.
158 }
159
160 void OnPageChanged(wxCommandEvent& event)
161 {
162 wxToolBarToolBase *tool = m_toolbar->FindById(event.GetId());
163 wxCHECK_RET( tool, "invalid tool ID" );
164 OnSelectPageForTool(tool);
165 }
166
167 void OnClose(wxCloseEvent& e)
168 {
169 // Instead of destroying the window, just hide it, it could be
170 // reused again by another invocation of the editor.
171 Hide();
172 }
173
174 private:
175 struct PageInfo : public wxObject
176 {
177 PageInfo(wxPreferencesPage *p) : page(p), win(NULL) {}
178
179 wxSharedPtr<wxPreferencesPage> page;
180 wxWindow *win;
181 };
182 // All pages. Use shared pointer to be able to get pointers to PageInfo structs
183 wxVector< wxSharedPtr<PageInfo> > m_pages;
184
185 wxToolBar *m_toolbar;
186 bool m_toolbarRealized;
187 wxWindow *m_visiblePage;
188 };
189
190
191 class wxCocoaPreferencesEditorImpl : public wxPreferencesEditorImpl
192 {
193 public:
194 wxCocoaPreferencesEditorImpl() : m_win(NULL)
195 {
196 }
197
198 virtual ~wxCocoaPreferencesEditorImpl()
199 {
200 // m_win may already be destroyed if this destructor is called from
201 // wxApp's destructor. In that case, all windows -- including this
202 // one -- would already be destroyed by now.
203 if ( m_win )
204 m_win->Destroy();
205 }
206
207 virtual void AddPage(wxPreferencesPage* page)
208 {
209 GetWin()->AddPage(page);
210 }
211
212 virtual void Show(wxWindow* WXUNUSED(parent))
213 {
214 // OS X preferences windows don't have parents, they are independent
215 // windows, so we just ignore the 'parent' argument.
216 wxWindow *win = GetWin();
217 win->Show();
218 win->Raise();
219 }
220
221 virtual void Dismiss()
222 {
223 // Don't destroy the window, only hide it, because OS X preferences
224 // window typically remember their state even when closed. Reopening
225 // the window should show it in the exact same state the user left it.
226 GetWin()->Hide();
227 }
228
229 private:
230 // Use this function to access m_win, so that the window is only created on
231 // demand when actually needed.
232 wxCocoaPrefsWindow* GetWin()
233 {
234 if ( !m_win )
235 m_win = new wxCocoaPrefsWindow();
236 return m_win;
237 }
238
239 wxWeakRef<wxCocoaPrefsWindow> m_win;
240 };
241
242 /*static*/
243 wxPreferencesEditorImpl* wxPreferencesEditorImpl::Create()
244 {
245 return new wxCocoaPreferencesEditorImpl();
246 }
247
248 #endif // wxHAS_PREF_EDITOR_NATIVE