xlnt
phonetic_pr.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 <xlnt/xlnt_config.hpp>
28 #include <xlnt/utils/optional.hpp>
29 #include <cstdint>
30 #include <ostream>
31 
32 namespace xlnt {
33 
39 class XLNT_API phonetic_pr
40 {
41 public:
42  static std::string Serialised_ID();
43 
47  enum class align
48  {
49  center,
50  distributed,
51  left,
52  no_control
53  };
54 
58  enum class phonetic_type
59  {
60  full_width_katakana,
61  half_width_katakana,
62  hiragana,
63  no_conversion
64  };
65 
69  using font_id_t = std::uint32_t;
70 
74  phonetic_pr() = default;
75 
79  explicit phonetic_pr(font_id_t font);
80 
84  void serialise(std::ostream &output_stream) const;
85 
89  font_id_t font_id() const;
90 
94  void font_id(font_id_t font);
95 
99  bool has_type() const;
100 
104  phonetic_type type() const;
105 
109  void type(phonetic_type type);
110 
114  bool has_alignment() const;
115 
119  align alignment() const;
120 
124  void alignment(align align);
125 
126  // serialisation
130  static const std::string &type_as_string(phonetic_type type);
131 
135  static phonetic_type type_from_string(const std::string &str);
136 
140  static const std::string &alignment_as_string(xlnt::phonetic_pr::align type);
141 
145  static align alignment_from_string(const std::string &str);
146 
147  bool operator==(const phonetic_pr &rhs) const;
148 
149 private:
154  font_id_t font_id_ = 0;
155 
161 
166  xlnt::optional<align> alignment_;
167 };
168 } // namespace xlnt
Enumerates the possible types a cell can be determined by it&#39;s current value.
Definition: cell.hpp:37
Describes the font style of a particular cell.
Definition: font.hpp:41
phonetic_type
possible values for type property
Definition: phonetic_pr.hpp:58
bool operator==(std::nullptr_t, const cell &cell)
Returns true if this cell is uninitialized.
std::uint32_t font_id_t
FontID represented by an unsigned 32-bit integer
Definition: phonetic_pr.hpp:69
Alignment options that determine how text should be displayed within a cell.
Definition: alignment.hpp:63
align
possible values for alignment property
Definition: phonetic_pr.hpp:47
Phonetic properties Element provides a collection of properties that affect display of East Asian Lan...
Definition: phonetic_pr.hpp:39