Documentation of SFML 2.4.2

Warning: this page refers to an old version of SFML. Click here to switch to the latest version.
Window/Window.hpp
1 //
3 // SFML - Simple and Fast Multimedia Library
4 // Copyright (C) 2007-2017 Laurent Gomila (laurent@sfml-dev.org)
5 //
6 // This software is provided 'as-is', without any express or implied warranty.
7 // In no event will the authors be held liable for any damages arising from the use of this software.
8 //
9 // Permission is granted to anyone to use this software for any purpose,
10 // including commercial applications, and to alter it and redistribute it freely,
11 // subject to the following restrictions:
12 //
13 // 1. The origin of this software must not be misrepresented;
14 // you must not claim that you wrote the original software.
15 // If you use this software in a product, an acknowledgment
16 // in the product documentation would be appreciated but is not required.
17 //
18 // 2. Altered source versions must be plainly marked as such,
19 // and must not be misrepresented as being the original software.
20 //
21 // 3. This notice may not be removed or altered from any source distribution.
22 //
24 
25 #ifndef SFML_WINDOW_HPP
26 #define SFML_WINDOW_HPP
27 
29 // Headers
31 #include <SFML/Window/Export.hpp>
32 #include <SFML/Window/ContextSettings.hpp>
33 #include <SFML/Window/VideoMode.hpp>
34 #include <SFML/Window/WindowHandle.hpp>
35 #include <SFML/Window/WindowStyle.hpp>
36 #include <SFML/Window/GlResource.hpp>
37 #include <SFML/System/Clock.hpp>
38 #include <SFML/System/Vector2.hpp>
39 #include <SFML/System/NonCopyable.hpp>
40 #include <SFML/System/String.hpp>
41 
42 
43 namespace sf
44 {
45 namespace priv
46 {
47  class GlContext;
48  class WindowImpl;
49 }
50 
51 class Event;
52 
57 class SFML_WINDOW_API Window : GlResource, NonCopyable
58 {
59 public:
60 
68  Window();
69 
89  Window(VideoMode mode, const String& title, Uint32 style = Style::Default, const ContextSettings& settings = ContextSettings());
90 
105  explicit Window(WindowHandle handle, const ContextSettings& settings = ContextSettings());
106 
113  virtual ~Window();
114 
132  void create(VideoMode mode, const String& title, Uint32 style = Style::Default, const ContextSettings& settings = ContextSettings());
133 
149  void create(WindowHandle handle, const ContextSettings& settings = ContextSettings());
150 
161  void close();
162 
173  bool isOpen() const;
174 
186  const ContextSettings& getSettings() const;
187 
211  bool pollEvent(Event& event);
212 
238  bool waitEvent(Event& event);
239 
248  Vector2i getPosition() const;
249 
262  void setPosition(const Vector2i& position);
263 
275  Vector2u getSize() const;
276 
285  void setSize(const Vector2u& size);
286 
295  void setTitle(const String& title);
296 
314  void setIcon(unsigned int width, unsigned int height, const Uint8* pixels);
315 
324  void setVisible(bool visible);
325 
339  void setVerticalSyncEnabled(bool enabled);
340 
349  void setMouseCursorVisible(bool visible);
350 
362  void setMouseCursorGrabbed(bool grabbed);
363 
376  void setKeyRepeatEnabled(bool enabled);
377 
393  void setFramerateLimit(unsigned int limit);
394 
406  void setJoystickThreshold(float threshold);
407 
424  bool setActive(bool active = true) const;
425 
440  void requestFocus();
441 
453  bool hasFocus() const;
454 
463  void display();
464 
477  WindowHandle getSystemHandle() const;
478 
479 protected:
480 
489  virtual void onCreate();
490 
498  virtual void onResize();
499 
500 private:
501 
514  bool filterEvent(const Event& event);
515 
520  void initialize();
521 
523  // Member data
525  priv::WindowImpl* m_impl;
526  priv::GlContext* m_context;
527  Clock m_clock;
528  Time m_frameTimeLimit;
529  Vector2u m_size;
530 };
531 
532 } // namespace sf
533 
534 
535 #endif // SFML_WINDOW_HPP
536 
537 
Utility string class that automatically handles conversions between types and encodings.
Definition: String.hpp:45
Represents a time value.
Definition: Time.hpp:40
Base class for classes that require an OpenGL context.
Definition: GlResource.hpp:44
Defines a system event and its parameters.
Definition: Event.hpp:44
Default window style.
Definition: WindowStyle.hpp:46
Window that serves as a target for OpenGL rendering.
Utility class that makes any derived class non-copyable.
Definition: NonCopyable.hpp:41
Structure defining the settings of the OpenGL context attached to a window.
VideoMode defines a video mode (width, height, bpp)
Definition: VideoMode.hpp:41
Utility class that measures the elapsed time.
Definition: Clock.hpp:41
Utility template class for manipulating 2-dimensional vectors.
Definition: Vector2.hpp:37