diff options
| author | Johannes Schickel | 2009-06-29 23:23:29 +0000 |
|---|---|---|
| committer | Johannes Schickel | 2009-06-29 23:23:29 +0000 |
| commit | b37beb4493f69de1e2338fcf10bb1852ba864bc7 (patch) | |
| tree | 9cebd661ae7442e3e8d6e520abb3dd4175b4b4b0 /graphics/cursorman.h | |
| parent | 267efdc8742fb64e72bc50e78e1d719451f2144e (diff) | |
| download | scummvm-rg350-b37beb4493f69de1e2338fcf10bb1852ba864bc7.tar.gz scummvm-rg350-b37beb4493f69de1e2338fcf10bb1852ba864bc7.tar.bz2 scummvm-rg350-b37beb4493f69de1e2338fcf10bb1852ba864bc7.zip | |
Add some more explanation to Graphics::CursorManager::showMouse and OSystem::showMouse.
svn-id: r41968
Diffstat (limited to 'graphics/cursorman.h')
| -rw-r--r-- | graphics/cursorman.h | 16 |
1 files changed, 15 insertions, 1 deletions
diff --git a/graphics/cursorman.h b/graphics/cursorman.h index 4cbd5bea12..f019e37b04 100644 --- a/graphics/cursorman.h +++ b/graphics/cursorman.h @@ -36,7 +36,21 @@ public: /** Query whether the mouse cursor is visible. */ bool isVisible(); - /** Show or hide the mouse cursor. */ + /** + * Show or hide the mouse cursor. + * + * This function does not call OSystem::updateScreen, when visible is true. + * This fact might result in a non visible mouse cursor if the caller does + * not call OSystem::updateScreen itself after a showMouse(true) call. + * + * TODO: We might want to reconsider this behavior, it might be confusing + * for the user to call OSystem::updateScreen separately, on the other + * hand OSystem::updateScreen might as well display unwanted changes on + * the screen. Another alternative would be to let the backend worry + * about this on OSystem::showMouse call. + * + * @see OSystem::showMouse. + */ bool showMouse(bool visible); /** |