separator separator

ChSD_UserAvailableOptions (Property)

Returns or sets a long value that specifies the options that will be available to user in the change skin dialog box.


object.ChSD_UserAvailableOptions [= value]

The ChSD_UserAvailableOptions property syntax has these parts:

Part Description
object An object expression referencing to a vbSkinner object.
value A long setting specifying the available options for the user, as described in Settings.


The settings for value are:

Value Description
0 (Default) The user will be able to select a skin from the predefined ones of the vbSkinner control as much as from a skin file.
1 The user will be able to select a skin only from the predefined of the vbSkinner control.
2 The user will be able to select a skin only from a skin file.

If you do not want to allow the user to create his own skin you can set this property value to 1. 
If you are not interested in using the predefined skins of vbSkinner control you could set this property value to 2 and provide some skin files to the user so he can change them. 
In this second case you also could load a skin file at design time in the SkinPicture property of the main form of the application, so it will be the default skin, but it is recommended to leave the Skin property at its default setting (it is skAuto_ReadFromRegistry, 0) in this way if the user change the skin image, the image selected by him will be loaded again the next time the application runs, and not to show the default skin you have put as default.

For all this to work properly you can write a code like the following:

Private Sub Form_Load ()
    If GetSetting (App.Title, "SkinnerControl",_
    "Initialized", 0) = 0 Then
        Skinner1.Skin = skCreateFromPicture
        SaveSetting App.Title, "SkinnerControl",_
Initialized", 1
    End if
End Sub

Do not forget to set the properties at design time:

Skin = skAuto_ReadFromRegistry (0)
Set to SkinPicture the default skin image that you want

Note: When you set the SkinPicture property (at design or run time), the Skin property automatically changes to skCreateFromPicture (98) setting, so you will have to set back to skAuto_ReadFromRegistry (0).


See also: To customize how the change skin dialog box is shown


ActiveX controls for Visual Basic 6 - homevbSkinner help main page Beginning   Go back Back