Products Downloads


French version


 

Associates an image with the object for a given status. The image will appear to the left of the element when it is in the specified status.

Syntax

CALL_METHOD NameTreeColumnObject ASSOCIATE_IMAGE ImageInfo Status ReturnCode

Parameters

ALPHA(n) or IMAGE ImageInfo

Image to be associated.

The parameter may be an alphanumeric variable containing the name and directory of the file containing the image. The acceptable file formats are: bmp, cut, emf, eps, ico, gif, iff, jpg, jp2, mng, pbm, pcx, pgm, png, ppm, psp, tif, tga, wmf.

 

The following formats only are supported with Adelia Mobile runtime: bmp, gif, jpg, png and ico.

The parameter can also be an IMAGE-type variable.

 

The content of the variable is either an image in DIB (Device-Independent Bitmap) format or a file containing an image with one of the following extensions: bmp, cut, emf, eps, ico, gif, iff, jpg, jp2, mng, pbm, pcx, pgm, png, ppm, psp, tif, tga, wmf (input parameter).

NUM_BIN_2 Status

Status of the element (input parameter)

_TCO_STATUS_SELECTED

The element has been selected,

_TCO_STATUS_NOT_SELECTED

The element is not selected,

_TCO_STATUS_COLLAPSED

The element is contracted,

_TCO_STATUS_EXPANDED

The element is expanded,

_TCO_STATUS_ALL

Gathers the different statuses previously described.


The order of priority of the various statuses (in ascending order) for a given element is:

_TCO_STATUS_NOT_SELECTED, _TCO_STATUS_EXPANDED, _TCO_STATUS_COLLAPSED, _TCO_STATUS_SELECTED.

NUM_BIN_2 ReturnCode

Return code for the operation (output parameter).

Possible values:

-3

Error while reading the image,

-2

Incorrect Status parameter value,

-1

Error while adding the image,

0

Internal error,

1

Operation completed successfully.

 

 

Conditions for use None (property applicable to all elements in the object). Where an element has no associated image for a given status, a default image will be associated with it. This will be the first image associated with an element (when the first call to the ASSOCIATE_IMAGE or SET_IMAGE methods is made).

 

 

Associates an image with the object for a given status. The image will appear to the left of the element's text when it is in the specified status.

Syntax

CALL_METHOD TreeColumnObjectName ASSOCIATE_IMAGE_FROM_URL UrlImage Status ReturnCode

Parameters

ALPHA (500) UrlImage

URL address specifying the Image file.

Input parameter.

The following image file extensions are supported: bmp, cut, emf, eps, ico, gif, iff, jpg, jp2, mng, pbm, pcx, pgm, png, ppm, psp, tif, tga, wmf.

NUM_BIN_2 Status

Status of the element.

Input parameter.

_TCO_STATUS_SELECTED

The element has been selected,

_TCO_STATUS_NOT_SELECTED

The element is not selected,

_TCO_STATUS_COLLAPSED

The element is contracted,

_TCO_STATUS_EXPANDED

The element is expanded,

_TCO_STATUS_ALL

Gathers the different statuses previously described.

 

The order of priority of the various statuses (in ascending order) for a given element is:

_TCO_STATUS_NOT_SELECTED, _TCO_STATUS_EXPANDED, _TCO_STATUS_COLLAPSED, _TCO_STATUS_SELECTED.

NUM_BIN_4  ReturnCode

Return code for the operation.

Output parameter.

Possible values:

-3: Error while reading the image file.

-2: Incorrect value of the Status parameter.

-1: Error while adding image.

 0: Internal error.

 1: Operation completed successfully.

>1: Error while executing http query.

Conditions for use 

None (property applicable to all elements in the object).

Where an element has no associated image for a given status, a default image will be associated with it. This will be the first image associated with an element (when the first call to the ASSOCIATE_IMAGE or SET_IMAGE, or ASSOCIATE_IMAGE_FROM_URL or SET_IMAGE_FROM_URL methods is made).

 

 

Locates the first and last selected character in the node's input field.

Syntax

CALL_METHOD TreeColumnObjectName GET_CURSOR_LOCATION LineNum StartPosition EndPosition ReturnCode

Parameters

NUM_BIN_4 LineNum

Line number (output parameter),

NUM_BIN_4 StartPosition

Position of the first selected character (output parameter),

NUM_BIN_4 EndPosition

Position of the first character after the last selected character (output parameter),

NUM_BIN_2 ReturnCode

Return code for the operation (output parameter).

Possible values:

-1: None of the column's node is in Edit mode

 0: Internal error

 1: Operation completed successfully

Conditions for use 

None

 

Note: This method is not implemented by the Java generator.

 

Merges two TREE_COLUMN objects together. The object calling the method is merged with the object following it (according to the specified sequence). The two merged objects then form a single element. The element's text will contain the values of the two component objects, separated by the separator of the object that called the method.

Syntax

CALL_METHOD NameTreeColumnObject MERGE ReturnCode

Parameters

NUM_BIN_2 ReturnCode

Return code for the operation (output parameter)

Possible values:

-1: No object after the object calling the method

 0: Internal error

 1: Operation completed successfully

 

 

Selects a block of characters in the node's input field.

Syntax

CALL_METHOD TreeColumnObjectName SET_CURSOR_LOCATION LineNum StartPosition EndPosition ReturnCode

Parameters

NUM_BIN_4 LineNum

Line number (input parameter).

NUM_BIN_4 StartPosition

Position of the first character that you want to select (input parameter).

