TextFeld.h 18 KB

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