Minor changes to the documentation and some parameters names

git-svn-id: https://sfml.svn.sourceforge.net/svnroot/sfml/branches/sfml2@1444 4e206d99-4929-0410-ac5d-dfc041789085
This commit is contained in:
LaurentGom 2010-03-08 17:50:16 +00:00
parent 4e93cc92fa
commit ef216acc5f
9 changed files with 42 additions and 41 deletions

View File

@ -83,7 +83,8 @@ private :
/// always be released when the current scope (most likely /// always be released when the current scope (most likely
/// a function) ends. /// a function) ends.
/// This is even more important when an exception or an early /// This is even more important when an exception or an early
/// return statement can interrupt the excution flow of the function. /// return statement can interrupt the execution flow of the
/// function.
/// ///
/// For maximum robustness, sf::Lock should always be used /// For maximum robustness, sf::Lock should always be used
/// to lock/unlock a mutex. /// to lock/unlock a mutex.
@ -129,7 +130,7 @@ private :
/// Having a mutex locked longer than required is a bad practice /// Having a mutex locked longer than required is a bad practice
/// which can lead to bad performances. Don't forget that when /// which can lead to bad performances. Don't forget that when
/// a mutex is locked, other threads may be waiting doing nothing /// a mutex is locked, other threads may be waiting doing nothing
/// until it ls released. /// until it is released.
/// ///
/// \see sf::Mutex /// \see sf::Mutex
/// ///

View File

@ -69,7 +69,7 @@ private :
//////////////////////////////////////////////////////////// ////////////////////////////////////////////////////////////
/// \brief Disabled assignment operator /// \brief Disabled assignment operator
/// ///
/// By making the copy constructor private, the compiler will /// By making the assignment operator private, the compiler will
/// trigger an error if anyone outside tries to use it. /// trigger an error if anyone outside tries to use it.
/// To prevent NonCopyable or friend classes from using it, /// To prevent NonCopyable or friend classes from using it,
/// we also give no definition, so that the linker will /// we also give no definition, so that the linker will

View File

@ -282,11 +282,11 @@ public :
//////////////////////////////////////////////////////////// ////////////////////////////////////////////////////////////
/// \brief Change the position of the mouse cursor /// \brief Change the position of the mouse cursor
/// ///
/// \param left Left coordinate of the cursor, relative to the window /// \param x Left coordinate of the cursor, relative to the window
/// \param top Top coordinate of the cursor, relative to the window /// \param y Top coordinate of the cursor, relative to the window
/// ///
//////////////////////////////////////////////////////////// ////////////////////////////////////////////////////////////
void SetCursorPosition(unsigned int left, unsigned int top); void SetCursorPosition(unsigned int x, unsigned int y);
//////////////////////////////////////////////////////////// ////////////////////////////////////////////////////////////
/// \brief Change the position of the window on screen /// \brief Change the position of the window on screen
@ -295,11 +295,11 @@ public :
/// (i.e. it will be ignored for windows created from /// (i.e. it will be ignored for windows created from
/// the handle of a child window/control). /// the handle of a child window/control).
/// ///
/// \param left Left position /// \param x Left position
/// \param top Top position /// \param y Top position
/// ///
//////////////////////////////////////////////////////////// ////////////////////////////////////////////////////////////
void SetPosition(int left, int top); void SetPosition(int x, int y);
//////////////////////////////////////////////////////////// ////////////////////////////////////////////////////////////
/// \brief Change the size of the rendering region of the window /// \brief Change the size of the rendering region of the window

View File

@ -317,17 +317,17 @@ void WindowImplX11::ShowMouseCursor(bool show)
//////////////////////////////////////////////////////////// ////////////////////////////////////////////////////////////
void WindowImplX11::SetCursorPosition(unsigned int left, unsigned int top) void WindowImplX11::SetCursorPosition(unsigned int x, unsigned int y)
{ {
XWarpPointer(myDisplay, None, myWindow, 0, 0, 0, 0, left, top); XWarpPointer(myDisplay, None, myWindow, 0, 0, 0, 0, x, y);
XFlush(myDisplay); XFlush(myDisplay);
} }
//////////////////////////////////////////////////////////// ////////////////////////////////////////////////////////////
void WindowImplX11::SetPosition(int left, int top) void WindowImplX11::SetPosition(int x, int y)
{ {
XMoveWindow(myDisplay, myWindow, left, top); XMoveWindow(myDisplay, myWindow, x, y);
XFlush(myDisplay); XFlush(myDisplay);
} }

View File

@ -110,20 +110,20 @@ private :
//////////////////////////////////////////////////////////// ////////////////////////////////////////////////////////////
/// \brief Change the position of the mouse cursor /// \brief Change the position of the mouse cursor
/// ///
/// \param left Left coordinate of the cursor, relative to the window /// \param x Left coordinate of the cursor, relative to the window
/// \param top Top coordinate of the cursor, relative to the window /// \param y Top coordinate of the cursor, relative to the window
/// ///
//////////////////////////////////////////////////////////// ////////////////////////////////////////////////////////////
virtual void SetCursorPosition(unsigned int left, unsigned int top); virtual void SetCursorPosition(unsigned int x, unsigned int y);
//////////////////////////////////////////////////////////// ////////////////////////////////////////////////////////////
/// \brief Change the position of the window on screen /// \brief Change the position of the window on screen
/// ///
/// \param left Left position /// \param x Left position
/// \param top Top position /// \param y Top position
/// ///
//////////////////////////////////////////////////////////// ////////////////////////////////////////////////////////////
virtual void SetPosition(int left, int top); virtual void SetPosition(int x, int y);
//////////////////////////////////////////////////////////// ////////////////////////////////////////////////////////////
/// \brief Change the size of the rendering region of the window /// \brief Change the size of the rendering region of the window

