Click or drag to resize

UserOptionsExtension Class

Base implementation of interface type ctExtensionInterfaceUserSettings. Inheritant must implement at least GetParent, CreateControl, LoadData(Byte), GetSaveData(Boolean), Validate and Refresh. Override GetInterface2(ctExtensionInterface) in your extension and return your implementation of this class when requested type is ctExtensionInterfaceUserSettings. This will add your extension to CUSTOMTOOLS' User options page.
Inheritance Hierarchy
SystemObject
  CTExtensions.InterfacesUserOptionsExtension
    CTExtensions.ExportCore.EXTsUserOptionsUSERSETTINGSTYPE

Namespace: CTExtensions.Interfaces
Assembly: CTInterface (in CTInterface.dll) Version: 25.0
Syntax
public abstract class UserOptionsExtension : IExtensionInterface

The UserOptionsExtension type exposes the following members.

Constructors
 NameDescription
Protected methodUserOptionsExtensionInitializes a new instance of the UserOptionsExtension class
Top
Properties
 NameDescription
Protected propertySetupForUser User in which context the settings are read/saved.
Top
Methods
 NameDescription
Public methodCreateControl Provide the control for your page. This is called in lazy-load manner, when the user selects this profile options extension from the tree.
Public methodCreateSettingsControl Create and return window handle for custom options page. Default implementation handles control lifetime and inheritant may just enjoy from CreateControl.
Public methodDispose Called when the settings page is closed. Disposes the control if not disposed already. Inheriants can ignore this if also CreateSettingsControl is left in default implementation.
Public methodGetParent Return parent CTExtension of this user options extension.
Public methodGetSaveData Called after Validate. Provide the data you wish to save.
Public methodInit Sets SetupForUser which is used in data retrieval and save.
Public methodLoadData Called after CreateControl. Setup the control you created with this stored data.
Public methodPageName Name that is shown in user options tree. By default this is parents FriendlyName.
Public methodReadUserData Helper function to read parent extension's user specific data from given profile.
Public methodRefresh Notification that occurs when user re-enters to this extension's user options page.
Public methodSave Called when user clicks OK at options and all pages have returned true on Validate. Inheriants can ignore this and just return data at GetSaveData(Boolean) when called.
Public methodStoreUserData Helper function to store parent extension's data to given profile.
Public methodTabPress Called when TAB is pressed. Handles control focusing.
Public methodValidate Validate settings user has made to your control. Show error message if needed.
Top
Revision History
DateVersionDescription
-2019 SP2First Release
See Also