UltraSuite(TM)

ActiveX(TM) Controls

Version 3.02.001
January, 2003
(C) Copyright Infragistics, Inc., 1997-2003
Windsor Corporate Park
50 Millstone Road
Building 200 - Suite 150
East Windsor, NJ 08520 USA
Voice (609) 448-2000
Fax (609) 448-2017
Internet http://www.infragistics.com

This document contains release notes for UltraSuite. Information in this document is more current than the on-line Help.

Included Samples

The Samples sub-folder of your product installation folder contains various samples demonstrating the use of the product. Brief descriptions of these can be found in the file Samples Descriptions.htm, located in the Samples folder.

Issues Addressed:

UltraSuite Version 3.02.001.00 - January, 2003
--------------------------------------------------------------------------------------------------------------------------------------------------------------
Full Release

ActiveTreeView 1.04.016.01 - January, 2003
SSTree.ocx (1.04.016)
DataExplorer 8.04.020.01 - January, 2003
PVOutlookBar.ocx (8.04.015)
PVResizer.ocx (8.03.004)
PVXPLORE8.ocx (8.04.020)
ScheduleX 9.00.015.01 - January, 2003
IGWeekView9.ocx (9.00.015)
PVCalendar9.ocx (9.00.008)
PVDateEdit9.ocx (9.00.007)
PVDayView9.ocx (9.00.015)
PVTaskPad9.ocx (9.00.007)
PVTime9.ocx (9.00.003)
UltraGrid 2.01.025.01 - January, 2003
IGUltraGrid20.ocx (2.01.025)
IGPrint.dll (1.00.028)
ssmask.dll (1.01.005)
SSPng2.dll (1.01.001)
SSPpg.dll (2.00.136)
SSPPG2.dll (1.00.008)
IGUltraGridPPG.ocx (2.00.024)
SSInput1.ocx (1.01.034)
PVShared.dll (8.00.000)
PVCurr.ocx (8.04.002)
PVNum.ocx (8.04.002)
UltraToolBars 5.01.019.01 - January, 2003
IGToolBars50.ocx (5.01.019)
IGResizer40.ocx (4.01.006)
IGScroll40.ocx (4.01.006
IGSplash40.ocx (4.01.006)
IGSplitter40.ocx (4.01.006)
IGTabs40.ocx (4.01.006)
IGThreed40.ocx (4.01.011)
IGTransition40.ocx (4.01.011)

UltraSuite Version 3.02.000.00 - March, 2002
--------------------------------------------------------------------------------------------------------------------------------------------------------------
Full Release

UltraSuite Version 2.00.000.00 - June, 2001
--------------------------------------------------------------------------------------------------------------------------------------------------------------
Full Release

UltraSuite Version 1.00.001.00 - February, 2001
--------------------------------------------------------------------------------------------------------------------------------------------------------------
Full Release

--------------------------------------------------------------------------------------------------------------------------------------------------------------
--------------------------------------------------------------------------------------------------------------------------------------------------------------

ActiveTreeView 1.04.016.01 - January, 2003
--------------------------------------------------------------------------------------------------------------------------------------------------------------
Full Release containing all previous Hot Fixes
SSTree.ocx (1.04.016)

ActiveTreeView 1.04.006.00 - March, 2002
--------------------------------------------------------------------------------------------------------------------------------------------------------------
Full release

ActiveTreeView 1.04.004.00 - March, 1 2002
--------------------------------------------------------------------------------------------------------------------------------------------------------------
Full release

ActiveTreeView 1.04.002.00 - January, 2002
--------------------------------------------------------------------------------------------------------------------------------------------------------------
Full release

ActiveTreeView 1.04.001.00 - December, 2001
--------------------------------------------------------------------------------------------------------------------------------------------------------------
Full release

(1.03.005.06) June, 2001:
Full release

(1.03.005.04) February, 2001:
Full release

(1.03.005) January, 2001:
Full release

(1.02.008) February, 1999:
Full release

Important Information

The following is a list of changes made since the previous version. Please see the help file for complete descriptions and examples.

Version 1.02

Keyboard changes have been modified as shown in the table below, changes are bolded.

Keystroke	ssatNodeSelectSingle	ssatNodeSelectMulti	ssatnodeSelectRange
ESCAPE	Cancels selection	Cancels selection	Cancels selection
DOWN	Focus & Selection moved to next node	Focus & Selection moved to next node	Focus & Selection moved to next node
CTRL+DOWN	Scrolls without moving selection	Scrolls without moving selection	Scrolls without moving selection
SHIFT+DOWN	Focus & Selection moved to next node	Selection Extends including the node that has focus	Selection Extends including the node that has focus
SPACE	Toggles node selection state	Toggles node selection state	Toggles node selection state
CTRL+SPACE	Toggles node selection state	Toggles node selection state	Toggles node selection state
Left Click	Focus & Selection moved to clicked node	Focus & Selection moved to clicked node	Focus & Selection moved to clicked node
CTRL+Left Click	Focus & Selection moved to clicked node	Adds node to selection	Adds node to selection

- Control now supports the use of the ImageList control inside Internet Explorer
- Two new properties, ImagesURL and PictureBackgroundURL have been added to support asynchronous downloading of images. See the help file for more information.

Special note for Visual C++ Programmers:

There is a known issue with the way the Visual Studio 6 Class Wizard generates function declarations for functions which contain parameters that are pointers to enumerated constants. If the parameter's data type is VT_PI2 (pointer to a short integer), the Class Wizard erroneously declares the type as VT_PI4 (pointer to an long integer). The following modifications must be made to work around this problem:

1. Change the parameter's data type in the class constructor's "Generated message map functions" section. For example:

afx_msg void OnValidateSelectionSstree1(long FAR* SelectionType, LPDISPATCH FAR* StartNode, LPDISPATCH FAR* EndNode, LPDISPATCH FAR* Cancel);

should be changed to:

afx_msg void OnValidateSelectionSstree1(short FAR* SelectionType, LPDISPATCH FAR* StartNode, LPDISPATCH FAR* EndNode, LPDISPATCH FAR* Cancel);

2. Change the parameter's data type in the implementation file's "BEGIN_EVENTSINK_MAP" section. For example:

ON_EVENT(CAddItemDlg, IDC_SSTREE1, 1212 /*ValidateSelection*/,
OnValidateSelectionSstree1, VTS_PI4 VTS_PDISPATCH VTS_PDISPATCH VTS_PDISPATCH)

should be changed to:

ON_EVENT(CAddItemDlg, IDC_SSTREE1, 1212 /*ValidateSelection*/,
OnValidateSelectionSstree1, VTS_PI2 VTS_PDISPATCH VTS_PDISPATCH VTS_PDISPATCH)

3. Change the parameter's data type in the actual implementation of the function: For example:

void CAddItemDlg::OnValidateSelectionSstree1(long FAR* SelectionType, LPDISPATCH FAR* StartNode, LPDISPATCH FAR* EndNode, LPDISPATCH FAR* Cancel)

should be changed to:

void CAddItemDlg::OnValidateSelectionSstree1(short FAR* SelectionType, LPDISPATCH FAR* StartNode, LPDISPATCH FAR* EndNode, LPDISPATCH FAR* Cancel)

Known Limitations

- There is a limitation in IE of data, which 4.0 SP1 of 4K for binary data stored on a page. Due to this limit you can't load the ActiveTreeView control if there is more than 4K typically will occur if you are saving images to the pagePictureBackgroundURL properties to download . To avoid this limitation you should use the new ImagesURL and images from a URL.

- There appears to be no way to support 16 x 16 icons through the prop pages using the standard picture object. If you take a standard VB form picture property and attempt to load a 16x16 ico file it will also be stretched to 32 x 32. The work around is to load a 16x16 bmp file into the prop page image list THEN load up 16x16 ico files.

- You may also experience problems if you change the default font at design time. The solution to this problem is to set any font properties at runtime using VB Script.

DataExplorer 8.04.020.01 - January, 2003
--------------------------------------------------------------------------------------------------------------------------------------------------------------
Full Release containing all previous Hot Fixes
PVOutlookBar.ocx (8.04.015)
PVResizer.ocx (8.03.004)
PVXPLORE8.ocx (8.04.020)

DataExplorer 8.04.008.00 - March, 2001
--------------------------------------------------------------------------------------------------------------------------------------------------------------
Full Release

DataExplorer 8.04.006.00 - December, 2001
--------------------------------------------------------------------------------------------------------------------------------------------------------------
Full Release

DataExplorer 8.04.00.00 - June, 2001
--------------------------------------------------------------------------------------------------------------------------------------------------------------
Full Release

DataExplorer 8.03.002.04 - February, 2001
--------------------------------------------------------------------------------------------------------------------------------------------------------------
Full Release

DataExplorer 8.03.002 - January, 2001
--------------------------------------------------------------------------------------------------------------------------------------------------------------
Full Release

ScheduleX 9.00.015.01 - January, 2003
--------------------------------------------------------------------------------------------------------------------------------------------------------------
Full Release containing all previous Hot Fixes
IGWeekView9.ocx (9.00.015)
PVCalendar9.ocx (9.00.008)
PVDateEdit9.ocx (9.00.007)
PVDayView9.ocx (9.00.015)
PVTaskPad9.ocx (9.00.007)
PVTime9.ocx (9.00.003)

ScheduleX Version 9.00.011.00 - March, 2002
--------------------------------------------------------------------------------------------------------------------------------------------------------------
Full Release

ScheduleX Version 9.00.010.00 - December, 2001
--------------------------------------------------------------------------------------------------------------------------------------------------------------
Full Release

ScheduleX Version 9.00.005.00 - October, 2001
--------------------------------------------------------------------------------------------------------------------------------------------------------------
Full Release

ScheduleX Version 8.04.000.00 - June, 2001
--------------------------------------------------------------------------------------------------------------------------------------------------------------
Full Release

ScheduleX Version 8.03.005.00 - February, 2001
--------------------------------------------------------------------------------------------------------------------------------------------------------------
Full Release

ScheduleX Version 8.03.002.00 - January, 2001
--------------------------------------------------------------------------------------------------------------------------------------------------------------
Full Release

UltraGrid 2.01.025.01 - January, 2003
--------------------------------------------------------------------------------------------------------------------------------------------------------------
Full Release containing all previous Hot Fixes
IGUltraGrid20.ocx (2.01.025)
IGPrint.dll (1.00.028)
ssmask.dll (1.01.005)
SSPng2.dll (1.01.001)
SSPpg.dll (2.00.136)
SSPPG2.dll (1.00.008)
IGUltraGridPPG.ocx (2.00.024)
SSInput1.ocx (1.01.034)
PVShared.dll (8.00.000)
PVCurr.ocx (8.04.002)
PVNum.ocx (8.04.002)
PVCalendar.ocx (8.04.004)

UltraGrid 2.01.007.00 - March, 2002
--------------------------------------------------------------------------------------------------------------------------------------------------------------
Full Release

UltraGrid 2.01.002.00 - December, 2001
--------------------------------------------------------------------------------------------------------------------------------------------------------------
Full Release

(2.00.025) June, 2001:

Full Release

(2.00.025) June, 2001:
Full Release

(1.01.005) January, 2001:
Full Release

UltraGrid Initial Release (1.00.075) October, 2000

ActiveInput Initial Release (1.00.036) May, 2000

UltraToolBars 5.01.019.01 - January, 2003
--------------------------------------------------------------------------------------------------------------------------------------------------------------
Full Release containing all previous Hot Fixes
IGToolBars50.ocx (5.01.019)
IGResizer40.ocx (4.01.006)
IGScroll40.ocx (4.01.006
IGSplash40.ocx (4.01.006)
IGSplitter40.ocx (4.01.006)
IGTabs40.ocx (4.01.006)
IGThreed40.ocx (4.01.011)
IGTransition40.ocx (4.01.011)

UltraToolBars 5.01.006.00 - March, 2002
--------------------------------------------------------------------------------------------------------------------------------------------------------------
Full Release

UltraToolBars 5.01.002.00 - December, 2001
--------------------------------------------------------------------------------------------------------------------------------------------------------------
Full Release

UltraToolBars 5.00.025.06 - October, 2001
--------------------------------------------------------------------------------------------------------------------------------------------------------------
Full Release

UltraToolBars 4.00.003.07 - June, 2001
--------------------------------------------------------------------------------------------------------------------------------------------------------------
Full Release

UltraToolBars 4.00.003.06 - February, 2001
--------------------------------------------------------------------------------------------------------------------------------------------------------------
Full Release

UltraToolBars 4.00.003 - January, 2001
--------------------------------------------------------------------------------------------------------------------------------------------------------------
Full Release

Upgrade Information

This section contains important information for users upgrading from earlier versions of ActiveToolBars, ActiveToolbars Plus or Designer Widgets to UltraToolBars.

Upgrading Visual Basic Projects

For Users of UltraToolBars 4.0:

It is easy to upgrade an existing Visual Basic project directly from UltraToolBars 4.0 to UltraToolBars 5.0. Run the Conversion Utility, which can be accessed from the Start Menu (in the UltraToolBars50 group) and follow the directions.

Alternatively, it is possible to directly upgrade existing projects using the UltraToolBars 4.0 controls to UltraToolBars 5.0 by editing the project (VBP) file in a text editor, such as Notepad. You must make the following modification:

In the old VBP file, find the following lines:

Object={17259422-7BB1-421A-88DE-7EA81AC1AC6F}#4.0#0; IGTOOLBARS40.OCX

and change the object GUID, OCX name, and version number as in the following line:

OBJECT ={85202277-6C76-4228-BC56-7B3E69E8D5CA}#5.0#0; IGTOOLBARS50.OCX

Save the file using your text editor, and then open the project as you normally would.

For Users of ActiveToolBars Plus:

It is easy to upgrade an existing Visual Basic project directly from ActiveToolBars Plus to UltraToolBars. Run the Conversion Utility, which can be accessed from the Start Menu (in the UltraToolBars group) and follow the directions.

Alternatively, it is possible to directly upgrade existing projects using the ActiveToolBars Plus controls to UltraToolBars by editing the project (VBP) file in a text editor, such as Notepad. You must make the following modification:

In the old VBP file, find the following lines:

Object={1BE65FA0-CBF9-11D2-BBC7-00104B9E0792}#2.0#0; SSTBARS2.OCX

Object={0A45DB48-BD0D-11D2-8D14-00104B9E072A}#2.0#0; SSTABS2.OCX

and change the object GUID, OCX name, and version number as in the following line:

Object={17259422-7BB1-421A-88DE-7EA81AC1AC6F}#4.0#0; IGTOOLBARS40.OCX

Object={D8F5B61D-9152-4399-BF30-A1E4F3F072F6}#4.0#0; IGTABS40.OCX

Save the file using your text editor, and then open the project as you normally would.

For Users of ActiveToolBars:

It is easy to upgrade an existing Visual Basic project directly from ActiveToolBars to UltraToolBars. Run the Conversion Utility, which can be accessed from the Start Menu (in the UltraToolBars group) and follow the directions.

Alternatively, it is possible to directly upgrade existing projects using the ActiveToolBars control (SSTBARS2.OCX) to UltraToolBars (IGTOOLBARS40.OCX) by editing the project (VBP) file in a text editor, such as Notepad. You must make the following modification:

In the old VBP file, find the following line:

Object={343F59D0-FE0F-11D0-A89A-0000C02AC6DB}#1.0#0; SSTBARS.OCX

and change the object GUID, OCX name, and version number as in the following line:

Object={17259422-7BB1-421A-88DE-7EA81AC1AC6F}#4.0#0; IGTOOLBARS40.OCX

Save the file using your text editor, and then open the project as you normally would.

For Users of Designer Widgets:

Although there is no direct procedure for upgrading a project from Designer Widgets to UltraToolBars, existing Designer Widgets Toolsets can be converted using the Toolset Conversion Wizard, located on the Start Menu, in the UltraToolBars group.

Additionally, the ActiveTabs control supports many of the same features as the Designer Widgets IndexTab control, but is more efficient. The layout of your index tabs can be quickly mimicked by adding a new form to your existing Designer Widgets project and placing an ActiveTabs control on the new form. Create an equal number of tabs as in the original, and place an ActiveTabPanel on each. Next, select multiple controls from the Designer Widgets IndexTab control by clicking while holding down the Ctrl key. When all of the controls of a tab are selected, copy them using the Visual Basic Edit menu or Ctrl-C. Finally, select the appropriate ActiveTabPanel control and paste the controls into it by using the Edit menu or Ctrl-V. Repeat this for each tab to convert the appearance of your tabbed interface from a Designer Widgets project to an ActiveToolBars Plus project.

At this time, the ActiveTabs control's NotePage style does not directly replicate the Designer Widgets IndexTab's Page mode, however, the appearance can be easily emulated by creating two ActiveTabs controls-one the child of another-the parent with the default style and the child with a tab style of 1 (ssStyleNotePage) or 2 (ssStyleNotePageFlat). The controls should then be placed on an ActiveTabPanel control on the child ActiveTabs control.

For ActiveThreed Plus users:

It is easy to upgrade an existing Visual Basic project directly from ActiveThreed Plus to UltraToolbars. Use the conversion utility installed with UltraToolbars to make the necessary changes for you. Run the program named Conversion.exe (located in the directory where you installed UltraToolbars) and follow the directions.

Alternatively, you may upgrade your existing projects by editing the Visual Basic Project file (.VBP). Open the project's .VBP file in Notepad, or a similar text editor, and follow the simple steps below.

1. Find the following lines:

Object={065E6FD1-1BF9-11D2-BAE8-00104B9E0792}#3.0#0; ssa3d30.ocx

Object={8C3D4AA0-2599-11D2-BAF1-00104B9E0792}#3.0#0; sssplt30.ocx

Object={44ECA3F0-BDD9-11D1-B3C2-00104B2B8509}#3.0#0; SSSPLS30.OCX

Object={E2585150-2883-11D2-B1DA-00104B9E0750}#3.0#0; SSRESZ30.OCX

Object={997E9620-3391-11D2-9DCF-00104B9E078A}#3.0#0; SSTRAN30.OCX

Object={9CD56991-2E37-11D2-8C87-00104B9E072A}#3.0#0; SSSCRL30.OCX

2. Replace them with the lines below:

Object={F20E41DE-526A-423A-B746-D860D06076B4}#4.0#0; IGTHREED40.OCX

Object={14ACBB92-9C4A-4C45-AFD2-7AE60E71E5B3}#4.0#0; IGSPLITTER40.OCX

Object={1943D383-0595-405B-9390-0A5CAAC0827F}#4.0#0; IGSPLASH40.OCX

Object={1AF1F43C-1DE4-44ED-B0FD-A49A4EAA03A6}#4.0#0; IGRESIZER40.OCX

Object={43E0D4CB-B249-449C-AC19-6AD486137F7D}#4.0#0; IGTRANSITION40.OCX

Object={3FD089E4-F742-431A-979F-380C3C77FBE6}#4.0#0; IGSCROLL40.OCX

3. Save the file using your text editor, and then open the project as you normally would.

For ActiveThreed users (THREED20.OCX and SPLITTER.OCX):

It is easy to upgrade an existing Visual Basic project directly from ActiveThreed to UltraToolbars. Use the conversion utility installed with UltraToolbars to make the necessary changes for you. Run the program named Conversion.exe (located in the directory where you installed UltraToolbars) and follow the directions.

Alternatively, you may upgrade your existing projects by editing the Visual Basic Project file (.VBP). Open the project's .VBP file in Notepad, or a similar text editor, and follow the simple steps below.

1. Find the following lines:

Object={0BA686C6-F7D3-101A-993E-0000C0EF6F5E}#2.0#0; THREED20.OCX

Object={F7BA9F11-0A5D-11D0-97C9-0000C09400C4}#2.0#0; SPLITTER.OCX

2. Replace them with the lines below:

Object={F20E41DE-526A-423A-B746-D860D06076B4}#4.0#0; IGTHREED40.OCX

Object={14ACBB92-9C4A-4C45-AFD2-7AE60E71E5B3}#4.0#0; IGSPLITTER40.OCX

3. Save the file using your text editor, and then open the project as you normally would.

For ThreeD users (THREED16.OCX or THREED32.OCX)

You can upgrade an existing Visual Basic project directly from THREED16.OCX or THREED32.OCX to UltraToolbars by editing the project file (.VBP). Open the project's .VBP file in Notepad, or a similar text editor, and follow the simple steps below.

1. Find the following line for THREED32.OCX (or THREED16.OCX):

Object={0BA686C6-F7D3-101A-993E-0000C0EF6F5E}#1.0#0; THREED32.OCX

2. Replace them with the line below:

Object={F20E41DE-526A-423A-B746-D860D06076B4}#4.0#0; IGTHREED40.OCX

3. Save the file using your text editor, then open the project as you normally would.

Upgrade Issues

The previous version of the SSCheck control found in THREED32.OCX and THREED16.OCX supported only two logical states: checked and unchecked. This differs from the standard Visual Basic and Windows check box which supports three states; checked, unchecked and grayed.

If you have existing programs that use a previous version of the SSCheck control, and those programs assume a specific set of values (i.e. that only 2 states are available) you must make sure that the TripleState property is set to False. This is the default setting, and ensures full compatibility with previous versions of the control. However, if you wish to use the new capabilities of the control, or use the SSCheck to replace standard check boxes, you should make sure TripleState is set to True.

ActiveToolBars Plus Known Control Issues

The ActiveTabs control, like most container controls, does not function properly when inserted directly into an HTML document. Almost all container controls experience problems when directly placed in an HTML document. However, the ActiveTabs control should function normally when wrapped, such as when it is embedded within an ActiveX User Control or Document.

If you are not sure that the display adapters on the machines you distribute to can or will be set to at least 16 bit colors, then it is strongly recommended that you convert the image to 16 bit colors.

For other known control issues, see the Known Issues section of the help file.

ActiveThreed Plus Control Notes

New method added to SSResizer control:
A new method, Reset has been added to the SSResizer control, and when invoked resets the proportions used by the control when resizing other controls.

New property added to SSSplitter control:
A new property, AllowMdiChildForms has been added to the SSSplitter control, and when set to True allows MdiChild forms to be set in a pane. This will allow focus to work correctly for this project with the caveat that you can't press the End key on any error dialog or you will get a GPF.

Splitter Panes containing forms:
You can now place a form inside a Splitter pane by using the Panes Control property at run-time. To do this remove the Caption and ControlBox from the form and in code set the Pane.Control property to the Form.hWnd property. See the ActiveSuite example for sample code.

When attempting to set focus to a form in a Splitter pane please note that since there is no way to set the container of a Form in VB, we are forced to use the Form's hwnd and re-parent using the Windows API SetParent. Unfortunately, this prevents VB from being notified of the re-parenting resulting in control focus issues occurring. One side effect is being unable to set focus to a control on a Splitter Form on the first mouse click. Another side effect is that tab order of the main Form and the re-parented Form are separate. You cannot tab from control on one Form to controls on the other.

Zorder Issues with Frame and Panel controls:
There is a known problem pertaining to Zorder with the Frame and Panel controls at design time in Visual Basic when the BackStyle property is set to ‘Transparent’. Unfortunately there is no current solution to this problem. For some reason when Visual Basic has a transparent control on a form it seems to reverse the Zorder of the transparent controls. NOTE: This only occurs at design time, at run time the correct Zorder is maintained.

Windowless property default value has been changed:
In ActiveThreed Plus the Windowless property now defaults to FALSE. This causes the control to have a window. If you prefer to have the control Windowless, set the property to TRUE. Note that there are limitations with Visual Basic 5's support of windowless controls. If you experience problems with windowless controls reset the Windowless property back to FALSE.

Delay values:
Note that when setting PictureAnimationDelay and MarqueeDelay properties the resolution under Windows 95 is 55 milliseconds, under Windows NT it is 10ms. If the delay is set to less than the resolution, the delay is equivalent to 0 and will be affected by any other applications using timers.

Transparency issues:
If you place a transparent control on top of another control (for example, a transparent SSPanel on top of a command button) the user of your application will be able to see the control, but will not be able to access it. You should avoid placing transparent controls on top of other controls.

Using Resizer with nested Microsoft Tabbed Dialog controls:
When using nested Microsoft Tabbed Dialog controls in VB it is possible to have the fonts of the tab controls resize improperly. This is a known issue with the tabbed dialog control. If you experience this problem simply change the fonts of the tabbed dialog controls to any other font and then switch back to the original font immediately after placing them on a form.

Transitioning certain controls does not work:
The way the Transition control works is that it sends a WM_PAINT message to all of its child controls with a memory dc in the wParam. Almost all controls correctly render themselves into this dc. However, certain controls don’t behave properly and unfortunately there is nothing that the Transition control can do to get around the problem.

The most notable example is the version 6 ListView control that ships with VB6. The version 5 control works fine, it seems the problem was introduced in version 6. If you encounter this problem with either the ListView or another 3^rd party control one workaround is to perform a SSTransition.Refresh or a ListView.Refresh after the transition finishes. This won’t show the control during the transition but will force a refresh afterward. You may also want to contact the control vendor to report the problem.

Too complex regions for SSSplash, SSRibbon and SSCommand:
The SSSplash control uses its Picture property to create an irregularly shaped region for its parent form. The SSRibbon and SSCommand controls use their Shape property (which is also a picture) to create an irregularly shaped region for their windows. There are situations where the region can be too complex for the OS to handle. This is especially true under Windows 95 and 98 in 256-color mode. If you have an image with large areas of a dithered color and one of the solid colors that makes up the dither is the transparent color (which is taken from the bottom/left corner pixel of the control) then the creation of the region may fail. When this happens at design time the SSSplash control will display the following message:

“The window region could not be created which may indicate that it is too complex.

The ActiveSplash control uses the color value of the lower left corner pixel as the transparent color. If this color is also used as part of a dithered color that covers a large area of the image the region may contain too many very small transparent areas. This happens most often in 256-color mode.

If the control's Picture property is set to an icon or metafile try setting the BackColor property to a SOLID color that is not used in dithered areas of the image.

If the Picture property is set to a bitmap try changing the lower left corner pixel to a color that isn't used in dithered areas."

Note: If you are developing under NT the window region creation may succeed but may fail when the application is run under 95 or 98. When this happens at runtime, no error message is displayed and the window reverts to being rectangular.

For more detailed information, consult the Known Control Issues section of the help file (THREED30.HLP).