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. public:
  53. // Konstruktor
  54. __declspec( dllexport ) AuswahlListe();
  55. // Destruktor
  56. __declspec( dllexport ) virtual ~AuswahlListe();
  57. // Aktualisiert die Styles, größe und Position der Einträge
  58. __declspec( dllexport ) void update();
  59. // Fügt einen Eintrag hinzu
  60. // txt: Der Text des Eintrags
  61. __declspec( dllexport ) void addEintrag( Text *txt );
  62. // Fügt einen Eintrag hinzu
  63. // txt: Der Text des Eintrags
  64. __declspec( dllexport ) void addEintrag( const char *txt );
  65. // Fügt einen zeiger auf einen Eintrag hinzu
  66. // tf: Das TextFeld, mit dem der Eintrag gezeichnet wird
  67. __declspec( dllexport ) void addEintragZ( TextFeld *tf );
  68. // Fügt einen Eintrag an einer bestimmten Position hinzu
  69. // pos: Der Index des neuen Eintrags
  70. // txt: Der Text des Eintrags
  71. __declspec( dllexport ) void addEintrag( int pos, Text *txt );
  72. // Fügt einen Eintrag an einer bestimmten Position hinzu
  73. // pos: Der Index des neuen Eintrags
  74. // txt: Der Text des Eintrags
  75. __declspec( dllexport ) void addEintrag( int pos, const char *txt );
  76. // Fügt einen zeiger auf einen Eintrag an einer bestimmten Position hinzu
  77. // pos: Der Index des neuen Eintrags
  78. // tf: Das TextFeld, mit dem der Eintrag gezeichnet wird
  79. __declspec( dllexport ) void addEintragZ( int pos, TextFeld *tf );
  80. // Ändert einen Eintrag
  81. // pos: Der Index des Eintrags
  82. // txt: Der neue Text des Eintrags
  83. __declspec( dllexport ) void setEintrag( int pos, Text *txt );
  84. // Ändert einen Eintrag
  85. // pos: Der Index des Eintrags
  86. // txt: Der neue Text des Eintrags
  87. __declspec( dllexport ) void setEintrag( int pos, unsigned char *txt );
  88. // Ändert den Zeiger eines Eintrags
  89. // pos: Der Index des Eintrags
  90. // tf: Der neue Eintrag
  91. __declspec( dllexport ) void setEintragZ( int pos, TextFeld *tf );
  92. // Vertauscht die Positionen zweier Einträge
  93. // vpos: Der Index des ersten Eintrags
  94. // npos: Der Index des zweiten Eintrags
  95. __declspec( dllexport ) void tauschEintragPos( int vpos, int npos );
  96. // Löscht einen Eintrag
  97. // pos: Der Index des Eintrags
  98. __declspec( dllexport ) void removeEintrag( int pos );
  99. // Setzt die verwendete Schrift
  100. // schrift: Die Schrift
  101. __declspec( dllexport ) void setSchriftZ( Schrift *schrift );
  102. // Scrollt zu einem bestimmen Eintrag
  103. // eintrag: Der Index des Eintrags
  104. __declspec( dllexport ) void setVScrollZuEintrag( int eintrag );
  105. // Aktualisiert die maximale Scroll Höhe indem die Höhe aller Einträge addiert wird
  106. __declspec( dllexport ) void updateVScroll();
  107. // Setzt den Zeiger auf den Rahmen, der bei ausgewählten Einträgen verwendet wird, fals MulitStyled nicht gesetzt wurde
  108. // rahmen: Der Rahmen
  109. __declspec( dllexport ) void setALRZ( Rahmen *rahmen );
  110. // Setzt die Breite des Rahmens, der bei ausgewählten Einträgen verwendet wird, fals MulitStyled nicht gesetzt wurde
  111. // br: Die Breite in Pixeln
  112. __declspec( dllexport ) void setALRBreite( int br );
  113. // Setzt die Farbe des Rahmens, der bei ausgewählten Einträgen verwendet wird, fals MulitStyled nicht gesetzt wurde
  114. // fc: Die Farbe im A8R8G8B8 Format
  115. __declspec( dllexport ) void setALRFarbe( int fc );
  116. // Setzt den Zeiger auf den Farbübergnag, der bei ausgewählten Einträgen verwendet wird, fals MulitStyled nicht gesetzt wurde
  117. // buffer: Der Farbübergang
  118. __declspec( dllexport ) void setAAFZ( AlphaFeld *buffer );
  119. // Setzt die Stärke des Farbübergnags, der bei ausgewählten Einträgen verwendet wird, fals MulitStyled nicht gesetzt wurde
  120. // st: Die Stärke
  121. __declspec( dllexport ) void setAAFStrength( int st );
  122. // Setzt die Farbe des Farbübergnags, der bei ausgewählten Einträgen verwendet wird, fals MulitStyled nicht gesetzt wurde
  123. // fc: Die Farbe im A8R8G8B8 Format
  124. __declspec( dllexport ) void setAAFFarbe( int fc );
  125. // Setzt das Hintergrund Bild durch kopieren, das bei ausgewählten Einträgen verwendet wird, fals MulitStyled nicht gesetzt wurde
  126. // bild: Das Bild, das kopiert werden soll
  127. __declspec( dllexport ) void setAHBild( Bild *bild );
  128. // Setzt einen Zeiger auf das Hintergrund Bild, 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 setAHBildZ( Bild *bild );
  131. // Setzt die Hintergrund Farbe, die bei ausgewählten Einträgen verwendet wird, fals MulitStyled nicht gesetzt wurde
  132. // fc: Die Farbe im A8R8G8B8 Format
  133. __declspec( dllexport ) void setAHFarbe( int fc );
  134. // Setzt den Zeiger auf den Rahmen, der bei einem ausgewählten Eintrag verwendet wird, fals MulitStyled gesetzt wurde
  135. // pos: Der Index des Eintrags
  136. // rahmen: Der Rahmen
  137. __declspec( dllexport ) void setALRZ( int pos, Rahmen *rahmen );
  138. // Setzt die Breite des Rahmens, der bei einem ausgewählten Eintrag verwendet wird, fals MulitStyled gesetzt wurde
  139. // pos: Der Index des Eintrags
  140. // br: Die Breite in Pixeln
  141. __declspec( dllexport ) void setALRBreite( int pos, int br );
  142. // Setzt die Farbe des Rahmens, der bei einem ausgewählten Eintrag verwendet wird, fals MulitStyled gesetzt wurde
  143. // pos: Der Index des Eintrags
  144. // fc: Die Farbe im A8R8G8B8 Format
  145. __declspec( dllexport ) void setALRFarbe( int pos, int fc );
  146. // Setzt den Zeiger auf den Farbübergnag, der bei einem ausgewählten Eintrag verwendet wird, fals MulitStyled gesetzt wurde
  147. // pos: Der Index des Eintrags
  148. // buffer: Der Farbübergang
  149. __declspec( dllexport ) void setAAFZ( int pos, AlphaFeld *buffer );
  150. // Setzt die Stärke des Farbübergnags, der bei einem ausgewählten Eintrag verwendet wird, fals MulitStyled gesetzt wurde
  151. // pos: Der Index des Eintrags
  152. // st: Die Stärke
  153. __declspec( dllexport ) void setAAFStrength( int pos, int st );
  154. // Setzt die Farbe des Farbübergnags, der bei einem ausgewählten Eintrag verwendet wird, fals MulitStyled gesetzt wurde
  155. // pos: Der Index des Eintrags
  156. // fc: Die Farbe im A8R8G8B8 Format
  157. __declspec( dllexport ) void setAAFFarbe( int pos, int fc );
  158. // Setzt das Hintergrund Bild durch kopieren, das bei einem ausgewählten Eintrag verwendet wird, fals MulitStyled gesetzt wurde
  159. // pos: Der Index des Eintrags
  160. // bild: Das Bild, das kopiert werden soll
  161. __declspec( dllexport ) void setAHBild( int pos, Bild *bild );
  162. // Setzt einen Zeiger auf das Hintergrund Bild, das bei einem ausgewählten Eintrag verwendet wird, fals MulitStyled gesetzt wurde
  163. // pos: Der Index des Eintrags
  164. // bild: Das Bild, das kopiert werden soll
  165. __declspec( dllexport ) void setAHBildZ( int pos, Bild *bild );
  166. // Setzt die Hintergrund Farbe, die bei einem ausgewählten Eintrag verwendet wird, fals MulitStyled gesetzt wurde
  167. // pos: Der Index des Eintrags
  168. // fc: Die Farbe im A8R8G8B8 Format
  169. __declspec( dllexport ) void setAHFarbe( int pos, int fc );
  170. // Setzt den Style eines Eintrags, falls MulitStyled gesetzt wurde und legt fest, ob ein Eintrag ausgewählt ist, falls MultiSelect gesetzt wurde
  171. // pos: Der Index des Eintrags
  172. // style: Der neue Style
  173. __declspec( dllexport ) void setMsStyle( int pos, __int64 style );
  174. // Ändert den Style eines Eintrags, falls MulitStyled gesetzt wurde und legt fest, ob ein Eintrag ausgewählt ist, falls MultiSelect gesetzt wurde
  175. // pos: Der Index des Eintrags
  176. // style: Der Style
  177. // add_remove: 1, falls der Style hinzugefügt werden soll. 0, falls der Style entfernt weden soll
  178. __declspec( dllexport ) void setMsStyle( int pos, __int64 style, bool add_remove );
  179. // Fügt Styles zu einem Eintrag hinzu, falls MulitStyled gesetzt wurde und legt fest, ob ein Eintrag ausgewählt ist, falls MultiSelect gesetzt wurde
  180. // pos: Der Index des Eintrags
  181. // style: Der Style, der hinzugefügt werden soll
  182. __declspec( dllexport ) void addMsStyle( int pos, __int64 style );
  183. // Entfernt Styles von einem Eintrag, falls MulitStyled gesetzt wurde und legt fest, ob ein Eintrag ausgewählt ist, falls MultiSelect gesetzt wurde
  184. // pos: Der Index des Eintrags
  185. // style: Der Style, der entfernt werden soll
  186. __declspec( dllexport ) void removeMsStyle( int pos, __int64 style );
  187. // Verarbeitet Tastatur Nachrichten
  188. // me: Das Ereignis, was durch die Tastatureingabe ausgelößt wurde
  189. __declspec( dllexport ) void doMausEreignis( MausEreignis &me ) override;
  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