Type | Description | |||
ID as Long | A Long expression that indicates the index of the skin being added or replaced. The value must be between 1 and 126, so Appearance collection should holds no more than 126 elements. | |||
Skin as Variant |
The Skin parameter of the Add method can a STRING as explained bellow, a BYTE[]
/ safe arrays of VT_I1 or VT_UI1 expression that indicates the content of the EBN
file. You can use the BYTE[] / safe arrays of VT_I1 or VT_UI1 option when using
the EBN file directly in the resources of the project. For instance, the VB6
provides the LoadResData to get the safe array o bytes for specified resource,
while in VB/NET or C# the internal class Resources provides definitions for all
files being inserted. ( ResourceManager.GetObject("ebn",
resourceCulture) )
If the Skin parameter points to a string expression, it can be one of the following:
|
Return | Description | |||
Boolean | A Boolean expression that indicates whether the new skin was added or replaced. |
For instance, the Background(exVSThumbP) = RGB(255,0,0) defines the thumb in a red color, when it is pressed. The skin method, in it's simplest form, uses a single graphic file (*.ebn) assigned to a part of the control, when the "XP:" prefix is not specified in the Skin parameter ( available for Windows XP systems ). By using a collection of objects laid over the graphic, it is possible to define which sections of the graphic will be used as borders, corners and other possible elements, fixing them to their proper position regardless of the size of the part. Use the Remove method to remove a specific skin from the control. Use the Clear method to remove all skins in the control. Use the BeginUpdate and EndUpdate methods to maintain performance while do multiple changes to the control.
The identifier you choose for the skin is very important to be used in the background properties like explained bellow. Shortly, the color properties ( Background property ) uses 4 bytes ( DWORD, double WORD, and so on ) to hold a RGB value. More than that, the first byte ( most significant byte in the color ) is used only to specify system color. if the first bit in the byte is 1, the rest of bits indicates the index of the system color being used. So, we use the last 7 bits in the high significant byte of the color to indicates the identifier of the skin being used. So, since the 7 bits can cover 127 values, excluding 0, we have 126 possibilities to store an identifier in that byte. This way, a DWORD expression indicates the background color stored in RRGGBB format and the index of the skin ( ID parameter ) in the last 7 bits in the high significant byte of the color. For instance, the Background(exThumbPart) = Background(exThumbPart) Or &H2000000 indicates that we apply the skin with the index 2 using the old color, to the thumb part.
In the following samples, we have used the following skin file:
The following VB sample changes the visual appearance of the thumb, in the vertical scrollbar:
With ScrollBar1 .VisualAppearance.Add 1, "D:\Exontrol\ExScrollBar\sample\VB\Gauge\Vertical 2\thumb.ebn" .Background(exVSThumb) = &H1000000 End With
The following VB sample changes the visual appearance of the thumb ( when it is pressed ), in the vertical scrollbar:
With ScrollBar1 .VisualAppearance.Add 1, "D:\Exontrol\ExScrollBar\sample\VB\Gauge\Vertical 2\thumb.ebn" .Background(exVSThumbP) = &H1000000 End With
The following C++ sample changes the visual appearance of the thumb, in the vertical scrollbar:
m_scrollbar.GetVisualAppearance().Add( 1, COleVariant( _T("D:\\Exontrol\\ExScrollBar\\sample\\VB\\Gauge\\Vertical 2\\thumb.ebn") ) ); m_scrollbar.SetBackground( 260 /*exVSThumb*/, 0x01000000 );
The following C++ sample changes the visual appearance of the thumb ( when it is pressed ), in the vertical scrollbar:
m_scrollbar.GetVisualAppearance().Add( 1, COleVariant( _T("D:\\Exontrol\\ExScrollBar\\sample\\VB\\Gauge\\Vertical 2\\thumb.ebn") ) ); m_scrollbar.SetBackground( 261 /*exVSThumbP*/, 0x01000000 );
The following VB.NET sample changes the visual appearance of the thumb, in the vertical scrollbar:
With AxScrollBar1 .VisualAppearance.Add(1, "D:\Exontrol\ExScrollBar\sample\VB\Gauge\Vertical 2\thumb.ebn") .set_Background(EXSCROLLBARLib.BackgroundPartEnum.exVSThumb, &H1000000) End With
The following VB.NET sample changes the visual appearance of the thumb ( when it is pressed ), in the vertical scrollbar:
With AxScrollBar1 .VisualAppearance.Add(1, "D:\Exontrol\ExScrollBar\sample\VB\Gauge\Vertical 2\thumb.ebn") .set_Background(EXSCROLLBARLib.BackgroundPartEnum.exVSThumbP, &H1000000) End With
The following C# sample changes the visual appearance of the thumb, in the vertical scrollbar:
axScrollBar1.VisualAppearance.Add(1, "D:\\Exontrol\\ExScrollBar\\sample\\VB\\Gauge\\Vertical 2\\thumb.ebn"); axScrollBar1.set_Background(EXSCROLLBARLib.BackgroundPartEnum.exVSThumb, 0x1000000);
The following C# sample changes the visual appearance of the thumb ( when it is pressed ), in the vertical scrollbar:
axScrollBar1.VisualAppearance.Add(1, "D:\\Exontrol\\ExScrollBar\\sample\\VB\\Gauge\\Vertical 2\\thumb.ebn"); axScrollBar1.set_Background(EXSCROLLBARLib.BackgroundPartEnum.exVSThumbP, 0x1000000);
The following VFP sample changes the visual appearance of the thumb, in the vertical scrollbar:
with thisform.ScrollBar1 .VisualAppearance.Add(1, "D:\Exontrol\ExScrollBar\sample\VB\Gauge\Vertical 2\thumb.ebn") .Background(260) = 0x1000000 endwith
The following VFP sample changes the visual appearance of the thumb ( when it is pressed ), in the vertical scrollbar:
with thisform.ScrollBar1 .VisualAppearance.Add(1, "D:\Exontrol\ExScrollBar\sample\VB\Gauge\Vertical 2\thumb.ebn") .Background(261) = 0x1000000 endwith