If StartPosition is set to -1 the text is deselected and the cursor moves to the end of the line.

NUM_BIN_4 EndPosition

Position of the first character following the last character that you want to select (input parameter).

If EndPosition is set to -1 the complete text is selected.

NUM_BIN_2 ReturnCode

Return code for the operation (output parameter).

Possible values:

-2: You cannot enable Data Entry mode for the node

-1: The line number set as a parameter is invalid

 0: Internal error

 1: Operation completed successfully

Conditions for use None

 

Note: This method is not implemented by the Java generator.

 

Places the focus on the object.

Syntax

CALL_METHOD NameTreeColumnObject SET_FOCUS NumLine

Parameters

NUM_BIN_4 NumLine

Line number (input parameter),

Conditions for use

None

 

 

Sets an image to the object for a given status and a given line number. The image will appear to the left of the element's text when it is in the specified status.

Syntax

CALL_METHOD TreeColumnObjectName SET_IMAGE NumLine ImageInfo Status ReturnCode

Parameters

NUM_BIN_4 NumLine

Line number affected. If NumLine is set to 0, the current line will be the one affected (input parameter),

ALPHA(n) or IMAGE ImageInfo

Image to be associated.

The parameter may be an alphanumeric variable containing the name and directory of the file containing the image. The acceptable file formats are: bmp, cut, emf, eps, ico, gif, iff, jpg, jp2, mng, pbm, pcx, pgm, png, ppm, psp, tif, tga, wmf.

 

The following formats only are supported with Adelia Mobile runtime: bmp, gif, jpg, png and ico.

The parameter can also be an IMAGE-type variable.

 

The content of the variable is either an image in DIB (Device-Independent Bitmap) format or a file containing an image with one of the following extensions: bmp, cut, emf, eps, ico, gif, iff, jpg, jp2, mng, pbm, pcx, pgm, png, ppm, psp, tif, tga, wmf (input parameter).

NUM_BIN_2 Status

Status of the element (input parameter)

_TCO_STATUS_SELECTED

The element has been selected,

_TCO_STATUS_NOT_SELECTED

The element is not selected,

_TCO_STATUS_COLLAPSED

The element is contracted,

_TCO_STATUS_EXPANDED

The element is expanded,

_TCO_ALL_STATUSES

Gathers the different statuses previously described.


The order of priority of the various statuses (in ascending order) for a given element is:

_TCO_STATUS_NOT_SELECTED, _TCO_STATUS_EXPANDED, _TCO_STATUS_COLLAPSED, _TCO_STATUS_SELECTED.

NUM_BIN_2 ReturnCode

Return code for the operation (output parameter).

Possible values:

-4: Incorrect NumLine parameter value

-3: Error while reading the image

-2: Incorrect Status parameter value

-1: Error while adding the image

 0: Internal error

 1: Operation completed successfully

Conditions for use None (property applicable to a given element in the object). Where an element has no associated image for a given state, a default picture will be associated with it. This will be the first image associated with an element (when the first call to the ASSOCIATE_IMAGE or SET_IMAGE methods is made).

 

 

Sets an image to the object for a given status and a given line number. The image will appear to the left of the element's text when it is in the specified status.

Syntax

CALL_METHOD TreeColumnObjectName SET_IMAGE_FROM_URL UrlImage NumLine Status ReturnCode

Parameters

ALPHA (500) UrlImage

URL address specifying the Image file.

Input parameter.

The following image file extensions are supported: bmp, cut, emf, eps, ico, gif, iff, jpg, jp2, mng, pbm, pcx, pgm, png, ppm, psp, tif, tga, wmf.

NUM_BIN_4 NumLine

Line number affected. If NumLine is set to 0, the current line will be the one affected.

Input parameter.

NUM_BIN_2 Status

Status of the element.

Input parameter.

_TCO_STATUS_SELECTED

The element has been selected,

_TCO_STATUS_NOT_SELECTED

The element is not selected,

_TCO_STATUS_COLLAPSED

The element is contracted,

_TCO_STATUS_EXPANDED

The element is expanded,

_TCO_STATUS_ALL

Gathers the different statuses previously described.

 

The order of priority of the various statuses (in ascending order) for a given element is:

_TCO_STATUS_NOT_SELECTED, _TCO_STATUS_EXPANDED, _TCO_STATUS_COLLAPSED, _TCO_STATUS_SELECTED.

NUM_BIN_2 ReturnCode

Return code for the operation.

Output parameter.

Possible values:

-4: Incorrect value of the NumLine parameter.

-3: Error while reading the image file.

-2: Incorrect value of the Status parameter.

-1: Error while adding image.

 0: Internal error.

 1: Operation completed successfully.

>1: Error while executing http query.

Conditions for use

None (property applicable to all elements in the object).

Where an element has no associated image for a given status, a default image will be associated with it. This will be the first image associated with an element (when the first call to the ASSOCIATE_IMAGE or SET_IMAGE, or ASSOCIATE_IMAGE_FROM_URL or SET_IMAGE_FROM_URL methods is made).

 

 

De-merges two merged TREE_COLUMN objects. The split takes place at the point between the object calling the method and the object following it (in the sequence).

Syntax

CALL_METHOD NameTreeColumnObject SPLIT ReturnCode

Parameters

NUM_BIN_2 ReturnCode

Return code for the operation (output parameter).

Possible values:

-1: No object after the object calling the method

 0: Internal error

 1: Operation completed successfully

 

Note: This method is not available in Java generation.

 

 

 

 

 

↑ Top of page