xlnt
comment.hpp
1 // Copyright (c) 2014-2022 Thomas Fussell
2 // Copyright (c) 2024 xlnt-community
3 //
4 // Permission is hereby granted, free of charge, to any person obtaining a copy
5 // of this software and associated documentation files (the "Software"), to deal
6 // in the Software without restriction, including without limitation the rights
7 // to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
8 // copies of the Software, and to permit persons to whom the Software is
9 // furnished to do so, subject to the following conditions:
10 //
11 // The above copyright notice and this permission notice shall be included in
12 // all copies or substantial portions of the Software.
13 //
14 // THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
15 // IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
16 // FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
17 // AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
18 // LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
19 // OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
20 // THE SOFTWARE
21 //
22 // @license: http://www.opensource.org/licenses/mit-license.php
23 // @author: see AUTHORS file
24 
25 #pragma once
26 
27 #include <string>
28 
29 #include <xlnt/xlnt_config.hpp>
30 #include <xlnt/cell/rich_text.hpp>
31 
32 namespace xlnt {
33 
37 class XLNT_API comment
38 {
39 public:
43  comment();
44 
48  comment(const rich_text &text, const std::string &author);
49 
53  comment(const std::string &text, const std::string &author);
54 
58  rich_text text() const;
59 
63  std::string plain_text() const;
64 
68  std::string author() const;
69 
73  void hide();
74 
78  void show();
79 
83  bool visible() const;
84 
88  void position(int left, int top);
89 
93  int left() const;
94 
98  int top() const;
99 
103  void size(int width, int height);
104 
108  int width() const;
109 
113  int height() const;
114 
118  bool operator==(const comment &other) const;
119 
123  bool operator!=(const comment &other) const;
124 
125 private:
129  rich_text text_;
130 
134  std::string author_;
135 
139  bool visible_ = false;
140 
144  std::string fill_;
145 
149  int left_ = 0;
150 
154  int top_ = 0;
155 
159  int width_ = 200;
160 
164  int height_ = 100;
165 };
166 
167 } // namespace xlnt
A comment can be applied to a cell to provide extra information about its contents.
Definition: comment.hpp:37
Enumerates the possible types a cell can be determined by it&#39;s current value.
Definition: cell.hpp:37
bool operator==(std::nullptr_t, const cell &cell)
Returns true if this cell is uninitialized.
Encapsulates zero or more formatted text runs where a text run is a string of text with the same defi...
Definition: rich_text.hpp:41
bool operator!=(const std::string &reference_string, const range_reference &ref)
Returns true if the string representation of the range is not equivalent to ref.