API Windows en C

La barre d'état ou Status Bar

CGi

La barre d'état ou Status Bar. ♪

- 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

Après la barre de progression, nous allons voir un deuxième contrôle de la bibliothèque dynamique « Common control library » : la barre d'état. Vous l'avez sûrement vue dans divers logiciels, c'est celle qui se trouve en bas des fenêtres et qui sert à donner des informations.

Elle sera créée dans la fenêtre principale. Nous reprendrons l'exemple du chapitre 10 « Communiquer avec les boîtes de dialogue », auquel nous ajouterons une barre d'état. Elle affichera des informations textuelles pour chaque option de menu. Ceci quand elles seront sélectionnées.

II - Mise en œuvre

Comme elle sera sur la fenêtre principale, nous la créons avec la fonction CreateStatusWindow. On aurait pu utiliser CreateWindow, mais CreateStatusWindow est plus simple.

1. InitCommonControls();

2. hsb = CreateStatusWindow(WS_CHILD | WS_VISIBLE, "Texte", hwnd, -1);

Comme pour la barre de progression, il faut appeler la fonction InitCommonControls avant de créer la barre. C'est tout pour sa création. Mais il va falloir gérer son redimensionnement quand les dimensions de sa fenêtre parent sont changées par l'utilisateur. Cela se fera comme pour le contrôle d'édition, à la réception du message WM_SIZE de la fenêtre parent.

1. case WM_SIZE:

2. {

3. RECT sbRect;

4. UINT sbheight;

5. GetWindowRect(hsb, &sbRect);

6. sbheight = sbRect.bottom - sbRect.top;

7. MoveWindow(hEdit, 0, 0, LOWORD(lParam), HIWORD(lParam)-sbheight,

8. TRUE);

9. MoveWindow(hsb, 0, HIWORD(lParam)-sbheight, LOWORD(lParam),

10. sbheight, TRUE);

11. return 0;

12. }

On récupère ses dimensions à l'aide de la fonction GetWindowRect, puis on positionne le contrôle d'édition avec la fonction MoveWindow afin qu'il laisse la place pour la barre d'état et enfin on positionne la barre d'état sur la place restante toujours avec la fonction MoveWindow.

Notre but est maintenant d'y afficher des informations quand des options de menus sont sélectionnées (ça ne veut pas dire actionnées, mais seulement quelles sont en surbrillances). Pour cela nous allons intercepter le message WM_MENUSELECT qui est envoyé à la fenêtre quand une option de son menu est sélectionnée.

1. case WM_MENUSELECT:

2. {

3. if (lParam == (LONG)GetMenu(hwnd))

4. {

5. if(LOWORD(wParam) == 0)

6. SendMessage(hsb, SB_SETTEXT, 0, (LONG)"Menu fichiers");

7. if(LOWORD(wParam) == 1)

8. SendMessage(hsb, SB_SETTEXT, 0, (LONG)"Menu Aide");

9. }

10. else

11. {

12. if(LOWORD(wParam) == IDM_QUIT)

13. SendMessage(hsb, SB_SETTEXT, 0,

14. (LONG)"Quitter l'application.");

15. if(LOWORD(wParam) == IDM_NEW)

16. SendMessage(hsb, SB_SETTEXT, 0,

17. (LONG)"Crée un nouveau fichier.");

18. if(LOWORD(wParam) == IDM_PARAM)

19. SendMessage(hsb, SB_SETTEXT, 0,

20. (LONG)"Changer les paramètres.");

21. if(LOWORD(wParam) == IDM_ABOUT)

22. SendMessage(hsb, SB_SETTEXT, 0, (LONG)"A Propos...");

23. }

24. return 0;

25. }

Puis nous testons le mot de poids faible du paramètre wParam qui est joint au message pour savoir de quelle option il s'agit. Ce mot contient identificateur de l'option. Le paramètre lParam contient le handle de menu, nous nous en servons pour savoir s'il s'agit du menu principal ou non.

Suite à la réception du message, nous modifions le texte de la barre d'état en lui envoyant un message SB_SETTEXT avec un pointeur sur la chaîne de caractère contenant le texte souhaité dans son paramètre lParam.

Nous changerons de même ce texte quand le menu ne sera plus en cours d'utilisation :

1. case WM_EXITMENULOOP:

2. SendMessage(hsb, SB_SETTEXT, 0, (LONG)"Texte");

3. return 0;

III - Code complet

III-A - resource.h

1. #define IDM_QUIT  1

2. #define IDM_NEW   2

3. #define IDM_ABOUT 3

4. #define IDM_PARAM 4

6. #define IDE_EDIT1 101

8. #define IDSB_SB1 201

III-B - resource.rc

1. #include <windows.h>

3. #include "resource.h"

5. 1 ICON icone.ico

6. 2 ICON autre.ico

8. LEMENU MENU

9. BEGIN

