// // Urho3D Engine // Copyright (c) 2008-2011 Lasse Öörni // // Permission is hereby granted, free of charge, to any person obtaining a copy // of this software and associated documentation files (the "Software"), to deal // in the Software without restriction, including without limitation the rights // to use, copy, modify, merge, publish, distribute, sublicense, and/or sell // copies of the Software, and to permit persons to whom the Software is // furnished to do so, subject to the following conditions: // // The above copyright notice and this permission notice shall be included in // all copies or substantial portions of the Software. // // THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR // IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, // FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE // AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER // LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, // OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN // THE SOFTWARE. // #pragma once #include "UIElement.h" static const int DEFAULT_FONT_SIZE = 12; class Font; /// Text UI element class Text : public UIElement { OBJECT(Text); using UIElement::SetStyle; public: /// Construct Text(Context* context); /// Destruct virtual ~Text(); /// Register object factory static void RegisterObject(Context* context); /// Set UI element style from XML data virtual void SetStyle(const XMLElement& element); /// Return UI rendering batches virtual void GetBatches(PODVector& batches, PODVector& quads, const IntRect& currentScissor); /// React to resize virtual void OnResize(); /// Set font and font size bool SetFont(const std::string& fontName, int size = DEFAULT_FONT_SIZE); /// Set font and font size bool SetFont(Font* font, int size = DEFAULT_FONT_SIZE); /// Set text void SetText(const std::string& text); /// Set row alignment void SetTextAlignment(HorizontalAlignment align); /// Set row spacing, 1.0 for original font spacing void SetRowSpacing(float spacing); /// Set wordwrap. In wordwrap mode the text element will respect its current width. Otherwise it resizes itself freely void SetWordwrap(bool enable); /// Set selection void SetSelection(unsigned start, unsigned length); /// Clear selection void ClearSelection(); /// Set selection background color. Color with 0 alpha (default) disables void SetSelectionColor(const Color& color); /// Set hover background color. Color with 0 alpha (default) disables void SetHoverColor(const Color& color); /// Return font Font* GetFont() const { return font_; } /// Return font size int GetFontSize() const { return fontSize_; } /// Return text const std::string& GetText() const { return text_; } /// Return row alignment HorizontalAlignment GetTextAlignment() const { return textAlignment_; } /// Return row spacing float GetRowSpacing() const { return rowSpacing_; } /// Return wordwrap mode bool GetWordwrap() const { return wordWrap_; } /// Return selection start unsigned GetSelectionStart() const { return selectionStart_; } /// Return selection length unsigned GetSelectionLength() const { return selectionLength_; } /// Return selection background color const Color& GetSelectionColor() const { return selectionColor_; } /// Return hover background color const Color& GetHoverColor() const { return hoverColor_; } /// Return row height int GetRowHeight() const { return rowHeight_; } /// Return number of rows unsigned GetNumRows() const { return rowWidths_.size(); } /// Return width of each row const std::vector& GetRowWidths() const { return rowWidths_; } /// Return position of each character const std::vector& GetCharPositions() const { return charPositions_; } /// Return size of each character const std::vector& GetCharSizes() const { return charSizes_; } protected: /// Update text when text, font or spacing changed void UpdateText(bool inResize = false); /// Validate text selection to be within the text void ValidateSelection(); /// Return row start X position int GetRowStartPosition(unsigned rowIndex) const; /// Font SharedPtr font_; /// Font size int fontSize_; /// Text std::string text_; /// Text modified into printed form std::string printText_; /// Row alignment HorizontalAlignment textAlignment_; /// Row spacing float rowSpacing_; /// Wordwrap mode bool wordWrap_; /// Selection start unsigned selectionStart_; /// Selection length unsigned selectionLength_; /// Selection background color Color selectionColor_; /// Hover background color Color hoverColor_; /// Row height int rowHeight_; /// Row widths std::vector rowWidths_; /// Positions of each character std::vector charPositions_; /// Sizes of each character std::vector charSizes_; };