Errors reported by the control are run-time errors in Visual Basic. They can be handled using the On Error statement and the Err object, which provides the error code and the message text.
The following errors are generated by SftTabs/OCX:
| Error | Name | Description |
|---|---|---|
| 380 | CTL_E_INVALIDPROPERTYVALUE | An invalid value was used to set a property or as an argument for a method. Many properties and methods allow only a certain range of values. Please see the documentation for valid values for the failing property or method. |
| 382 | CTL_E_SETNOTSUPPORTEDATRUNTIME | A property was set which cannot be set at run-time. It can only be modified at design time. Most properties (even if documented as read/only at design time) can be modified at run time, however the control must be empty (all tabs must be removed from the control using Tabs.Clear). |
| 387 | CTL_E_SETNOTPERMITTED | A property was set at design time which can only be set at run time. It cannot be modified at design time. |
| 394 | CTL_E_GETNOTSUPPORTED | A property was retrieved which cannot be accessed at run time. It can only be modified at design time. A property was retrieved which cannot be accessed at design time. It can only be modified at run time. Please see the documentation of the failing property. |
| 481 | CTL_E_INVALIDPICTURE | An operation involving a Picture object has failed. The text of the accompanying error message provides additional information as to the source of the error. Possible reasons are: - An invalid Picture object or interface pointer was used. - A certain type of graphic is required. Most properties in the control only support bitmap graphics. Icons and metafiles are not supported. Please see the documentation for valid graphic types for the failing property. - The bitmap described by the Picture object (i.e. the bitmap handle) is no longer valid, because the bitmap handle has already been destroyed. Please see the documentation of the failing property for additional information. |
| 1001 | SFTTABS_E_INVALIDTABINDEX | An invalid tab index was specified. The tab index is zero-based, which means the valid range of tabs is 0..Tabs.Count-1. Please see the documentation of the failing property or method. |
| 1002 | SFTTABS_E_DEMO - Demo Version | This demo version of SftTabs/OCX is limited to hold up to 6 tabs. If more tabs are added, an error is generated. The demo version is supplied for evaluation purposes only. Applications developed using the demo version are not redistributable as the control will not be displayed. Only applications developed using a fully licensed version of SftTabs/OCX are redistributable. If you need further assistance please contact Softel vdm, Inc. |
| 1003 | SFTTABS_E_NOTCOMPAT | A property was modified and set to a value which is not compatible with the current tab style. Usually this is caused when mutually exclusive options are used. Please see the documentation of the failing property or method for more information. |
| 1004 | SFTTABS_E_NEEDCLIENTAREA | A client area is needed to use the method or property. The current tab control has been defined without a client area (see ClientArea property). Please see the documentation of the failing property or method for more information. |
| 1005 | SFTTABS_E_NOCLIENTAREA | The method or property can only be used if a client area has not been defined. The current tab control has been defined with a client area (see ClientArea property). Please see the documentation of the failing property or method for more information. |
| 1006 | SFTTABS_E_PAGENOTEMPTY | A tab can only be deleted if the associated controls of the page have been removed. If any controls are located on the tab's client area, the tab cannot be removed. Please see the documentation of the failing property or method for more information. |
| 1007 | SFTTABS_E_NOTNOW | The method or property cannot be used now. Usually this occurs if tab control styles are modified during tab switching. |
| 1008 | SFTTABS_E_TABDISABLED | A disabled tab cannot be the current tab. The Tabs.Current property was used and a tab was specified which is disabled. |
| 1009 | SFTTABS_E_TABHIDDEN | The specified tab is hidden (see Tab.Visible) and cannot be made the current tab. |
| 1010 | SFTTABS_E_INVALIDTABNAME | The specified tab name was not found (see Tab.Name). |
| 1100 | SFTTABS_E_OBJECTINVALID | An object is used which is no longer valid. This can occur if a reference to an object is saved, but the object has been removed as in the following example: pre Private Sub Form_Load() Dim FirstIndex As Integer, SecondIndex As Integer, ThirdIndex As Integer Dim TabObject As SftTabsLib.SftTabsTab With SftTabs1.Direct .Tabs.Clear FirstIndex = .Tabs.Add("Tab &1") SecondIndex = .Tabs.Add("Tab &2") ThirdIndex = .Tabs.Add("Tab &3") ' get the tab object for the second tab Set TabObject = .Tab(SecondIndex) ' now delete the second tab .Tabs.Delete SecondIndex ' accessing the tab object now fails TabObject.Text = "Hello" End With End Sub end |
| 2000 | SFTDATAOBJECT_E_INVALIDUSE | A DataObject is used in an inconsistent manner. A drop target cannot update the DataObject and a drag source cannot retrieve data from the DataObject. |
| 2001 | SFTDATAOBJECT_E_UNSUPPORTEDFORMAT | The data format or storage medium to be added to the DataObject or about to be retrieved is not supported by the product. |
| 2002 | SFTDATAOBJECT_E_ARGREQ | A required argument is missing. Please see the documentation of the failing property or method. |
| 2003 | SFTDATAOBJECT_E_TYPEBAD | The data argument has a type which is inconsistent with the specified data format. |
| 2004 | SFTDATAOBJECT_E_NOSUCHFORMAT | The Format requested using the DataObject.GetData method is not available. It has not been added to the DataObject by the drag source. |
| 2005 | SFTDATAOBJECT_E_NODATA | No data has been provided to the DataObject by the drag source, even though the drag source indicated that the specified Format will be available. |
| 2006 | SFTDATAOBJECT_E_OBJECTINVALID | The object which is used is no longer valid. |
| 2010 | SFTDATAOBJECTFILES_E_INDEXINVALID | An invalid item index was specified (usually the ItemIndex argument). The item index is one-based, which means the valid range of index values is 1..DataObjectFiles.Count. Please see the documentation of the failing property or method. |
| 2011 | SFTDATAOBJECTFILES_E_OBJECTINVALID | The object which is used is no longer valid. |
| 0x80004002L | E_NOINTERFACE | A required interface IStream is not available. A Picture object was about to be copied. Use Picture object references instead (see PutRef syntax of the failing property). |
| 0x8000FFFFL | E_UNEXPECTED | An error occurred which was not anticipated. Internally, an operation which (in theory) should not fail has returned an error. This usually indicates an error in the product, but can also be caused by unexpected use of the product or due to a system limit which may have been reached. The text of the accompanying error message provides additional information as to the source of the error. Please note the circumstances of the error including the complete message text and contact Softel vdm, Inc. Product Support. |
| 0x8007000EL | CTL_E_OUTOFMEMORY | Insufficient resources are available to perform the desired action. This could be caused because all virtual memory is exhausted, a system limit has been reached, such as the available bitmap handles, window handles, etc. |