wxWidgets/include/wx/artprov.h
Václav Slavík 0e04ef47f6 move wxApp::GetStdIcon to wxArtProvider
git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@14746 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
2002-03-24 00:19:01 +00:00

137 lines
5.2 KiB
C++

/////////////////////////////////////////////////////////////////////////////
// Name: artprov.h
// Purpose: wxArtProvider class
// Author: Vaclav Slavik
// Modified by:
// Created: 18/03/2002
// RCS-ID: $Id$
// Copyright: (c) Vaclav Slavik
// Licence: wxWindows licence
/////////////////////////////////////////////////////////////////////////////
#ifndef _WX_ARTPROV_H_
#define _WX_ARTPROV_H_
#ifdef __GNUG__
#pragma interface "artprov.h"
#endif
#include "wx/string.h"
#include "wx/bitmap.h"
#include "wx/icon.h"
class WXDLLEXPORT wxArtProvidersList;
class WXDLLEXPORT wxArtProviderCache;
// ----------------------------------------------------------------------------
// Types
// ----------------------------------------------------------------------------
typedef wxString wxArtClient;
typedef wxString wxArtID;
// ----------------------------------------------------------------------------
// Art clients
// ----------------------------------------------------------------------------
#define wxART_TOOLBAR _T("toolbar_C")
#define wxART_MENU _T("menu_C")
#define wxART_FRAME_ICON _T("frame_icon_C")
#define wxART_CMN_DIALOG _T("cmn_dialog_C")
#define wxART_HELP_BROWSER _T("help_browser_C")
#define wxART_MESSAGE_BOX _T("message_box_C")
#define wxART_OTHER _T("other_C")
// ----------------------------------------------------------------------------
// Art IDs
// ----------------------------------------------------------------------------
#define wxART_ADD_BOOKMARK _T("add_bookmark")
#define wxART_DEL_BOOKMARK _T("del_bookmark")
#define wxART_HELP_SIDE_PANEL _T("help_side_panel")
#define wxART_HELP_SETTINGS _T("help_settings")
#define wxART_HELP_BOOK _T("help_book")
#define wxART_HELP_FOLDER _T("help_folder")
#define wxART_HELP_PAGE _T("help_page")
#define wxART_GO_BACK _T("go_back")
#define wxART_GO_FORWARD _T("go_forward")
#define wxART_GO_UP _T("go_up")
#define wxART_GO_DOWN _T("go_down")
#define wxART_GO_TO_PARENT _T("go_to_parent")
#define wxART_GO_HOME _T("go_home")
#define wxART_FILE_OPEN _T("file_open")
#define wxART_PRINT _T("print")
#define wxART_HELP _T("help")
#define wxART_TIP _T("tip")
#define wxART_REPORT_VIEW _T("report_view")
#define wxART_LIST_VIEW _T("list_view")
#define wxART_NEW_DIR _T("new_dir")
#define wxART_FOLDER _T("folder")
#define wxART_GO_DIR_UP _T("go_dir_up")
#define wxART_EXECUTABLE_FILE _T("executable_file")
#define wxART_NORMAL_FILE _T("normal_file")
#define wxART_TICK_MARK _T("tick")
#define wxART_CROSS_MARK _T("cross")
#define wxART_ERROR _T("error")
#define wxART_QUESTION _T("question")
#define wxART_WARNING _T("warning")
#define wxART_INFORMATION _T("information")
// ----------------------------------------------------------------------------
// wxArtProvider class
// ----------------------------------------------------------------------------
class WXDLLEXPORT wxArtProvider : public wxObject
{
public:
// Add new provider to the top of providers stack.
static void PushProvider(wxArtProvider *provider);
// Remove latest added provider and delete it.
static bool PopProvider();
// Remove provider. The provider must have been added previously!
// The provider is _not_ deleted.
static bool RemoveProvider(wxArtProvider *provider);
// Query the providers for bitmap with given ID and return it. Return
// wxNullBitmap if no provider provides it.
static wxBitmap GetBitmap(const wxArtID& id,
const wxArtClient& client = wxART_OTHER,
const wxSize& size = wxDefaultSize);
// Query the providers for icon with given ID and return it. Return
// wxNullIcon if no provider provides it.
static wxIcon GetIcon(const wxArtID& id,
const wxArtClient& client = wxART_OTHER,
const wxSize& size = wxDefaultSize);
// Destroy caches & all providers
static void CleanUpProviders();
protected:
// Derived classes must override this method to create requested
// art resource. This method is called only once per instance's
// lifetime for each requested wxArtID.
virtual wxBitmap CreateBitmap(const wxArtID& WXUNUSED(id),
const wxArtClient& WXUNUSED(client),
const wxSize& WXUNUSED(size))
{
wxFAIL_MSG(_T("pure virtual method wxArtProvider::CreateBitmap called!"));
return wxNullBitmap;
}
private:
// list of providers:
static wxArtProvidersList *sm_providers;
// art resources cache (so that CreateXXX is not called that often):
static wxArtProviderCache *sm_cache;
DECLARE_ABSTRACT_CLASS(wxArtProvider)
};
#endif // _WX_ARTPROV_H_