TcxCustomEditButton.Default Property
Specifies if the button is the default editor button.
Declaration
property Default: Boolean read; write; default False;
Property Value
Type | Default | Description |
---|---|---|
Boolean | False |
|
Remarks
The default editor button is associated with the default action in an editor. An editor’s Properties.OnButtonClick event occurs for the default button every time a user presses the keystroke defined in the editor’s Properties.ClickKey property while the editor has focus.
Set the Default
property to True
to define the editor button as default. This operation changes the Default
property value to False
for the previous default editor button because an editor can have only one default editor at a time.
Code Example
The code example in this topic section demonstrates an OnPropertiesChanged event handler for a TcxImageComboBox editor.
This event handler changes editor appearance and behavior in response to ReadOnly property value changes as follows:
- Read-Only Mode
Hides the predefined drop-down button and displays the custom Info button at the left editor border when the ReadOnly property value changes to
True
.- Normal Mode
Restores the initial editor layout and behavior when the ReadOnly property value changes back to
False
.
procedure TMyForm.cxImageComboBox1PropertiesChanged(Sender: TObject);
var
AProperties: TcxImageComboBoxProperties;
AButton: TcxEditButton;
begin
AProperties := (Sender as TcxImageComboBoxProperties);
if AProperties.ReadOnly then // Configures the read-only editor layout
begin
AProperties.BeginUpdate; // Initiates the following batch change
try
AProperties.Buttons.Items[0].Visible := False; // Hides the predefined drop-down button
if AProperties.Buttons.Count = 1 then
begin
AButton := AProperties.Buttons.Add;
AButton.Kind := bkText;
AButton.Caption := 'Info';
AButton.LeftAlignment := True;
end;
AProperties.Buttons.Items[1].Visible := True; // Displays the "Info" button
AProperties.Buttons.Items[1].Default := True;
finally
AProperties.EndUpdate; // Calls EndUpdate regardless of the batch operation's success
end;
end
else if not AProperties.ReadOnly then // Restores the initial editor layout
begin
AProperties.BeginUpdate; // Initiates the following batch change
try
AProperties.Buttons.Items[0].Visible := True; // Displays the predefined button
AProperties.Buttons.Items[0].Default := True;
if AProperties.Buttons.Count = 2 then
AProperties.Buttons.Items[1].Visible := False; // Hides the "Info" button
finally
AProperties.EndUpdate; // Calls EndUpdate regardless of the batch operation's success
end;
end;
end;
Default Value
The Default
property’s default value is False
.