10. POPUP "Fichier"

11. BEGIN

12. MENUITEM "&Nouveau\tCtrl+N", IDM_NEW

13. MENUITEM "&Paramètres...\tCtrl+P", IDM_PARAM

14. MENUITEM SEPARATOR

15. MENUITEM "Quitter\tAlt+F4", IDM_QUIT

16. END

17. POPUP "Aide"

18. BEGIN

19. MENUITEM "À propos...", IDM_ABOUT

20. END

21. END

23. LesAccel ACCELERATORS

24. BEGIN

25. "N", IDM_NEW, CONTROL, VIRTKEY

26. "P", IDM_PARAM, CONTROL, VIRTKEY

27. VK_F1, IDM_ABOUT, VIRTKEY

28. END

30. DIALOG2 DIALOG

31. 60, 60, 182, 70

32. STYLE WS_POPUP | WS_VISIBLE | WS_CAPTION | WS_SYSMENU

33. CAPTION "Paramètres"

34. BEGIN

35. DEFPUSHBUTTON "OK", IDOK, 36, 42, 42, 12

36. PUSHBUTTON "Cancel", IDCANCEL, 96, 42, 42, 12

37. EDITTEXT IDE_EDIT1, 88, 15, 74, 12

38. LTEXT "Titre de la fenêtre", -1, 24, 18, 60, 10

39. END

41. DIALOG1 DIALOG

42. 60, 60, 160, 80

43. STYLE WS_POPUP | WS_VISIBLE | WS_CAPTION | WS_SYSMENU

44. CAPTION "À propos"

45. BEGIN

46. DEFPUSHBUTTON "OK", IDOK, 56, 50, 42, 12

47. ICON 2, -1, 20, 15, 32, 32

48. LTEXT "Mon beau programme !", -1, 60, 18, 80, 10

49. END

III-C - winmain.c

1. #include <windows.h>

2. #include <commctrl.h>

4. #include "resource.h"

6. HINSTANCE hinst;

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

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

10. BOOL APIENTRY Dialog2Proc(HWND, UINT, WPARAM, LPARAM);

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

14. LPSTR lpCmdLine, int nCmdShow)

15. {

16. HWND hwnd;

17. MSG msg;

18. WNDCLASS wc;

19. HACCEL haccel;

21. hinst = hinstance;

23. wc.style = 0 ;

24. wc.lpfnWndProc = MainWndProc;

25. wc.cbClsExtra = 0;

26. wc.cbWndExtra = 0;

27. wc.hInstance = hinstance;

28. wc.hIcon = LoadIcon(hinstance,MAKEINTRESOURCE(2));

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

30. wc.hbrBackground = NULL;

31. wc.lpszMenuName =  "LEMENU";

32. wc.lpszClassName = "MaWinClass";

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

36. hwnd = CreateWindow("MaWinClass", "Titre", WS_OVERLAPPEDWINDOW,

37. CW_USEDEFAULT, CW_USEDEFAULT, 400, 300,

38. NULL, NULL, hinstance, NULL);

39. if (!hwnd)  return FALSE;

41. ShowWindow(hwnd, nCmdShow);

43. haccel = LoadAccelerators(hinstance, "LesAccel");

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

46. {

47. if (!TranslateAccelerator(hwnd, haccel, &msg))

48. {

49. TranslateMessage(&msg);

50. DispatchMessage(&msg);

51. }

52. }

53. return msg.wParam;

54. }

55. /******************************************************************************/

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

