ae7fa19ae3
This improves the changes of f78db92462 (Avoid bitmap scaling in
wxArtProvider::GetBitmapBundle(), 2021-12-17) and still uses a custom
bundle to avoid scaling the bitmap if possible, but does it in
GetBitmapBundle() itself rather than CreateBitmapBundle().
This allows to also use CreateBitmapBundle() from GetBitmap(), as there
is no possibility of infinite recursion due to calling each of these
functions from the other one any more, and so allows defining art
providers overriding only CreateBitmapBundle() instead of having to
always override both it and CreateBitmap().
Also add a unit test, even if just a trivial one, for these functions,
to at least check that they don't crash.
281 lines
12 KiB
C++
281 lines
12 KiB
C++
/////////////////////////////////////////////////////////////////////////////
|
|
// Name: wx/artprov.h
|
|
// Purpose: wxArtProvider class
|
|
// Author: Vaclav Slavik
|
|
// Modified by:
|
|
// Created: 18/03/2002
|
|
// Copyright: (c) Vaclav Slavik
|
|
// Licence: wxWindows licence
|
|
/////////////////////////////////////////////////////////////////////////////
|
|
|
|
#ifndef _WX_ARTPROV_H_
|
|
#define _WX_ARTPROV_H_
|
|
|
|
#include "wx/string.h"
|
|
#include "wx/bitmap.h"
|
|
#include "wx/icon.h"
|
|
#include "wx/iconbndl.h"
|
|
#include "wx/bmpbndl.h"
|
|
|
|
class WXDLLIMPEXP_FWD_CORE wxArtProvidersList;
|
|
class WXDLLIMPEXP_FWD_CORE wxArtProviderCache;
|
|
class wxArtProviderModule;
|
|
|
|
// ----------------------------------------------------------------------------
|
|
// Types
|
|
// ----------------------------------------------------------------------------
|
|
|
|
typedef wxString wxArtClient;
|
|
typedef wxString wxArtID;
|
|
|
|
#define wxART_MAKE_CLIENT_ID_FROM_STR(id) ((id) + wxASCII_STR("_C"))
|
|
#define wxART_MAKE_CLIENT_ID(id) (#id "_C")
|
|
#define wxART_MAKE_ART_ID_FROM_STR(id) (id)
|
|
#define wxART_MAKE_ART_ID(id) (#id)
|
|
|
|
// ----------------------------------------------------------------------------
|
|
// Art clients
|
|
// ----------------------------------------------------------------------------
|
|
|
|
#define wxART_TOOLBAR wxART_MAKE_CLIENT_ID(wxART_TOOLBAR)
|
|
#define wxART_MENU wxART_MAKE_CLIENT_ID(wxART_MENU)
|
|
#define wxART_FRAME_ICON wxART_MAKE_CLIENT_ID(wxART_FRAME_ICON)
|
|
|
|
#define wxART_CMN_DIALOG wxART_MAKE_CLIENT_ID(wxART_CMN_DIALOG)
|
|
#define wxART_HELP_BROWSER wxART_MAKE_CLIENT_ID(wxART_HELP_BROWSER)
|
|
#define wxART_MESSAGE_BOX wxART_MAKE_CLIENT_ID(wxART_MESSAGE_BOX)
|
|
#define wxART_BUTTON wxART_MAKE_CLIENT_ID(wxART_BUTTON)
|
|
#define wxART_LIST wxART_MAKE_CLIENT_ID(wxART_LIST)
|
|
|
|
#define wxART_OTHER wxART_MAKE_CLIENT_ID(wxART_OTHER)
|
|
|
|
// ----------------------------------------------------------------------------
|
|
// Art IDs
|
|
// ----------------------------------------------------------------------------
|
|
|
|
#define wxART_ADD_BOOKMARK wxART_MAKE_ART_ID(wxART_ADD_BOOKMARK)
|
|
#define wxART_DEL_BOOKMARK wxART_MAKE_ART_ID(wxART_DEL_BOOKMARK)
|
|
#define wxART_HELP_SIDE_PANEL wxART_MAKE_ART_ID(wxART_HELP_SIDE_PANEL)
|
|
#define wxART_HELP_SETTINGS wxART_MAKE_ART_ID(wxART_HELP_SETTINGS)
|
|
#define wxART_HELP_BOOK wxART_MAKE_ART_ID(wxART_HELP_BOOK)
|
|
#define wxART_HELP_FOLDER wxART_MAKE_ART_ID(wxART_HELP_FOLDER)
|
|
#define wxART_HELP_PAGE wxART_MAKE_ART_ID(wxART_HELP_PAGE)
|
|
#define wxART_GO_BACK wxART_MAKE_ART_ID(wxART_GO_BACK)
|
|
#define wxART_GO_FORWARD wxART_MAKE_ART_ID(wxART_GO_FORWARD)
|
|
#define wxART_GO_UP wxART_MAKE_ART_ID(wxART_GO_UP)
|
|
#define wxART_GO_DOWN wxART_MAKE_ART_ID(wxART_GO_DOWN)
|
|
#define wxART_GO_TO_PARENT wxART_MAKE_ART_ID(wxART_GO_TO_PARENT)
|
|
#define wxART_GO_HOME wxART_MAKE_ART_ID(wxART_GO_HOME)
|
|
#define wxART_GOTO_FIRST wxART_MAKE_ART_ID(wxART_GOTO_FIRST)
|
|
#define wxART_GOTO_LAST wxART_MAKE_ART_ID(wxART_GOTO_LAST)
|
|
#define wxART_FILE_OPEN wxART_MAKE_ART_ID(wxART_FILE_OPEN)
|
|
#define wxART_FILE_SAVE wxART_MAKE_ART_ID(wxART_FILE_SAVE)
|
|
#define wxART_FILE_SAVE_AS wxART_MAKE_ART_ID(wxART_FILE_SAVE_AS)
|
|
#define wxART_PRINT wxART_MAKE_ART_ID(wxART_PRINT)
|
|
#define wxART_HELP wxART_MAKE_ART_ID(wxART_HELP)
|
|
#define wxART_TIP wxART_MAKE_ART_ID(wxART_TIP)
|
|
#define wxART_REPORT_VIEW wxART_MAKE_ART_ID(wxART_REPORT_VIEW)
|
|
#define wxART_LIST_VIEW wxART_MAKE_ART_ID(wxART_LIST_VIEW)
|
|
#define wxART_NEW_DIR wxART_MAKE_ART_ID(wxART_NEW_DIR)
|
|
#define wxART_HARDDISK wxART_MAKE_ART_ID(wxART_HARDDISK)
|
|
#define wxART_FLOPPY wxART_MAKE_ART_ID(wxART_FLOPPY)
|
|
#define wxART_CDROM wxART_MAKE_ART_ID(wxART_CDROM)
|
|
#define wxART_REMOVABLE wxART_MAKE_ART_ID(wxART_REMOVABLE)
|
|
#define wxART_FOLDER wxART_MAKE_ART_ID(wxART_FOLDER)
|
|
#define wxART_FOLDER_OPEN wxART_MAKE_ART_ID(wxART_FOLDER_OPEN)
|
|
#define wxART_GO_DIR_UP wxART_MAKE_ART_ID(wxART_GO_DIR_UP)
|
|
#define wxART_EXECUTABLE_FILE wxART_MAKE_ART_ID(wxART_EXECUTABLE_FILE)
|
|
#define wxART_NORMAL_FILE wxART_MAKE_ART_ID(wxART_NORMAL_FILE)
|
|
#define wxART_TICK_MARK wxART_MAKE_ART_ID(wxART_TICK_MARK)
|
|
#define wxART_CROSS_MARK wxART_MAKE_ART_ID(wxART_CROSS_MARK)
|
|
#define wxART_ERROR wxART_MAKE_ART_ID(wxART_ERROR)
|
|
#define wxART_QUESTION wxART_MAKE_ART_ID(wxART_QUESTION)
|
|
#define wxART_WARNING wxART_MAKE_ART_ID(wxART_WARNING)
|
|
#define wxART_INFORMATION wxART_MAKE_ART_ID(wxART_INFORMATION)
|
|
#define wxART_MISSING_IMAGE wxART_MAKE_ART_ID(wxART_MISSING_IMAGE)
|
|
|
|
#define wxART_COPY wxART_MAKE_ART_ID(wxART_COPY)
|
|
#define wxART_CUT wxART_MAKE_ART_ID(wxART_CUT)
|
|
#define wxART_PASTE wxART_MAKE_ART_ID(wxART_PASTE)
|
|
#define wxART_DELETE wxART_MAKE_ART_ID(wxART_DELETE)
|
|
#define wxART_NEW wxART_MAKE_ART_ID(wxART_NEW)
|
|
|
|
#define wxART_UNDO wxART_MAKE_ART_ID(wxART_UNDO)
|
|
#define wxART_REDO wxART_MAKE_ART_ID(wxART_REDO)
|
|
|
|
#define wxART_PLUS wxART_MAKE_ART_ID(wxART_PLUS)
|
|
#define wxART_MINUS wxART_MAKE_ART_ID(wxART_MINUS)
|
|
|
|
#define wxART_CLOSE wxART_MAKE_ART_ID(wxART_CLOSE)
|
|
#define wxART_QUIT wxART_MAKE_ART_ID(wxART_QUIT)
|
|
|
|
#define wxART_FIND wxART_MAKE_ART_ID(wxART_FIND)
|
|
#define wxART_FIND_AND_REPLACE wxART_MAKE_ART_ID(wxART_FIND_AND_REPLACE)
|
|
|
|
#define wxART_FULL_SCREEN wxART_MAKE_ART_ID(wxART_FULL_SCREEN)
|
|
|
|
#define wxART_EDIT wxART_MAKE_ART_ID(wxART_EDIT)
|
|
|
|
#define wxART_WX_LOGO wxART_MAKE_ART_ID(wxART_WX_LOGO)
|
|
|
|
// ----------------------------------------------------------------------------
|
|
// wxArtProvider class
|
|
// ----------------------------------------------------------------------------
|
|
|
|
class WXDLLIMPEXP_CORE wxArtProvider : public wxObject
|
|
{
|
|
public:
|
|
// Dtor removes the provider from providers stack if it's still on it
|
|
virtual ~wxArtProvider();
|
|
|
|
// Does this platform implement native icons theme?
|
|
static bool HasNativeProvider();
|
|
|
|
// Add new provider to the top of providers stack (i.e. the provider will
|
|
// be queried first of all).
|
|
static void Push(wxArtProvider *provider);
|
|
|
|
// Add new provider to the bottom of providers stack (i.e. the provider
|
|
// will be queried as the last one).
|
|
static void PushBack(wxArtProvider *provider);
|
|
|
|
#if WXWIN_COMPATIBILITY_2_8
|
|
// use PushBack(), it's the same thing
|
|
wxDEPRECATED( static void Insert(wxArtProvider *provider) );
|
|
#endif
|
|
|
|
// Remove latest added provider and delete it.
|
|
static bool Pop();
|
|
|
|
// Remove provider from providers stack but don't delete it.
|
|
static bool Remove(wxArtProvider *provider);
|
|
|
|
// Delete the given provider and remove it from the providers stack.
|
|
static bool Delete(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 = wxASCII_STR(wxART_OTHER),
|
|
const wxSize& size = wxDefaultSize);
|
|
|
|
// Query the providers for bitmapbundle with given ID and return it.
|
|
// If none is available, then the search for a bitmap with the same properties
|
|
// is performed. If successful, the bitmap is wrapped into a bitmap bundle.
|
|
static wxBitmapBundle
|
|
GetBitmapBundle(const wxArtID& id,
|
|
const wxArtClient& client = wxASCII_STR(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 = wxASCII_STR(wxART_OTHER),
|
|
const wxSize& size = wxDefaultSize);
|
|
|
|
// 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)
|
|
{
|
|
return GetIcon(GetMessageBoxIconId(flags), wxASCII_STR(wxART_MESSAGE_BOX));
|
|
}
|
|
|
|
// Query the providers for iconbundle with given ID and return it. Return
|
|
// wxNullIconBundle if no provider provides it.
|
|
static wxIconBundle GetIconBundle(const wxArtID& id,
|
|
const wxArtClient& client = wxASCII_STR(wxART_OTHER));
|
|
|
|
// Gets native size for given 'client' or wxDefaultSize if it doesn't
|
|
// have native equivalent
|
|
static wxSize GetNativeSizeHint(const wxArtClient& client);
|
|
|
|
// Get the size hint of an icon from a specific wxArtClient, queries
|
|
// the topmost provider if platform_dependent = false
|
|
static wxSize GetSizeHint(const wxArtClient& client, bool platform_dependent = false);
|
|
|
|
#if WXWIN_COMPATIBILITY_3_0
|
|
wxDEPRECATED_MSG("use wxBitmap::Rescale() instead.")
|
|
static void RescaleBitmap(wxBitmap& bmp, const wxSize& sizeNeeded);
|
|
#endif // WXWIN_COMPATIBILITY_3_0
|
|
|
|
protected:
|
|
friend class wxArtProviderModule;
|
|
#if wxUSE_ARTPROVIDER_STD
|
|
// Initializes default provider
|
|
static void InitStdProvider();
|
|
#endif // wxUSE_ARTPROVIDER_STD
|
|
// Initializes Tango-based icon provider
|
|
#if wxUSE_ARTPROVIDER_TANGO
|
|
static void InitTangoProvider();
|
|
#endif // wxUSE_ARTPROVIDER_TANGO
|
|
// Initializes platform's native provider, if available (e.g. GTK2)
|
|
static void InitNativeProvider();
|
|
// Destroy caches & all providers
|
|
static void CleanUpProviders();
|
|
|
|
// Get the default size of an icon for a specific client
|
|
virtual wxSize DoGetSizeHint(const wxArtClient& client)
|
|
{
|
|
return GetSizeHint(client, true);
|
|
}
|
|
|
|
// Derived classes must override at least one of the CreateXXX() functions
|
|
// below to create requested art resource. Overriding more than one of them
|
|
// is also possible but is usually not needed, as both GetBitmap() and
|
|
// GetBitmapBundle() will try using both CreateBitmap() and
|
|
// CreateBitmapBundle().
|
|
//
|
|
// Note that these methods are called only once per instance's lifetime for
|
|
// each requested wxArtID as the return value is cached.
|
|
virtual wxBitmap CreateBitmap(const wxArtID& WXUNUSED(id),
|
|
const wxArtClient& WXUNUSED(client),
|
|
const wxSize& WXUNUSED(size))
|
|
{
|
|
return wxNullBitmap;
|
|
}
|
|
|
|
virtual wxBitmapBundle CreateBitmapBundle(const wxArtID& WXUNUSED(id),
|
|
const wxArtClient& WXUNUSED(client),
|
|
const wxSize& WXUNUSED(size))
|
|
{
|
|
return wxBitmapBundle();
|
|
}
|
|
|
|
virtual wxIconBundle CreateIconBundle(const wxArtID& WXUNUSED(id),
|
|
const wxArtClient& WXUNUSED(client))
|
|
{
|
|
return wxNullIconBundle;
|
|
}
|
|
|
|
private:
|
|
static void CommonAddingProvider();
|
|
static wxIconBundle DoGetIconBundle(const wxArtID& id,
|
|
const wxArtClient& client);
|
|
|
|
private:
|
|
// list of providers:
|
|
static wxArtProvidersList *sm_providers;
|
|
// art resources cache (so that CreateXXX is not called that often):
|
|
static wxArtProviderCache *sm_cache;
|
|
|
|
wxDECLARE_ABSTRACT_CLASS(wxArtProvider);
|
|
};
|
|
|
|
|
|
#if !defined(__WXUNIVERSAL__) && \
|
|
((defined(__WXGTK__) && defined(__WXGTK20__)) || defined(__WXMSW__) || \
|
|
defined(__WXMAC__))
|
|
// *some* (partial) native implementation of wxArtProvider exists; this is
|
|
// not the same as wxArtProvider::HasNativeProvider()!
|
|
#define wxHAS_NATIVE_ART_PROVIDER_IMPL
|
|
#endif
|
|
|
|
#endif // _WX_ARTPROV_H_
|