SftPrintPreview/DLL 2.0 - Print Preview Control for C/C++

SFTPRINTPREVIEW_COLORS Structure

The SFTPRINTPREVIEW_COLORS structure is used with the GetCtlColors and SetCtlColors functions to define color attributes.

typedef struct tagSftPrintPreviewColors {
    COLORREF colorFg; // foreground color - not used
    COLORREF colorBg; // background color
    COLORREF colorPaper; // paper color
    COLORREF colorShadow; // page shadow
    COLORREF colorPageGap; // page gap
    COLORREF colorToolbar; // toolbar background color
    COLORREF colorSelected; // selected page frame color
    COLORREF colorMargin; // margin color
    COLORREF colorGutter; // gutter margin color
    COLORREF colorHeaderText, colorFooterText;// header, footer text color
    COLORREF colorHeaderLine, colorFooterLine;// header, footer line color
} SFTPRINTPREVIEW_COLORS, * LPSFTPRINTPREVIEW_COLORS;
typedef const SFTPRINTPREVIEW_COLORS * LPCSFTPRINTPREVIEW_COLORS;

Members

colorFg

Reserved for future use.

colorBg

Defines the background color of the area around displayed pages.

colorPaper

Defines the paper (background color) of displayed pages.

colorShadow

Defines the shadow color used for displayed pages.

colorPageGap

Defines the color used to fill the gap between displayed pages (when pages are paired).

colorToolbar

Defines the background color used for the built-in tool bar. If Windows themes are in effect, the color defined using the colorToolbar member is ignored.

colorSelected

Defines the color used to outline the current page, when multiple pages are displayed.

colorMargin

Defines the color used to shade the left, right, top, bottom margins when SFTPRINTPREVIEW_CONTROL, fShowAreas is set to TRUE.

colorGutter

Defines the color used to shade the gutter margin when SFTPRINTPREVIEW_CONTROL, fShowAreas is set to TRUE.

colorHeaderText

Defines the color used for the header text.

colorFooterText

Defines the color used for the footer text.

colorHeaderLine

Defines the color used for the line below the header. The line is only shown if SFTPRINTPREVIEW_CONTROL, fLineBelowHeader is TRUE.

colorFooterLine

Defines the color used for the line above the footer. The line is only shown if SFTPRINTPREVIEW_CONTROL, fLineAboveFooter is TRUE.

Comments

The SFTPRINTPREVIEW_COLORS structure is used with the GetCtlColors and SetCtlColors functions to define color attributes.

An RGB value or a GetSysColor index value can be specified for all color values. If a color index is used, the high-order bit must be set (e.g., COLOR_WINDOW | 0x80000000L).

Example

C

SFTPRINTPREVIEW_COLORS Colors;
SftPrintPreview_GetCtlColors(m_hwndPreview, &Colors);
Colors.colorPaper = RGB(255,255,255);
Colors.colorShadow = COLOR_BTNSHADOW | 0x80000000L;
SftPrintPreview_SetCtlColors(m_hwndPreview, &Colors);

C++

SFTPRINTPREVIEW_COLORS Colors;
m_Preview.GetCtlColors(&Colors);
Colors.colorPaper = RGB(255,255,255);
Colors.colorShadow = COLOR_BTNSHADOW | 0x80000000L;
m_Preview.SetCtlColors(&Colors);

See Also C/C++ API | C++ Classes | Notifications