1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
| //------------------------------------------------------------------------------
(* SoLuTions is an Versatile Library for Delphi -
* -
* Copyright "SLT Solutions", (©2006) -
* contributeur : ShaiLeTroll (2012) - Gestion des Styles sous C++BuilderXE2 -
* contributeur : ShaiLeTroll (2012) - Documentation Insight -
* contributeur : ShaiLeTroll (2014) - Traduction du code C++Builder vers DelphiXE2
* -
* ShaiLeTroll -
* -
* Ce logiciel est un programme informatique servant à aider les développeurs -
* Delphi avec une bibliothèque polyvalente, adaptable et fragmentable. -
* -
* Ce logiciel est régi par la licence CeCILL-C soumise au droit français et -
* respectant les principes de diffusion des logiciels libres. Vous pouvez -
* utiliser, modifier et/ou redistribuer ce programme sous les conditions -
* de la licence CeCILL-C telle que diffusée par le CEA, le CNRS et l'INRIA -
* sur le site "http://www.cecill.info". -
* -
* En contrepartie de l'accessibilité au code source et des droits de copie, -
* de modification et de redistribution accordés par cette licence, il n'est -
* offert aux utilisateurs qu'une garantie limitée. Pour les mêmes raisons, -
* seule une responsabilité restreinte pèse sur l'auteur du programme, le -
* titulaire des droits patrimoniaux et les concédants successifs. -
* -
* A cet égard l'attention de l'utilisateur est attirée sur les risques -
* associés au chargement, à l'utilisation, à la modification et/ou au -
* développement et à la reproduction du logiciel par l'utilisateur étant -
* donné sa spécificité de logiciel libre, qui peut le rendre complexe à -
* manipuler et qui le réserve donc à des développeurs et des professionnels -
* avertis possédant des connaissances informatiques approfondies. Les -
* utilisateurs sont donc invités à charger et tester l'adéquation du -
* logiciel à leurs besoins dans des conditions permettant d'assurer la -
* sécurité de leurs systèmes et ou de leurs données et, plus généralement, -
* à l'utiliser et l'exploiter dans les mêmes conditions de sécurité. -
* -
* Le fait que vous puissiez accéder à cet en-tête signifie que vous avez -
* pris connaissance de la licence CeCILL-C, et que vous en avez accepté les -
* termes. -
* -
*----------------------------------------------------------------------------*)
unit SLT.Controls.VCL.GridsEx;
interface
uses System.SysUtils, System.Types,
Vcl.Grids, Vcl.Graphics, Vcl.Themes;
type
/// <summary>Erreur liée à l'assistant TStringGridSLTAssistant de la classe TStringGrid</summary>
EStringGridSLTAssistantError = class(Exception);
/// <summary>Assistance de la classe TStringGrid</summary>
/// <remarks>Le TStringGridSLTAssistant n'est pas un class helper car lors de sa création la version utilisée était C++Builder XE2,
/// Traduction C++Builder vers Delphi en concervant ce concept des Assistances de classes (Class Helper) du Delphi.NET</remarks>
TStringGridSLTAssistant = class(TObject)
private
// Membres privés
FStringGrid: TStringGrid;
public
// Constructeurs
constructor Create(AStringGrid: TStringGrid); overload;
constructor Create(Sender: TObject); overload;
/// <summary>DrawCellOfEmptyGrid Fournit une assistance au TStringGrid.OnDrawCell pour fournir le rendu d'une cellule vide</summary>
/// <param name="ACol">indique l'indice de colonne de la cellule à redessiner</param>
/// <param name="ARow">indique l'indice de ligne de la cellule à redessiner</param>
/// <param name="ABackgroundColor">Couleur de fond, clNone pour utiliser la couleur du thème</param>
/// <param name="AState">Le paramètre State indique si la cellule détient la focalisation, si elle est sélectionnée ou si la cellule est une cellule fixe (qui ne défile pas).</param>
procedure DrawCellEmpty(ACol, ARow: Integer; ABackgroundColor: TColor = clNone; AState: TGridDrawState = []);
/// <summary>DrawCellTitleCenter Fournit une assistance au TStringGrid.OnDrawCell pour fournir le rendu d'une cellule de titre avec son texte centré horizontalement et verticalement</summary>
/// <param name="ACol">indique l'indice de colonne de la cellule à redessiner</param>
/// <param name="ARow">indique l'indice de ligne de la cellule à redessiner</param>
/// <param name="AText">indique le texte de cellule à redessiner</param>
/// <param name="ABackgroundColor">Couleur de fond, clNone pour utiliser la couleur du thème</param>
/// <param name="AState">Le paramètre State indique si la cellule détient la focalisation, si elle est sélectionnée ou si la cellule est une cellule fixe (qui ne défile pas).</param>
procedure DrawCellTitleCenter(ACol, ARow: Integer; const AText: string; ABackgroundColor: TColor = clNone; AState: TGridDrawState = []);
/// <summary>DrawCheckBox fournit un assistant d'implémentation d'un TStringGrid.OnDrawColumnCell qui dessine une case à cocher centrée dans la zone définie par ARect</summary>
/// <param name="ACol">indique l'indice de colonne de la cellule à redessiner</param>
/// <param name="ARow">indique l'indice de ligne de la cellule à redessiner</param>
/// <param name="AChecked">Etat de la case à cocher</param>
/// <param name="AEnabled">la case à cocher est-elle active</param>
/// <param name="ABackgroundColor">Couleur de fond, clNone pour utiliser la couleur du thème</param>
/// <param name="AState">Etat de la cellule d'une grille qui est en cours de restitution</param>
procedure DrawCellCheckBox(ACol, ARow: Integer; AChecked: Boolean; AEnabled: Boolean = True; ABackgroundColor: TColor = clNone; AState: TGridDrawState = []);
// Méthodes d'ergonomie
procedure ZoomColumnWidth(AZoomPourcent: Integer);
// Propriétés
property StringGrid: TStringGrid read FStringGrid;
end;
implementation
uses Winapi.Windows,
SLT.Controls.VCL.GraphicsEx;
const
ERR_UNASSISTED_CLASS = 'La Classe d''Assistance %s ne prend pas en charge la classe %s mais la classe %s';
{ TStringGridSLTAssistant }
//------------------------------------------------------------------------------
constructor TStringGridSLTAssistant.Create(AStringGrid: TStringGrid);
begin
inherited Create();
FStringGrid := AStringGrid;
end;
//------------------------------------------------------------------------------
constructor TStringGridSLTAssistant.Create(Sender: TObject);
begin
inherited Create();
if Assigned(Sender) then
begin
if Sender is TStringGrid then
FStringGrid := TStringGrid(Sender)
else
raise EStringGridSLTAssistantError.CreateFmt(ERR_UNASSISTED_CLASS, [ClassName(), Sender.ClassName(), TStringGrid.ClassName()]);
end
else
raise EStringGridSLTAssistantError.CreateFmt(ERR_UNASSISTED_CLASS, [ClassName(), '[nil]', TStringGrid.ClassName()])
end;
//------------------------------------------------------------------------------
procedure TStringGridSLTAssistant.DrawCellCheckBox(ACol, ARow: Integer; AChecked: Boolean; AEnabled: Boolean = True; ABackgroundColor: TColor = clNone; AState: TGridDrawState = []);
const
CSelected: array[TGridDrawingStyle] of TThemedGrid = (
tgClassicCellSelected, tgCellSelected, tgGradientCellSelected);
var
uState: UINT;
tbState: TThemedButton;
Details: TThemedElementDetails;
StyleColor: TColor;
Buffer: Vcl.Graphics.TBitmap;
vRect, BufferRect: TRect;
begin
if StyleServices.Enabled then
begin
vRect := StringGrid.CellRect(ACol, ARow); // Rect Plus fiable que celui fourni par OnDrawCell !
// J'utilise un Buffer temporaire pour dessiner le ThemedButton CheckBox dans le TStringGrid
Buffer := Vcl.Graphics.TBitmap.Create();
try
BufferRect := Rect(0, 0, vRect.Width, vRect.Height);
Buffer.SetSize(BufferRect.Width, BufferRect.Height);
if ABackgroundColor = clNone then
begin
// On dessine un fond normal assurant normalement un bon constrate avec la CheckBox
Details := StyleServices.GetElementDetails(tgCellNormal);
StyleServices.GetElementColor(Details, ecFillColor, StyleColor);
end
else
StyleColor := ABackgroundColor;
// Même si la cellule est sélectionné, on laisse un fond neutre pour mieux voir la CheckBox
// Force un fond opaque pour cacher le texte !
Buffer.Canvas.Brush.Color := StyleColor;
Buffer.Canvas.Brush.Style := bsSolid;
Buffer.Canvas.FillRect(BufferRect);
tbState := tbCheckBoxUncheckedNormal;
if AChecked then
tbState := tbCheckBoxCheckedNormal;
if not AEnabled then
begin
if AChecked then
tbState := tbCheckBoxCheckedDisabled
else
tbState := tbCheckBoxUncheckedDisabled;
end;
Details := StyleServices.GetElementDetails(tbState);
StyleServices.DrawElement(Buffer.Canvas.Handle, Details, BufferRect, BufferRect);
// Dessin final
StringGrid.Canvas.Draw(vRect.Left, vRect.Top, Buffer);
finally
Buffer.Free();
end;
end
else
begin
uState := DFCS_BUTTONCHECK;
if AChecked then
uState := uState or DFCS_CHECKED;
if not AEnabled then
uState := uState or DFCS_INACTIVE;
StringGrid.Canvas.FillRect(vRect);
DrawFrameControl(StringGrid.Canvas.Handle, vRect, DFC_BUTTON, uState);
end;
end;
//------------------------------------------------------------------------------
procedure TStringGridSLTAssistant.DrawCellEmpty(ACol, ARow: Integer; ABackgroundColor: TColor = clNone; AState: TGridDrawState = []);
var
Details: TThemedElementDetails;
DetailColor: TColor;
vRect: TRect;
begin
with StringGrid.Canvas do
begin
if StyleServices.Enabled then
begin
Details := StyleServices.GetElementDetails(tgCellNormal);
StyleServices.GetElementColor(Details, ecFillColor, DetailColor);
if ABackgroundColor = clNone then
begin
Pen.Color := DetailColor;
Brush.Color := DetailColor;
end
else
begin
Pen.Color := ABackgroundColor;
Brush.Color := ABackgroundColor;
end;
end
else
begin
Pen.Color := StringGrid.Color;
Brush.Color := StringGrid.Color;
end;
vRect := StringGrid.CellRect(ACol, ARow); // Rect Plus fiable que celui fourni par OnDrawCell !
Rectangle(vRect);
end;
end;
//------------------------------------------------------------------------------
procedure TStringGridSLTAssistant.DrawCellTitleCenter(ACol, ARow: Integer; const AText: string; ABackgroundColor: TColor = clNone; AState: TGridDrawState = []);
var
vText: string;
vRect: TRect;
begin
if ABackgroundColor <> clNone then
begin
StringGrid.Canvas.Pen.Color := ABackgroundColor;
StringGrid.Canvas.Brush.Color := ABackgroundColor;
DrawCellEmpty(ACol, ARow, ABackgroundColor, AState);
StringGrid.Canvas.Font.Color := TCanvasSLTAssistant.GetConstratedColor(ABackgroundColor); // Couleur de luminosité inverse : Contraste garanti pour les couleurs claires ou foncées
end;
// TextRect encapsule DraxTextEx et est aussi pénible avec ses paramètres in-out !
vText := AText;
vRect := StringGrid.CellRect(ACol, ARow);
vRect.Left := vRect.Left + 3; // Pour ne pas superposer le texte et le rectangle de sélection
// DT_CENTER Centers text horizontally in the rectangle.
// DT_VCENTER Centers text vertically. This value is used only with the DT_SINGLELINE value.
StringGrid.Canvas.TextRect(vRect, vText, [tfCenter, tfSingleLine, tfVerticalCenter]);
end;
//------------------------------------------------------------------------------
procedure TStringGridSLTAssistant.ZoomColumnWidth(AZoomPourcent: Integer);
var
I: Integer;
begin
for I := 0 to StringGrid.ColCount - 1 do
StringGrid.ColWidths[I] := Round(StringGrid.ColWidths[I] * AZoomPourcent / 100);
end;
end. |