View File

@ -238,18 +238,18 @@ void WindowImplWin32::ShowMouseCursor(bool show)
//////////////////////////////////////////////////////////// ////////////////////////////////////////////////////////////
void WindowImplWin32::SetCursorPosition(unsigned int left, unsigned int top) void WindowImplWin32::SetCursorPosition(unsigned int x, unsigned int y)
{ {
POINT position = {left, top}; POINT position = {x, y};
ClientToScreen(myHandle, &position); ClientToScreen(myHandle, &position);
SetCursorPos(position.x, position.y); SetCursorPos(position.x, position.y);
} }
//////////////////////////////////////////////////////////// ////////////////////////////////////////////////////////////
void WindowImplWin32::SetPosition(int left, int top) void WindowImplWin32::SetPosition(int x, int y)
{ {
SetWindowPos(myHandle, NULL, left, top, 0, 0, SWP_NOSIZE | SWP_NOZORDER); SetWindowPos(myHandle, NULL, x, y, 0, 0, SWP_NOSIZE | SWP_NOZORDER);
} }

View File

@ -99,20 +99,20 @@ private :
//////////////////////////////////////////////////////////// ////////////////////////////////////////////////////////////
/// \brief Change the position of the mouse cursor /// \brief Change the position of the mouse cursor
/// ///
/// \param left Left coordinate of the cursor, relative to the window /// \param x Left coordinate of the cursor, relative to the window
/// \param top Top coordinate of the cursor, relative to the window /// \param y Top coordinate of the cursor, relative to the window
/// ///
//////////////////////////////////////////////////////////// ////////////////////////////////////////////////////////////
virtual void SetCursorPosition(unsigned int left, unsigned int top); virtual void SetCursorPosition(unsigned int x, unsigned int y);
//////////////////////////////////////////////////////////// ////////////////////////////////////////////////////////////
/// \brief Change the position of the window on screen /// \brief Change the position of the window on screen
/// ///
/// \param left Left position /// \param x Left position
/// \param top Top position /// \param y Top position
/// ///
//////////////////////////////////////////////////////////// ////////////////////////////////////////////////////////////
virtual void SetPosition(int left, int top); virtual void SetPosition(int x, int y);
//////////////////////////////////////////////////////////// ////////////////////////////////////////////////////////////
/// \brief Change the size of the rendering region of the window /// \brief Change the size of the rendering region of the window

View File

@ -251,24 +251,24 @@ void Window::ShowMouseCursor(bool show)
//////////////////////////////////////////////////////////// ////////////////////////////////////////////////////////////
void Window::SetCursorPosition(unsigned int left, unsigned int top) void Window::SetCursorPosition(unsigned int x, unsigned int y)
{ {
if (myWindow) if (myWindow)
{ {
// Keep coordinates for later checking (to reject the generated MouseMoved event) // Keep coordinates for later checking (to reject the generated MouseMoved event)
mySetCursorPosX = left; mySetCursorPosX = x;
mySetCursorPosY = top; mySetCursorPosY = y;
myWindow->SetCursorPosition(left, top); myWindow->SetCursorPosition(x, y);
} }
} }
//////////////////////////////////////////////////////////// ////////////////////////////////////////////////////////////
void Window::SetPosition(int left, int top) void Window::SetPosition(int x, int y)
{ {
if (myWindow) if (myWindow)
myWindow->SetPosition(left, top); myWindow->SetPosition(x, y);
} }

View File

@ -143,20 +143,20 @@ public :
//////////////////////////////////////////////////////////// ////////////////////////////////////////////////////////////
/// \brief Change the position of the mouse cursor /// \brief Change the position of the mouse cursor
/// ///
/// \param left Left coordinate of the cursor, relative to the window /// \param x Left coordinate of the cursor, relative to the window
/// \param top Top coordinate of the cursor, relative to the window /// \param y Top coordinate of the cursor, relative to the window
/// ///
//////////////////////////////////////////////////////////// ////////////////////////////////////////////////////////////
virtual void SetCursorPosition(unsigned int left, unsigned int top) = 0; virtual void SetCursorPosition(unsigned int x, unsigned int y) = 0;
//////////////////////////////////////////////////////////// ////////////////////////////////////////////////////////////
/// \brief Change the position of the window on screen /// \brief Change the position of the window on screen
/// ///
/// \param left Left position /// \param x Left position
/// \param top Top position /// \param y Top position
/// ///
//////////////////////////////////////////////////////////// ////////////////////////////////////////////////////////////
virtual void SetPosition(int left, int top) = 0; virtual void SetPosition(int x, int y) = 0;
//////////////////////////////////////////////////////////// ////////////////////////////////////////////////////////////
/// \brief Change the size of the rendering region of the window /// \brief Change the size of the rendering region of the window