58. {

59. static HWND hEdit;

60. static HWND hsb;

61. static BOOL EditNotChg = TRUE;

62. switch (uMsg)

63. {

64. case WM_CREATE:

65. {

66. HFONT hFont;

67. hEdit = CreateWindowEx(WS_EX_CLIENTEDGE ,"edit", "Texte",

68. WS_CHILD | WS_VISIBLE | ES_MULTILINE | ES_WANTRETURN | WS_VSCROLL,

69. 0, 0, 0, 0, hwnd, NULL, hinst, NULL);

70. hFont = (HFONT)GetStockObject(ANSI_FIXED_FONT);

71. SendMessage(hEdit,WM_SETFONT,(UINT)hFont,TRUE);

72. SendMessage(hEdit, EM_SETMARGINS, EC_LEFTMARGIN | EC_RIGHTMARGIN,

73. MAKELONG(5, 5));

75. InitCommonControls();

76. hsb = CreateStatusWindow(WS_CHILD | WS_VISIBLE, "Texte", hwnd, -1);

78. return 0;

79. }

81. case WM_CLOSE:

82. if(EditNotChg ||

83. MessageBox(hwnd,"Le texte a été modifié.\r\nÊtes vous sûr de \

84. vouloir fermer l'application ?"

85. ,"Question ?",MB_YESNO | MB_ICONQUESTION ) == IDYES)

86. DestroyWindow(hwnd);

87. return 0;

89. case WM_COMMAND:

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

92. if(LOWORD(wParam) == IDM_NEW)

93. if(EditNotChg ||

94. MessageBox(hwnd,"Le texte a été modifié.\r\nÊtes vous sûr de \

95. vouloir fermer votre travail ?"

96. ,"Question ?",MB_YESNO | MB_ICONQUESTION ) == IDYES)

97. {

98. SendMessage(hEdit,WM_SETTEXT,0,(LPARAM)"");

99. EditNotChg = TRUE;

100. }

102. if(LOWORD(wParam) == IDM_ABOUT)

103. DialogBox(hinst, "DIALOG1" , hwnd, (DLGPROC)Dialog1Proc);

105. if(LOWORD(wParam) == IDM_PARAM)

106. DialogBoxParam(hinst, "DIALOG2" , hwnd,

107. (DLGPROC)Dialog2Proc, (LPARAM)hwnd);

109. if(HIWORD(wParam) == EN_CHANGE) EditNotChg = FALSE;

111. return 0;

113. case WM_SIZE:

114. {

115. RECT sbRect;

116. UINT sbheight;

117. GetWindowRect(hsb, &sbRect);

118. sbheight = sbRect.bottom - sbRect.top;

119. MoveWindow(hEdit, 0, 0, LOWORD(lParam), HIWORD(lParam)-sbheight,

120. TRUE);

121. MoveWindow(hsb, 0, HIWORD(lParam)-sbheight, LOWORD(lParam),

122. sbheight, TRUE);

123. return 0;

124. }

126. case WM_MENUSELECT:

127. {

128. if (lParam == (LONG)GetMenu(hwnd))

129. {

130. if(LOWORD(wParam) == 0)

131. SendMessage(hsb, SB_SETTEXT, 0, (LONG)"Menu fichiers");

132. if(LOWORD(wParam) == 1)

133. SendMessage(hsb, SB_SETTEXT, 0, (LONG)"Menu Aide");

134. }

135. else

136. {

137. if(LOWORD(wParam) == IDM_QUIT)

138. SendMessage(hsb, SB_SETTEXT, 0,

139. (LONG)"Quitter l'application.");

140. if(LOWORD(wParam) == IDM_NEW)

141. SendMessage(hsb, SB_SETTEXT, 0,

142. (LONG)"Crée un nouveau fichier.");

143. if(LOWORD(wParam) == IDM_PARAM)

144. SendMessage(hsb, SB_SETTEXT, 0,

145. (LONG)"Changer les paramètres.");

146. if(LOWORD(wParam) == IDM_ABOUT)

147. SendMessage(hsb, SB_SETTEXT, 0, (LONG)"A Propos...");

148. }

149. return 0;

150. }

152. case WM_EXITMENULOOP:

153. SendMessage(hsb, SB_SETTEXT, 0, (LONG)"Texte");

154. return 0;

156. case WM_DESTROY:

157. PostQuitMessage(0);

158. return 0;

160. default:

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

162. }

163. }

164. /*****************************************************************************/

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

167. {

168. switch (uMsg)

169. {

170. case WM_INITDIALOG:

172. return TRUE;

174. case WM_COMMAND:

175. if (LOWORD(wParam) == IDCANCEL || LOWORD(wParam) == IDOK)

176. {

177. EndDialog(hDlg,0);

178. return TRUE;

179. }

181. default:

182. return FALSE;

183. }

184. }

185. /*****************************************************************************/

187. BOOL APIENTRY Dialog2Proc(HWND hDlg,UINT uMsg,WPARAM wParam,LPARAM lParam)

188. {

189. static HWND hParent;

190. switch (uMsg)

191. {

192. case WM_INITDIALOG:

193. {

194. int WindowTextLength;

195. CHAR *buffer;

196. hParent = (HWND)lParam;

197. WindowTextLength = GetWindowTextLength(hParent);

198. buffer = (CHAR*)LocalAlloc(LMEM_FIXED, WindowTextLength+1);

199. GetWindowText(hParent, buffer, WindowTextLength+1);

200. SetDlgItemText(hDlg, IDE_EDIT1, buffer);

201. LocalFree(buffer);

202. }

203. return TRUE;

205. case WM_COMMAND:

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

207. {

208. CHAR st[128];

209. GetDlgItemText(hDlg, IDE_EDIT1, st, 128);

210. SetWindowText(hParent,st);

211. EndDialog(hDlg,0);

212. return TRUE;

213. }

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

215. {

216. EndDialog(hDlg,0);

217. return TRUE;

218. }

219. default:

220. return FALSE;

221. }

222. }

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

N'oubliez pas d'ajouter la librairie d'importation « libcomctl32.a » avec Dev-C++ (Load object files dans Project options).

À voir aussi : la barre de progression.

À vos PC.

CGi

Retour au sommaire.