TTMSFNCLocalizationEditor.Execute Method
Shows the editor and invokes the given notification callback once the editor closes.
API unit family: TMSFNCLocalizationEditor
Declaring type: TTMSFNCLocalizationEditor
Overloads
Overload 1
Shows the editor and invokes the given notification callback once the editor closes.
procedure Execute(AProc: TNotifyEvent = nil); overload;
void __fastcall Execute(System::Classes::TNotifyEvent AProc = 0x0)/* overload */;
Remarks
Calling this method again while the editor is open brings the existing window to the front instead of opening a second one. At design time the editor is shown modally, so this method returns only after it closes. At run time it is shown non-modally and this method returns immediately, so read the outcome from the callback rather than from the statement after the call.
At design time the editor user interface follows the language of the IDE when it is one of the built-in languages; otherwise, and at run time, it is shown in English. Use the overload with a locale to choose a built-in language at run time.
Parameters
| Name | Description |
|---|---|
AProc |
Callback invoked when the editor closes, receiving the editor as its sender. |
Overload 2
Shows the editor with its user interface in one of the built-in languages and invokes the given notification callback once the editor closes.
procedure Execute(ABuiltInLocale: string; AProc: TNotifyEvent = nil); overload;
void __fastcall Execute(System::UnicodeString ABuiltInLocale, System::Classes::TNotifyEvent AProc = 0x0)/* overload */;
Remarks
Behaves like the overload without a locale, including its modal and non-modal behavior. The locale applies to this call only and is reset when the editor closes. It changes only the language of the editor itself, not the active language of the application. The locale has no effect while AllowCustomTranslation is True, because the editor then uses the translations of the application instead of its built-in ones.
Parameters
| Name | Description |
|---|---|
ABuiltInLocale |
Locale of the built-in editor language: 'en', 'de', 'fr' or 'ja', compared case-insensitively. Any other value is ignored and the editor opens in its default language. |
AProc |
Callback invoked when the editor closes, receiving the editor as its sender. |
Overload 3
Shows the editor and invokes the given callback with the dialog's modal result once the editor closes.
procedure Execute(AProc: TModalResultProc = nil); overload;
void __fastcall Execute(System::Classes::TNotifyEvent AProc = 0x0)/* overload */;
Remarks
Calling this method again while the editor is open brings the existing window to the front instead of opening a second one. The editor is never shown modally here, so this method always returns immediately and the outcome must be read from the callback.
Parameters
| Name | Description |
|---|---|
AProc |
Callback invoked when the editor closes, receiving the modal result the dialog was closed with. |
Overload 4
Shows the editor and invokes the given callback with the dialog's modal result once the editor closes.
procedure Execute(ABuiltInLocale: string; AProc: TModalResultProc = nil); overload;
void __fastcall Execute(System::UnicodeString ABuiltInLocale, System::Classes::TNotifyEvent AProc = 0x0)/* overload */;
Remarks
Selecting a built-in editor language is supported in desktop applications only. Here the locale is accepted for source compatibility but the editor is shown in its default language; otherwise this overload behaves like the one without a locale.
Parameters
| Name | Description |
|---|---|
ABuiltInLocale |
Locale of a built-in editor language: 'en', 'de', 'fr' or 'ja'. |
AProc |
Callback invoked when the editor closes, receiving the modal result the dialog was closed with. |