X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/3c99e2fd1b3432974b892be508c0757da5b6ad49..4fe4a7c50f6d65642adad374e3b2fc6eb5f5b58a:/interface/wx/artprov.h diff --git a/interface/wx/artprov.h b/interface/wx/artprov.h index b141297fb5..3b4f092095 100644 --- a/interface/wx/artprov.h +++ b/interface/wx/artprov.h @@ -3,18 +3,18 @@ // 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 wxString wxArtClient; +typedef class wxString wxArtClient; /** This type identifies a specific art object which can be requested to wxArtProvider. */ -typedef wxString wxArtID; +typedef class wxString wxArtID; /** @@ -59,62 +59,67 @@ typedef wxString wxArtID; @section artprovider_identify Identifying art resources Every bitmap and icon bundle are known to wxArtProvider under an unique ID that - is used when requesting a resource from it. The ID is represented by wxArtID type + is used when requesting a resource from it. The ID is represented by the ::wxArtID type and can have one of these predefined values (you can see bitmaps represented by these constants in the @ref page_samples_artprov):
- @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_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
@@ -125,17 +130,17 @@ typedef wxString wxArtID; When running under GTK+ 2, GTK+ stock item IDs (e.g. @c "gtk-cdrom") may be used as well: @code - #ifdef __WXGTK__ + #ifdef __WXGTK__ wxBitmap bmp = wxArtProvider::GetBitmap("gtk-cdrom", wxART_MENU); - #endif + #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. - Additionally, if wxGTK was compiled against GTK+ >= 2.4, then it is also - possible to load icons from 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). + 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. 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 +151,14 @@ typedef 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 +171,8 @@ typedef 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 {