API Windows en C

Le contrôle scroll bar ou ascenseur.

CGi

Le contrôle scroll bar ou ascenseur. ?

- Titre : API Windows en C

- Auteur : CGi

- Parution : 6 juillet 2005

- Mise à jour : 4 janvier 2013

- Licence : Copyright ® 2005 CGi. Aucune reproduction, même partielle, ne peut être faite de ce site et de l'ensemble de son contenu : textes, documents, images, etc. sans l'autorisation expresse de l'auteur. Sinon vous encourez selon la loi jusqu'à trois ans de prison et jusqu'à 300 000 € de dommages et intérêts.

Sommaire

- I. Introduction

- II. Mise en œuvre

- III. Code complet

- III-A. resource.h

- III-B. resource.rc

- III-C. winmain.c

I - Introduction

Nous allons voir l'ascenseur en tant que contrôle. Je parle de celui que l'on utilise pour changer des valeurs et non des ascenseurs associés à certains contrôles pour en faire défiler leur contenu.

Afin de l'implémenter, nous reprendrons l'exemple de la liste déroulante, ou nous remplacerons le groupe de boutons radio destiné à modifier la largeur du trait par un ascenseur horizontal.

II - Mise en œuvre

L'ascenseur sera ajouté depuis les ressources et identifié par la constante ID_SB1.

1. SCROLLBAR ID_SB1, 96, 24, 60, 10

Comme pour l'exemple de la liste déroulante la largeur du trait sera mémorisée dans la variable globale Trait.

Pour utiliser un ascenseur, nous devons définir une structure SCROLLINFO servant de tampon pour transmettre ou récupérer les données de l'ascenseur.

Initialisation des données :

1. static HWND hsb;

2. static SCROLLINFO si;

3. switch (uMsg)

