/usr/include/Wt/WTheme is in libwt-dev 3.3.3+dfsg-4.1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 | // This may look like C code, but it's really -*- C++ -*-
/*
* Copyright (C) 2012 Emweb bvba, Kessel-Lo, Belgium.
*
* See the LICENSE file for terms of use.
*/
#ifndef WT_WTHEME_H
#define WT_WTHEME_H
#include <Wt/WObject>
#include <Wt/WGlobal>
#include <Wt/WValidator>
namespace Wt {
class DomElement;
class WStringStream;
/*! \brief Enumeration for the role of a subwidget (for theme support)
*
* \sa WTheme::apply()
*/
enum WidgetThemeRole {
MenuItemIconRole = 100,
MenuItemCheckBoxRole = 101,
MenuItemCloseRole = 102,
DialogCoverRole = 200,
DialogTitleBarRole = 201,
DialogBodyRole = 202,
DialogFooterRole = 203,
DialogCloseIconRole = 204,
DialogContent = 205, // For bootstrap 3 modal-content style
TableViewRowContainerRole = 300,
DatePickerPopupRole = 400,
PanelTitleBarRole = 500,
PanelCollapseButtonRole = 501,
PanelTitleRole = 502,
PanelBodyRole = 503,
AuthWidgets = 600,
InPlaceEditingRole = 700,
NavbarRole = 800,
NavCollapseRole = 801,
NavBrandRole = 802,
NavbarSearchRole = 803,
NavbarMenuRole = 804,
NavbarBtn = 805,
NavbarAlignLeftRole = 806,
NavbarAlignRightRole = 807
};
/*! \brief Enumeration for the role of a css class (for theme support)
*
* \sa WTheme::utilityCssClass()
*/
enum UtilityCssClassRole {
ToolTipInner = 100,
ToolTipOuter = 101
};
/*! \brief Enumeration for the role of a DOM element (for theme support)
*
* \sa WTheme::apply()
*/
enum ElementThemeRole {
MainElementThemeRole = 0,
ProgressBarBarRole = 100,
ProgressBarLabelRole = 101
};
/*! \brief Enumeration that indicates what validation styles are to be applie
*
* \sa WTheme::applyValidationStyle()
*/
enum ValidationStyleFlag {
ValidationInvalidStyle = 0x1,
ValidationValidStyle = 0x2
};
W_DECLARE_OPERATORS_FOR_FLAGS(ValidationStyleFlag)
/** \brief Remove validation styles */
static const WFlags<ValidationStyleFlag> ValidationNoStyle = 0;
/** \brief All validation styles */
static const WFlags<ValidationStyleFlag> ValidationAllStyles
= ValidationInvalidStyle | ValidationValidStyle;
/*! \class WTheme Wt/WTheme Wt/WTheme
*
* Abstract base class for themes in %Wt.
*
* \sa WApplication::setTheme()
*/
class WT_API WTheme : public WObject
{
public:
/*! \brief Constructor.
*/
WTheme(WObject *parent = 0);
/*! \brief Destructor.
*/
virtual ~WTheme();
/*! \brief Returns a theme name.
*
* Returns a unique name for the theme. This name is used by the default
* implementation of resourcesUrl() to compute a location for the theme's
* resources.
*/
virtual std::string name() const = 0;
/*! \brief Returns the URL where theme-related resources are stored.
*
* The default implementation considers a folder within %Wt's
* resource directory, based on the theme name().
*/
virtual std::string resourcesUrl() const;
/*! \brief Serves the CSS for the theme.
*
* This must serve CSS declarations for the theme.
*
* The default implementation serves all the styleSheets().
*/
virtual void serveCss(WStringStream& out) const;
/*! \brief Returns a vector with stylesheets for the theme.
*
* This should return a vector with stylesheets that implement the
* theme. This list may be tailored to the current user agent, which
* is read from the application environment.
*/
virtual std::vector<WCssStyleSheet> styleSheets() const = 0;
/*! \brief Applies the theme to a child of a composite widget.
*
* The \p widgetRole indicates the role that \p child has within the
* implementation of the \p widget.
*/
virtual void apply(WWidget *widget, WWidget *child, int widgetRole)
const = 0;
/*! \brief Applies the theme to a DOM element that renders a widget.
*
* The \p element is a rendered representation of the \p widget, and
* may be further customized to reflect the theme.
*/
virtual void apply(WWidget *widget, DomElement& element, int elementRole)
const = 0;
/*! \brief Returns a generic CSS class name for a disabled element.
*/
virtual std::string disabledClass() const = 0;
/*! \brief Returns a generic CSS class name for an active element.
*/
virtual std::string activeClass() const = 0;
/*! \brief Returns a generic CSS class name for the chosen role.
*
* \sa WTheme::utilityCssClassRole
*/
virtual std::string utilityCssClass(int utilityCssClassRole) const = 0;
/*! \brief Returns whether the theme allows for an anchor to be styled
* as a button.
*/
virtual bool canStyleAnchorAsButton() const = 0;
/*! \brief Applies a style that indicates the result of validation.
*/
virtual void applyValidationStyle(WWidget *widget,
const Wt::WValidator::Result& validation,
WFlags<ValidationStyleFlag> flags) const
= 0;
virtual bool canBorderBoxElement(const DomElement& element) const = 0;
};
}
#endif // WT_WTHEME_H
|