llclipboard.h 2.3 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869
  1. /**
  2. * @file llclipboard.h
  3. * @brief LLClipboard base class
  4. *
  5. * $LicenseInfo:firstyear=2001&license=viewergpl$
  6. *
  7. * Copyright (c) 2001-2009, Linden Research, Inc.
  8. * Copyright (c) 2009-2023, Henri Beauchamp.
  9. *
  10. * Second Life Viewer Source Code
  11. * The source code in this file ("Source Code") is provided by Linden Lab
  12. * to you under the terms of the GNU General Public License, version 2.0
  13. * ("GPL"), unless you have obtained a separate licensing agreement
  14. * ("Other License"), formally executed by you and Linden Lab. Terms of
  15. * the GPL can be found in doc/GPL-license.txt in this distribution, or
  16. * online at http://secondlifegrid.net/programs/open_source/licensing/gplv2
  17. *
  18. * There are special exceptions to the terms and conditions of the GPL as
  19. * it is applied to this Source Code. View the full text of the exception
  20. * in the file doc/FLOSS-exception.txt in this software distribution, or
  21. * online at
  22. * http://secondlifegrid.net/programs/open_source/licensing/flossexception
  23. *
  24. * By copying, modifying or distributing this software, you acknowledge
  25. * that you have read and understood your obligations described above,
  26. * and agree to abide by those obligations.
  27. *
  28. * ALL LINDEN LAB SOURCE CODE IS PROVIDED "AS IS." LINDEN LAB MAKES NO
  29. * WARRANTIES, EXPRESS, IMPLIED OR OTHERWISE, REGARDING ITS ACCURACY,
  30. * COMPLETENESS OR PERFORMANCE.
  31. * $/LicenseInfo$
  32. */
  33. #ifndef LL_LLCLIPBOARD_H
  34. #define LL_LLCLIPBOARD_H
  35. #include "llstring.h"
  36. // We support two flavors of clipboard. The default is the explicitly
  37. // copy-and-pasted clipboard. The second is the so-called "primary" clipboard
  38. // which is implicitly copied upon mouse selection (similarly to what happens
  39. // under X11/Linux: the same behaviour is emulated, within the viewer text
  40. // fields, for the other OSes: see in llwindow/llwindow.cpp).
  41. class LLClipboard
  42. {
  43. public:
  44. LLClipboard() = default;
  45. void copyFromSubstring(const LLWString& text, S32 pos, S32 len);
  46. bool canPasteString() const;
  47. const LLWString& getPasteWString();
  48. void copyFromPrimarySubstring(const LLWString& text, S32 pos, S32 len);
  49. bool canPastePrimaryString() const;
  50. const LLWString& getPastePrimaryWString();
  51. LL_INLINE const LLWString& getClipBoardString() { return mString; }
  52. private:
  53. LLWString mString;
  54. };
  55. // Global instance
  56. extern LLClipboard gClipboard;
  57. #endif // LL_LLCLIPBOARD_H