Własne klasy obsługujące podstawowe kontrolki WinApi

Stronę tą wyświetlono już: 871 razy

Sporą wadą WinApi jest fakt, że obsługa kontrolek wymaga znajomości wielu funkcji obsługi okien oraz komunikatów i styli wpływających na wygląd tychże kontrolek. Nie ma tutaj również mowy o obiektowym tworzeniu kontrolek. Można jednak samemu napisać sobie klasy, które umożliwią łatwe obsłużenie tworzenia kontrolek, sterowania ich zachowaniem oraz wyglądem. Z tego właśnie powodu utworzyłem sobie mały zbiór klas, które umożliwiają mi dynamiczne tworzenie kontrolek oraz łatwy dostęp do opcji nimi sterujących oraz możliwość podpinania obiektów klas odpowiedzialnych za realizację zadań wywoływanych przez notyfikacje wysyłane przez daną kontrolkę do okna rodzica.

Oto lista klas do obsługi podstawowych kontrolek:

  • WndLabel - klasa odpowiedzialna za tworzenie i obsługę notyfikacji kontrolki static;
  • WndEdit - klasa odpowiedzialna za tworzenie i obsługę notyfikacji kontrolki edit;
  • WndButton - klasa odpowiedzialna za tworzenie i obsługę notyfikacji kontrolki button;
  • WndScrollBar - klasa odpowiedzialna za tworzenie i obsługę notyfikacji kontrolki scrollbar;
  • WndListBox - klasa odpowiedzialna za tworzenie i obsługę notyfikacji kontrolki listbox;
  • WndComboBox - klasa odpowiedzialna za tworzenie i obsługę notyfikacji kontrolki combobox;
  • WndTooltip - klasa odpowiedzialna za tworzenie i obsługę notyfikacji kontrolki tooltip służącej do wyświetlania podpowiedzi/opisów kontekstowych innych kontrolek.
Przykładowy widok dynamicznie utworzonych w WinApi kontrolek przy użyciu klas
Rys. 1
Przykładowy widok dynamicznie utworzonych w WinApi kontrolek przy użyciu klas

Cały kod poszczególnych klas wraz z przykładem ich zastosowania zamieściłem na stronie GitHub. Jedynie pokażę jak można tworzyć kontrolki za ich pomocą. Oto jak tworzone są kontrolki w komunikacie WM_CREATE:

