CGXGridParam Class Members
Construction
CGXGridParam | Constructs a parameter 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. |
Operations
operator= | Copies all settings from another parameter object. All embedded data objects (CGXData, CGXStylesMap, CGXProperties etc.) will also be copied. |
Serialization
Serialize | Serializes the parameter object. |
CreateFromFile | Instantiates a parameter object and initializes its data from a layout file. The layout file can be created with Objective Grid Designer. |
CreateFromResource | Instantiates a parameter object and initializes its data from a binary resource. |
WriteToFile | Writes the parameter object and all its object members to a layout file. |
Object Members
SetData | Attaches a data object to the parameter object. If the parameter object already owns a pointer to a data object, the old one is replaced and if necessary deleted. |
GetData | Returns a pointer to the data object. |
SetPrintDevice | Attaches a printer device object to the parameter object. If the parameter object already owns a pointer to a printer device object, the old one is replaced and if necessary deleted. |
GetPrintDevice | Returns a pointer to the print device object. |
SetProperties | Attaches a properties object to the parameter object. If the parameter object already owns a pointer to a properties object, the old one is replaced and if necessary deleted. |
GetProperties | Returns a pointer to the properties object. |
SetStylesMap | Attaches a styles map object to the parameter object. If the parameter object already owns a pointer to a styles map object, the old one is replaced and if necessary deleted. |
GetStylesMap | Returns a pointer to the styles map. |
GetCoveredCellsList | Returns a pointer to the covered cells list. |
GetRangeList | Returns a pointer to the selected ranges list. |
Undo/Redo
EnableUndo | Enables or disables generation of undo information in subsequent commands. If you do execute commands in OnInitialUpdate, you should first disable undo creation, execute the necessary commands and at last enable undo creation, so that the user cannot undo the initial settings. |
IsEnableUndo | TRUE if undo creation is enabled. |
GetUndoList | Returns a reference to the undo list. |
GetRedoList | Returns a reference to the redo list. |
EmptyRedoList | Removes and deletes all commands maintained by the redo list. |
EmptyUndoList | Removes and deletes all commands maintained by the undo list. |
Options
SetExcelLikeCurrentCell | Choose between the default Objective Grid and Excel-like behavior of the current cell. It is recommended that you also enable SetSyncCurrentCell and SetExcelLikeSelectionFrame if you enable SetExcelLikeCurrentCell. |
GetExcelLikeCurrentCell | Returns the setting that specifies whether the current cell uses (the default) Objective Grid or Excel-like behavior. |
SetExcelLikeSelectionFrame | Choose between only inverting selected cells or drawing a small frame around the selected range of cells as Excel does. It is recommended that you also enable SetSyncCurrentCell and SetExcelLikeCurrentCell if you enable SetExcelLikeSelectionFrame. |
GetExcelLikeSelectionFrame | Returns TRUE if a small frame shall be drawn around the selected range of cells. |
SetExcelLikeFillFlags | Enables Excel like auto fill with text or styles. |
GetExcelLikeFillFlags | Returns the Excel like auto fill setting. |
SetGridLineStyle | Choose between solid, dotted and dashed grid lines. |
GetGridLineStyle | Returns the type of grid lines to draw in the grid. |
SetNewGridLineMode | Choose between the old and the new grid line drawing. |
GetNewGridLineMode | Returns the grid line drawing mode. |
SetSmartResize | With smart resizing, the grid will redraw only those cells which were not visible before the user resizes the view. |
IsSmartResize | Returns TRUE if smart resizing is enabled. |
SetSortColsOnDblClk | Enable sorting the grid by a specific column when the user double-clicks on the header. |
GetSortColsOnDblClk | Returns TRUE if sorting the grid by a specific column when the user double-clicks on the header is enabled. |
SetSortRowsOnDblClk | Enable sorting the grid by a specific row when the user double-clicks on the header. |
GetSortRowsOnDblClk | Returns TRUE if sorting the grid by a specific row when the user double-clicks on the header is enabled. |
SetDrawWYSIWYG | Lets you specify if cells shall be drawn with respect to the current printer settings. |
IsDrawWYSIWYG | Determineswhether cells shall be drawn with respect to the current printer settings. |
SetEnterKeyAction | Lets you specify the default grid action when the user presses the ENTER key. The default is to move to the right cell. |
GetEnterKeyAction | Determinesthe default grid action when the user presses the ENTER key. |
SetUndoLimit | Lets you specify the maximum number of operations the grid shall hold in its undo list. Transactions will be handled like a single undo operation. |
GetUndoLimit | Returns the maximum number of operations the grid shall hold in its undo list. |
SetSyncCurrentCell | Enables or disables synchronizing current cell movements among views attached to the same document. |
IsSyncCurrentCell | Determineswhether synchronizing the current cell is enabled. |
SetSpecialMode | Enables the specified special mode. Call this method for using the grid as single or multiple selection list box. |
IsSpecialMode | Determineswhether the grid is in list box mode and the specified options are enabled. |
EnableChangeTab | Enables or disables changing the worksheet name by double-clicking on the associated tab in the tab beam. |
IsEnableChangeTab | Indicates if changing the tab is enabled. |
EnableMoveCols | Enables or disables moving columns by clicking the mouse on a selected column and dragging it to a new column. |
IsEnableMoveCols | Indicates if moving columns is enabled. |
EnableMoveRows | Enables or disables moving rows by clicking the mouse on a selected row and dragging it to a new row. |
IsEnableMoveRows | Indicates if moving rows is enabled. |
EnableSelection | Specifies the options available for the end user or disables selecting cells, rows, columns or the whole table with the keyboard or the mouse. |
IsEnableSelection | Determines if the end user can select cells and if the specified options are enabled. |
EnableThumbTrack | Enables or disables immediate scrolling of the grid when the user is dragging the scrollbar thumb. |
IsEnableThumbTrack | Indicates if the grid should scroll immediately when the user drags the scrollbar thumb. |
EnableTrackColWidth | Specifies the options or disables changing the column’s width by the end user. |
IsEnableTrackColWidth | Determines if the column’s width can be changed by the end user and the specified options are enabled. |
EnableTrackRowHeight | Specifies the options or disables changing the row’s height by the end user. |
IsEnableTrackRowHeight | Determines if the row’s height can be changed by the end user and the specified options are enabled. |
SetActivateCellFlags | Specifies options for activating/editing the current cell. Possible options are: after moving the cell, when clicking in the text, and when clicking on the cell. |
GetActivateCellFlags | Determines the options for activating/editing the current cell. |
SetDefaultComboBoxHeight | Specifies the default height for the CGXComboBox drop-down list box. |
GetDefaultComboBoxHeight | Returns the default height for the CGXComboBox drop-down list box. |
SetDrawOrder | Specifies whether cells should be loaded row by row or column by column when drawing. |
GetDrawOrder | Returns whether cells should be loaded row by row or column by column when drawing. |
SetEatFirstMouseClick | Specifies whether the grid view shall ignore the first mouse click when it gets activated. |
IsEatFirstMouseClick | Returns whether the grid view shall ignore the first mouse click when it gets activated. |
SetHideCurrentCell | Specifies options for hiding the frame of the current cell. Possible options are: never, when grid is inactive, or always. |
GetHideCurrentCell | Returns options for hiding the frame of the current cell. |
SetLockReadOnly | Call this method if you want to turn on/off the protection of read-only cells in the grid. |
IsLockReadOnly | Returns whether read-only cells in the grid are protected. |
SetMinTrackColWidth | Specifies the minimum width for columns when the end user is sizing them. |
GetMinTrackColWidth | Returns the minimum width for columns when the end user is sizing them. |
SetMinTrackRowHeight | Specifies the minimum height for rows when the end user is sizing them. |
GetMinTrackRowHeight | Returns the minimum height for rows when the end user is sizing them. |
SetNumberedColHeaders | Returns whether column headers are numbered (A,B,C,...) or if they depend on column information (e.g., a title for a column). If you display titles in column headers, you should set this attribute FALSE. This will increase performance when moving columns. |
SetNumberedRowHeaders | Specifies whether row headers are numbered (1,2,3,...) or if they depend on row information (e.g., a title for a row). If you display titles in row headers, you should set this attribute FALSE. This will increase performance when moving rows. |
IsNumberedColHeaders | Returns whether column headers are numbered (A,B,C,...) or if they depend on column information (e.g., a title for a column). |
IsNumberedRowHeaders | Returns whether row headers are numbered (1,2,3,...) or if they depend on row information (e.g., a title for a row). |
SetRemoveColsFlags | Specifies the type of undo information needed when removing columns. You can choose between none, column base styles, and cell contents. |
GetRemoveColsFlags | Returns the type of undo information needed when removing columns. |
SetRemoveRowsFlags | Specifies the type of undo information needed when removing rows. You can choose between none, row base styles, and cell contents. |
GetRemoveRowsFlags | Returns the type of undo information needed when removing rows. |
SetScrollLikeExcel | Specifies whether the grid should scroll when rows/columns are frozen and the user presses the left/up-arrow key on the first non-frozen column/row. |
IsScrollLikeExcel | Returns whether the grid should scroll when rows/columns are frozen and the user presses the left/up-arrow key on the first non-frozen column/row. |
SetSheetName | Specifies the sheet name for the grid if used in a workbook. |
GetSheetName | Returns the sheet name for the grid if used in a workbook. |
SetTransparentBackground | Specifies whether the background color for cells should be transparent. If TRUE, you could use a bitmap as background. |
IsTransparentBackground | Returns whether the background color for cells should be transparent. |
Control Factory
ImplementSerialize | Serialization: Provides implementation for serializing CGXGridParam, CGXProperties, CGXData and CGXStylesMap object. Forces also that the implementation for serializing style objects gets linked into the application or DLL. |
ImplementCopyOperator | Copy Parameter Object: Implements copy operator for CGXGridParamCGXProperties and CGXStylesMap. |
Attributes
m_bDirectCopyPaste | TRUE if data should be copied within the grid with the CopyCells method and not using the clipboard. FALSE if conventional clipboard copy/paste should be used. |
m_bDirectCutPaste | TRUE if data should be moved within the grid with the MoveCells method and not using the clipboard. When cutting cells, cells will only be marked as cut and cleared only when the user executes a Paste command. If m_bDirectCutPaste is FALSE the conventional clipboard cut/paste will be used. |
m_bDirectDragDrop | TRUE if data should be copied or moved with CopyCells or MoveCells. FALSE if conventional clipboard cut/copy/paste should be used. |
m_nDisplayExpression | Toggles the display of formula expressions in inactive cells: GX_EXPR_DISPLAYALWAYS will display formula expression in inactive cells; GX_EXPR_DISPLAYACTIVE will display formula expression only in the active current cell; GX_EXPR_DISPLAYNEVER will display no formula expressions at all. |