NXKnowledge

Block UI Styler > Block Catalog > Numbers

Integer

The Integer block provides a control to input an integer number to the command. The block provides input validation error messages should the user enter a value outside the valid range specified by the Minimum and Maximum value block properties.

Adaptive Limit on Scale

Adaptive scale limits may be used when the application employs the block with both scale and entry field together (i.e., PresentationStyle = Scale or ScaleKeyIn). To make the adaptive behavior broadly applicable, the application can change the default scale factors if necessary.

The scale limits behave as follows:

  • The initial range is calculated from the initial value and the scale factors.
  • Lower limit: Lower scale factor multiplied by the initial value.
  • Upper limit: Upper scale factor multiplied by the initial value.
  • The pointer is located at the initial value within the calculated range.

(The exact default lower/upper scale-factor numeric constants could not be captured cleanly from the source table; consult the live doc page for the precise default multipliers.)

Block-specific properties

Property Name Description Access Property Type List of Values
BalloonTooltipImage Specifies the file name of the image displayed in the balloon tooltip. CIGS String Valid bitmap file name from the NX library (no suffix/extension needed), or complete path. Supports TIFF, PNG, GIF, JPEG, BMP.
BalloonTooltipLayout Specifies the location of text with respect to the image in the balloon tooltip. Applicable only when both text and image are specified. CIGS Enum Horizontal — default; text to the right of image. Vertical — text below image; use when image is >300px wide or width:height ratio > 4.
Increment Sets the spin arrow/keyboard accelerator increment when PresentationStyle is set to Spin. CSG Double Any Double value.
LineIncrement Specifies the value by which to increment the scale when the user presses Left/Right Arrow keys. Only available when PresentationStyle is Scale or ScaleKeyIn. CSG Double Any integer value less than MaximumValue.
MaximumValue Specifies the maximum allowed integer value. Any value greater than this is invalid. A value equal to this is valid if MaxInclusive is True. CSG Integer Any integer value.
MaxInclusive See MaximumValue. SG Logical TRUE / FALSE — whether a value exactly equal to the maximum is valid.
MinimumValue Specifies the minimum allowed integer value. Any value less than this is invalid. A value equal to this is valid if either MinInclusive is True or PresentationStyle is Scale or Spin. CSG Integer Any integer value.
MinInclusive See MinimumValue. SG Logical TRUE — an input value exactly equal to the minimum is valid. FALSE — it is invalid.
PageIncrement Specifies the value by which to increment the scale when the user presses Page Up/Page Dn. Only available when PresentationStyle is Scale or ScaleKeyIn. CSG Double Any integer value less than MaximumValue.
PresentationStyle Defines how the integer value is presented to the user. CIG Enum KeyIn — user enters value directly. Scale — user inputs via a slider. ScaleKeyIn — slider plus input field. Spin — user inputs in increments via keyboard accelerators or spin arrows next to the field.
ScaleLimits Specifies whether the scale max/min labels are visible. CIG Logical TRUE — show scale limit labels. FALSE — do not show.
ScaleMaxLimitLabel Specifies the string shown as the maximum scale limit. Default is the value of MaximumValue. Shown only if ScaleLimits is TRUE. CIG String Any string value.
ScaleMinLimitLabel Specifies the string shown as the minimum scale limit. Default is the value of MinimumValue. Shown only if ScaleLimits is TRUE. CIG String Any string value.
ShowScaleValue Specifies whether to show the current value based on scale location. CSG Logical TRUE — show the current value based on scale location. FALSE — do not show.
Value Specifies the integer value. CSG Integer Any integer value.
ComboOptions Specifies the drop-down values if PresentationStyle is "Combo" (note: Combo is not listed among the PresentationStyle enum values documented above, but this property exists per the property table — likely a related/legacy presentation mode). One value can be selected from the drop-down to set the block's value. CSG IntegerVector Array of any integer values.

Access column legend

Character Stands for Meaning
C Creation Modifiable interactively in Block UI Styler at design time.
I Initialize Modifiable at run time via NXOpen API, but only during the Initialize callback.
G Get Readable via NXOpen API in any callback.
S Set Modifiable at run time via NXOpen API in any callback.

Related Numbers blocks

Double, Expression, Linear Dimension, Angular Dimension, Radius Dimension, On Path Dimension, Integer Table, Double Table.

Source: https://docs.sw.siemens.com/en-US/doc/209349590/PL20220512394070742.blockstyler/bs_integer · retrieved 2026-07-07