Listing 1
  1. case WM_CREATE:
  2. {
  3. NONCLIENTMETRICS ncm;
  4. ncm.cbSize=sizeof(ncm);
  5. SystemParametersInfo(SPI_GETNONCLIENTMETRICS, sizeof(ncm), &ncm, 0);
  6. font = CreateFontIndirect(&ncm.lfStatusFont);
  8. myEdit = new WndEdit( // Create WndEdit control object
  9. "some edit stuff", // text to set in edit control
  10. ws::window::ws_child // control styles: as child window
  11. | ws::window::ws_visible // as visible window
  12. | ws::window::ws_hscrollbar // as window with horizontal scroll bar
  13. | ws::window::ws_vscrollbar // as window with vertical scroll bar
  14. | ws::edit::es_autohscroll // as edit control with auto horizontal scroll
  15. | ws::edit::es_autovscroll // as edit control with auto vertical scroll
  16. | ws::edit::es_multiline, // as multiline edit control
  17. 100, // x - position
  18. 0, // y - position
  19. 100, // width
  20. 50, // height
  21. hWnd, // handle to parent window
  22. (HMENU) 5000, // in this case id of control
  23. hInst, // handle to application instance
  24. NULL // pointer to some extra data stuff (in this cas NULL means no extra data stuff)
  25. );
  26. // set myEdit object control font
  27. myEdit->setFont(font);
  29. myScrollBar = new WndScrollBar( // create WndScrollBar object of control ScrollBar
  30. ws::window::ws_child| // Style of control: as child
  31. ws::window::ws_visible| // as visible
  32. ws::scrollbar::sbs_horizontal, // as hotizontal scroll bar
  33. 100, // x - position
  34. 50, // y - position
  35. 100, // width
  36. 20, // height
  37. hWnd, // parent window handle
  38. (HMENU) 5001, // in this case it is a id of control
  39. hInst, // handle to application instance
  40. NULL // pointer to some extra data stuff (in this cas NULL means no extra data stuff)
  41. );
  43. SCROLLINFO si; // structure describe setting of scroll bar control
  45. si.cbSize = sizeof(SCROLLINFO); // this parameter must be set
  46. si.fMask = SIF_ALL; // flag describing whitch of struct field will be used
  47. si.nMax = 110; // maximum value + nPage - 1
  48. si.nMin = 0; // minimum value
  49. si.nPage = 11; // page scrolling size
  50. si.nPos = 0; // current scroll bar pos
  51. si.nTrackPos = 0; // current track pos
  53. myScrollBar->setScrollInfo(&si, false); // set settings of scrollbar
  54. myScrollBar->setThumbtract(true); // this means that when user move control slider then value of nPos Scroll Bar is changed
  55. // add some notification command for myScrollBar object control
  56. myScrollBar->addNotification(WndScrollBar::notifications::wmscroll, new OnScrollChanged(myEdit, myScrollBar));
  58. myListBox = new WndListBox( // create WndListBox window object
  59. ws::window::ws_hscrollbar| // with styla: hotizontal scrollbar
  60. ws::window::ws_vscrollbar| // vertical scrollbar
  61. ws::window::ws_child| // as child window
  62. ws::window::ws_visible| // as visible widnow
  63. ws::listbox::lbs_notify| // with sending notification code
  64. ws::listbox::lbs_hasstrings,// with string data item
  65. 100, // x-position
  66. 70, // y-position
  67. 100, // control width
  68. 100, // control height
  69. hWnd, // parent window handle
  70. (HMENU) 5002, // in this case it is an window ID
  71. hInst, // application instance handle
  72. NULL // pointer to some extra data (in this case NULL - means no extra data)
  73. );
  75. // add items to list box
  76. myListBox->addTextItem("Polska");
  77. myListBox->addTextItem("Czechy");
  78. myListBox->addTextItem("Słowacja");
  79. myListBox->addTextItem("Litwa");
  80. myListBox->addTextItem("Łotwa");
  81. myListBox->addTextItem("Estonia");
  82. myListBox->addTextItem("Węgry");
  83. myListBox->addTextItem("Stany Zjednoczone Ameryki");
  84. // set myListBox font
  85. myListBox->setFont(font);
  86. // add some notifications stuff
  87. myListBox->addNotification(WndListBox::notifications::selchange, new OnListBoxSelChanged(myEdit, myListBox)); // notification command for selchange notify
  88. myListBox->addNotification(WndListBox::notifications::doubleclick, new OnListBoxDblClick(myEdit, myListBox)); // notification command for doubleclick notify
  90. myLabel = new WndLabel( // create WndLabel object of Static control
  91. "Label", // text to write in window
  92. ws::window::ws_child| // window style: as child
  93. ws::window::ws_visible| // as visible
  94. ws::label::ss_notify, // with sending notifications to parent window
  95. 100, // x - position
  96. 170, // y - position
  97. 100, // width
  98. 20, // height
  99. hWnd, // parent window handle
  100. (HMENU) 5003, // in this case id of cotrol
  101. hInst, // handle to application instance
  102. NULL // pointer to some extra data (in this case NULL - means no extra data)
  103. );
  104. // set myLabel font
  105. myLabel->setFont(font);
  106. // add notification command object to myLabel control
  107. myLabel->addNotification(WndLabel::notifications::clicked, new OnLabelClick(myLabel));
  109. myComboBox = new WndComboBox( // create WndComboBox class object of combobox control
  110. ws::window::ws_child| // with style: as child
  111. ws::window::ws_visible| // as visible
  112. ws::window::ws_vscrollbar| // with vertical scrollbar
  113. ws::combobox::cbs_hasstrings| // with string data for stored items
  114. ws::combobox::cbs_dropdown, // with drop down list
  115. 100, // x - position
  116. 190, // y - position
  117. 100, // width
  118. 100, // height (including drop down list height)
  119. hWnd, // handle to parent window
  120. (HMENU) 5004, // in this case control id
  121. hInst, // application instance handle
  122. NULL // pointer to some extra data (in this case NULL - means no extra data)
  123. );
  125. // add items to combo box
  126. myComboBox->addTextItem("Polska");
  127. myComboBox->addTextItem("Czechy");
  128. myComboBox->addTextItem("Słowacja");
  129. myComboBox->addTextItem("Litwa");
  130. myComboBox->addTextItem("Łotwa");
  131. myComboBox->addTextItem("Estonia");
  132. myComboBox->addTextItem("Węgry");
  133. myComboBox->addTextItem("Stany Zjednoczone Ameryki");
  135. myComboBox->setFont(font);
  137. myComboBox->addNotification(WndComboBox::notifications::selchange, new OnComboBoxSelChanged(myEdit, myComboBox));
  138. }
  139. break;

