1 /////////////////////////////////////////////////////////////////////////////
2 // Name:        src/osx/artmac.cpp
3 // Purpose:     wxArtProvider instance with native Mac stock icons
4 // Author:      Alan Shouls
5 // Created:     2006-10-30
6 // Copyright:   (c) wxWindows team
7 // Licence:     wxWindows licence
8 /////////////////////////////////////////////////////////////////////////////
9 
10 // ---------------------------------------------------------------------------
11 // headers
12 // ---------------------------------------------------------------------------
13 
14 // For compilers that support precompilation, includes "wx.h".
15 #include "wx/wxprec.h"
16 
17 #if defined(__BORLANDC__)
18     #pragma hdrstop
19 #endif
20 
21 #include "wx/artprov.h"
22 
23 #ifndef WX_PRECOMP
24     #include "wx/image.h"
25 #endif
26 
27 #include "wx/osx/private.h"
28 
29 // ----------------------------------------------------------------------------
30 // wxMacArtProvider
31 // ----------------------------------------------------------------------------
32 
33 class wxMacArtProvider : public wxArtProvider
34 {
35 protected:
36 #if wxOSX_USE_COCOA_OR_CARBON
37     virtual wxIconBundle CreateIconBundle(const wxArtID& id,
38                                           const wxArtClient& client);
39 #endif
40 #if wxOSX_USE_COCOA_OR_IPHONE
CreateBitmap(const wxArtID & id,const wxArtClient & client,const wxSize & size)41     virtual wxBitmap CreateBitmap(const wxArtID& id,
42                                   const wxArtClient& client,
43                                   const wxSize& size)
44     {
45         return wxOSXCreateSystemBitmap(id, client, size);
46     }
47 #endif
48 };
49 
InitNativeProvider()50 /* static */ void wxArtProvider::InitNativeProvider()
51 {
52     PushBack(new wxMacArtProvider);
53 }
54 
55 #if wxOSX_USE_COCOA_OR_CARBON
56 
57 // ----------------------------------------------------------------------------
58 // helper macros
59 // ----------------------------------------------------------------------------
60 
61 #define CREATE_STD_ICON(iconId, xpmRc) \
62     { \
63         wxIconBundle icon(wxT(iconId), wxBITMAP_TYPE_ICON_RESOURCE); \
64         return icon; \
65     }
66 
67 // Macro used in CreateBitmap to get wxICON_FOO icons:
68 #define ART_MSGBOX(artId, iconId, xpmRc) \
69     if ( id == artId ) \
70     { \
71         CREATE_STD_ICON(#iconId, xpmRc) \
72     }
73 
wxMacArtProvider_CreateIconBundle(const wxArtID & id)74 static wxIconBundle wxMacArtProvider_CreateIconBundle(const wxArtID& id)
75 {
76     ART_MSGBOX(wxART_ERROR,       wxICON_ERROR,       error)
77     ART_MSGBOX(wxART_INFORMATION, wxICON_INFORMATION, info)
78     ART_MSGBOX(wxART_WARNING,     wxICON_WARNING,     warning)
79     ART_MSGBOX(wxART_QUESTION,    wxICON_QUESTION,    question)
80 
81     ART_MSGBOX(wxART_FOLDER,      wxICON_FOLDER,      folder)
82     ART_MSGBOX(wxART_FOLDER_OPEN, wxICON_FOLDER_OPEN, folder_open)
83     ART_MSGBOX(wxART_NORMAL_FILE, wxICON_NORMAL_FILE, deffile)
84     ART_MSGBOX(wxART_EXECUTABLE_FILE, wxICON_EXECUTABLE_FILE, exefile)
85 
86     ART_MSGBOX(wxART_CDROM,       wxICON_CDROM,       cdrom)
87     ART_MSGBOX(wxART_FLOPPY,      wxICON_FLOPPY,      floppy)
88     ART_MSGBOX(wxART_HARDDISK,    wxICON_HARDDISK,    harddisk)
89     ART_MSGBOX(wxART_REMOVABLE,   wxICON_REMOVABLE,   removable)
90 
91     ART_MSGBOX(wxART_DELETE,      wxICON_DELETE,      delete)
92 
93     ART_MSGBOX(wxART_GO_BACK,     wxICON_GO_BACK,     back)
94     ART_MSGBOX(wxART_GO_FORWARD,  wxICON_GO_FORWARD,  forward)
95     ART_MSGBOX(wxART_GO_HOME,     wxICON_GO_HOME,     home)
96 
97     ART_MSGBOX(wxART_HELP_SETTINGS, wxICON_HELP_SETTINGS, htmoptns)
98     ART_MSGBOX(wxART_HELP_PAGE,   wxICON_HELP_PAGE,   htmpage)
99 
100     return wxNullIconBundle;
101 }
102 
103 // ----------------------------------------------------------------------------
104 // CreateIconBundle
105 // ----------------------------------------------------------------------------
106 
CreateIconBundle(const wxArtID & id,const wxArtClient & client)107 wxIconBundle wxMacArtProvider::CreateIconBundle(const wxArtID& id, const wxArtClient& client)
108 {
109     // On the Mac folders in lists are always drawn closed, so if an open
110     // folder icon is asked for we will ask for a closed one in its place
111     if ( client == wxART_LIST && id == wxART_FOLDER_OPEN )
112         return wxMacArtProvider_CreateIconBundle(wxART_FOLDER);
113 
114     return wxMacArtProvider_CreateIconBundle(id);
115 }
116 
117 #endif
118 
119 // ----------------------------------------------------------------------------
120 // wxArtProvider::GetNativeSizeHint()
121 // ----------------------------------------------------------------------------
122 
123 /*static*/
GetNativeSizeHint(const wxArtClient & client)124 wxSize wxArtProvider::GetNativeSizeHint(const wxArtClient& client)
125 {
126     if ( client == wxART_TOOLBAR )
127     {
128         // See http://developer.apple.com/documentation/UserExperience/Conceptual/AppleHIGuidelines/XHIGIcons/chapter_15_section_9.html:
129         // "32 x 32 pixels is the recommended size"
130         return wxSize(32, 32);
131     }
132     else if ( client == wxART_BUTTON || client == wxART_MENU )
133     {
134         // Mac UI doesn't use any images in neither buttons nor menus in
135         // general but the code using wxArtProvider can use wxART_BUTTON to
136         // find the icons of a roughly appropriate size for the buttons and
137         // 16x16 seems to be the best choice for this kind of use
138         return wxSize(16, 16);
139     }
140 
141     return wxDefaultSize;
142 }
143 
144