TextFeld.h 19 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373
  1. #pragma once
  2. #include "Array.h"
  3. #include "Zeichnung.h"
  4. namespace Framework
  5. {
  6. class Schrift; //! Schrift.h
  7. class Text; //! Text.h
  8. class AlphaFeld; //! AlphaFeld.h
  9. class Rahmen; //! Rahmen.h
  10. class TextFeld; //! aus dieser Datei
  11. class VScrollBar; //! Scroll.h
  12. class HScrollBar; //! Scroll.h
  13. class TextRenderer;
  14. struct TextStyle
  15. {
  16. int beginIndex;
  17. unsigned char fontSize;
  18. int fontColor;
  19. int selectedColor;
  20. int selectedBackcroundColor;
  21. bool underlined;
  22. bool selected;
  23. int interactParam;
  24. unsigned char rendererIndex;
  25. DLLEXPORT bool equals(const TextStyle& rhs);
  26. };
  27. //! Verwaltet ein Textfeld
  28. class TextFeld : public ZeichnungHintergrund
  29. {
  30. public:
  31. class TextStyleManager : public virtual ReferenceCounter
  32. {
  33. protected:
  34. RCArray<TextRenderer>* renderer;
  35. Array<TextStyle> textStyle;
  36. int index;
  37. int styleIndex;
  38. TextStyle current;
  39. Text* text;
  40. public:
  41. DLLEXPORT TextStyleManager();
  42. DLLEXPORT virtual ~TextStyleManager();
  43. //! Setzt den Style eines Textabschnittes
  44. //! \param begin die startposition des Abschnittes
  45. //! \param end die endposition des Abschnittes (nicht enthalten)
  46. DLLEXPORT void setTextStyle(int begin, int end, TextStyle style);
  47. //! Entfernt einen Textabschnitt
  48. //! \param begin der index des ersten betroffenen zeichens
  49. //! \param end der index des ersten zeichens nach dem abschnitt
  50. DLLEXPORT void removeText(int begin, int end);
  51. //! Fügt ein Text an einer bestimmten Position ein
  52. //! \param pos die position des neuen Textausschnitts
  53. //! \param text der neue Text
  54. DLLEXPORT void insertText(int pos, const char* text);
  55. //! Entfernt nicht benötiegte gleiche styles
  56. DLLEXPORT void cleanupStyles();
  57. //! gibt eine referenz auf das style objekt zurück
  58. DLLEXPORT TextStyle& currentStyle();
  59. //! gibt den aktuellen text renderer zurück
  60. DLLEXPORT TextRenderer* zCurrentRenderer();
  61. //! ändert den inhalt des style objektes auf den style des nächsten
  62. //! zeichens
  63. //! gibt 0 zurück falls es kein weiteres zeichen gibt
  64. DLLEXPORT bool nextStyle();
  65. //! ändert den inhalt des style objektes auf den style des
  66. //! angegebenen zeichens \param index der Index des Zeichens zu dem
  67. //! gesprungen werden soll
  68. //! gibt 0 zurück falls es das zeichen nicht gibt
  69. DLLEXPORT bool stepTo(int index);
  70. //! ändert den inhalt des style objektes auf den style des ersten
  71. //! zeichens
  72. DLLEXPORT void resetIteration();
  73. //! Gibt den Style eines bestimmten zeichens zurück
  74. //! \param index Der index des Zeichens
  75. DLLEXPORT TextStyle getTextStyle(int index) const;
  76. friend TextFeld;
  77. };
  78. class Style : public ZeichnungHintergrund::Style
  79. {
  80. public:
  81. //! Wenn dieser Flag nicht gesetzt wird, werden alle Zeilenumbrüche
  82. //! automatisch aus dem Text entfernt
  83. static const __int64 Mehrzeilig = 0x001000;
  84. //! Wenn dieser Flag gesetzt wird, wird der Text genau in der
  85. //! horizontaen Mitte des Feldes plaziert
  86. static const __int64 HCenter = 0x002000;
  87. //! Wenn dieser Flag gesetzt wird, wird der Text genau in der
  88. //! vertikalen Mitte des Feldes plaziert
  89. static const __int64 VCenter = 0x004000;
  90. //! Wenn dieser Flag gesetzt wird, kann der Text durch den Nutzer
  91. //! bearbeitet werden
  92. static const __int64 Editierbar = 0x2000000;
  93. //! Fügt beim rendern automatisch zeilenumbrüche in den Text ein, so
  94. //! dass die Breite des Textfeldes nicht überschritten wird. Der
  95. //! Text wird dabei nicht verändert. Benötigt Style Mehrzeilig
  96. static const __int64 AutoLineBreak = 0x4000000;
  97. //! Vereint die Flags HCenter und VCenter
  98. static const __int64 Center = HCenter | VCenter;
  99. //! Vereint die Flags Sichtbar, Erlaubt, Rahmen,
  100. //! Buffered, VCenter
  101. static const __int64 TextFeld
  102. = Sichtbar | Erlaubt | Rahmen | Buffered | VCenter | Editierbar;
  103. //! Vereint die Flags Sichtbar,
  104. //! Mehrfarbig, Mehrzeilig
  105. static const __int64 Text = Sichtbar | Mehrzeilig | Erlaubt;
  106. //! Vereint die Flags Sichtbar, Erlaubt, Rahmen,
  107. //! Hintergrund, Mehrzeilig, Mehrfarbig, VScroll
  108. static const __int64 TextGebiet = Sichtbar | Erlaubt | Rahmen
  109. | Hintergrund | Editierbar
  110. | Mehrzeilig | VScroll;
  111. //! Vereint die Flags VScroll und HScroll
  112. static const __int64 Scroll = VScroll | HScroll;
  113. };
  114. private:
  115. TextStyleManager* tm;
  116. Text* autoLineBreakSpacing;
  117. unsigned char showChar;
  118. int cpos;
  119. double tickVal;
  120. bool mausKlick;
  121. std::function<void(int, int, MausEreignis me)> charEvent;
  122. int getTextHeight() const;
  123. int getTextWidth() const;
  124. //! Verarbeitet Maus Nachrichten
  125. //! \param me Das Ereignis, was durch die Mauseingabe ausgelößt wurde
  126. DLLEXPORT virtual void doMausEreignis(
  127. MausEreignis& me, bool userRet) override;
  128. public:
  129. //! Konstruktor
  130. DLLEXPORT TextFeld();
  131. //! Destruktor
  132. DLLEXPORT virtual ~TextFeld();
  133. //! charEvent: eine funktion die aufgerufen wird, wenn sich die maus auf
  134. //! einem bestimmten zeichen befindet und der interactParam im style !=
  135. //! 0 ist \param aufruf charEvent( charIndex, interactParam,
  136. //! mausEreignis );
  137. DLLEXPORT void setCharEvent(
  138. std::function<void(int, int, MausEreignis me)> charEvent);
  139. //! setzt einen Zeiger auf den Text im Textfeld
  140. //! \param txt Der Zeiger auf den Text
  141. DLLEXPORT void setTextZ(Text* txt);
  142. //! setzt den Text des Textfeldes
  143. //! \param txt der Text
  144. DLLEXPORT void setText(Text* txt);
  145. //! setzt den Text des Textfeldes
  146. //! \param txt der Text
  147. DLLEXPORT void setText(const char* txt);
  148. //! setzt den Text mit styles
  149. //! \param txt der Text
  150. //! \param format
  151. //! - \\x1: aktiviert unterschtrich
  152. //! - \\x2\\xY: setzt die schriftgröße auf y für den
  153. //! folgenden text
  154. //! - \\x3\\xA\\xR\\xG\\xB: setzt die schriftfarbe auf
  155. //! ARGB
  156. //! - \\x4\\xA\\xR\\xG\\xB: setzt die farbe des
  157. //! ausgewählten textes
  158. //! - \\x5\\xA\\xR\\xG\\xB: setzt die hintergrundfarbe des
  159. //! ausgewählten textes
  160. //! - \\x6\\xY: setzt text renderer index auf y
  161. //! - \\x7: deaktiviert unterschtrich
  162. //! - \\x8\\xA\\xB\\xC\\xD: set interact param to ABCD
  163. DLLEXPORT void setFormattedText(const char* txt);
  164. //! fügt zeilenumbrüche so ein, dass der text nicht die breite des
  165. //! textfeldes überschreitet \param spacing ein text, der direkt nach
  166. //! jedem eingefügten Zeilenumbruch eingefügt wird
  167. DLLEXPORT void addLineBreaks(const char* spacing = "");
  168. //! fügt zeilenumbrüche in den Text txt so ein, dass der text nicht die
  169. //! breite des textfeldes überschreitet \param txt der Text in den
  170. //! Zeilenumbrüche eingefügt werden sollen \param spacing ein text, der
  171. //! direkt nach jedem eingefügten Zeilenumbruch eingefügt wird \return
  172. //! der Text mit zeilenumbrüchen
  173. DLLEXPORT Text addLineBreaksToText(
  174. const char* txt, const char* spacing = "") const;
  175. //! setzt eine Zeichenfolge die mit dem style AutoLineBreak nach jedem
  176. //! eingefügten Zeilenumbruch eingefügt wird
  177. DLLEXPORT void setAutoLineBreakSpacing(const char* spacing);
  178. //! Setzt den Style eines Textabschnittes
  179. //! \param begin die startposition des Abschnittes
  180. //! \param end die endposition des Abschnittes (nicht enthalten)
  181. DLLEXPORT void setTextStyle(int begin, int end, TextStyle style);
  182. //! Fügt eine Zeile an den Text an
  183. //! \param zeile Die neue Zeile
  184. DLLEXPORT void addZeile(const char* zeile);
  185. //! Fügt eine Zeile an den Text an
  186. //! \param zeile Die neue Zeile
  187. //! \param color Die Farbe der Zeile
  188. DLLEXPORT void addZeile(const char* zeile, int color);
  189. //! Deselectiert alle textabschnitte
  190. DLLEXPORT void deselectAuswahl();
  191. //! Setzt den ausgewählten textabschnitt fest
  192. //! pos1: Die Cursorposition im Text
  193. //! pos2: Die Position im Text, bis zu der der Text eingefärbt werden
  194. //! soll
  195. DLLEXPORT void setAuswahl(int pos1, int pos2);
  196. //! Setzt den ausgewählten textabschnitt fest
  197. //! \param auswahl Ein punkt mit x als Cursorposition und y als der
  198. //! Position, bis zu der der Text eingefärbt werden soll
  199. DLLEXPORT void setAuswahl(Punkt& auswahl);
  200. //! Setzt den ausgewählten textabschnitt fest
  201. //! pos1: Die Cursorposition im Text
  202. //! pos2: Die Position im Text, bis zu der der Text eingefärbt werden
  203. //! soll
  204. DLLEXPORT void addAuswahl(int pos1, int pos2);
  205. //! Setzt den ausgewählten textabschnitt fest
  206. //! \param auswahl Ein punkt mit x als Cursorposition und y als der
  207. //! Position, bis zu der der Text eingefärbt werden soll
  208. DLLEXPORT void addAuswahl(Punkt& auswahl);
  209. //! Setzt den ausgewählten textabschnitt fest
  210. //! \param begin Die Cursorposition im Text
  211. //! \param end Die Position im Text, bis zu der der Text eingefärbt
  212. //! werden soll
  213. DLLEXPORT void invertAuswahl(int begin, int end);
  214. //! ersetzt alle ausgewählten Textabschnitte mit einem text
  215. //! \param text der neue Text
  216. DLLEXPORT void replaceAuswahl(const char* text);
  217. //! Setzt den verwendeten TextRenderer
  218. //! \param textRd Der Textrenderer
  219. DLLEXPORT void setTextRendererZ(TextRenderer* textRd);
  220. //! Fügt einen TextRenderer hinzu
  221. //! \param textRd Der Textrenderer
  222. DLLEXPORT void addTextRendererZ(TextRenderer* textRd);
  223. //! Setzt die verwendeten TextRenderer
  224. //! \param textRd Die Textrenderer
  225. DLLEXPORT void setTextRendererZ(RCArray<TextRenderer>* textRd);
  226. //! Setzt einen Zeiger zur Schrift
  227. //! \param schrift Die Schrift, die zum Textzeichnen verwendet werden
  228. //! soll.
  229. DLLEXPORT void setSchriftZ(Schrift* schrift);
  230. //! Setzt einen Zeiger zur Schrift
  231. //! \param rendererIndex Der Index des Renderers dessen Schrift gesetzt
  232. //! werden soll \param schrift Die Schrift, die zum Textzeichnen
  233. //! verwendet werden soll.
  234. DLLEXPORT void setSchriftZ(int rendererIndex, Schrift* schrift);
  235. //! Setzt die Schriftgröße (Standart: 12)
  236. //! \param gr Die Schriftgröße, die zum Textzeichnen verwendet werden
  237. //! soll
  238. DLLEXPORT void setSchriftSize(unsigned char gr);
  239. //! Setzt die Schriftgröße (Standart: 12)
  240. //! \param begin Der Index des ersten betroffenen Zeichens
  241. //! \param end Der Index des ersten nicht betroffenen Zeichens
  242. //! \param gr Die Schriftgröße, die zum Textzeichnen verwendet werden
  243. //! soll
  244. DLLEXPORT void setSchriftSize(int begin, int end, unsigned char gr);
  245. //! Setzt die Schrift Farbe
  246. //! \param fc Die Farbe, die zum Textzeichnen verwendet werden soll
  247. DLLEXPORT void setSchriftFarbe(int fc);
  248. //! Setzt die Schrift Farbe
  249. //! \param begin Der Index des ersten betroffenen Zeichens
  250. //! \param end Der Index des ersten nicht betroffenen Zeichens
  251. //! \param fc Die Farbe, die zum Textzeichnen verwendet werden soll
  252. DLLEXPORT void setSchriftFarbe(int begin, int end, int fc);
  253. //! Legt einen Buchstaben fest, der zum zeichnen verwendet werden soll,
  254. //! unabhängig vom Text des Textfeldes (benötigt Flag zum Zeichnen:
  255. //! Rahmen) \param c Der Buchstabe, der gezeichnet werden soll Beispiel:
  256. //! setShowChar( '*' ); Bei Passwort Textfeldern
  257. DLLEXPORT void setSchowChar(unsigned char c);
  258. //! Scrollt zu einer bestimmten Zeile (benötigt Flag zum Zeichnen:
  259. //! VScroll) \param zeile Der Index der Zeile, die als oberste Zeile zu
  260. //! sehen sein soll
  261. DLLEXPORT void setVScrollZuZeile(int zeile);
  262. //! Scrollt zu einer bestimmten Position im Text. Ohne den Flag Erlaubt
  263. //! wrd immer ganz nach unten gescrollt. (benötigt Flag zum Zeichnen:
  264. //! VScroll) \param pos Der Index des Zeichens, zu dem gescrollt werden
  265. //! soll. Standartmäßig wird zur Cursorposition gescrollt
  266. DLLEXPORT void updateVScroll(int pos = -1);
  267. //! Scrollt zu einer bestimmten Position im Text. Benötigt den Flag
  268. //! Erlaubt. (benötigt Flag zum Zeichnen: HScroll) \param pos Der Index
  269. //! des Zeichens, zu dem gescrollt werden soll. Standartmäßig wird zur
  270. //! Cursorposition gescrollt
  271. DLLEXPORT void updateHScroll(int pos = -1);
  272. //! Gibt die breite in pixeln zurück, die benötigt wird um den aktuellen
  273. //! text mit den aktuellen styles voll anzuzeigen
  274. DLLEXPORT int getNeededWidth();
  275. //! Gibt die höhe in pixeln zurück, die benötigt wird um den aktuellen
  276. //! text mit den aktuellen styles voll anzuzeigen
  277. DLLEXPORT int getNeededHeight();
  278. //! Aktualisiert das Objekt. Wird vom Framework aufgerufen
  279. //! \param tickVal Die Zeit in sekunden, die seit dem lezten Aufruf
  280. //! dieser Funktion vergangen ist \return 1, wenn sich etwas verändert
  281. //! hat und das Bild neu gezeichnet werden muss. 0 sonst
  282. DLLEXPORT virtual bool tick(double tickval) override;
  283. //! Verarbeitet Tastatur Nachrichten
  284. //! \param me Das Ereignis, was durch die Tastatureingabe ausgelößt
  285. //! wurde
  286. DLLEXPORT void doTastaturEreignis(TastaturEreignis& te) override;
  287. //! Zeichnet das Objekt nach zRObj, falls es sichtbar ist
  288. //! \param zRObj Das Bild, in welches gezeichnet werden soll
  289. DLLEXPORT virtual void render(Bild& zRObj) override;
  290. //! Gibt den Text aus dem Textfeld zurück
  291. DLLEXPORT Text* getText() const;
  292. //! Gibt den Text aus dem Textfeld ohne erhöhten Reference Counter
  293. //! zurück
  294. DLLEXPORT Text* zText() const;
  295. //! Gibt die Schrift zurück.
  296. //! \return 0, falls die Schrift nicht gesetzt wurde
  297. DLLEXPORT Schrift* getSchrift() const;
  298. //! Gibt die Schrift ohne erhöhten Reference Counter zurük
  299. //! \return 0, falls die Schrift nicht gesetzt wurde
  300. DLLEXPORT Schrift* zSchrift() const;
  301. //! Gibt die Schrift zurück.
  302. //! \param rendererIndex Der Index des Renderers dessen Schrift
  303. //! zurückgegeben werden soll \return 0, falls die Schrift nicht gesetzt
  304. //! wurde
  305. DLLEXPORT Schrift* getSchrift(int rendererIndex) const;
  306. //! Gibt die Schrift ohne erhöhten Reference Counter zurük
  307. //! \param rendererIndex Der Index des Renderers dessen Schrift
  308. //! zurückgegeben werden soll \return 0, falls die Schrift nicht gesetzt
  309. //! wurde
  310. DLLEXPORT Schrift* zSchrift(int rendererIndex) const;
  311. //! Gibt den TextRenderer zurück.
  312. //! \return 0, falls der TextRenderer nicht gesetzt wurde
  313. DLLEXPORT TextRenderer* getTextRenderer() const;
  314. //! Gibt dien TextRenderer ohne erhöhten Reference Counter zurük
  315. //! \return 0, falls der TextRenderer nicht gesetzt wurde
  316. DLLEXPORT TextRenderer* zTextRenderer() const;
  317. //! Gibt den TextRenderer zurück.
  318. //! \param index Der Index des Renderers der zurückgegeben werden soll
  319. //! \return 0, falls der TextRenderer nicht gesetzt wurde
  320. DLLEXPORT TextRenderer* getTextRenderer(int index) const;
  321. //! Gibt dien TextRenderer ohne erhöhten Reference Counter zurük
  322. //! \param index Der Index des Renderers der zurückgegeben werden soll
  323. //! \return 0, falls der TextRenderer nicht gesetzt wurde
  324. DLLEXPORT TextRenderer* zTextRenderer(int index) const;
  325. //! Gibt die Schriftgröße zurück
  326. DLLEXPORT unsigned char getSchriftSize() const;
  327. //! Gibt die Schriftgröße zurück
  328. //! \param index Der Index des Zeichens
  329. DLLEXPORT unsigned char getSchriftSize(int index) const;
  330. //! Gibt die Schriftfarbe im A8R8G8B8 Format zurück
  331. DLLEXPORT int getSchriftFarbe() const;
  332. //! Gibt die Schriftfarbe im A8R8G8B8 Format zurück
  333. //! \param index Der Index des Zeichens
  334. DLLEXPORT int getSchriftFarbe(int index) const;
  335. //! Gibt den Anzeigebuchstabe zurück
  336. DLLEXPORT unsigned char getShowChar() const;
  337. //! Gibt die Cursorposition zurück
  338. DLLEXPORT int getCursorPos() const;
  339. //! Gibt 1 zurück wenn das Zeichen ausgewählt ist
  340. //! \param index Der Index des Zeichens
  341. DLLEXPORT bool isCharSelected(int index) const;
  342. //! Gibt den Index des Zeichens zurück, das sich unter der Maus befindet
  343. //! \param mx die x position der maus relativ zur position des
  344. //! textfeldes \param my die y position der maus relativ zut position
  345. //! des textfeldes \return -1, falls sich an der Position kein zeichen
  346. //! befindet
  347. DLLEXPORT int getTextIndexAt(int mx, int my) const;
  348. //! Gibt den Index des Zeichens zurück, vor dem der curser gesetzt wird,
  349. //! wenn mit der maus geklickt wird \param mx die x position der maus
  350. //! relativ zur position des textfeldes \param my die y position der
  351. //! maus relativ zut position des textfeldes
  352. DLLEXPORT int getCurserPosAt(int mx, int my) const;
  353. //! Gibt den Style eines bestimmten zeichens zurück
  354. //! \param index Der index des Zeichensf
  355. DLLEXPORT TextStyle getTextStyle(int index) const;
  356. //! gibt die Zeichenkette zurück, die bei Verwendung des Styles
  357. //! AutoLineBreak nach jedem Zeilenumbruch eingefügt wird
  358. DLLEXPORT Text getAutoLineBreakSpacing() const;
  359. //! Erzeugt eine Komplette Kopie des Textfeldes, welches ohne
  360. //! auswirkungen verändert werden kann
  361. DLLEXPORT Zeichnung* dublizieren() const override;
  362. };
  363. } // namespace Framework