Static Control Styles (Compact 2013)

3/28/2014

The following table shows the styles that are supported by Windows Embedded Compact.

Static control style

Description

SS_BITMAP

Specifies that a bitmap will be displayed in the static control. The text is the name of a bitmap that is defined elsewhere in the resource file, not a file name. The style ignores the nWidth and nHeight parameters; the control automatically sizes itself to accommodate the bitmap.

SS_CENTER

Specifies a simple rectangle and centers the error value text at the top of the rectangle. Windows Embedded Compact formats the text before display. The control automatically wraps words that extend past the end of a line to the beginning of the next centered line.

SS_CENTERIMAGE

Specifies that the midpoint of a static control with the SS_BITMAP or SS_ICON style will remain fixed when you resize the control. The four sides are adjusted to accommodate a new bitmap.

Unlike in previous versions of Windows Embedded Compact, this style bit no longer results in unused portions of the control being filled with the color of the top left pixel of the bitmap or icon. Unused portions of the control will remain the background color.

The SS_CENTERIMAGE style cannot be set by itself. It must always be set in combination (through a bitwise OR) with the SS_BITMAP style or the SS_ICON style.

Do not use SS_CENTERIMAGE for a static control that contains text.

SS_EDITCONTROL

Specifies that the static control duplicates the text-displaying characteristics of a multi-line edit control. Specifically, the average character width is calculated in the same manner as with an edit control, and the function does not display a partially visible last line.

SS_ICON

Specifies that an icon will be displayed in the static control. The text is the name of an icon defined elsewhere in the resource file, not a file name. The style ignores the nWidth and nHeight parameters; the icon automatically sizes itself.

SS_LEFT

Specifies a rectangle and left-aligns the text in the rectangle. Windows Embedded Compact formats the text before display. The control automatically wraps words that extend past the end of a line to the beginning of the next left-aligned line.

SS_LEFTNOWORDWRAP

Specifies a rectangle and left-aligns the text in the rectangle. Tabs are expanded, but words are not wrapped. Text that extends past the end of a line is clipped.

SS_NOPREFIX

Prevents interpretation of any ampersand (&) characters in the control's text as accelerator prefix characters.

An application can combine SS_NOPREFIX with other styles by using the bitwise OR (|) operator. This can be useful when file names or other strings that might contain an ampersand (&) must be displayed within a static control in a dialog box.

SS_NOTIFY

Sends the parent window the STN_CLICKED notification when the user clicks the control.

SS_RIGHT

Specifies a rectangle and right-aligns the specified text in the rectangle. Windows Embedded Compact formats the text before display. The control automatically wraps words that extend past the end of a line to the beginning of the next right-aligned line.

See Also

Reference

Control Styles
Window and Message Box Styles