CGXProperties Class Members

Construction

 CGXProperties Constructs a property object.

Parent Grid

 Grid Returns a pointer to a CGXGridCore object that uses this stylesmap object. If the stylesmap object is shared by several grids, a pointer to the first CGXGridCore object is returned.

Attributes

 SetSection Specifies the name for the profile section where the object settings should be stored and loaded from.
 GetSection Returns a string with the name of the profile section.
 SetPrinting Changes the property object into printing-mode. Some methods return values depending on whether the object is in printing-mode.
 GetPrinting Returns whether the object is in printing-mode or not.

Attributes - Display

 SetMarkRowHeader Specifies if the row header for the row with the current cell should be drawn pressed.
 GetMarkRowHeader Returns the setting whether the row header for the row with the current cell should be drawn pressed.
 SetMarkColHeader Specifies if the column header for the column with the current cell should be drawn pressed.
 GetMarkColHeader Returns the setting whether the column header for the column with the current cell should be drawn pressed.
 SetDisplayHorzLines Specifies if horizontal lines should be drawn.
 GetDisplayHorzLines Returns the setting whether horizontal lines should be drawn.
 SetDisplayVertLines Specifies if vertical lines should be drawn.
 GetDisplayVertLines Returns the setting whether vertical lines should be drawn.
 SetDisplay3dButtons Specifies if row and column headers should be drawn raised (like a button) or normal.
 GetDisplay3dButtons Returns the setting whether row and column headers should be drawn raised (like a button) or normal.
 SetLastZoom Stores the default zooming factor into the property object.
 GetLastZoom Returns the default zooming factor.

Attributes - User properties and colors

 AddUserProperty Call this method to register a user property in the property-object.
 SetUserProperty Call this method to change the value of a specific user property.
 GetUserProperty Call this method to determine the value of a specific user property.
 AddColorProperty Call this method to register a new color property in the property-object.
 GetColor Returns the color for a specific color-property.
 SetColor Changes the color for a specific color-property.

Attributes - Printing

 SetMargins Specifies the print margins.
 GetMargins Returns print margins.
 SetPrintRowHeaders Specifies if row headers should be printed.
 GetPrintRowHeaders Returns the setting whether row headers should be printed.
 SetPrintColHeaders Specifies if column headers should be printed.
 GetPrintColHeaders Returns the setting whether column headers should be printed.
 SetPrintFrame Specifies if a frame should be drawn around the grid when printed.
 GetPrintFrame Returns the setting whether a frame should be drawn around the grid when printed.
 SetPrintHorzLines Specifies if horizontal lines should be printed.
 GetPrintHorzLines Returns the setting whether horizontal lines should be printed.
 SetPrintVertLines Specifies if vertical lines should be printed.
 GetPrintVertLines Returns the setting whether vertical lines should be printed.
 SetBlackWhite Specifies if the grid should be printed only with black and white colors.
 GetPrintBlackWhite Returns the setting whether the grid should be printed only with black and white colors.
 SetPageOrder Specifies the page-order for printing the grid. You can choose between row precedence or column precedence.
 GetPageOrder Returns the page-order setting for printing the grid.
 SetCenterHorizontal Specifies if the grid should be centered horizontally on the page when printing.
 GetCenterHorizontal Returns the setting whether the grid should be centered horizontally on the page when printing.
 SetCenterVertical Specifies if the grid should be centered vertically on the page when printing.
 GetCenterVertical Returns the setting whether the grid should be centered vertically on the page when printing.

Attributes - Header/Footer

 SetDistances Specifies the distances for the header to the top margin and for the footer to the bottom margin.
 GetDistances Returns the distances for the header to the top margin and for the footer to the bottom margin.
 SetFirstPage Specifies a page offset for printing the page number token. -1 if the page numbers should be the real page number. If greater or equal to 0, page numbering will start with this number.
 GetFirstPage Returns the page offset for printing the page number token.
 GetDataHeader Returns a reference to the CGXData-object with the header formatting.
 GetDataFooter Returns a reference to the CGXData-object with the footer formatting.

Operations

 AddDefaultUserProperties Register the default user properties in the property-object (e.g., the current cell’s border).
 WriteProfile Writes the property-object setting to the profile section specified with SetSection.
 ReadProfile Reads the settings from the profile section specified with SetSection.
 OnPrintHeaderAndFooter Called to print the header and footer for a grid view.
 GetTokenArgs Returns the argument-string for a token, if any. If there are no arguments, an empty string is returned.
 AddToken Call this method to register additional tokens, as for example “$D” for the current date. You can interpret this token at run time by overriding SubstTokenText.

Overridables

 SubstTokenText Override this method if you want to provide more tokens for the end user.

CGXProperties

Class Overview