X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/adf8418e3caafe5ece776cb08b33faa7c32264ba..1b7751aaa9a86d76a850b9267bc0c201e3cea30f:/interface/wx/artprov.h diff --git a/interface/wx/artprov.h b/interface/wx/artprov.h index 149e49ba42..0ef4101dbb 100644 --- a/interface/wx/artprov.h +++ b/interface/wx/artprov.h @@ -3,18 +3,91 @@ // Purpose: interface of wxArtProvider // Author: wxWidgets team // RCS-ID: $Id$ -// Licence: wxWindows license +// Licence: wxWindows licence ///////////////////////////////////////////////////////////////////////////// /** This type identifies the client of the art objects requested to wxArtProvider. */ -typedef class wxString wxArtClient; +typedef wxString wxArtClient; /** This type identifies a specific art object which can be requested to wxArtProvider. */ -typedef class wxString wxArtID; +typedef wxString wxArtID; + + +wxArtClient wxART_TOOLBAR; +wxArtClient wxART_MENU; +wxArtClient wxART_FRAME_ICON; + +wxArtClient wxART_CMN_DIALOG; +wxArtClient wxART_HELP_BROWSER; +wxArtClient wxART_MESSAGE_BOX; +wxArtClient wxART_BUTTON; +wxArtClient wxART_LIST; + +wxArtClient wxART_OTHER; + + +wxArtID wxART_ADD_BOOKMARK; +wxArtID wxART_DEL_BOOKMARK; +wxArtID wxART_HELP_SIDE_PANEL; +wxArtID wxART_HELP_SETTINGS; +wxArtID wxART_HELP_BOOK; +wxArtID wxART_HELP_FOLDER; +wxArtID wxART_HELP_PAGE; +wxArtID wxART_GO_BACK; +wxArtID wxART_GO_FORWARD; +wxArtID wxART_GO_UP; +wxArtID wxART_GO_DOWN; +wxArtID wxART_GO_TO_PARENT; +wxArtID wxART_GO_HOME; +wxArtID wxART_GOTO_FIRST; +wxArtID wxART_GOTO_LAST; +wxArtID wxART_FILE_OPEN; +wxArtID wxART_FILE_SAVE; +wxArtID wxART_FILE_SAVE_AS; +wxArtID wxART_PRINT; +wxArtID wxART_HELP; +wxArtID wxART_TIP; +wxArtID wxART_REPORT_VIEW; +wxArtID wxART_LIST_VIEW; +wxArtID wxART_NEW_DIR; +wxArtID wxART_HARDDISK; +wxArtID wxART_FLOPPY; +wxArtID wxART_CDROM; +wxArtID wxART_REMOVABLE; +wxArtID wxART_FOLDER; +wxArtID wxART_FOLDER_OPEN; +wxArtID wxART_GO_DIR_UP; +wxArtID wxART_EXECUTABLE_FILE; +wxArtID wxART_NORMAL_FILE; +wxArtID wxART_TICK_MARK; +wxArtID wxART_CROSS_MARK; +wxArtID wxART_ERROR; +wxArtID wxART_QUESTION; +wxArtID wxART_WARNING; +wxArtID wxART_INFORMATION; +wxArtID wxART_MISSING_IMAGE; + +wxArtID wxART_COPY; +wxArtID wxART_CUT; +wxArtID wxART_PASTE; +wxArtID wxART_DELETE; +wxArtID wxART_NEW; + +wxArtID wxART_UNDO; +wxArtID wxART_REDO; + +wxArtID wxART_PLUS; +wxArtID wxART_MINUS; + +wxArtID wxART_CLOSE; +wxArtID wxART_QUIT; + +wxArtID wxART_FIND; +wxArtID wxART_FIND_AND_REPLACE; /** @@ -65,57 +138,61 @@ typedef class wxString wxArtID;
- @li wxART_ERROR - @li wxART_QUESTION - @li wxART_WARNING - @li wxART_INFORMATION - @li wxART_ADD_BOOKMARK - @li wxART_DEL_BOOKMARK - @li wxART_HELP_SIDE_PANEL - @li wxART_HELP_SETTINGS - @li wxART_HELP_BOOK - @li wxART_HELP_FOLDER - @li wxART_HELP_PAGE - @li wxART_GO_BACK - @li wxART_GO_FORWARD - @li wxART_GO_UP - - @li wxART_GO_DOWN - @li wxART_GO_TO_PARENT - @li wxART_GO_HOME - @li wxART_PRINT - @li wxART_HELP - @li wxART_TIP - @li wxART_REPORT_VIEW - @li wxART_LIST_VIEW - @li wxART_NEW_DIR - @li wxART_FOLDER - @li wxART_FOLDER_OPEN - @li wxART_GO_DIR_UP - @li wxART_EXECUTABLE_FILE - @li wxART_NORMAL_FILE - @li wxART_TICK_MARK - @li wxART_CROSS_MARK - - @li wxART_MISSING_IMAGE - @li wxART_NEW - @li wxART_FILE_OPEN - @li wxART_FILE_SAVE - @li wxART_FILE_SAVE_AS - @li wxART_DELETE - @li wxART_COPY - @li wxART_CUT - @li wxART_PASTE - @li wxART_UNDO - @li wxART_REDO - @li wxART_CLOSE - @li wxART_QUIT - @li wxART_FIND - @li wxART_FIND_AND_REPLACE - @li wxART_HARDDISK - @li wxART_FLOPPY - @li wxART_CDROM - @li wxART_REMOVABLE + @li @c wxART_ERROR + @li @c wxART_QUESTION + @li @c wxART_WARNING + @li @c wxART_INFORMATION + @li @c wxART_ADD_BOOKMARK + @li @c wxART_DEL_BOOKMARK + @li @c wxART_HELP_SIDE_PANEL + @li @c wxART_HELP_SETTINGS + @li @c wxART_HELP_BOOK + @li @c wxART_HELP_FOLDER + @li @c wxART_HELP_PAGE + @li @c wxART_GO_BACK + @li @c wxART_GO_FORWARD + @li @c wxART_GO_UP + @li @c wxART_GO_DOWN + @li @c wxART_GO_TO_PARENT + @li @c wxART_GO_HOME + @li @c wxART_GOTO_FIRST (since 2.9.2) + + @li @c wxART_GOTO_LAST (since 2.9.2) + @li @c wxART_PRINT + @li @c wxART_HELP + @li @c wxART_TIP + @li @c wxART_REPORT_VIEW + @li @c wxART_LIST_VIEW + @li @c wxART_NEW_DIR + @li @c wxART_FOLDER + @li @c wxART_FOLDER_OPEN + @li @c wxART_GO_DIR_UP + @li @c wxART_EXECUTABLE_FILE + @li @c wxART_NORMAL_FILE + @li @c wxART_TICK_MARK + @li @c wxART_CROSS_MARK + @li @c wxART_MISSING_IMAGE + @li @c wxART_NEW + @li @c wxART_FILE_OPEN + @li @c wxART_FILE_SAVE + + @li @c wxART_FILE_SAVE_AS + @li @c wxART_DELETE + @li @c wxART_COPY + @li @c wxART_CUT + @li @c wxART_PASTE + @li @c wxART_UNDO + @li @c wxART_REDO + @li @c wxART_PLUS (since 2.9.2) + @li @c wxART_MINUS (since 2.9.2) + @li @c wxART_CLOSE + @li @c wxART_QUIT + @li @c wxART_FIND + @li @c wxART_FIND_AND_REPLACE + @li @c wxART_HARDDISK + @li @c wxART_FLOPPY + @li @c wxART_CDROM + @li @c wxART_REMOVABLE
@@ -130,12 +207,13 @@ typedef class wxString wxArtID; wxBitmap bmp = wxArtProvider::GetBitmap("gtk-cdrom", wxART_MENU); #endif @endcode - For a list of the GTK+ stock items please refer to the GTK+ documentation page - http://library.gnome.org/devel/gtk/stable/gtk-Stock-Items.html. + For a list of the GTK+ stock items please refer to the + GTK+ documentation + page. It is also possible to load icons from the current icon theme by specifying their name (without extension and directory components). - Icon themes recognized by GTK+ follow the freedesktop.org Icon Themes specification - (see http://freedesktop.org/Standards/icon-theme-spec). + Icon themes recognized by GTK+ follow the freedesktop.org + Icon Themes specification. Note that themes are not guaranteed to contain all icons, so wxArtProvider may return ::wxNullBitmap or ::wxNullIcon. The default theme is typically installed in @c /usr/share/icons/hicolor. @@ -146,14 +224,14 @@ typedef class wxString wxArtID; The @e client is the entity that calls wxArtProvider's GetBitmap() or GetIcon() function. It is represented by wxClientID type and can have one of these values: - @li wxART_TOOLBAR - @li wxART_MENU - @li wxART_BUTTON - @li wxART_FRAME_ICON - @li wxART_CMN_DIALOG - @li wxART_HELP_BROWSER - @li wxART_MESSAGE_BOX - @li wxART_OTHER (used for all requests that don't fit into any of the + @li @c wxART_TOOLBAR + @li @c wxART_MENU + @li @c wxART_BUTTON + @li @c wxART_FRAME_ICON + @li @c wxART_CMN_DIALOG + @li @c wxART_HELP_BROWSER + @li @c wxART_MESSAGE_BOX + @li @c wxART_OTHER (used for all requests that don't fit into any of the categories above) Client ID serve as a hint to wxArtProvider that is supposed to help it to @@ -166,7 +244,8 @@ typedef class wxString wxArtID; @library{wxcore} @category{misc} - @see the @ref page_samples_artprov for an example of wxArtProvider usage. + @see @ref page_samples_artprov for an example of wxArtProvider usage; + @ref page_stockitems "stock ID list" */ class wxArtProvider : public wxObject { @@ -299,6 +378,21 @@ public: */ static bool Remove(wxArtProvider* provider); + /** + * Helper used by GetMessageBoxIcon(): return the art id corresponding to + * the standard wxICON_INFORMATION/WARNING/ERROR/QUESTION flags (only one + * can be set) + */ + static wxArtID GetMessageBoxIconId(int flags); + + /** + * Helper used by several generic classes: return the icon corresponding to + * the standard wxICON_INFORMATION/WARNING/ERROR/QUESTION flags (only one + * can be set) + */ + static wxIcon GetMessageBoxIcon(int flags); + + protected: /**