Liste.h 17 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261
  1. #ifndef Liste_H
  2. #define Liste_H
  3. #include "Zeichnung.h"
  4. #include "Array.h"
  5. namespace Framework
  6. {
  7. class Rahmen; // Rahmen.h
  8. class AlphaFeld; // AlphaFeld.h
  9. class Bild; // Bild.h
  10. class Text; // Text.h
  11. class TextFeld; // TextFeld.h
  12. class VScrollBar; // Scroll.h
  13. struct TastaturEreignis; // TastaturEreignis.h
  14. struct MausEreignis; // MausEreignis.h
  15. class Schrift; // Schrift.h
  16. class AuswahlListe; // aus dieser datei
  17. // Eine Zeichnung des 2D GUI Frameworks, die eine Liste darstellt, aus der der Benutzer Elemente aus und abwählen kann
  18. class AuswahlListe : public ZeichnungHintergrund
  19. {
  20. public:
  21. class Style : public ZeichnungHintergrund::Style
  22. {
  23. public:
  24. const static __int64 FeldRahmen = 0x0001000; // Legt fest, ob die Einträge der Liste einen Rahmen haben
  25. const static __int64 FeldHintergrund = 0x0002000; // Legt fest, ob die Einträge einen Hintergrund haben
  26. const static __int64 FeldHBild = 0x0004000; // Legt fest, ob die Einträge ein Hintergrund Bild haben
  27. const static __int64 FeldHAlpha = 0x0008000; // Legt fest, ob beim zeichnen der Eintrag Hintergründe alpha blending verwendet werden soll
  28. const static __int64 FeldBuffer = 0x0010000; // Legt fest, ob die Einträge einen Farbübergang besitzen
  29. const static __int64 AuswahlHintergrund = 0x0020000; // Legt fest, ob die ausgewählten Einträge einen Hintergrund haben
  30. const static __int64 AuswahlHBild = 0x0040000; // Legt fest, ob die ausgewählten einträge ein Bild als Hintergrund haben
  31. const static __int64 AuswahlHAlpha = 0x0080000; // Legt fest, ob für das Zeichnen der Hintergründe der ausgewählten Einträge alpha blending verwendet wird
  32. const static __int64 AuswahlBuffer = 0x0100000; // Legt fest, ob die ausgewählten Einträge einen Farbübergang besitzen
  33. const static __int64 AuswahlRahmen = 0x0200000; // Legt fest, ob die ausgewählten Einträge einen Rahmen besitzen
  34. const static __int64 MultiStyled = 0x0400000; // Legt fest, ob jeder Eintrag seine eigenen Hintergrund, Farbübergang und Rahmen hat, fals er ausgewählt ist
  35. const static __int64 MultiSelect = 0x0800000; // Legt fest, das mehrere Einträge gleichzeitig ausgewählt sein können
  36. const static __int64 Selected = 0x1000000; // Legt fest, ob ein bestimmter Eintrag ausgewählt ist, falls MultiSelect gesetzt wurde.
  37. const static __int64 Normal = Sichtbar | Erlaubt | Rahmen | FeldHAlpha | FeldHintergrund | FeldRahmen | AuswahlBuffer | AuswahlRahmen; // Vereint die Flags Sichtbar, Erlaubt, Rahmen, FeldHAlpha, FeldHintergrund, FeldRahmen, AuswahlBuffer, AuswahlRahmen
  38. };
  39. private:
  40. RCArray< TextFeld > *tfListe;
  41. int entries, auswahl;
  42. int ahFarbe;
  43. Bild *ahBild;
  44. AlphaFeld *aBuffer;
  45. Rahmen *aRahmen;
  46. Array< __int64 > *styles;
  47. Array< int > *ahFarbeListe;
  48. RCArray< Bild > *ahBildListe;
  49. RCArray< AlphaFeld > *aBufferListe;
  50. RCArray< Rahmen > *aRahmenListe;
  51. Schrift *schrift;
  52. // Verarbeitet Tastatur Nachrichten
  53. // me: Das Ereignis, was durch die Tastatureingabe ausgelößt wurde
  54. __declspec( dllexport ) void doMausEreignis( MausEreignis &me, bool userRet ) override;
  55. public:
  56. // Konstruktor
  57. __declspec( dllexport ) AuswahlListe();
  58. // Destruktor
  59. __declspec( dllexport ) virtual ~AuswahlListe();
  60. // Aktualisiert die Styles, größe und Position der Einträge
  61. __declspec( dllexport ) void update();
  62. // Fügt einen Eintrag hinzu
  63. // txt: Der Text des Eintrags
  64. __declspec( dllexport ) void addEintrag( Text *txt );
  65. // Fügt einen Eintrag hinzu
  66. // txt: Der Text des Eintrags
  67. __declspec( dllexport ) void addEintrag( const char *txt );
  68. // Fügt einen zeiger auf einen Eintrag hinzu
  69. // tf: Das TextFeld, mit dem der Eintrag gezeichnet wird
  70. __declspec( dllexport ) void addEintragZ( TextFeld *tf );
  71. // Fügt einen Eintrag an einer bestimmten Position hinzu
  72. // pos: Der Index des neuen Eintrags
  73. // txt: Der Text des Eintrags
  74. __declspec( dllexport ) void addEintrag( int pos, Text *txt );
  75. // Fügt einen Eintrag an einer bestimmten Position hinzu
  76. // pos: Der Index des neuen Eintrags
  77. // txt: Der Text des Eintrags
  78. __declspec( dllexport ) void addEintrag( int pos, const char *txt );
  79. // Fügt einen zeiger auf einen Eintrag an einer bestimmten Position hinzu
  80. // pos: Der Index des neuen Eintrags
  81. // tf: Das TextFeld, mit dem der Eintrag gezeichnet wird
  82. __declspec( dllexport ) void addEintragZ( int pos, TextFeld *tf );
  83. // Ändert einen Eintrag
  84. // pos: Der Index des Eintrags
  85. // txt: Der neue Text des Eintrags
  86. __declspec( dllexport ) void setEintrag( int pos, Text *txt );
  87. // Ändert einen Eintrag
  88. // pos: Der Index des Eintrags
  89. // txt: Der neue Text des Eintrags
  90. __declspec( dllexport ) void setEintrag( int pos, unsigned char *txt );
  91. // Ändert den Zeiger eines Eintrags
  92. // pos: Der Index des Eintrags
  93. // tf: Der neue Eintrag
  94. __declspec( dllexport ) void setEintragZ( int pos, TextFeld *tf );
  95. // Vertauscht die Positionen zweier Einträge
  96. // vpos: Der Index des ersten Eintrags
  97. // npos: Der Index des zweiten Eintrags
  98. __declspec( dllexport ) void tauschEintragPos( int vpos, int npos );
  99. // Löscht einen Eintrag
  100. // pos: Der Index des Eintrags
  101. __declspec( dllexport ) void removeEintrag( int pos );
  102. // Setzt die verwendete Schrift
  103. // schrift: Die Schrift
  104. __declspec( dllexport ) void setSchriftZ( Schrift *schrift );
  105. // Scrollt zu einem bestimmen Eintrag
  106. // eintrag: Der Index des Eintrags
  107. __declspec( dllexport ) void setVScrollZuEintrag( int eintrag );
  108. // Aktualisiert die maximale Scroll Höhe indem die Höhe aller Einträge addiert wird
  109. __declspec( dllexport ) void updateVScroll();
  110. // Setzt den Zeiger auf den Rahmen, der bei ausgewählten Einträgen verwendet wird, fals MulitStyled nicht gesetzt wurde
  111. // rahmen: Der Rahmen
  112. __declspec( dllexport ) void setALRZ( Rahmen *rahmen );
  113. // Setzt die Breite des Rahmens, der bei ausgewählten Einträgen verwendet wird, fals MulitStyled nicht gesetzt wurde
  114. // br: Die Breite in Pixeln
  115. __declspec( dllexport ) void setALRBreite( int br );
  116. // Setzt die Farbe des Rahmens, der bei ausgewählten Einträgen verwendet wird, fals MulitStyled nicht gesetzt wurde
  117. // fc: Die Farbe im A8R8G8B8 Format
  118. __declspec( dllexport ) void setALRFarbe( int fc );
  119. // Setzt den Zeiger auf den Farbübergnag, der bei ausgewählten Einträgen verwendet wird, fals MulitStyled nicht gesetzt wurde
  120. // buffer: Der Farbübergang
  121. __declspec( dllexport ) void setAAFZ( AlphaFeld *buffer );
  122. // Setzt die Stärke des Farbübergnags, der bei ausgewählten Einträgen verwendet wird, fals MulitStyled nicht gesetzt wurde
  123. // st: Die Stärke
  124. __declspec( dllexport ) void setAAFStrength( int st );
  125. // Setzt die Farbe des Farbübergnags, der bei ausgewählten Einträgen verwendet wird, fals MulitStyled nicht gesetzt wurde
  126. // fc: Die Farbe im A8R8G8B8 Format
  127. __declspec( dllexport ) void setAAFFarbe( int fc );
  128. // Setzt das Hintergrund Bild durch kopieren, das bei ausgewählten Einträgen verwendet wird, fals MulitStyled nicht gesetzt wurde
  129. // bild: Das Bild, das kopiert werden soll
  130. __declspec( dllexport ) void setAHBild( Bild *bild );
  131. // Setzt einen Zeiger auf das Hintergrund Bild, das bei ausgewählten Einträgen verwendet wird, fals MulitStyled nicht gesetzt wurde
  132. // bild: Das Bild, das kopiert werden soll
  133. __declspec( dllexport ) void setAHBildZ( Bild *bild );
  134. // Setzt die Hintergrund Farbe, die bei ausgewählten Einträgen verwendet wird, fals MulitStyled nicht gesetzt wurde
  135. // fc: Die Farbe im A8R8G8B8 Format
  136. __declspec( dllexport ) void setAHFarbe( int fc );
  137. // Setzt den Zeiger auf den Rahmen, der bei einem ausgewählten Eintrag verwendet wird, fals MulitStyled gesetzt wurde
  138. // pos: Der Index des Eintrags
  139. // rahmen: Der Rahmen
  140. __declspec( dllexport ) void setALRZ( int pos, Rahmen *rahmen );
  141. // Setzt die Breite des Rahmens, der bei einem ausgewählten Eintrag verwendet wird, fals MulitStyled gesetzt wurde
  142. // pos: Der Index des Eintrags
  143. // br: Die Breite in Pixeln
  144. __declspec( dllexport ) void setALRBreite( int pos, int br );
  145. // Setzt die Farbe des Rahmens, der bei einem ausgewählten Eintrag verwendet wird, fals MulitStyled gesetzt wurde
  146. // pos: Der Index des Eintrags
  147. // fc: Die Farbe im A8R8G8B8 Format
  148. __declspec( dllexport ) void setALRFarbe( int pos, int fc );
  149. // Setzt den Zeiger auf den Farbübergnag, der bei einem ausgewählten Eintrag verwendet wird, fals MulitStyled gesetzt wurde
  150. // pos: Der Index des Eintrags
  151. // buffer: Der Farbübergang
  152. __declspec( dllexport ) void setAAFZ( int pos, AlphaFeld *buffer );
  153. // Setzt die Stärke des Farbübergnags, der bei einem ausgewählten Eintrag verwendet wird, fals MulitStyled gesetzt wurde
  154. // pos: Der Index des Eintrags
  155. // st: Die Stärke
  156. __declspec( dllexport ) void setAAFStrength( int pos, int st );
  157. // Setzt die Farbe des Farbübergnags, der bei einem ausgewählten Eintrag verwendet wird, fals MulitStyled gesetzt wurde
  158. // pos: Der Index des Eintrags
  159. // fc: Die Farbe im A8R8G8B8 Format
  160. __declspec( dllexport ) void setAAFFarbe( int pos, int fc );
  161. // Setzt das Hintergrund Bild durch kopieren, das bei einem ausgewählten Eintrag verwendet wird, fals MulitStyled gesetzt wurde
  162. // pos: Der Index des Eintrags
  163. // bild: Das Bild, das kopiert werden soll
  164. __declspec( dllexport ) void setAHBild( int pos, Bild *bild );
  165. // Setzt einen Zeiger auf das Hintergrund Bild, das bei einem ausgewählten Eintrag verwendet wird, fals MulitStyled gesetzt wurde
  166. // pos: Der Index des Eintrags
  167. // bild: Das Bild, das kopiert werden soll
  168. __declspec( dllexport ) void setAHBildZ( int pos, Bild *bild );
  169. // Setzt die Hintergrund Farbe, die bei einem ausgewählten Eintrag verwendet wird, fals MulitStyled gesetzt wurde
  170. // pos: Der Index des Eintrags
  171. // fc: Die Farbe im A8R8G8B8 Format
  172. __declspec( dllexport ) void setAHFarbe( int pos, int fc );
  173. // Setzt den Style eines Eintrags, falls MulitStyled gesetzt wurde und legt fest, ob ein Eintrag ausgewählt ist, falls MultiSelect gesetzt wurde
  174. // pos: Der Index des Eintrags
  175. // style: Der neue Style
  176. __declspec( dllexport ) void setMsStyle( int pos, __int64 style );
  177. // Ändert den Style eines Eintrags, falls MulitStyled gesetzt wurde und legt fest, ob ein Eintrag ausgewählt ist, falls MultiSelect gesetzt wurde
  178. // pos: Der Index des Eintrags
  179. // style: Der Style
  180. // add_remove: 1, falls der Style hinzugefügt werden soll. 0, falls der Style entfernt weden soll
  181. __declspec( dllexport ) void setMsStyle( int pos, __int64 style, bool add_remove );
  182. // Fügt Styles zu einem Eintrag hinzu, falls MulitStyled gesetzt wurde und legt fest, ob ein Eintrag ausgewählt ist, falls MultiSelect gesetzt wurde
  183. // pos: Der Index des Eintrags
  184. // style: Der Style, der hinzugefügt werden soll
  185. __declspec( dllexport ) void addMsStyle( int pos, __int64 style );
  186. // Entfernt Styles von einem Eintrag, falls MulitStyled gesetzt wurde und legt fest, ob ein Eintrag ausgewählt ist, falls MultiSelect gesetzt wurde
  187. // pos: Der Index des Eintrags
  188. // style: Der Style, der entfernt werden soll
  189. __declspec( dllexport ) void removeMsStyle( int pos, __int64 style );
  190. // Verarbeitet ein Tastatur Ereignis. Wird vom Framework automatisch aufgerufen
  191. // te: Das Ereignis
  192. __declspec( dllexport ) void doTastaturEreignis( TastaturEreignis &te ) override;
  193. // Zeichnet das Objekt nach zRObj, falls es sichtbar ist
  194. // zRObj: Das Bild, in welches gezeichnet werden soll
  195. __declspec( dllexport ) void render( Bild &zRObj ) override;
  196. // Gibt den Index eines Eintrags zurück, auf den die Maus zeigt
  197. // my: Die Position der Maus auf der Y Achse basierend auf dem oberend Rand der Liste
  198. __declspec( dllexport ) int getKlickEintrag( int my );
  199. // Wählt einen Eintrag aus
  200. // ausw: Der Index des Eintrags
  201. __declspec( dllexport ) void setAuswahl( int ausw );
  202. // Wählt alle ausgewählten Einträge ab
  203. __declspec( dllexport ) void deSelect();
  204. // Gibt die Anzahl an Einträgen zurück
  205. __declspec( dllexport ) int getEintragAnzahl() const;
  206. // Gibt den Index des ausgewählten Eintrags zurück, fals MultiSelect nicht gesetzt ist. Wenn MultiSelect gesetzt wurde, kann die Auswahl eines Eintrags mit hatMsStyle( Eintrag Index, AuswahlListe::Style::Ausgewählt ) geprüft werden
  207. __declspec( dllexport ) int getAuswahl() const;
  208. // Gibt den Index eines Eintrags zurück
  209. // eintragText: Der Text des Eintrags
  210. __declspec( dllexport ) int getEintragPos( Text *eintragText );
  211. // Gibt einen Eintrag zurück
  212. // pos: Der Index des Eintrags
  213. __declspec( dllexport ) TextFeld *getEintrag( int pos ) const;
  214. // Gibt einen Eintrag ohne erhöhten reference Counter zurück
  215. // pos: Der Index des Eintrags
  216. __declspec( dllexport ) TextFeld *zEintrag( int pos ) const;
  217. // Gibt den Rahmen zurück, der für ausgewählte Einträge verwendet wird, falls MultiStyled nicht gesetzt wurde
  218. __declspec( dllexport ) Rahmen *getARahmen() const;
  219. // Gibt den Rahmen ohne erhöhten Reference Counter zurück, der für ausgewählte Einträge verwendet wird, falls MultiStyled nicht gesetzt wurde
  220. __declspec( dllexport ) Rahmen *zARahmen() const;
  221. // Gibt die Hintergrund Farbe im A8R8G8B8 Format zurück, die für ausgewählte Einträge verwendet wird, falls MultiStyled nicht gesetzt wurde
  222. __declspec( dllexport ) int getAHFarbe() const;
  223. // Gibt das Hintergrund Bild zurück, das für ausgewählte Einträge verwendet wird, falls MultiStyled nicht gesetzt wurde
  224. __declspec( dllexport ) Bild *getAHBild() const;
  225. // Gibt das Hintergrund Bild ohne erhöhten Reference Counter zurück, das für ausgewählte Einträge verwendet wird, falls MultiStyled nicht gesetzt wurde
  226. __declspec( dllexport ) Bild *zAHBild() const;
  227. // Gibt den Farbverlauf zurück, der für ausgewählte Einträge verwendet wird, falls MultiStyled nicht gesetzt wurde
  228. __declspec( dllexport ) AlphaFeld *getABuffer() const;
  229. // Gibt den Farbverlauf ohne erhöhten Reference Counter zurück, der für ausgewählte Einträge verwendet wird, falls MultiStyled nicht gesetzt wurde
  230. __declspec( dllexport ) AlphaFeld *zABuffer() const;
  231. // Gibt den Rahmen zurück, der für einen ausgewählten Eintrag verwendet wird, falls MultiStyled gesetzt wurde
  232. __declspec( dllexport ) Rahmen *getARahmen( int pos ) const;
  233. // Gibt den Rahmen ohne erhöhten Reference Counter zurück, der für einen ausgewählten Eintrag verwendet wird, falls MultiStyled gesetzt wurde
  234. __declspec( dllexport ) Rahmen *zARahmen( int pos ) const;
  235. // Gibt die Hintegrrund Farbe im A8R8G8B8 Format zurück, die für einen ausgewählten Eintrag verwendet wird, falls MultiStyled gesetzt wurde
  236. __declspec( dllexport ) int getAHFarbe( int pos ) const;
  237. // Gibt das Hintergrund Bild zurück, das für einen ausgewählten Eintrag verwendet wird, falls MultiStyled gesetzt wurde
  238. __declspec( dllexport ) Bild *getAHBild( int pos ) const;
  239. // Gibt das Hintergrund Bild ohne erhöhten Reference Counter zurück, das für einen ausgewählten Eintrag verwendet wird, falls MultiStyled gesetzt wurde
  240. __declspec( dllexport ) Bild *zAHBild( int pos ) const;
  241. // Gibt den Farbübergang zurück, der für einen ausgewählten Eintrag verwendet wird, falls MultiStyled gesetzt wurde
  242. __declspec( dllexport ) AlphaFeld *getABuffer( int pos ) const;
  243. // Gibt den Farbübergang ohne erhöhten Reference Counter zurück, der für einen ausgewählten Eintrag verwendet wird, falls MultiStyled gesetzt wurde
  244. __declspec( dllexport ) AlphaFeld *zABuffer( int pos ) const;
  245. // Überprüft, ob für einen Bestimmten Eintarg betimmte Styles gesetzt wurden, falls MultiStyled gesetzt wurde. Überprüft auch, ob ein Eintrag ausgewählt wurde, falls MultiSelect gesetzt wurde
  246. // pos: Der Index des Eintrags
  247. // style: Die zu prüfenden Styles
  248. __declspec( dllexport ) inline bool hatMsStyle( int pos, __int64 style ) const;
  249. // Überprüft, ob für einen Bestimmten Eintarg betimmte Styles nicht gesetzt wurden, falls MultiStyled gesetzt wurde. Überprüft auch, ob ein Eintrag nicht ausgewählt wurde, falls MultiSelect gesetzt wurde
  250. // pos: Der Index des Eintrags
  251. // style: Die zu prüfenden Styles
  252. __declspec( dllexport ) inline bool hatMsStyleNicht( int pos, __int64 style ) const;
  253. };
  254. }
  255. #endif