Label/Bitmap

The Label/Bitmap block provides a way to put a label or a bitmap on the command's dialog. It does not collect input to the command.

Notes

• If you wish to have both a bitmap and label in your dialog, you must create two separate Label/Bitmap blocks. A single Label/Bitmap block cannot manage the properties for both a label and a bitmap simultaneously.
• To display a label that has an ampersand (&), use a double ampersand (&&) to get the correct display. For example, GD&&T is displayed as GD&T.

Inherited general properties

The Label/Bitmap block also inherits the following general properties:

• BlockID
• Enable
• Group
• Label
• Show
• Expanded

Block-specific properties

Property Name	Description	Access	Property Type	List of Values
BalloonTooltipText	Specifies text for the balloon tooltip.	CIGS	String	Any string value. Type \n to specify a line feed in the text.
BalloonTooltipImage	Specifies a bitmap image. If the bitmap has multiple sizes, NX uses the 48x48 size. If you need an image with a different size, you must specify the suffix for the image in the required size. If you want to reference an image of a different file type that is not in NX, you must specify the file extension. You can also specify the complete path of an image file. NX supports the following image file formats: TIFF, PNG, GIF, JPEG, and 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 placed to the right of the image. Vertical — text placed below the image. Use when the image is more than 300 pixels wide or if the width-to-height ratio of the image is greater than 4.
Bitmap	Specifies the name of the Bitmap image used by this block. See Customizing Toolbar Bitmaps section for more on bitmaps.	CSG	String	Specify a valid bitmap file name from the NX library (suffix/extension not required), or the complete path of an image file. NX supports only the BMP format here.
HighQualityBitmap	Specifies whether to show the current bitmap with true color (24-bit).	CIG	Logical	TRUE — show with true color (24-bit). FALSE — do not.
Localize	Allows localization of the block Label. If the Label matches an English string in the NX string localization database and Localize is true, the Label is translated to the current locale language.	CIG	Logical	TRUE — translate the Label string. FALSE — do not translate.
Tooltip	Specifies the tooltip. The tooltip string is not localized but accepts non-English characters.	—	—	—
WordWrap	Specifies whether the Label string should be wrapped or not. Note: When WordWrap is TRUE, the Bitmap property is ignored. When WordWrap is FALSE and no value is given for Bitmap, the Label string displays without word wrapping.	CIG	Logical	TRUE — wrap the current Label string. FALSE — do not wrap.
DisplayBitmapLabel	Specifies whether to display both bitmap and label.	CSG	Logical	True — display both bitmap and label. False — display either bitmap or label.

Access column legend

The characters in the Access column mean:

Character	Stands for	Meaning
C	Creation	Property can be modified interactively in the Block UI Styler when designing the dialog box.
I	Initialize	Property can be modified at run time using the NXOpen API, but only during the Initialize callback.
G	Get	Property can be read using the NXOpen API in any callback.
S	Set	(implied — property can be set at run time using the NXOpen API in any callback)

(This Access-column legend — C/I/G/S — is shared across all Block UI Styler block property tables.)