Menu

[r4761]: / branches / parsnip / Src / FrUpdatePrefs.pas  Maximize  Restore  History

Download this file

222 lines (193 with data), 6.7 kB

  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
{
* This Source Code Form is subject to the terms of the Mozilla Public License,
* v. 2.0. If a copy of the MPL was not distributed with this file, You can
* obtain one at http://mozilla.org/MPL/2.0/
*
* Copyright (C) 2013-2014, Peter Johnson (www.delphidabbler.com).
*
* $Rev$
* $Date$
*
* Implements a frame to be hosted in the preferences diaogue box that permits
* the user to set their application and database update preferences.
}
unit FrUpdatePrefs;
interface
uses
// Delphi
Classes,
Controls,
StdCtrls,
// Project
CS.UI.Helper.CollectionCtrlKVMgr,
FrPrefsBase,
UPreferences;
type
/// <summary>Frame that allows the user to set their application and database
/// update preferences.</summary>
/// <remarks>Designed for use within the preferences dialogue box.</remarks>
TUpdatePrefsFrame = class(TPrefsBaseFrame)
lblProgAutoCheckFreq: TLabel;
lblDBAutoCheckFreq: TLabel;
cbProgAutoCheckFreq: TComboBox;
cbDBAutoCheckFreq: TComboBox;
/// <summary>Handles OnChange events on auto-update frequency check boxes.
/// Sets changed flag since display may need to be updated.</summary>
procedure CBAutoCheckFreqChanged(Sender: TObject);
strict private
var
/// <summary>Flag indicating if user has changed any update frequencies.
/// </summary>
fChanged: Boolean;
/// <summary>Manages mapping of items in "check for program updates"
/// drop-down list to the number of days each item represents.</summary>
fProgAutoCheckFreqMgr: TUnsortedCollectionCtrlKVMgr<Word>;
/// <summary>Manages mapping of items in "check for database updates"
/// drop-down list to the number of days each item represents.</summary>
fDBAutoCheckFreqMgr: TUnsortedCollectionCtrlKVMgr<Word>;
/// <summary>Populates the given combo box with values for each available
/// auto update check frequency.</summary>
procedure PopulateFrequencyCB(
const CBMgr: TUnsortedCollectionCtrlKVMgr<Word>);
public
/// <summary>Constructs new frame instance and initialises controls.
/// </summary>
constructor Create(AOwner: TComponent); override;
/// <summary>Destroys object instance.</summary>
destructor Destroy; override;
/// <summary>Updates controls to reflect values recorded in given
/// preferences object.</summary>
/// <remarks>Called when the page is activated.</remarks>
procedure Activate(const Prefs: IPreferences); override;
/// <summary>Updates given preferences object from values entered in
/// controls.</summary>
/// <remarks>Called when the page is deactivated.</remarks>
procedure Deactivate(const Prefs: IPreferences); override;
/// <summary>Checks if preference changes require that main window UI is
/// updated.</summary>
/// <returns>Boolean. Always False.</returns>
/// <remarks>Called when dialogue box containing frame is closing.
/// </remarks>
function UIUpdated: Boolean; override;
/// <summary>Arranges the frame's controls.</summary>
/// <remarks>Called after frame has been (re)sized.</remarks>
procedure ArrangeControls; override;
/// <summary>Returns the caption that is to be displayed to identify this
/// to the user.</summary>
function DisplayName: string; override;
/// <summary>Returns a number that determines the position of this frame
/// relative to other frames in host control.</summary>
class function Index: Byte; override;
end;
implementation
uses
// Delphi
Math, Generics.Defaults,
// Project
FmPreferencesDlg, UCtrlArranger, UGraphicUtils;
{$R *.dfm}
{ TUpdatePrefsFrame }
procedure TUpdatePrefsFrame.Activate(const Prefs: IPreferences);
begin
fProgAutoCheckFreqMgr.Select(Prefs.AutoCheckProgramFrequency);
fDBAutoCheckFreqMgr.Select(Prefs.AutoCheckDatabaseFrequency);
end;
procedure TUpdatePrefsFrame.ArrangeControls;
begin
TCtrlArranger.AlignLefts(
[lblProgAutoCheckFreq, lblDBAutoCheckFreq], 0
);
TCtrlArranger.AlignLefts(
[cbProgAutoCheckFreq, cbDBAutoCheckFreq],
Max(
StringExtent(lblProgAutoCheckFreq.Caption, lblProgAutoCheckFreq.Font).cx,
StringExtent(lblDBAutoCheckFreq.Caption, lblDBAutoCheckFreq.Font).cx
) + 12
);
TCtrlArranger.AlignVCentres(0, [lblProgAutoCheckFreq, cbProgAutoCheckFreq]);
TCtrlArranger.AlignVCentres(
TCtrlArranger.BottomOf([lblProgAutoCheckFreq, cbProgAutoCheckFreq], 12),
[lblDBAutoCheckFreq, cbDBAutoCheckFreq]
);
end;
procedure TUpdatePrefsFrame.CBAutoCheckFreqChanged(Sender: TObject);
begin
fChanged := True;
end;
constructor TUpdatePrefsFrame.Create(AOwner: TComponent);
var
WordEqualFn: TEqualityComparison<Word>;
begin
inherited;
WordEqualFn := function (const Left, Right: Word): Boolean
begin
Result := Left = Right;
end;
fProgAutoCheckFreqMgr := TUnsortedCollectionCtrlKVMgr<Word>.Create(
TComboBoxAdapter.Create(cbProgAutoCheckFreq), True, WordEqualFn
);
fDBAutoCheckFreqMgr := TUnsortedCollectionCtrlKVMgr<Word>.Create(
TComboBoxAdapter.Create(cbDBAutoCheckFreq), True, WordEqualFn
);
PopulateFrequencyCB(fProgAutoCheckFreqMgr);
PopulateFrequencyCB(fDBAutoCheckFreqMgr);
end;
procedure TUpdatePrefsFrame.Deactivate(const Prefs: IPreferences);
begin
if fProgAutoCheckFreqMgr.HasSelection then
Prefs.AutoCheckProgramFrequency := fProgAutoCheckFreqMgr.GetSelected;
if fDBAutoCheckFreqMgr.HasSelection then
Prefs.AutoCheckDatabaseFrequency := fDBAutoCheckFreqMgr.GetSelected;
end;
destructor TUpdatePrefsFrame.Destroy;
begin
fProgAutoCheckFreqMgr.Free;
fDBAutoCheckFreqMgr.Free;
inherited;
end;
function TUpdatePrefsFrame.DisplayName: string;
resourcestring
sDisplayName = 'Updates';
begin
Result := sDisplayName;
end;
class function TUpdatePrefsFrame.Index: Byte;
begin
Result := 60;
end;
procedure TUpdatePrefsFrame.PopulateFrequencyCB(
const CBMgr: TUnsortedCollectionCtrlKVMgr<Word>);
resourcestring
s0 = 'Never';
s1 = 'Daily';
s3 = 'Every 3 days';
s7 = 'Weekly';
s14 = 'Fortnightly';
s28 = 'Monthly';
const
FreqMap: array[0..5] of record
Text: string;
Value: Word;
end = (
(Text: s0; Value: 0),
(Text: s1; Value: 1),
(Text: s3; Value: 3),
(Text: s7; Value: 7),
(Text: s14; Value: 14),
(Text: s28; Value: 28)
);
var
I: Integer;
begin
CBMgr.Clear;
for I := Low(FreqMap) to High(FreqMap) do
CBMgr.Add(FreqMap[I].Value, FreqMap[I].Text);
end;
function TUpdatePrefsFrame.UIUpdated: Boolean;
begin
Result := fChanged;
end;
initialization
// Register frame with preferences dialogue box
TPreferencesDlg.RegisterPage(TUpdatePrefsFrame);
end.
Want the latest updates on software, tech news, and AI?
Get latest updates about software, tech news, and AI from SourceForge directly in your inbox once a month.