Modifying Tab Blocks on Screens

In the Explorer Tree, locate the object for which you wish to modify a block.

Expand the Template Information object and select the template screen for which you wish to modify a block.
Expand the Group Information object and any sub-groups until you can select the screen for which you wish to modify a block.

Expand the screen and select the block that you wish to modify.
Display the block properties. These will either be displayed in Alphabetical or Logically, depending on the setting of the [Sort Alphabetically/Logically] button. The following instructions are assuming that the properties are sorted logically.
In the Name property, the name entered during block creation is displayed, and can be changed, if desired.
In the Description property, enter the user-defined description for the block.
In the Parent pop-list, if the parent of this block is another block, the parent block is displayed, grayed out. Otherwise, this pop-list is set to (entity root).
In the Type pop-list, the original setting from the block creation will be displayed, and can be changed, if desired. The type can be Standard Block, Tab Block, Chart Block, Bread Crumb, or iFrame. It should be set to Tab Block.
In the Mutability pop-list, select whether this block can be modified on screens that are created from this template. This option is ONLY available for template screens.

When set to Fully Mutable, the block is placed on all screens that inherit from this template and can be modified or deleted.
When set to Positionally Mutable, the block is placed on all screens that inherit from this template and can only be moved.
When set the Not Mutable, the block is placed on all screens that inherit from this template and cannot be modified in anyway.

In the Tab Type property, select the type of tab that will be displayed for this tab block. Choices are:

Angle
Full Round
Half Round
Notched
Oval
Square
Set the On QBE pop-list to true, if this block should be included in QBE mode for this screen.
Set the On New pop-list to true, if this block should be included in New mode for this screen.
Set the On List pop-list to true, if this block should be included in List mode for this screen.
Set the On Edit pop-list to true, if this block should be included in Edit mode for this screen.
Set the Display Only pop-list to the desired setting to indicate whether the data on this block be displayed as text only and cannot be modified.

When this pop-list is set to true, the data will be displayed as text only and cannot be modified.

When this pop-list is set to false, the data will be displayed as editable fields by default, but field level settings can override this.

A list is considered to be editable if the block's Display Only pop-list is set to false.
Set the Editability pop-list to the desired setting to indicate when this block is editable.

Always Editable: the data on this block will be displayed in form fields, and can be modified by default. This setting can be overridden at the field level.

Editable on New Only: the data on this block will be displayed in form fields and can be modified when the screen is in New mode only, by default. This setting can be overridden to Never Editable at the field level.

Never Editable: the data on this block will be displayed in form fields, but cannot be modified.
Set the Body Style pop-list to the style to be applied to the body for this block. If set to (from parent), the style used will be the Body Style from the screen properties.
Set the Editable Field Style pop-list to the style to be applied by default to the editable fields for this block. If set to (from parent), the style used will be the Editable Field Style from the screen properties.
Set the Non- Editable Field Style pop-list to the style to be applied by default to the display only and label fields for this block. If set to (from parent), the style used will be the Non- Editable Field Style from the screen properties.
Set the Link Style pop-list to the style to be applied to hyperlinks for this block. If set to (from parent), the style used will be the Link Style from the screen properties.
In the Unselected Style property, select the style to apply to tabs when they are inactive.
In the Selected Style property, select the style to apply to a tab when it is the active tab.
In the X property, the location in pixels is displayed for the top left corner of this block or field on the X-axis (horizontal) of the layout screen. You can change this number manually, or it will be changed when you are altering the layout with the Designer Tool.
In the Y property, the location in pixels is displayed for the top left corner of this block or field on the Y-axis (vertical) of the layout screen. This value is used in conjunction with the Y Anchor Type setting. You can change this number manually, or it will be changed when you are altering the layout with the Designer Tool.
In the Y Anchor Type pop-list, select the anchor type for this block. Choices are Fixed and Relative to Block..