Ważnym elementem obsługi kontrolek w WinApi są notyfikacje, czyli komunikaty pochodzące od danej kontrolki wysyłane do okna rodzica. Mechanizm podpinania jest bardzo prosty i przytoczę tutaj jeden przykładowy wycinek z listing-u 1:

Listing 2
  1. myComboBox->addNotification(WndComboBox::notifications::selchange, new OnComboBoxSelChanged(myEdit, myComboBox));

To co jest wykonywane w powyższym fragmencie kodu to podpinanie pod zdarzenie (notyfikację) typu selchange obiektu klasy OnComboBoxSelChanged. Klasa ta dziedziczy po specjalnie utworzonym interfejsie INotificationCommand, który dysponuje czysto wirtualną metodą notify. To ta metoda będzie wywoływana, gdy obiekt wyśle notyfikację do okna rodzica. Do obsługi więc notyfikacji konieczne jest utworzenie takiej klasy. Oto przykład:

Listing 3
  1. class OnComboBoxSelChanged : public INotificationCommand{
  2. public:
  3. WndEdit* edit;
  4. WndComboBox* combobox;
  6. OnComboBoxSelChanged(WndEdit* edit, WndComboBox* combobox) : edit(edit), combobox(combobox){}
  8. virtual void notify(){
  9. edit->setWindowText(combobox->getSelectedText());
  10. }
  11. };

Klasa OnComboBoxSelChanged przechowuje dane niezbędne do realizacji zadań wykonywanych w metodzie notify. Niestety samo podpięcie klasy nie wystarczy, trzeba jeszcze obsłużyć komunikat WM_COMMAND, gdzie lądują notyfikacje wysyłane przez okna potomne. Oto przykładowy kod:

Listing 4
  1. case WM_COMMAND:
  2. {
  3. UINT nc = HIWORD(wParam);
  4. UINT id = LOWORD(wParam);
  5. HWND ctrl = (HWND) lParam;
  7. if(myListBox->notify(ctrl, id, nc)) // doing notification stuff for myListBox control object
  8. break;
  9. if(myLabel->notify(ctrl, id, nc)) // doing notification stuff for myLabel control object
  10. break;
  11. if(myComboBox->notify(ctrl, id, nc)) // doing notification stuff for myComboBox control object
  12. break;
  13. }
  14. break;

Jak widać metoda notify wywołana w komunikacie WM_COMMAND wykonuje całą brudną robotę związaną z obsługą notyfikacji i zwraca wartość niezerową, gdy notyfikacja została obsłużona.

Strony powiązane
strony powiązane
  1. github.com/Obliczeniowo/WinApiControlsClass - repozytorium z całym kodem klas i przykładem ich użycia
Tematy powiązane

Komentarze