IDLffLangCat::Init

IDLffLangCat::Init

Syntax | Return Value | Arguments | Keywords | Version History

The IDLffLangCat::Init function method initializes an IDLffLangCat object.

Note

Init methods are special life cycle methods, and as such cannot be called outside the context of object creation. This means that in most cases, you cannot call the Init method directly. There is one exception to this rule: If you write your own subclass of this class, you can call the Init method from within the Init method of the subclass.

Any invalid input will result in a failure to create a valid object. Invalid input includes the following cases:

The requested language is not found in any of the input files

Any application in APP_NAME is not found

Any file in FILENAME is not found

Any directory in APP_PATH does not exist

The requested default language is not found

You can set the VERBOSE keyword to view the output log for a detailed description of the creation (or failure) of the object. You can also set CONTINUE_ON_ERROR to override the failure behavior if you have the language specified, regardless of the language's existence.

Syntax

Obj = OBJ_NEW( `IDLffLangCat', Language [, PROPERTY=value] [, /CONTINUE_ON_ERROR]

Result = Obj->[IDLffLangCat::]Init( Language [, PROPERTY=value] [, /CONTINUE_ON_ERROR] )

(Only in a subclass's Init method)

Return Value

Returns the new object if successful or a null object otherwise if initialized with OBJ_NEW, or returns 1 if successful or 0 otherwise if called from a subclass's Init method.

Arguments

Language

A string containing the name of the language to load from the catalog.

Keywords

Any property listed under IDLffLangCat Properties that contains the word "Yes" in the "Init" column of the properties table can be initialized during object creation using this method. To initialize the value of a property, specify the property name as a keyword set equal to the appropriate property value.

You must specify either APP_NAME or FILENAME for this method. If APP_NAME is specified, it overrides any input to FILENAME.

CONTINUE_ON_ERROR

If set, the object will be created as long as the language is specified, regardless of the validity of any of the input parameters. If not set, the object will not be created if any input is invalid. If a language is not specified or is specified incorrectly (e.g., as a multiple element array), the object will not be created, and an error will be thrown, regardless of the value of this keyword.

Version History

Introduced: 6.1