Product Documentation
Cadence User Interface SKILL Reference
Product Version IC23.1, September 2023

hiReattachField

hiReattachField(
g_formOrScrollRegion
s_field
l_positionalInfo
i_fieldAttachment
)

Description

Reattaches a field in a two-dimensional form or scroll region that has field attachments. This function places the field according to the new position and attachment information. This function can be used only with forms or scroll regions that already have field attachments. For forms or scroll regions that do not have field attachments, use the hiMoveField, hiResizeField, hiOffsetField, and hiOffsetFields functions.

Arguments

g_formOrScrollRegion

  

Handle to the two-dimensional form or scroll region that contains the field you want to reattach.

s_field

Handle to the field you want to reattach.

i_positionalInfo

The two-dimensional attributes for the field. Use the following syntax:

list ( x:y width:height [ x_promptBoxWidthOrTitleHeight ] )

i_fieldAttachment

A bitwise OR of a list of constants. The field attachment determines how the two-dimensional attributes of a field are used to position the field in the form. This argument is valid only for two-dimensional forms.

Values Returned

t

The field characteristics are changed.

nil

The field characteristics are not changed. An error message is also issued.

Related Topics

Form and Field Functions

Two Dimensional Form Layout

Field Attachments


Return to top
 ⠀
X