ViewVC Help
View File | Revision Log | Show Annotations | Download File | View Changeset | Root Listing
root/public/ibx/branches/journaling/ibcontrols/IBLookupComboEditBox.pas
Revision: 27
Committed: Tue Apr 14 13:10:23 2015 UTC (9 years, 8 months ago) by tony
Content type: text/x-pascal
Original Path: ibx/trunk/ibcontrols/IBLookupComboEditBox.pas
File size: 16132 byte(s)
Log Message:
Committing updates for Release R1-2-3

File Contents

# Content
1 (*
2 * IBX For Lazarus (Firebird Express)
3 *
4 * The contents of this file are subject to the Initial Developer's
5 * Public License Version 1.0 (the "License"); you may not use this
6 * file except in compliance with the License. You may obtain a copy
7 * of the License here:
8 *
9 * http://www.firebirdsql.org/index.php?op=doc&id=idpl
10 *
11 * Software distributed under the License is distributed on an "AS
12 * IS" basis, WITHOUT WARRANTY OF ANY KIND, either express or
13 * implied. See the License for the specific language governing rights
14 * and limitations under the License.
15 *
16 * The Initial Developer of the Original Code is Tony Whyman.
17 *
18 * The Original Code is (C) 2015 Tony Whyman, MWA Software
19 * (http://www.mwasoftware.co.uk).
20 *
21 * All Rights Reserved.
22 *
23 * Contributor(s): ______________________________________.
24 *
25 *)
26 unit IBLookupComboEditBox;
27
28 {$mode objfpc}{$H+}
29
30 interface
31
32 uses
33 Classes, SysUtils, LResources, Forms, Controls, Graphics, Dialogs, DbCtrls,
34 ExtCtrls, IBSQLParser, DB, StdCtrls, IBCustomDataSet;
35
36 type
37
38 {TIBLookupComboEditBox is a TDBLookupComboBox descendent that implements "autocomplete"
39 of typed in text and "autoinsert" of new entries. Autocomplete uses SQL manipulation
40 to revise the available list and restrict it to items that are prefixed by the
41 typed text (either case sensitive or case insenstive). Autoinsert allows a
42 newly typed entry to be added to the list dataset and included in the available
43 list items. }
44
45 TAutoInsert = procedure(Sender: TObject; aText: string; var NewKeyValue: variant) of object;
46 TCanAutoInsert = procedure (Sender: TObject; aText: string; var Accept: boolean) of object;
47
48 TIBLookupComboEditBox = class;
49
50 { TIBLookupComboDataLink }
51
52 TIBLookupComboDataLink = class(TDataLink)
53 private
54 FOwner: TIBLookupComboEditBox;
55 protected
56 procedure ActiveChanged; override;
57 procedure RecordChanged(Field: TField); override;
58 procedure UpdateData; override;
59 public
60 constructor Create(AOwner: TIBLookupComboEditBox);
61 end;
62
63 { TIBLookupControlLink }
64
65 TIBLookupControlLink = class(TIBControlLink)
66 private
67 FOwner: TIBLookupComboEditBox;
68 protected
69 procedure UpdateSQL(Sender: TObject); override;
70 public
71 constructor Create(AOwner: TIBLookupComboEditBox);
72 end;
73
74
75 { TIBLookupComboEditBox }
76
77 TIBLookupComboEditBox = class(TDBLookupComboBox)
78 private
79 FCanAutoInsert: TCanAutoInsert;
80 { Private declarations }
81 FDataLink: TIBLookupComboDataLink;
82 FIBLookupControlLink: TIBLookupControlLink;
83 FAutoComplete: boolean;
84 FAutoInsert: boolean;
85 FKeyPressInterval: integer;
86 FOnCanAutoInsert: TCanAutoInsert;
87 FRelationName: string;
88 FTimer: TTimer;
89 FFiltered: boolean;
90 FOnAutoInsert: TAutoInsert;
91 FOriginalTextValue: string;
92 FUpdating: boolean;
93 FInserting: boolean;
94 FExiting: boolean;
95 FLastKeyValue: variant;
96 procedure DoActiveChanged(Data: PtrInt);
97 function GetAutoCompleteText: TComboBoxAutoCompleteText;
98 function GetListSource: TDataSource;
99 function GetRelationNameQualifier: string;
100 procedure HandleTimer(Sender: TObject);
101 procedure IBControlLinkChanged;
102 procedure ResetParser;
103 procedure RecordChanged(Sender: TObject; aField: TField);
104 procedure SetAutoCompleteText(AValue: TComboBoxAutoCompleteText);
105 procedure SetListSource(AValue: TDataSource);
106 procedure UpdateList;
107 procedure UpdateSQL(Sender: TObject; Parser: TSelectSQLParser);
108 procedure HandleEnter(Data: PtrInt);
109 procedure UpdateLinkData(Sender: TObject);
110 protected
111 { Protected declarations }
112 procedure ActiveChanged(Sender: TObject);
113 procedure CheckAndInsert;
114 procedure DoEnter; override;
115 procedure DoExit; override;
116 procedure KeyUp(var Key: Word; Shift: TShiftState); override;
117 procedure Notification(AComponent: TComponent; Operation: TOperation); override;
118 procedure SetItemIndex(const Val: integer); override;
119 function SQLSafe(aText: string): string;
120 procedure UpdateShowing; override;
121
122 public
123 { Public declarations }
124 constructor Create(TheComponent: TComponent); override;
125 destructor Destroy; override;
126 procedure EditingDone; override;
127 published
128 { Published declarations }
129 property AutoInsert: boolean read FAutoInsert write FAutoInsert;
130 property AutoComplete: boolean read FAutoComplete write FAutoComplete default true;
131 property AutoCompleteText: TComboBoxAutoCompleteText read GetAutoCompleteText
132 write SetAutoCompleteText;
133 property ItemHeight;
134 property ItemWidth;
135 property ListSource: TDataSource read GetListSource write SetListSource;
136 property KeyPressInterval: integer read FKeyPressInterval write FKeyPressInterval default 200;
137 property RelationName: string read FRelationName write FRelationName;
138 property OnAutoInsert: TAutoInsert read FOnAutoInsert write FOnAutoInsert;
139 property OnCanAutoInsert: TCanAutoInsert read FOnCanAutoInsert write FOnCanAutoInsert;
140 end;
141
142
143 implementation
144
145 uses IBQuery, LCLType, Variants, LCLProc;
146
147 { TIBLookupControlLink }
148
149 constructor TIBLookupControlLink.Create(AOwner: TIBLookupComboEditBox);
150 begin
151 inherited Create;
152 FOwner := AOwner;
153 end;
154
155 procedure TIBLookupControlLink.UpdateSQL(Sender: TObject);
156 begin
157 FOwner.UpdateSQL(self,TIBParserDataSet(Sender).Parser)
158 end;
159
160 { TIBLookupComboDataLink }
161
162 procedure TIBLookupComboDataLink.ActiveChanged;
163 begin
164 FOwner.ActiveChanged(self)
165 end;
166
167 procedure TIBLookupComboDataLink.RecordChanged(Field: TField);
168 begin
169 FOwner.RecordChanged(self,Field);
170 end;
171
172 procedure TIBLookupComboDataLink.UpdateData;
173 begin
174 FOwner.UpdateLinkData(self)
175 end;
176
177 constructor TIBLookupComboDataLink.Create(AOwner: TIBLookupComboEditBox);
178 begin
179 inherited Create;
180 FOwner := AOwner
181 end;
182
183 { TIBLookupComboEditBox }
184
185 procedure TIBLookupComboEditBox.HandleTimer(Sender: TObject);
186 var ActiveState: boolean;
187 begin
188 FTimer.Interval := 0;
189 FFiltered := Text <> '';
190 UpdateList
191 end;
192
193 procedure TIBLookupComboEditBox.IBControlLinkChanged;
194 begin
195 if (ListSource <> nil) and (ListSource.DataSet <> nil) and (ListSource.DataSet is TIBParserDataSet) then
196 FIBLookupControlLink.IBDataSet := TIBCustomDataSet(ListSource.DataSet)
197 else
198 FIBLookupControlLink.IBDataSet := nil;
199 end;
200
201 function TIBLookupComboEditBox.GetListSource: TDataSource;
202 begin
203 Result := inherited ListSource;
204 end;
205
206 function TIBLookupComboEditBox.GetRelationNameQualifier: string;
207 begin
208 if FRelationName <> '' then
209 Result := FRelationName + '.'
210 else
211 Result := ''
212 end;
213
214 procedure TIBLookupComboEditBox.ActiveChanged(Sender: TObject);
215 begin
216 if not FInserting and not FUpdating then
217 Application.QueueAsyncCall(@DoActiveChanged,0);
218 IBControlLinkChanged;
219 end;
220
221 procedure TIBLookupComboEditBox.DoActiveChanged(Data: PtrInt);
222 begin
223 if AppDestroying in Application.Flags then Exit;
224
225 if (DataSource = nil) and assigned(ListSource) and assigned(ListSource.DataSet)
226 and ListSource.DataSet.Active then
227 begin
228 begin
229 if varIsNull(FLastKeyValue) and (ItemIndex = -1) then
230 KeyValue := ListSource.DataSet.FieldByName(KeyField).AsVariant
231 else
232 begin
233 KeyValue := FLastKeyValue;
234 UpdateData(self); {Force auto scroll}
235 if varIsNull(KeyValue) then {Value not present}
236 Text := ListSource.DataSet.FieldByName(ListField).AsString
237 end;
238 end;
239 end
240 else
241 if (DataSource <> nil) and assigned(DataSource.DataSet) and
242 (DataSource.DataSet.Active) and (DataField <> '') then
243 begin
244 ResetParser;
245 KeyValue := Field.AsVariant;
246 end
247 else
248 Text := '';
249 FOriginalTextValue := Text;
250 end;
251
252 function TIBLookupComboEditBox.GetAutoCompleteText: TComboBoxAutoCompleteText;
253 begin
254 Result := inherited AutoCompleteText;
255 if AutoComplete then
256 Result := Result + [cbactEnabled]
257 end;
258
259 procedure TIBLookupComboEditBox.ResetParser;
260 var curKeyValue: variant;
261 begin
262 if FFiltered then
263 begin
264 FFiltered := false;
265 curKeyValue := KeyValue;
266 Text := ''; {Ensure full list}
267 UpdateList;
268 KeyValue := curKeyValue;
269 UpdateData(self); {Force Scroll}
270 end;
271 end;
272
273 procedure TIBLookupComboEditBox.RecordChanged(Sender: TObject; aField: TField);
274 begin
275 {Make sure that we are in sync with other data controls}
276 if DataSource = nil then
277 begin
278 KeyValue := ListSource.DataSet.FieldByName(KeyField).AsVariant;
279 if VarIsNull(KeyValue) then {Probable deletion}
280 begin
281 UpdateList;
282 KeyValue := ListSource.DataSet.FieldByName(KeyField).AsVariant;
283 end;
284 end;
285 end;
286
287 procedure TIBLookupComboEditBox.SetAutoCompleteText(
288 AValue: TComboBoxAutoCompleteText);
289 begin
290 if AValue <> AutoCompleteText then
291 begin
292 FAutoComplete := cbactEnabled in AValue;
293 inherited AutoCompleteText := AValue - [cbactEnabled]
294 end;
295 end;
296
297 procedure TIBLookupComboEditBox.SetListSource(AValue: TDataSource);
298 begin
299 if AValue <> inherited ListSource then
300 begin
301 FDataLink.DataSource := AValue;
302 inherited ListSource := AValue;
303 IBControlLinkChanged;
304 end;
305 end;
306
307 procedure TIBLookupComboEditBox.UpdateList;
308 { Note: Algorithm taken from TCustomComboBox.KeyUp but modified to use the
309 ListSource DataSet as the source for the autocomplete text. It also runs
310 after a delay rather than immediately on keyup
311 }
312 var
313 iSelStart: Integer; // char position
314 sCompleteText, sPrefixText, sResultText: string;
315 curText: string;
316 begin
317 if assigned(ListSource) and assigned(ListSource.DataSet) and (ListSource.DataSet is TIBCustomDataSet)
318 and ListSource.DataSet.Active then
319 begin
320 FUpdating := true;
321 try
322 iSelStart := SelStart;//Capture original cursor position
323 if ((iSelStart < UTF8Length(Text)) and
324 (cbactEndOfLineComplete in AutoCompleteText)) then
325 Exit;
326 curText := Text;
327 sPrefixText := UTF8Copy(Text, 1, iSelStart);
328 ListSource.DataSet.Active := false;
329 ListSource.DataSet.Active := true;
330 Text := curText;
331 if not FExiting and Focused and (Text <> '')then
332 begin
333 if ListSource.DataSet.Active and (ListSource.DataSet.RecordCount > 0) then
334 begin
335 sCompleteText := ListSource.DataSet.FieldByName(ListField).AsString;
336 if (sCompleteText <> Text) then
337 begin
338 sResultText := sCompleteText;
339 if ((cbactEndOfLineComplete in AutoCompleteText) and
340 (cbactRetainPrefixCase in AutoCompleteText)) then
341 begin//Retain Prefix Character cases
342 UTF8Delete(sResultText, 1, iSelStart);
343 UTF8Insert(sPrefixText, sResultText, 1);
344 end;
345 Text := sResultText;
346 SelStart := iSelStart;
347 SelLength := UTF8Length(Text);
348 end;
349 end;
350 end;
351 finally
352 FUpdating := false
353 end;
354 end;
355 end;
356
357 procedure TIBLookupComboEditBox.UpdateSQL(Sender: TObject;
358 Parser: TSelectSQLParser);
359 var FieldPosition: integer;
360 begin
361 if FFiltered then
362 begin
363 if cbactSearchCaseSensitive in AutoCompleteText then
364 Parser.Add2WhereClause(GetRelationNameQualifier + '"' + ListField + '" Like ''' +
365 SQLSafe(Text) + '%''')
366 else
367 Parser.Add2WhereClause(GetRelationNameQualifier + 'Upper("' + ListField + '") Like Upper(''' +
368 SQLSafe(Text) + '%'')');
369
370 end;
371 if cbactSearchAscending in AutoCompleteText then
372 begin
373 FieldPosition := Parser.GetFieldPosition(ListField);
374 if FieldPosition = 0 then Exit;
375
376 Parser.OrderByClause := IntToStr(FieldPosition) + ' ascending';
377 end;
378 end;
379
380 procedure TIBLookupComboEditBox.HandleEnter(Data: PtrInt);
381 begin
382 SelectAll
383 end;
384
385 procedure TIBLookupComboEditBox.UpdateLinkData(Sender: TObject);
386 begin
387 if FInserting then
388 ListSource.DataSet.FieldByName(ListField).AsString := Text
389 end;
390
391 procedure TIBLookupComboEditBox.CheckAndInsert;
392 var Accept: boolean;
393 NewKeyValue: variant;
394 begin
395 if AutoInsert and (Text <> '') and assigned(ListSource) and assigned(ListSource.DataSet)
396 and ListSource.DataSet.Active and (ListSource.DataSet.RecordCount = 0) then
397 try
398 {Is it OK to insert a new list member?}
399 Accept := true;
400 if assigned(FOnCanAutoInsert) then
401 OnCanAutoInsert(self,Text,Accept);
402 if not Accept then
403 begin
404 ResetParser;
405 Text := FOriginalTextValue;
406 SelectAll;
407 Exit;
408 end;
409
410 FInserting := true;
411 try
412 {New Value}
413 FFiltered := false;
414 if assigned(FOnAutoInsert) then
415 begin
416 {In an OnAutoInsert handler, the client is expected to insert the new
417 row into the List DataSet and to set the KeyValue property to the
418 value of the primary key of the new row.}
419 OnAutoInsert(self,Text,NewKeyValue);
420 end
421 else
422 begin
423 ListSource.DataSet.Append;
424 {The new KeyValue should be determined by an external generator or
425 in the "OnInsert" handler. If it is the same as the ListField, then
426 it will be set from the UpdateLinkData method}
427 try
428 ListSource.DataSet.Post;
429 except
430 ListSource.DataSet.Cancel;
431 raise;
432 end;
433 NewKeyValue := ListSource.DataSet.FieldByName(KeyField).AsVariant;
434 end;
435 Text := ''; {Ensure full list}
436 UpdateList;
437 KeyValue := NewKeyValue;
438 UpdateData(nil); {Force sync with DataField}
439 finally
440 FInserting := false
441 end;
442 except
443 Text := FOriginalTextValue;
444 ResetParser;
445 raise;
446 end;
447 end;
448
449 procedure TIBLookupComboEditBox.DoEnter;
450 begin
451 inherited DoEnter;
452 FOriginalTextValue:= Text;
453 ResetParser;
454 Application.QueueAsyncCall(@HandleEnter,0);
455 end;
456
457 procedure TIBLookupComboEditBox.DoExit;
458 begin
459 FExiting := true;
460 try
461 CheckAndInsert;
462 ResetParser;
463 FTimer.Interval := 0;
464 finally
465 FExiting := false;
466 end;
467 inherited DoExit;
468 end;
469
470 procedure TIBLookupComboEditBox.KeyUp(var Key: Word; Shift: TShiftState);
471 begin
472 inherited KeyUp(Key, Shift);
473 if Key = VK_RETURN then
474 EditingDone
475 else
476 if Key = VK_ESCAPE then
477 begin
478 SelStart := UTF8Length(Text); {Ensure end of line selection}
479 ResetParser;
480 Text := FOriginalTextValue;
481 SelectAll;
482 end
483 else
484 if (IsEditableTextKey(Key) or (Key = VK_BACK))
485 and AutoComplete and (Style <> csDropDownList) and
486 (not (cbactEndOfLineComplete in AutoCompleteText) or (SelStart = UTF8Length(Text))) then
487 FTimer.Interval := FKeyPressInterval
488 else
489 FTimer.Interval := 0
490 end;
491
492 procedure TIBLookupComboEditBox.Notification(AComponent: TComponent;
493 Operation: TOperation);
494 begin
495 inherited Notification(AComponent, Operation);
496 if (Operation = opRemove) and (AComponent = DataSource) then
497 ListSource := nil;
498 end;
499
500 procedure TIBLookupComboEditBox.SetItemIndex(const Val: integer);
501 begin
502 inherited SetItemIndex(Val);
503 FLastKeyValue := KeyValue;
504 end;
505
506 function TIBLookupComboEditBox.SQLSafe(aText: string): string;
507 var I: integer;
508 begin
509 Result := '';
510 for I := 1 to length(aText) do
511 if aText[I] = '''' then
512 Result := Result + ''''''
513 else
514 Result := Result + aText[I];
515 end;
516
517 procedure TIBLookupComboEditBox.UpdateShowing;
518 begin
519 inherited UpdateShowing;
520 if Showing then {Ensure up-to-date as we were ignoring any changes}
521 ActiveChanged(nil);
522 end;
523
524 constructor TIBLookupComboEditBox.Create(TheComponent: TComponent);
525 begin
526 inherited Create(TheComponent);
527 FDataLink := TIBLookupComboDataLink.Create(self);
528 FIBLookupControlLink := TIBLookupControlLink.Create(self);
529 FKeyPressInterval := 200;
530 FAutoComplete := true;
531 FTimer := TTimer.Create(nil);
532 FTimer.Interval := 0;
533 FTimer.OnTimer := @HandleTimer;
534 FLastKeyValue := NULL;
535 end;
536
537 destructor TIBLookupComboEditBox.Destroy;
538 begin
539 if assigned(FDataLink) then FDataLink.Free;
540 if assigned(FIBLookupControlLink) then FIBLookupControlLink.Free;
541 if assigned(FTimer) then FTimer.Free;
542 inherited Destroy;
543 end;
544
545 procedure TIBLookupComboEditBox.EditingDone;
546 begin
547 CheckAndInsert;
548 inherited EditingDone;
549 end;
550
551 end.