#include <Pt/Forms/ButtonStyler.h>
Binds a push button to the current style renderer. More...
Inherits Styler.
Public Member Functions | |
| ButtonStyler () | |
| Constructs an unbound button styler. | |
| const Gfx::Brush & | foreground () const |
| Returns the effective foreground brush. | |
| void | setForeground (const Gfx::Brush &brush) |
| Sets the widget-local foreground brush to brush. | |
| const Gfx::Pen & | contour () const |
| Returns the effective contour pen. | |
| void | setContour (const Gfx::Pen &pen) |
| Sets the widget-local contour pen to pen. | |
| const Gfx::Color & | accentColor () const |
| Returns the effective accent color. | |
| void | setAccentColor (const Gfx::Color &color) |
| Sets the widget-local accent color to color. | |
| const Gfx::Color & | highlightColor () const |
| Returns the effective highlight color. | |
| void | setHighlightColor (const Gfx::Color &color) |
| Sets the widget-local highlight color to color. | |
| const Gfx::Color & | textColor () const |
| Returns the effective text color. | |
| void | setTextColor (const Gfx::Color &color) |
| Sets the widget-local text color to color. | |
| Gfx::Font | font () const |
| Returns the effective font. | |
| void | setFont (const Gfx::Font &font) |
| Sets the widget-local font to font. | |
| void | setFontSize (std::size_t size) |
| Sets the widget-local font size to size. | |
| void | setFontWeight (Gfx::Font::Weight weight) |
| Sets the widget-local font weight to weight. | |
| void | setFontSlant (Gfx::Font::Slant slant) |
| Sets the widget-local font slant to slant. | |
| bool | prepareIcon (const Gfx::Image &icon, Pixmap &picture, const ButtonState &state) const |
| Prepares picture from icon for state. | |
| void | measureText (PaintSurface &surface, const String &text, Gfx::TextMetrics &textMetrics, Gfx::FontMetrics &fontMetrics) const |
| Measures text and stores its metrics for surface. | |
| Gfx::SizeF | measureContent (PaintSurface &surface, Direction direction, const Gfx::SizeF &iconSize, const Gfx::SizeF &textSize) const |
| Measures icon and text content arranged by direction. | |
| Gfx::SizeF | measureFrame (PaintSurface &surface, const Gfx::SizeF &contentSize) const |
| Measures the frame enclosing contentSize. | |
| Gfx::RectF | layoutFrame (PaintSurface &surface, const Gfx::RectF &frameRect) const |
| Returns the frame content rectangle within frameRect. | |
| void | layoutContent (PaintSurface &surface, const Gfx::RectF &contentRect, Direction direction, const Gfx::SizeF &iconSize, const Gfx::SizeF &textSize, Gfx::RectF &iconRect, Gfx::RectF &textRect) const |
| Lays out icon and text rectangles within contentRect. | |
| Gfx::RectF | layoutMnemonic (PaintSurface &surface, const String &text, const Gfx::PointF &textPos, const Gfx::FontMetrics &fontMetrics, String::size_type mnemonicIndex) const |
| Returns the mnemonic underline rectangle for mnemonicIndex. | |
| void | renderBackground (PaintContext &context, const Gfx::RectF &rect, const ButtonState &state) const |
| Renders the button background within rect for state. | |
| void | renderChrome (PaintContext &context, const Gfx::RectF &rect, const ButtonState &state) const |
| Renders the button chrome within rect for state. | |
| void | renderText (PaintContext &context, const Gfx::RectF &rect, const String &text, const Gfx::PointF &pos, const ButtonState &state) const |
| Renders text at pos within rect for state. | |
| void | renderMnemonic (PaintContext &context, const Gfx::RectF &rect, const Gfx::RectF &mnemonic, const ButtonState &state) const |
| Renders the mnemonic underline within mnemonic for state. | |
| void | renderIcon (PaintContext &context, const Gfx::RectF &rect, const Pixmap &picture, const Gfx::PointF &pos, const ButtonState &state) const |
| Renders picture at pos within rect for state. | |
| void | setRenderer (ButtonRenderer *renderer=0) |
| Assigns a specific button renderer. | |
| StyleOptions & | options () |
| Returns the bound effective button options. | |
| const StyleOptions & | options () const |
| Returns the bound effective button options. | |
| bool | bind (const Style &style, const StyleOptions &styleOptions) |
| Binds this styler to style and styleOptions. | |
| bool | isBound () const |
| Returns true if a renderer is bound. | |
Protected Member Functions | |
| virtual StyleOptions & | onBindOptions (const StyleOptions &styleOptions) |
| Binds the overlay to styleOptions and returns it. | |
| virtual Renderer * | onStyleRenderer (const Style &style) |
| Returns the shared button renderer from style, or 0. | |
| virtual Renderer * | onCreateRenderer (const Style &style) |
| Creates an independent clone of the style renderer, or 0. | |
| void | init (Renderer *renderer) |
| Replaces the bound renderer with renderer. | |
A PushButton owns a ButtonStyler. Applications do not construct one. Call Styler::bind() from onInvalidate(). When the overlay has no local options, bind uses the shared renderer from the style. Local options use a private clone. setRenderer() keeps an assigned renderer until it is cleared. A null renderer falls back on the next bind.
Appearance getters return effective tokens after bind. Setters write widget-local options. Measure, layout, and paint call the typed methods on this styler, not a public renderer accessor.
| bool prepareIcon | ( | const Gfx::Image & | icon, |
| Pixmap & | picture, | ||
| const ButtonState & | state ) const |
Returns true when a bound renderer prepared picture.
| StyleOptions & options | ( | ) |
Use StyleOptions::findLocal() to query an explicit widget-local token.
|
inherited |
Returns true when the effective renderer or the effective options changed.
|
protectedinherited |
A non-null renderer is a custom renderer. bind() keeps it until init() is called with 0, which falls back to the current style.