Static Control Styles (Windows CE 5.0)

Send Feedback

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

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 in the rectangle. Windows CE 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 CE, 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_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 CE 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 CE 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

Control Styles | Window and Message Box Styles

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.