Other Window Styles for Line Controls

InstallShield 2016

Project • This information applies to the following project types:

InstallScript
InstallScript MSI
InstallScript Object

The following window style options are available for line controls. For additional information, see the MSDN Library.

Window Styles for Line Controls

Value

Description

SS_SIMPLE

Specifies a simple rectangle and displays a single line of left-aligned text in the rectangle. The text line cannot be shortened or altered in any way. Also, if the control is disabled, the control does not gray its text.

SS_ETCHEDVERT

Draws the left and right edges of the static control using the EDGE_ETCHED edge style. For more information, see the DrawEdge Windows API function in the MSDN Library.

SS_ETCHEDFRAME

Draws the frame of the static control using the EDGE_ETCHED edge style. For more information, see the DrawEdge Windows API function in the MSDN Library.

SS_ETCHEDHORZ

Draws the top and bottom edges of the static control using the EDGE_ETCHED edge style. For more information, see the DrawEdge Windows API function in the MSDN Library.

SS_BLACKRECT

Specifies a rectangle filled with the current window frame color. This color is black in the default color scheme.

SS_BLACKFRAME

Specifies a box with a frame drawn in the same color as the window frames. This color is black in the default color scheme.

SS_WHITERECT

Specifies a rectangle filled with the current window background color. This color is white in the default color scheme.

SS_WHITEFRAME

Specifies a box with a frame drawn with the same color as the window background. This color is white in the default color scheme.

SS_GRAYRECT

Specifies a rectangle filled with the current screen background color. This color is gray in the default color scheme.

SS_GRAYFRAME

Specifies a box with a frame drawn with the same color as the screen background (desktop). This color is gray in the default color scheme.

WS_GROUP

Specifies the first control in a group of controls. All controls defined with this style after the first control belong to the same group.

WS_VSCROLL

Creates a window with a vertical scroll bar.

SS_NOTIFY

Sends the parent window STN_CLICKED, STN_DBLCLK, STN_DISABLE, and STN_ENABLE notification messages when the user clicks or double-clicks the control.

SS_REALSIZECONTROL

Adjusts the bitmap to fit the size of the static control. Certain display settings on a target machine can affect the size of the control area used to render an image, such as the system font or DPI scaling. This style bit automatically resizes bitmaps to fit their controls. This style is recommended instead of SS_REALSIZEIMAGE to support high DPI machines. Otherwise, the image may be clipped or not fill the entire control at runtime on some machines.

SS_RIGHTJUST

Specifies that the lower right corner of a static control with the SS_BITMAP or SS_ICON style is to remain fixed when the control is resized. Only the top and left sides are adjusted to accommodate a new bitmap or icon.

SS_CENTERIMAGE

Specifies that, if the bitmap or icon is smaller than the client area of the static control, the rest of the client area is filled with the color of the pixel in the top left corner of the bitmap or icon. If the static control contains a single line of text, the text is centered vertically in the client area of the control.

SS_REALSIZEIMAGE

Prevents a static icon or bitmap control (that is, static controls that have the SS_ICON or SS_BITMAP style) from being resized as it is loaded or drawn. If the icon or bitmap is larger than the destination area, the image is clipped.

SS_ENDELLIPSIS

If the end of a string does not fit in the rectangle, it is truncated and ellipses are added. If a word that is not at the end of the string goes beyond the limits of the rectangle, it is truncated without ellipses. Compare with SS_PATHELLIPSIS and SS_WORDELLIPSIS.

Note • SS_ENDELLIPSIS, SS_PATHELLIPSIS, and SS_WORDELLIPSIS are mutually exclusive.

SS_PATHELLIPSIS

Replaces characters in the middle of the string with ellipses so that the result fits in the specified rectangle. If the string contains backslash (\) characters, SS_PATHELLIPSIS preserves as much as possible of the text after the last backslash. Compare with SS_ENDELLIPSIS and SS_WORDELLIPSIS.

Note • SS_ENDELLIPSIS, SS_PATHELLIPSIS, and SS_WORDELLIPSIS are mutually exclusive.

SS_WORDELLIPSIS

Truncates any word that does not fit in the rectangle and adds ellipses. Compare with SS_ENDELLIPSIS and SS_PATHELLIPSIS.

Note • SS_ENDELLIPSIS, SS_PATHELLIPSIS, and SS_WORDELLIPSIS are mutually exclusive.

See Also