Siebel VB Language Reference > VB Language Reference >

Type Statement

This standard VB statement declares a user-defined type.

Syntax

Type userType
   field1 As type1
   field2 As type2
...
End Type

Returns

Not applicable

Usage

The user-defined type declared by Type can be used in a Dim statement to declare a record variable. A user defined type is sometimes referred to as a record type or a structure type.

Field cannot be an array. However, arrays of records are allowed.

The Type statement is not valid inside a procedure definition. It must be placed in the (general) (declarations) section, shown in Option Base Statement. User defined Types cannot be passed to COM Object functions or subroutines.

To access the fields of a record, use syntax of the form:

recordName.fieldName

To access the fields of an array of records, use syntax of the form:

arrayName(index).fieldName

No memory is allocated when a type is defined. Memory is allocated when a variable of the user defined type is declared with a Dim statement. Declaring a variable of a user defined type is called instantiating, or declaring an instance of, the type.

Example

This example shows a Type and Dim statement for a record. You must define a record type before you can declare a record variable. The subroutine then references a field within the record.

Type Testrecord
   Custno As Integer
   Custname As String
End Type

Sub Button_Click
   Dim myrecord As Testrecord
   Dim msgText As String
i:
   myrecord.custname = "Chris Smith"
   If myrecord.custname = "" then
      Exit Sub
   End If
End Sub

Related Topics

Deftype Statement
Dim Statement