4. {

5. case WM_INITDIALOG:

6. {

7. hsb = GetDlgItem(hDlg, ID_SB1);

8. ZeroMemory(&si, sizeof(SCROLLINFO));

9. si.cbSize = sizeof(si);

10. si.fMask  = SIF_RANGE | SIF_POS;

11. si.nMin   = 0;

12. si.nMax   = 10;

13. si.nPos   = Trait;

14. SetScrollInfo(hsb, SB_CTL, &si, FALSE);

15. SetDlgItemInt(hDlg, ID_LT1, Trait, FALSE);

16. return TRUE;

17. }

À l'initialisation de la boîte de dialogue nous remplissons la structure SCROLLINFO, avec le champ fMask initialisé selon l'action que l'on voudra faire, puis le champ nMin avec la valeur mini, le champ nMax avec la valeur maxi et le champ nPos avec la largeur du trait actuelle afin qu'il reflète sa taille sur l'ascenseur. Nous exécutons le transfert des données avec la fonction SetScrollInfo qui reçoit comme paramètre : le handle de fenêtre de l'ascenseur, puis le flag SB_CTL, car c'est un contrôle, puis l'adresse de la variable (SCROLLINFO)si. Le dernier paramètre indique si l'on veut redessiner la barre à l'appel de la fonction.

J'ai rajouté dans la boîte de dialogue un contrôle texte pour afficher la valeur de la largeur du trait. Il est mis à jour avec la fonction SetDlgItemInt qui effectue automatiquement la conversion d'un entier en texte.

Ce contrôle n'est pas le plus simple, car nous devons gérer par programme son positionnement. Quand la position d'un ascenseur est modifiée un message WM_HSCROLL est envoyé à sa fenêtre parent. C'est donc sur ce message que l'on va gérer l'ascenseur.

1. case WM_HSCROLL:

2. GetScrollInfo((HWND)lParam, SB_CTL, &si);

3. switch (LOWORD(wParam))

4. {

5. case SB_PAGEUP:

6. si.nPos -= 2;

7. if(si.nPos < si.nMin) si.nPos = si.nMin ;

8. break;

10. case SB_PAGEDOWN:

11. si.nPos += 2;

12. if(si.nPos > si.nMax) si.nPos = si.nMax ;

13. break;

15. case SB_LINEUP:

16. if(si.nPos > si.nMin) si.nPos--;

17. break;

19. case SB_LINEDOWN:

20. if(si.nPos < si.nMax) si.nPos++;

21. break;

23. case SB_THUMBPOSITION:

24. si.nPos = HIWORD(wParam);

25. break;

26. }

27. si.fMask  = SIF_POS;

28. SetScrollInfo((HWND)lParam, SB_CTL, &si, TRUE);

29. SetDlgItemInt(hDlg, ID_LT1, si.nPos, FALSE);

30. return TRUE;

Nous récupérons les informations de l'ascenseur en cours de manipulation dans la variable (SCROLLINFO)si, avec la fonction GetScrollInfo (il peut y avoir plusieurs ascenseurs). Le handle de fenêtre de l'ascenseur étant récupéré dans le paramètre lParam du message. Dans le mot de poids faible de son paramètre wParam, il retourne l'action qui a été effectuée sur l'ascenseur.

- SB_PAGEUP : clic sur la zone entre la flèche de gauche ou du haut et le curseur.

- SB_PAGEDOWN : clic sur la zone entre le curseur et la flèche de droite ou du bas.

- SB_LINEUP : clic sur la flèche de gauche ou du haut s'il est vertical.

- SB_LINEDOWN : clic sur la flèche de droite ou du bas s'il est vertical.

- SB_THUMBPOSITION : déplacement du curseur. En ce cas la valeur est retournée par le mot de poids fort du paramètre wParam.

Nous nous en servons pour changer ses positions qui seront effectives après l'appel de la fonction SetScrollInfo. Nous mettons de même à jour le texte reflétant sa valeur avec la fonction SetDlgItemInt.

À la fermeture de la boîte de dialogue par OK :

1. case WM_COMMAND:

2. if (LOWORD(wParam) == IDOK)

3. {

4. GetScrollInfo(hsb, SB_CTL, &si);

5. Trait = si.nPos;

6. EndDialog(hDlg,DB_OK);

7. return TRUE;

8. }

Nous récupérons sa position à l'aide de GetScrollInfo et nous l'affectons à la variable Trait.

III - Code complet

III-A - resource.h

1. #define IDM_QUIT 1

2. #define IDM_PROP 2

4. #define ID_SB1 101

5. #define ID_CB1 102

6. #define ID_LT1 103

III-B - resource.rc

1. #include <windows.h>

3. #include "resource.h"

5. LEMENU MENU

6. BEGIN

7. POPUP "Fichier"

8. BEGIN

9. MENUITEM "Propriétés...", IDM_PROP

10. MENUITEM SEPARATOR

11. MENUITEM "Quitter", IDM_QUIT

12. END

13. END

15. DIALOG1 DIALOG

16. 110, 0, 175, 90

17. STYLE WS_POPUP | WS_VISIBLE | WS_CAPTION | WS_SYSMENU

18. CAPTION "Propriétés de la figure"

19. BEGIN

21. LTEXT "Figure", -1, 35, 10, 30, 10

22. COMBOBOX ID_CB1, 20, 24, 56, 45, CBS_DROPDOWNLIST

24. LTEXT "Trait", -1, 115, 10, 30, 10

25. SCROLLBAR ID_SB1, 96, 24, 60, 10

26. LTEXT "Larg :", -1, 110, 44, 20, 10

27. RTEXT "0", ID_LT1, 130, 44, 10, 10

29. DEFPUSHBUTTON "OK", IDOK, 36, 65, 42, 12

30. PUSHBUTTON "Cancel", IDCANCEL, 96, 65, 42, 12

31. END

III-C - winmain.c

1. #include <windows.h>

3. #include "resource.h"

5. #define DB_OK 1

7. #define ID_CARRE 0

8. #define ID_CERCLE 1

9. #define ID_TRIANGLE 2

11. UINT Forme;

12. UINT Trait;

14. HINSTANCE hinst;

16. LRESULT CALLBACK MainWndProc(HWND, UINT, WPARAM, LPARAM);

17. BOOL APIENTRY Dialog1Proc(HWND, UINT, WPARAM, LPARAM);

19. int WINAPI WinMain(HINSTANCE hinstance, HINSTANCE hPrevInstance,

20. LPSTR lpCmdLine, int nCmdShow)

21. {

22. HWND hwnd;

23. MSG msg;

24. WNDCLASS wc;

26. hinst = hinstance;

28. wc.style = 0;

29. wc.lpfnWndProc = MainWndProc;

30. wc.cbClsExtra = 0;

31. wc.cbWndExtra = 0;

32. wc.hInstance = hinstance;

33. wc.hIcon = LoadIcon(NULL, IDI_APPLICATION);

34. wc.hCursor = LoadCursor(NULL, IDC_ARROW);

35. wc.hbrBackground = (HBRUSH)(1 + COLOR_BTNFACE);

36. wc.lpszMenuName =  "LEMENU";

37. wc.lpszClassName = "MaWinClass";

39. if(!RegisterClass(&wc)) return FALSE;

41. hwnd = CreateWindow("MaWinClass", "Check Box", WS_OVERLAPPED | WS_SYSMENU,

42. CW_USEDEFAULT, CW_USEDEFAULT, 400, 260,

43. NULL, NULL, hinstance, NULL);

44. if (!hwnd) return FALSE;

46. ShowWindow(hwnd, nCmdShow);

47. UpdateWindow(hwnd);

49. while (GetMessage(&msg, NULL, 0, 0))

50. {

51. TranslateMessage(&msg);

52. DispatchMessage(&msg);

53. }

54. return msg.wParam;

55. }

57. /******************************************************************************/

59. LRESULT CALLBACK MainWndProc(HWND hwnd, UINT uMsg, WPARAM wParam, LPARAM lParam)

60. {

61. switch (uMsg)

62. {

63. case WM_CREATE:

64. Forme = ID_CARRE;

65. Trait = 1;

66. return 0;

68. case WM_COMMAND:

69. if(LOWORD(wParam) == IDM_QUIT) PostMessage(hwnd, WM_CLOSE,0,0);

70. if(LOWORD(wParam) == IDM_PROP)

71. {

72. if(DialogBox(hinst, "DIALOG1" , hwnd, (DLGPROC)Dialog1Proc)

73. == DB_OK)

74. InvalidateRect(hwnd,NULL,TRUE);

75. }

76. return 0;

78. case WM_PAINT :

79. {

80. PAINTSTRUCT ps;

81. HDC hdc ;

82. HPEN hpen, hpOld;

84. POINT ptTriangle[3];

85. ptTriangle[0].x = 20;

86. ptTriangle[0].y = 20;

87. ptTriangle[1].x = 20;

88. ptTriangle[1].y = 170;

89. ptTriangle[2].x = 170;

90. ptTriangle[2].y = 95;

92. hdc = BeginPaint(hwnd, &ps);

94. hpen = CreatePen(PS_SOLID, Trait, 0);

95. hpOld = SelectObject(hdc,hpen);

97. if(Forme == ID_CARRE) Rectangle(hdc, 20, 20, 170, 170);

99. if(Forme == ID_CERCLE) Ellipse(hdc, 20, 20, 170, 170);

101. if(Forme == ID_TRIANGLE) Polygon(hdc, ptTriangle, 3);

103. SelectObject(hdc,hpOld);

104. DeleteObject(hpen);

106. EndPaint(hwnd, &ps);

107. return 0;

108. }

110. case WM_DESTROY:

111. PostQuitMessage(0);

112. return 0;

114. default:

115. return DefWindowProc(hwnd, uMsg, wParam, lParam);

116. }

117. }

119. /******************************************************************************/

121. BOOL APIENTRY Dialog1Proc(HWND hDlg,UINT uMsg,WPARAM wParam,LPARAM lParam)

122. {

123. static HWND hsb;

124. static SCROLLINFO si;

125. switch (uMsg)

126. {

127. case WM_INITDIALOG:

128. {

130. SendDlgItemMessage(hDlg, ID_CB1, CB_ADDSTRING, 0, (LONG)"Carré");

131. SendDlgItemMessage(hDlg, ID_CB1, CB_ADDSTRING, 0, (LONG)"Cercle");

132. SendDlgItemMessage(hDlg, ID_CB1, CB_ADDSTRING, 0, (LONG)"Triangle");

133. SendDlgItemMessage(hDlg, ID_CB1, CB_SETCURSEL, Forme, 0);

135. hsb = GetDlgItem(hDlg, ID_SB1);

136. ZeroMemory(&si, sizeof(SCROLLINFO));

137. si.cbSize = sizeof(si);

138. si.fMask  = SIF_RANGE | SIF_POS;

139. si.nMin   = 0;

140. si.nMax   = 10;

141. si.nPos   = Trait;

142. SetScrollInfo(hsb, SB_CTL, &si, FALSE);

143. SetDlgItemInt(hDlg, ID_LT1, Trait, FALSE);

144. return TRUE;

145. }

147. case WM_HSCROLL:

148. GetScrollInfo((HWND)lParam, SB_CTL, &si);

149. switch (LOWORD(wParam))

150. {

151. case SB_PAGEUP:

152. si.nPos -= 2;

153. if(si.nPos < si.nMin) si.nPos = si.nMin ;

154. break;

156. case SB_PAGEDOWN:

157. si.nPos += 2;

158. if(si.nPos > si.nMax) si.nPos = si.nMax ;

159. break;

161. case SB_LINEUP:

162. if(si.nPos > si.nMin) si.nPos--;

163. break;

165. case SB_LINEDOWN:

166. if(si.nPos < si.nMax) si.nPos++;

167. break;

169. case SB_THUMBPOSITION:

170. si.nPos = HIWORD(wParam);

171. break;

172. }

173. si.fMask  = SIF_POS;

174. SetScrollInfo((HWND)lParam, SB_CTL, &si, TRUE);

175. SetDlgItemInt(hDlg, ID_LT1, si.nPos, FALSE);

176. return TRUE;

178. case WM_COMMAND:

179. if (LOWORD(wParam) == IDOK)

180. {

181. GetScrollInfo(hsb, SB_CTL, &si);

182. Trait = si.nPos;

183. Forme = SendDlgItemMessage(hDlg, ID_CB1, CB_GETCURSEL, 0, 0);

184. EndDialog(hDlg,DB_OK);

185. return TRUE;

186. }

188. if (LOWORD(wParam) == IDCANCEL)

189. {

190. EndDialog(hDlg,0);

191. return TRUE;

192. }

194. default:

195. return FALSE;

196. }

197. }

J'ai testé les compilations avec C++ Builder et DevC++.

À vos PC.

CGi

Retour au sommaire.