String.hpp

00001 
00002 //
00003 // SFML - Simple and Fast Multimedia Library
00004 // Copyright (C) 2007-2008 Laurent Gomila (laurent.gom@gmail.com)
00005 //
00006 // This software is provided 'as-is', without any express or implied warranty.
00007 // In no event will the authors be held liable for any damages arising from the use of this software.
00008 //
00009 // Permission is granted to anyone to use this software for any purpose,
00010 // including commercial applications, and to alter it and redistribute it freely,
00011 // subject to the following restrictions:
00012 //
00013 // 1. The origin of this software must not be misrepresented;
00014 //    you must not claim that you wrote the original software.
00015 //    If you use this software in a product, an acknowledgment
00016 //    in the product documentation would be appreciated but is not required.
00017 //
00018 // 2. Altered source versions must be plainly marked as such,
00019 //    and must not be misrepresented as being the original software.
00020 //
00021 // 3. This notice may not be removed or altered from any source distribution.
00022 //
00024 
00025 #ifndef SFML_STRING_HPP
00026 #define SFML_STRING_HPP
00027 
00029 // Headers
00031 #include <SFML/Graphics/Drawable.hpp>
00032 #include <SFML/Graphics/Font.hpp>
00033 #include <SFML/Graphics/Rect.hpp>
00034 #include <string>
00035 
00036 
00037 namespace sf
00038 {
00042 class SFML_API String : public Drawable
00043 {
00044 public :
00045 
00049     enum Style
00050     {
00051         Regular    = 0,      
00052         Bold       = 1 << 0, 
00053         Italic     = 1 << 1, 
00054         Underlined = 1 << 2  
00055     };
00056 
00065     String(const std::string& Text, const Font& CharFont = Font::GetDefaultFont(), float Size = 30.f);
00066 
00075     String(const std::wstring& Text = L"", const Font& CharFont = Font::GetDefaultFont(), float Size = 30.f);
00076 
00083     void SetText(const std::string& Text);
00084 
00091     void SetText(const std::wstring& Text);
00092 
00099     void SetFont(const Font& CharFont);
00100 
00108     void SetSize(float Size);
00109 
00117     void SetStyle(unsigned long TextStyle);
00118 
00125     const std::wstring& GetUnicodeText() const;
00126 
00133     std::string GetText() const;
00134 
00141     const Font& GetFont() const;
00142 
00149     float GetSize() const;
00150 
00157     unsigned long GetStyle() const;
00158 
00165     FloatRect GetRect() const;
00166 
00167 protected :
00168 
00173     virtual void Render(const RenderWindow& Window) const;
00174 
00175 private :
00176 
00181     void RecomputeRect();
00182 
00184     // Member data
00186     std::wstring  myText;           
00187     const Font*   myFont;           
00188     float         mySize;           
00189     unsigned long myStyle;          
00190     FloatRect     myBaseRect;       
00191     bool          myNeedRectUpdate; 
00192 };
00193 
00194 } // namespace sf
00195 
00196 
00197 #endif // SFML_STRING_HPP