Obsolete elements

Return to index

Obsolete elements

With respect to previous versions of the control, Version 8's internal design has been changed in order to support a more object-oriented approach during the development of applications: this has caused some of the control's properties and methods to become obsolete. These obsolete properties and methods should not be used in new development projects. They have been maintained internally for backward compatibility only and they will not be documented here nor supported in the future. Furthermore, these obsolete elements will not be displayed by Intellisense and, in Visual C++, will not be inserted inside the wrapper class.

The following is the full list of obsolete properties and methods with the current alternative you should use from now on.

Obsolete properties

Old property name	Current alternative

Texture (*)	Texture.Filepath
TextureMode (*)	Texture.Mode
TextureLightIntensity (*)	Texture.LightIntensity
TextureColorMix (*)	Texture.ColorToMix
TextureColorMixPerc (*)	Texture.PercentageColorMix
TextureBevelFactor (*)	SurfaceColor.GradientFactor
ButtonCustomFitPicture (*)	Dropped: the use of this property is not needed because, from version 7, this control supports custom picture masks based upon a color picture.
Roundness (*)	CornerFactor
ButtonCustomRaised (**)	ButtonRaiseFactor

Obsolete methods

Old method name	Current alternative

SetAuxText (*)	TextDescriptor object
GetAuxText (*)	TextDescriptor object
SetTextVisible (*)	TextDescriptor.Visible property
SetCaptionText (*)	TextDescriptor.Text property
GetCaptionText (*)	TextDescriptor.Text property
SetSurfaceColor (*)	SurfaceColor.Color property
GetSurfaceColor (*)	SurfaceColor.Color property
SetAuxTextString (*)	TextDescriptor.Text property
SetTextOnPos (*)	TextDescriptor.Text property
GetTextOnPos (*)	TextDescriptor.Text property
SetTextSettingOnPos (*)	TextDescriptor object
GetTextSettingOnPos (*)	TextDescriptor object
SetSurfaceColorDesc (*)	SurfaceColor object
GetSurfaceColorDesc (*)	SurfaceColor object
InternalRefresh (*)	Dropped: with the latest internal changes this call is not needed
ShowEditingButtons (*)	Dropped: this method doesn't conform with the latest changes to the Design-time user interface.
EditProperties (*)	Dropped: this method doesn't conform with the latest changes to the Design-time user interface.
SetHelpLink (*)	Dropped: this method doesn't conform with the latest changes to the Design-time user interface.
SetEditingTplMode (*)	Dropped: this method doesn't conform with the latest changes to the Design-time user interface.
SetBackPicture (**)	SurfaceTransparentFactor property
GetBackPicture (**)	SurfaceTransparentFactor property
SetBackPictureVisible (**)	SurfaceTransparentFactor property

Old method name	Current alternative

ContainerNeedRefresh (**)	Dropped: with the latest internal changes this event is not needed

Obsolete data structures

SURFACE_COLOR_DESC and the TEXT_DESC data structures are now obsolete because they were used only by methods that are now obsolete (*).

Obsolete enumerated values

COLOR_GRADIENT_HORIZONTAL, COLOR_GRADIENT_DIAGONAL and COLOR_GRADIENT_VERTICAL are now replaced by COLOR_GRADIENT_LINEAR in combination with the LightDirection property (**).

(*) Obsolete starting from version 7

(**) Obsolete starting from version 8