When set to Fixed, the upper left corner of this block will be placed a fixed number of pixels in relation to the upper left corner of the block's parent. The number of pixels is defined in the Y field for the block.
When set to Relative to Block, the upper left corner of this block will be placed a fixed number of pixels from the bottom edge of the specified block defined in the Y Anchor field. Example: if you want a particular block to appear immediately after another block which happens to be an Expandable block (and therefore you don't know where it will end on the entity).

In the Y Anchor property, select the block or field that will be used to determine the location of the block on the Y-axis. The property is only displayed when the Y Anchor Type pop-list is set to Block.
In the Width property, enter the width for the block in pixels.
In the Height property, enter the height for the block in pixels.
In the Expand Type pop-list, define the size of the block. Choices are Expandable, Fixed No Scroll Bars, and Fixed with Scroll Bars.

When set to Expandable, the block will be at least the size of the Width and Height values, but it can be larger.
When set to Fixed No Scroll Bars, the block will be the exact size defined using the Width and Height values.
When set to Fixed with Scroll Bars, the block will be the exact sized defined using the Width and Height values, but there will be a scroll bar that allows you to scroll up or down within the block or field.
Example: an address block on a report may be fixed size, while the block for the line items on an invoice will be expandable so that all line items will be visible when the report is generated.

In the Hide If property, enter the conditions under which this block will be hidden. The field will be visible on the block when the conditions are met. When an entry is made in this property, the Show If property will be hidden.

Expressions are entered in this field using formulas and are evaluated on the server side.
When the expression entered in this property evaluates to true, the field will be hidden. The evaluation of the expression occurs when the entity is generated, and not when the user is making modifications to fields on the block. (i.e. This does not "watch" user input in a field and dynamically show a block; everything is locked in when the block is first output).
Example: $$VENDOR.ACTIVE$$ = 'Y'
Hide the block if the value of the active field on the vendor block is set to Y when the block is generated.
Example: starts-with( $$CUST_NO$$, 'NDS')
Hide the block only if the customer number starts with NDS.
The code entered in this field can also include and/or expressions:
And is indicated by two ampersands &&
Or is indicated by two vertical lines ||

Example: ($$XEPHR_ENTITY_NAME$$='MENU')&&($$NEXTMENU$$='MM')
Hide this block if the current entity is the MENU entity and the NEXTMENU global value is set to MM.

Example: ($$CUST_NO$$='NDS')||($$CUST_NO$$='')
Hide this block if the customer number global is set to NDS, or the customer number global is null or doesn't exist.

In the Show If property, enter the conditions under which this block will be displayed. The block will be hidden when the conditions are met. When an entry is made in this property, the Hide If property will be hidden.

Expressions are entered in this field using formulas and are evaluated on the server side.
When the expression entered in this property evaluates to true, the field will be displayed. The evaluation of the expression occurs when the entity is generated, and not when the user is making modifications to fields on the block. (i.e. This does not "watch" user input in a field and dynamically hide a block; everything is locked in when the block is first output).
Example: $$VENDOR.ACTIVE$$ = 'N'
The block will be displayed when the value of the active field on the vendor block is N when the entity is generated.
Example: number( $$ORDER.TOTAL$$) = 0
Displays the block if the value of the total field on the order block is zero.
The code entered in this field can also include and/or expressions:
And is indicated by two ampersands &&
Or is indicated by two vertical lines ||

Example: ($$XEPHR_ENTITY_NAME$$='MENU')&&($$NEXTMENU$$='MM')
Show this block if the current entity is the MENU entity and the NEXTMENU global value is set to MM.

Example: ($$CUST_NO$$='NDS')||($$CUST_NO$$='')
Show this block if the customer number global is set to NDS, or the customer number global is null or doesn't exist.

In the Show if Empty pop-list, determine whether the block will be displayed when it is empty. When set to true, the block will be displayed on the screen even when it contains no data. When set to false, the block will be hidden when it contains no data.
In the Z Order property, enter a number to define the order in which the block will be generated on the entity. The higher the number, the later the block will be generated. The Z order is specific to the indention level in the entity tree, and is affected by the Y Anchor and Anchor Type properties.
The Created on property displays the date and time on which this block was created and cannot be changed.
The Modified on property displays the date and time on which this block was last changed and cannot be modified.
When all changes have been made, press the [Save] button in the Main Toolbar.

Xephr is a registered trademark of NDS Systems, LC.