cCJGrid
-------
Wraps the main grid control.
Construct_Object()
- Integer
hoFieldChooserPanel - Integer
hoDataSource - Integer
hoContextMenu - Handle
phoDataSourceObject handle properties....................
cCJGridDataSource object
- Handle
phoFieldChooserPanelField Chooser tool panel object
- Handle
phoHeaderContextMenu - Handle
phoContextMenu - Handle
phoContextMenuColumncolumn use for context menu
- Handle
phoReportToolTipInfomakes it easier to bind com objects
- Handle
phoToolTipContext - Handle
phoReportColumn - Handle
phoReportColumns - Handle
phoReportRecords - Handle
phoReportRecord - Handle
phoReportRecordItem - Handle
phoReportRecordItemMetrics - Handle
phoReportRow - Handle
phoReportRows - Handle
phoReportNavigator - Handle
phoReportPaintManager - Handle
phoImageManagerIcons - Handle[]
phoColumnObjectscollection of report column objects
- Boolean
pbSelectTextOnEditDetermines if text is selected when cell goes into edit mode, see ReportRecordItemEditOptions.SelectTextOnEdit, we apply this setting to every column by default.
- Variant
private_pvSelectedFontCOM object pointer of the selected cell's Font. This is maintained in OnComBeforeDrawRow.
- Integer
private_piSelectedTextColorcolor of the selected cell's text. This is maintained in OnComBeforeDrawRow.
- Integer
private_Colorsee cReportPaintManager.BackColor
- Boolean
private_Enabled_StateGets or sets a value indicating whether the ReportControl can respond to user interaction., see ReportControl.Enabled
- Boolean
private_pbAllowColumnRemoveSpecifies whether ReportColumns can be removed from the ReportControl, see ReportControl.AllowColumnRemove
- Boolean
private_pbAllowColumnReorderSpecifies whether ReportColumns can be reordered in the ReportControl, see ReportControl.AllowColumnReorder
- Boolean
private_pbAllowColumnResizeSpecifies whether ReportColumns can be resized, see ReportControl.AllowColumnResize
- Boolean
private_pbAllowEditAllows the text in all ReportRecordItems to be edited, see cReportControl.AllowEdit.
- Boolean
private_pbAutoColumnSizingSpecifies If AutoColumnSizing should be used. see ReportControl.AutoColumnSizing
- Boolean
private_pbEditOnClickDetermine whether a ReportRecorditem can be edited by single-clicking on the item., see ReportControl.EditOnClick
- Integer
private_pbFixedInplaceButtonHeightSpecifies whether the paint manager supports fixed height of in-place buttons, see ReportControl.FixedInplaceButtonHeight
- Boolean
private_pbFullColumnScrollingSpecifies whether full column scrolling will be used., see ReportControl.FullColumnScrolling
- Boolean
private_pbDrawGridForEmptySpaceGets or sets wether grid lines will be drawn after the body of rows to fill the empty space. See ReportPaintManager.DrawGridForEmptySpace.
- Boolean
private_pbGrayIfDisableSpecifies whether to draw the report using "normal" colors or standard Windows disabled colors when the report control disabled. See ReportPaintManager.GrayIfDisable.
- Boolean
private_pbHideSelectionDetermines whether the currently selected rows will remain shaded when the ReportControl loses focus. See ReportPaintManager.HideSelection.
- Boolean
private_pbHotTrackingGets\Set whether hot tracking is used While moving the mouse over the column header when using the "Explorer" or "Office 2003" column styles. See ReportPaintManager.HotTracking.
- Boolean
private_pbInitialSelectionEnableSpecifies whether the first row in the report will become selected when initially populated., see ReportControl.InitialSelectionEnable
- Boolean
private_pbMultipleSelectionSpecifies whether multiple ReportRows can be selected at the same Time in the grid, see cReportControl.MultipleSelection
- Boolean
private_pbMultiSelectionModeEnables/disables the multiple selection mode for the control., see ReportControl.MultiSelectionMode
- Boolean
private_pbSelectionEnableGets or sets whether rows will become selected when clicked or navigated with the arrow keys., see ReportControl.SelectionEnable
- Boolean
private_pbShowFooterShows\Hides the report column footer., see ReportControl.ShowFooter
- Boolean
private_pbShowHeaderThe ShowHeader Property is used to hide or display the Column Headers in the Report Control., see ReportControl.ShowHeader
- Boolean
private_pbShowNonActiveInPlaceButtonSpecifies whether to Show NonActive InPlace Buttons (Combo, Expand, Spin) all the Time. See ReportPaintManager.ShowNonActiveInPlaceButton.
- Boolean
private_pbShowRowFocusSpecifies whether to draw a focus rectangle around the focused row, see cReportControl.ShowRowFocus
- Boolean
private_pbUseAlternateRowBackgroundColorSpecifies whether to use the piAlternateRowBackgroundColor to color the background of every second row. See ReportPaintManager.UseAlternativeBackground.
- Boolean
private_pbUseColumnTextAlignmentThe UseColumnTextAlignment Property specifies whether the text in the column header will Use the ReportColumn.Alignment setting to align the header caption. See ReportPaintManager.UseColumnTextAlignment.
- Boolean
private_pbUseEditTextAlignmentSpecifies whether the ReportColumn.Alignment setting is automatically applied to items when in edit mode. See ReportPaintManager.UseEditTextAlignment.
- XTPReportBorderStyle
private_peBorderStyleThe type of border style that is placed around the ReportControl, see ReportControl.BorderStyle
- XTPReportColumnStyle
private_peColumnStyleStores the style used to display ReportColumn headers. See ReportPaintManager.ColumnStyle.
- XTPReportFreezeColsDividerStyle
private_peFreezeColsDividerStyleStyle of the freeze column divider. See ReportPaintManager.FreezeColsDividerStyle.
- XTPReportGridStyle
private_peHorizontalGridStyleStyle used to draw horizontal grid lines. See ReportPaintManager.HorizontalGridStyle.
- XTPToolTipStyle
private_peTooltipStyleThe Style Property gets\sets the style of the tool tip window. See TooltipContext.Style
- XTPReportGridStyle
private_peVerticalGridStylesee cReportPaintManager.VerticalGridStyle
- XTPReportWatermarkAlignment
private_peWatermarkAlignmentGets or sets the alignment of the watermark., see ReportControl.WatermarkAlignment
- Integer
private_piAlternateRowBackgroundColorThe background color of every second grid row. See ReportPaintManager.AlternativeBackgroundColor
- Integer
piDefaultAlternateRowBackColorUsed to store the COM Object's default. This is a workaround as setting this COM property to -1 does not work.
- Integer
private_piHScrollStepGets\sets the amount of pixels the report is scrolled when the horizontal scroll bar buttons are clicked., see ReportControl.HScrollStep
- Integer
private_piCaptionBackColorThe background color of the column headers. See ReportPaintManager.CaptionBackColor.
- Integer
private_piCaptionBackGradientColorDarkThe "Dark" color in the color gradient used for the background color of "normal" column headers. See ReportPaintManager.CaptionBackGradientColorDark.
- Integer
private_piCaptionBackGradientColorLightThe "Light" color in the color gradient used for the background color of "normal" column headers. See ReportPaintManager.CaptionBackGradientColorLight.
- Integer
private_piCaptionForeColorThe forecolor\caption color of the column headers. See ReportPaintManager.CaptionForeColor.
- Integer
private_piColumnHotGradientColorDarkThe "Dark" color in the color gradient used for the background color of "hot" column headers. See ReportPaintManager.ColumnHotGradientColorDark.
- Integer
private_piColumnHotGradientColorLightThe "Light" color in the color gradient used for the background color of "hot" column headers. See ReportPaintManager.ColumnHotGradientColorLight.
- Integer
private_piColumnPushedGradientColorDarkThe "Dark" color in the color gradient used for the background color of "pushed" column headers. See ReportPaintManager.ColumnPushedGradientColorDark.
- Integer
private_piColumnPushedGradientColorLightThe "Light" color in the color gradient used for the background color of "pushed" column headers. See ReportPaintManager.ColumnPushedGradientColorLight.
- Integer
private_piHeaderHeightMultipliernumber of fixed header rows (overrides cCJGridColumn.pbMultiLine), -1 or 0 = ignore.
- Integer
private_piFreezeColsDividerColorColor of the freeze column divider. See ReportPaintManager.FreezeColsDividerColor.
- Integer
private_piFreezeColumnsCountGets\Sets the Number of columns that are frozen when the report is scrolled horizontally., see ReportControl.FreezeColumnsCount
- Integer
private_piGridLineColorThe color used to draw grid lines. See ReportPaintManager.GridLineColor.
- Integer
private_piHighlightBackColorThe background color of selected rows. See ReportPaintManager.HighlightBackColor.
- Integer
private_piHighlightForeColorThe text color of selected rows. See ReportPaintManager.HighlightForeColor.
- Integer
private_piSelectedRowBackColorThe background color of selected rows when grid doees not have the focus. See ReportPaintManager.SelectedRowBackColor.
- Integer
private_piSelectedRowForeColorThe text color of selected rows when grid does not have the focus. See ReportPaintManager.SelectedRowForeColor.
- Integer
private_piHotDividerColorGets\sets the color of the arrows used to Show where a column can be dropped when dragging a column header. See ReportPaintManager.HotDividerColor.
- Integer
private_piTooltipBkColorGets\sets the background color of the tool tip window. See TooltipContext.TipBkColor
- Integer
private_piTooltipMaxWidthThe MaxTipWidth Property gets\sets the maximum tool tip width in pixels. See TooltipContext.MaxTipWidth
- Integer
private_piTooltipTextColorGets\sets the color of the text that is displayed in the tool tip window. See TooltipContext.TipTextColor
- String
private_psNoFieldsAvailableTextThe "No Fields Available" text message displayed in the Field Chooser when no Column Headers are present. See ReportPaintManager.NoFieldsAvailableText.
- String
private_psNoItemsTextThe "No Items" text message displayed in the ReportControl when there are no visible rows. See ReportPaintManager.NoItemsText.
- Integer
private_TextColorDefault grid text color. see cReportPaintManager.ForeColor
- Integer
private_piShadeSortColorDefault sorted column background. see cReportPaintManager.ShadeSortColor
- Boolean
private_pbShadeSortColumn - XTPReportDrawSortTriangleStyle
private_peDrawSortTriangleStyle - Boolean
pbNavigateOutOfEditModepbNavigateOutOfEditMode: Internal - Used to determine if the Tab, Shift Tab or Enter keys
were used to navigate out of a cell that was being edited. This property is used to stop
the navigated to cell from going into edit mode. See OnComRequestEdit.
- Integer
piLastImageIdUsed to assign sequential image IDs in the ImageManagerIcons object
- Integer
piTooltipMarginTop - Integer
piTooltipMarginLeft - Integer
piTooltipMarginBottom - Integer
piTooltipMarginRight - Integer
piBeginEditLockCount - String
psWatermarkInternal: Used to set up the grid's watermark during OnCreate.
- Integer
piWatermarkTransparencyInternal: Used to set up the grid's watermark during OnCreate.
- Boolean
pbValidateOnNext - Boolean
pbVirtualMode - Handle
phoCustomEdit - Handle
phoIdleHandler - Integer
piLastTopRowIndexlast topindex. Used to determine if scrolling in paint
- Integer
piLastVisibleRowCountlast visible row count. Used to determine if scrolling in paint
- Integer
piSelectedColumn - Integer
piLastKey - Integer
piLastKey2 - Integer
private_pbFocusSubItems - Integer
private_pbEditOnKeyNavigation - Boolean
pbInRowFocusChanging - Handle
phoDeferredFocusColumn - Integer
piDeferredRemoveRow - Boolean
pbNoFocusChangeCheck - Boolean
pbNeedsRedraw - Integer
piFocusCellBackColor(RGB(217,222,243)) // Background color of the focused cell. clNone means that if pbSelectionEnable is true then piSelectedRowBackColor is used.
- Integer
piFocusCellForeColorclBlack // text color of the focused cell. clNone means that if pbSelectionEnable is true then piSelectedRowForeColor is used.
- Integer
piFocusCellRectangleColorpen color of the focused cell rectangle. See pbUseFocusCellRectangle
- Boolean
pbUseFocusCellRectangledraw focus rectangle of selected cell. See piFocusCellRectangleColor.
- Boolean
pbUseFocusCellColorsdraw focus cell background using piFocusCellBackColor & piFocusCellForeColor
- Boolean
pbReadOnlycan change rows: in-place edit, save, delete, insert or append
- Boolean
pbAllowDeleteRowcan delete rows
- Boolean
pbAutoSaveattempt save on row change
- Boolean
pbAutoAppendappend new rows when in add mode
- Boolean
pbAllowAppendRowcan append a row to the end
- Boolean
pbAllowInsertRowcan insert rows
- String
psLayoutSectionthe developer must provide a unique string id for this.
- Boolean
pbRestoreLayout - Integer
piLayoutBuild - String
psOriginalLayout - String
psInstanceLayout - Boolean
pbHeaderReordersclick on header reorders
- Boolean
pbHeaderTogglesDirectionclick on header changes order direction
- Boolean
pbHeaderSelectsColumnclick on header sets this as the selected column
- Boolean
pbHeaderPromptsclick on header executes prompt if one exists
- Boolean
private_pbReverseOrderingcurrent direction of ordering
- Integer
peGridMouseStatusdetermines mouse down, up, moved status
- Integer
private_piSortColumntracks current sort column
- Integer
piCurrentEditColumntracks last column edited (including current edit)
- Handle
phoPriorScopeFocus - Handle
pbNeedPostEntering - Boolean
pbEditOnTyping - Boolean
pbBeginEditOnIdlewhen set true, OnIdle will start edit-mode if appropriate
Set(Integer iValue)
------------------------------------------------------------------------
Property Get/Set Methods................................................
------------------------------------------------------------------------
Color
The background color of the grid, see ReportPaintManager.BackColor
- Integer
hoPaintManager
- Integer
Color()
- Integer
iValue - Integer
hoPaintManager
Set(Integer bValue)
Enabled_State
Augmented to set/return ReportControl.Enabled
- Integer
Enabled_State()
- Boolean
bValue
Set(Boolean bValue)
pbAllowColumnRemove
Specifies whether ReportColumns can be removed from the ReportControl, see ReportControl.AllowColumnRemove
- Boolean
pbAllowColumnRemove()
- Boolean
bValue
Set(Boolean bValue)
pbAllowColumnReorder
Specifies whether ReportColumns can be reordered in the ReportControl, see ReportControl.AllowColumnReorder
- Boolean
pbAllowColumnReorder()
- Boolean
bValue
Set(Boolean bValue)
pbAllowColumnResize
Specifies whether ReportColumns can be resized, see ReportControl.AllowColumnResize
- Boolean
pbAllowColumnResize()
- Boolean
bValue
Set(Boolean bValue)
pbAllowEdit:
Allows the text in all cells to be edited by default. see cReportControl.AllowEdit
- Boolean
pbAllowEdit()
- Boolean
bValue
Set(Boolean bValue)
pbAutoColumnSizing
Specifies If AutoColumnSizing should be used, see ReportControl.AutoColumnSizing
- Boolean
pbAutoColumnSizing()
- Boolean
bValue
Set(Boolean bValue)
pbDrawGridForEmptySpace
Gets or sets wether grid lines will be drawn after the body of rows to fill the empty space. See ReportPaintManager.DrawGridForEmptySpace.
- Integer
hoPaintManager
- Boolean
pbDrawGridForEmptySpace()
- Boolean
bValue - Integer
hoPaintManager
Set(Boolean bValue)
pbEditOnClick
Determine whether a ReportRecorditem can be edited by single-clicking on the item., see ReportControl.EditOnClick
- Boolean
pbEditOnClick()
- Boolean
bValue
Set(Boolean bValue)
pbFixedInplaceButtonHeight
Specifies whether the paint manager supports fixed height of in-place buttons, see ReportControl.FixedInplaceButtonHeight
- Integer
hoPaintManager
- Boolean
pbFixedInplaceButtonHeight()
- Boolean
bValue - Integer
hoPaintManager
Set(Boolean bValue)
pbFocusSubItems:
If True, when a cell is clicked, the entire row will become highlighted except the individual cell that was clicked.
If False, the entire row will become highlighted when an item is clicked, including the item that was clicked.
Also controls the ability of the grid control to address individual cells.
See cReportControl.FocusSubItems
- Boolean
pbFocusSubItems()
- Boolean
bValue
Set(Boolean bValue)
pbFullColumnScrolling
Specifies whether full column scrolling will be used., see ReportControl.FullColumnScrolling
- Boolean
pbFullColumnScrolling()
- Boolean
bValue
Set(Boolean bValue)
pbGrayIfDisable
Specifies whether to draw the report using "normal" colors or standard Windows disabled colors when the report control disabled. See ReportPaintManager.GrayIfDisable.
- Integer
hoPaintManager
- Boolean
pbGrayIfDisable()
- Boolean
bValue - Integer
hoPaintManager
Set(Boolean bValue)
pbHideSelection
Determines whether the currently selected rows will remain shaded when the ReportControl loses focus. See ReportPaintManager.HideSelection.
- Integer
hoPaintManager
- Boolean
pbHideSelection()
- Boolean
bValue - Integer
hoPaintManager
Set(Boolean bValue)
pbHotTracking
Gets\Set whether hot tracking is used While moving the mouse over the column header when using the "Explorer" or "Office 2003" column styles. See ReportPaintManager.HotTracking.
- Integer
hoPaintManager
- Boolean
pbHotTracking()
- Boolean
bValue - Integer
hoPaintManager
Set(Boolean bValue)
pbInitialSelectionEnable
Specifies whether the first row in the report will become selected when initially populated., see ReportControl.InitialSelectionEnable
- Boolean
pbInitialSelectionEnable()
- Boolean
bValue
Set(Boolean bValue)
pbMultipleSelection:
Specifies whether multiple rows can be selected at the same time, see cReportControl.MultipleSelection
- Boolean
pbMultipleSelection()
- Boolean
bValue
Set(Boolean bValue)
pbMultiSelectionMode
Enables/disables the multiple selection mode for the control., see ReportControl.MultiSelectionMode
- Boolean
pbMultiSelectionMode()
- Boolean
bValue
Set(Boolean bValue)
pbSelectionEnable
Gets or sets whether rows will become selected when clicked or navigated with the arrow keys., see ReportControl.SelectionEnable
- Boolean
pbSelectionEnable()
- Boolean
bValue
Set(Boolean bValue)
pbShowNonActiveInPlaceButton
Specifies whether to Show NonActive InPlace Buttons (Combo, Expand, Spin) all the Time. See ReportPaintManager.ShowNonActiveInPlaceButton.
- Integer
hoPaintManager
- Boolean
pbShowNonActiveInPlaceButton()
- Boolean
bValue - Integer
hoPaintManager
Set(Boolean bValue)
pbShowRowFocus:
Specifies whether to draw a focus rectangle around the focused row, see cReportControl.ShowRowFocus
- Boolean
pbShowRowFocus()
- Boolean
bValue
Set(Boolean bValue)
pbShowFooter
Shows\Hides the report column footer., see ReportControl.ShowFooter
- Boolean
pbShowFooter()
- Boolean
bValue
Set(Boolean bValue)
pbShowHeader
The ShowHeader Property is used to hide or display the Column Headers in the Report Control., see ReportControl.ShowHeader
- Boolean
pbShowHeader()
- Boolean
bValue
Set(Boolean bValue)
pbEditOnKeyNavigation
Determines the behavior of Tab Key Navigation. When False, the default Grid control behavior is applied. When True,
the appication can trap the Tab key to alter its behavior.
See cReportControl.TrapTabKey
- Boolean
pbEditOnKeyNavigation()
- Boolean
bValue
Set(Boolean bValue)
pbUseAlternateRowBackgroundColor
Specifies whether to use the piAlternateRowBackgroundColor to color the background of every second row. See ReportPaintManager.UseAlternativeBackground.
- Integer
hoPaintManager
- Boolean
pbUseAlternateRowBackgroundColor()
- Boolean
bValue - Integer
hoPaintManager
Set(Boolean bValue)
pbUseColumnTextAlignment
The UseColumnTextAlignment Property specifies whether the text in the column header will Use the ReportColumn.Alignment setting to align the header caption. See ReportPaintManager.UseColumnTextAlignment.
- Integer
hoPaintManager
- Boolean
pbUseColumnTextAlignment()
- Boolean
bValue - Integer
hoPaintManager
Set(Boolean bValue)
pbUseEditTextAlignment
Specifies whether the ReportColumn.Alignment setting is automatically applied to items when in edit mode. See ReportPaintManager.UseEditTextAlignment.
- Integer
hoPaintManager
- Boolean
pbUseEditTextAlignment()
- Boolean
bValue - Integer
hoPaintManager
Set(XTPReportBorderStyle eValue)
peBorderStyle
The type of border style that is placed around the ReportControl, see ReportControl.BorderStyle
- XTPReportBorderStyle
peBorderStyle()
- Integer
eValue
Set(XTPReportColumnStyle iValue)
peColumnStyle
Stores the style used to display ReportColumn headers. See ReportPaintManager.ColumnStyle.
- Integer
hoPaintManager
- XTPReportColumnStyle
peColumnStyle()
- Integer
iValue - Integer
hoPaintManager
Set(XTPReportFreezeColsDividerStyle iValue)
peFreezeColsDividerStyle
Style of the freeze column divider. See ReportPaintManager.FreezeColsDividerStyle.
- Integer
hoPaintManager
- XTPReportFreezeColsDividerStyle
peFreezeColsDividerStyle()
- Integer
iValue - Integer
hoPaintManager
Set(XTPReportGridStyle iValue)
peHorizontalGridStyle:
Style used to draw horizontal grid lines. See ReportPaintManager.HorizontalGridStyle.
- Integer
hoPaintManager
- XTPReportGridStyle
peHorizontalGridStyle()
- Integer
iValue - Integer
hoPaintManager
Set(XTPToolTipStyle iValue)
peTooltipStyle
The Style Property gets\sets the style of the tool tip window. See TooltipContext.Style.
- Integer
hoTooltipContext
- XTPToolTipStyle
peTooltipStyle()
- Integer
iValue - Integer
hoToolTipContext
Set(XTPReportGridStyle iValue)
peVerticalGridStyle:
Style used to draw vertical grid lines, see cReportPaintManager.VerticalGridStyle
- Integer
hoPaintManager
- XTPReportGridStyle
peVerticalGridStyle()
- Integer
iValue - Integer
hoPaintManager
Set(XTPReportWatermarkAlignment eValue)
peWatermarkAlignment
Gets or sets the alignment of the watermark., see ReportControl.WatermarkAlignment
- XTPReportWatermarkAlignment
peWatermarkAlignment()
- Integer
eValue
Set(Integer iValue)
piAlternateRowBackgroundColor
The background color of every second grid row. See ReportPaintManager.AlternativeBackgroundColor
- Integer
hoPaintManager
- Integer
piAlternateRowBackgroundColor()
- Integer
iValue - Integer
hoPaintManager
Set(Integer iValue)
piCaptionBackColor
The background color of the column headers. See ReportPaintManager.CaptionBackColor.
- Integer
hoPaintManager
- Integer
piCaptionBackColor()
- Integer
iValue - Integer
hoPaintManager
Set(Integer iValue)
piCaptionBackGradientColorDark
The "Dark" color in the color gradient used for the background color of "normal" column headers. See ReportPaintManager.CaptionBackGradientColorDark.
- Integer
hoPaintManager
- Integer
piCaptionBackGradientColorDark()
- Integer
iValue - Integer
hoPaintManager
Set(Integer iValue)
piCaptionBackGradientColorLight
The "Light" color in the color gradient used for the background color of "normal" column headers. See ReportPaintManager.CaptionBackGradientColorLight.
- Integer
hoPaintManager
- Integer
piCaptionBackGradientColorLight()
- Integer
iValue - Integer
hoPaintManager
Set(Integer iValue)
piCaptionForeColor
The forecolor\caption color of the column headers. See ReportPaintManager.CaptionForeColor.
- Integer
hoPaintManager
- Integer
piCaptionForeColor()
- Integer
iValue - Integer
hoPaintManager
Set(Integer iValue)
piColumnHotGradientColorDark
The "Dark" color in the color gradient used for the background color of "hot" column headers. See ReportPaintManager.ColumnHotGradientColorDark.
- Integer
hoPaintManager
- Integer
piColumnHotGradientColorDark()
- Integer
iValue - Integer
hoPaintManager
Set(Integer iValue)
piColumnHotGradientColorLight
The "Light" color in the color gradient used for the background color of "hot" column headers. See ReportPaintManager.ColumnHotGradientColorLight.
- Integer
hoPaintManager
- Integer
piColumnHotGradientColorLight()
- Integer
iValue - Integer
hoPaintManager
Set(Integer iValue)
piColumnPushedGradientColorDark
The "Dark" color in the color gradient used for the background color of "pushed" column headers. See ReportPaintManager.ColumnPushedGradientColorDark.
- Integer
hoPaintManager
- Integer
piColumnPushedGradientColorDark()
- Integer
iValue - Integer
hoPaintManager
Set(Integer iValue)
piColumnPushedGradientColorLight
The "Light" color in the color gradient used for the background color of "pushed" column headers. See ReportPaintManager.ColumnPushedGradientColorLight.
- Integer
hoPaintManager
- Integer
piColumnPushedGradientColorLight()
- Integer
iValue - Integer
hoPaintManager
Set(Integer iValue)
piHeaderHeightMultiplier
Determines the height of the report header section in lines of text. See ReportFormulaMulDivC.Multiplier.
If this value = -1 or 0 then it is ignored and the header height is one text line by default,
unless one of the grid columns has pbMultiLine set to True in which case the header height
is determined by the tallest column header.
- Integer
hoPaintManager - Integer
hoFormula - Variant
vFormula - Boolean
bMultiLineHeader
- Integer
piHeaderHeightMultiplier()
- Integer
iValue
Set(Integer iValue)
piFreezeColsDividerColor
Color of the freeze column divider. See ReportPaintManager.FreezeColsDividerColor.
- Integer
hoPaintManager
- Integer
piFreezeColsDividerColor()
- Integer
iValue - Integer
hoPaintManager
Set(Integer iValue)
piFreezeColumnsCount
Gets\Sets the Number of columns that are frozen when the report is scrolled horizontally., see ReportControl.FreezeColumnsCount
- Integer
piFreezeColumnsCount()
- Integer
iValue
Set(Integer iValue)
piGridLineColor
The color used to draw grid lines. See ReportPaintManager.GridLineColor.
- Integer
hoPaintManager
- Integer
piGridLineColor()
- Integer
iValue - Integer
hoPaintManager
Set(Integer iValue)
piHighlightBackColor
The background color of selected rows. See ReportPaintManager.HighlightBackColor.
- Integer
hoPaintManager - Integer
iSelectedRowColor
- Integer
piHighlightBackColor()
- Integer
iValue - Integer
hoPaintManager
Set(Integer iValue)
piHighlightForeColor
The text color of selected rows. See ReportPaintManager.HighlightForeColor.
- Integer
hoPaintManager - Integer
iSelectedRowColor
- Integer
piHighlightForeColor()
- Integer
iValue - Integer
hoPaintManager
Set(Integer iValue)
piSelectedRowBackColor
The background color of selected rows when grid doees not have the focus. See ReportPaintManager.SelectedRowBackColor.
- Integer
hoPaintManager
- Integer
piSelectedRowBackColor()
- Integer
iValue - Integer
hoPaintManager
Set(Integer iValue)
piSelectedRowForeColor
The text color of selected rows when grid does not have the focus. See ReportPaintManager.SelectedRowForeColor.
- Integer
hoPaintManager
- Integer
piSelectedRowForeColor()
- Integer
iValue - Integer
hoPaintManager
Set(Integer iValue)
piHotDividerColor
Gets\sets the color of the arrows used to Show where a column can be dropped when dragging a column header. See ReportPaintManager.HotDividerColor.
- Integer
hoPaintManager
- Integer
piHotDividerColor()
- Integer
iValue - Integer
hoPaintManager
Set(Integer iValue)
piHScrollStep
Gets\sets the amount of pixels the report is scrolled when the horizontal scroll bar buttons are clicked., see ReportControl.HScrollStep
- Integer
piHScrollStep()
- Integer
iValue
Set(Integer iValue)
piTooltipBkColor
Gets\sets the background color of the tool tip window. See TooltipContext.TipBkColor
- Integer
hoTooltipContext
- Integer
piTooltipBkColor()
- Integer
iValue - Integer
hoTooltipContext
Set(Integer iValue)
piTooltipMaxWidth
The MaxTipWidth Property gets\sets the maximum tool tip width in pixels. See TooltipContext.MaxTipWidth.
- Integer
hoTooltipContext
- Integer
piTooltipMaxWidth()
- Integer
iValue - Integer
hoTooltipContext
Set(Integer iValue)
piTooltipTextColor
Gets\sets the color of the text that is displayed in the tool tip window. See TooltipContext.TipTextColor.
- Integer
hoTooltipContext
- Integer
piTooltipTextColor()
- Integer
iValue - Integer
hoTooltipContext
Set(String sValue)
psNoFieldsAvailableText
The "No Fields Available" text message displayed in the Field Chooser when no Column Headers are present. See ReportPaintManager.NoFieldsAvailableText.
- Integer
hoPaintManager
- String
psNoFieldsAvailableText()
- String
sValue - Integer
hoPaintManager
Set(String sValue)
psNoItemsText
The "No Items" text message displayed in the ReportControl when there are no visible rows. See ReportPaintManager.NoItemsText.
- Integer
hoPaintManager
- String
psNoItemsText()
- String
sValue - Integer
hoPaintManager
Set(Integer iValue)
TextColor:
The foreground\text color of the grid, see ReportPaintManager.ForeColor
- Integer
hoPaintManager
- Integer
TextColor()
- Integer
iValue - Integer
hoPaintManager
Set(Integer iValue)
piShadeSortColor:
- Integer
hoPaintManager
- Integer
piShadeSortColor()
- Integer
iValue - Integer
hoPaintManager
Set(Boolean bValue)
pbShadeSortColumn:
- Integer
hoPaintManager
- Boolean
pbShadeSortColumn()
- Boolean
bValue - Integer
hoPaintManager
Set(XTPReportDrawSortTriangleStyle eStyle)
peDrawSortTriangleStyle:
- Integer
hoPaintManager
- XTPReportDrawSortTriangleStyle
peDrawSortTriangleStyle()
- Integer
eStyle - Integer
hoPaintManager
- Integer
ConvertSystemColor(Integer iColor)
------------------------------------------------------------------------
Methods.................................................................
------------------------------------------------------------------------
- Integer
iSysColor
ActivateFieldChooser()
ActivateFieldChooser:
Send this message to popup a field chooser object.
- Integer
hoFieldChooserPanel
- Integer
AddImageType(Boolean bIsIcon String sImage Integer iId)
AddImageType:
Adds an image to imagelist. Pass if bmp or icon, the image name and the Id and image type (normal, disabled, etc.)
With Bitmaps this will first look for the resource then search for the file in the file path.
With Icons it checks for the file first (explained below)
return Image Id if success
- Integer
hBitmap - Variant
vIcons - Integer
hoIcons - Integer
iVoid - Boolean
bOk - String
sFileImage
- Integer
AddImage(String sImage Integer iId)
AddImage
Adds an image to imagelist.
We assume that this is an icon unless the .bmp extension is passed.
return True if success
- Boolean
bIsIcon
AllowMultiLineCells()
AllowMultiLineCells
Send this message to enable multi line cells in the grid. (usually this message is sent by a column object
when it's pbMultiLine property is set to true.
- Integer
hoPaintManager
- Boolean
CreateDataSource()
CreateDataSource
Called by constructor to create a datasource
- Integer
hoDataSource
- Handle
CreateHeaderContextMenu()
CreateHeaderContextMenu
Called by constructor to create a header context menu. Can be augmented
create a different object or none at all
- Integer
hoMenu - Integer
hoMenu1
- Handle
CreateContextMenu()
CreateContextMenu
Called by constructor to create a regular context grid menu. Can be augmented
create a different object or none at all. By default this creates nothing
- Handle
CreateFieldChooserPanel()
CreateFieldChooserPanel
Called by constructor to create a field chooser panel. Can be augmented
create a different object or none at all
- Integer
hoFieldChooserPanel
AttachFieldChooser(Handle hoFieldChooser Boolean bAttach)
AttachFieldChooser
Send this message to attach a field chooser object to the Grid. See ReportControl.FieldChooser
hoFieldChooser - is the object handle of the cCJGridFieldChooser control. The field chooser's COM object
should be already created before sending this message.
- Variant
vFieldChooser
- Boolean
CanCopy()
CanCopy
Indicates whether a Copy operation can be performed., see ReportControl.CanCopy
- Boolean
bValue
- Boolean
CanCut()
CanCut
Indicates whether a Cut operation can be performed., see ReportControl.CanCut
- Boolean
bValue
- Boolean
CanPaste()
CanPaste
Indicates whether a Paste operation can be performed., see ReportControl.CanPaste
- Boolean
bValue
Set(Integer i1 Integer i2)
Dynamic_Colors
We need to kill this procedure, else the procedures
Set Color and Set TextColor wont work. (Internal VDF behaviour).
OnComBeforeDrawRow(Variant llRow Variant llItem Variant llMetrics)
OnComBeforeDrawRow
- Integer
hoItem - Integer
hoRow - Integer
hoMetrics - Integer
iSize - Integer
iTop - Integer
iLastTop - Integer
iRowOffset - Integer
iLastRowOffset - Integer
iLastVisibleRowCount - Integer
iVisRows - Integer
iRow - Integer
iCol - Integer
iSelectedRow - Integer
iSelectedCol - Integer
iBackColor - Integer
iForeColor - Integer
iFocusedColumnIndex - String
sValue - Integer
hoDataSource - Integer
hoColumn - Integer
hoFocus - Boolean
bCheckbox - Boolean
bChecked - Boolean
bFocusable - Boolean
bUseFocusCell - Boolean
bSelectionEnable - Boolean
bGridIsFocus - Boolean
bHideSelection - Boolean
bSelected - Boolean
bFauxSelection - Boolean
bCustomEdit - Variant
vFont - Integer
hoEdit - Integer
iSizeX - Integer
iSizeY - Integer
iLocX - Integer
iLocY - Integer
iGuiLoc - Integer
iGuiLocX - Integer
iGuiSize - Integer
iGuiSizeX
OnComRowRClick(Variant llRow Variant llItem)
OnComRowRClick
Augmented to handle popping up a context menu....
- Integer
hoReportRow - Integer
hoReportItem - Integer
iRow - Integer
iCol - Boolean
bPostEntering
OnComRowDblClick(Variant llRow Variant llItem)
Augmented to send OnRowDoubleClick
- Integer
hoReportRow - Integer
hoReportItem - Integer
iRow - Integer
iCol
OnComDrawItem(Variant llRow Variant llColumn Variant llItem OLE_HANDLE hDC Integer iLeft Integer iTop Integer iRight Integer iBottom Boolean ByRef llDoDefault)
OnComDrawItem
Augmented to draw a rectangle around the "focused cell".
- Variant
vFocusedColumn - Variant
vFocusedRow - Variant
vRow - Boolean
bVoid - Boolean
bUseFocusCell - Boolean
bContainsFocus - Integer
eHorizontalGrid - Integer
eVerticalGrid - Integer
iVoid - Integer
iRow - Integer
iFocusedRow - Integer
iFocusedCol - Integer
iCol - Integer
iPenColor - Integer
hPen - Integer
hPenOld - Integer
hoRow - Integer
hoRowCollection - Integer
hoItem - Integer
hoDataSource - Integer
lpOrigin - tWinPoint
Origin - tWinRect
ARect
OnComFocusChanging(Variant llNewRow Variant llNewColumn Variant llNewItem Boolean ByRef llCancel)
OnComFocusChanging
use this to synch the focus row with the datasource's selectrow
Thi gets called first to move to column (if needed) and then it is called to move the row (if needed). If col
is canceled, it is called to mvoe the row with the current column.
- Integer
iIndex - Integer
iOldRow - Integer
iOldCol - Integer
iCol - Integer
hoReportRow - Integer
hoItem - Boolean
bSelect - Boolean
bInFocusChanging - Boolean
bNoFocusChangeCheck - Boolean
bPostEntering - Boolean
bEdit - Integer
hoDataSource - Integer
hoRows - Variant
vRows
OnComGetToolTipInfo(Variant lltoolTipInfo)
OnComGetToolTipInfo
Send tooltip event to the appropriate column object.
- Variant
vRow - Variant
vItem - Variant
vColumn - Integer
hoTooltipInfo - Integer
hoColumnObject - Integer
hoRow - Integer
hoItem - String
sText - String
sValue - Integer
iRow - Integer
iItemIndex
OnComItemCheck(Variant llRow Variant llItem)
OnComItemCheck
- Integer
hoRow - Integer
hoItem - Integer
iRow - Integer
iColumn - Boolean
bAllowEdit
OnComKeyDown(Short ByRef llKeyCode Short llShift)
OnComKeyDown
- Boolean
bInEdit
OnComPreviewKeyDown(Short ByRef iKeyCode Short iShift Boolean ByRef bCancel)
OnComPreviewKeyDown
Handle keyboard navigation duties. Triggered after a key is pressed down but before it is processed.
- Integer
hoNavigator - Boolean
bEditMode - Boolean
bFocusSub
GetCustomEditSizeAndLocation(Handle hoRow Variant llItem Integer ByRef iSizeY Integer ByRef iSizeX Integer ByRef iLocY Integer ByRef iLocX)
this returns by reference the GUI size and location for the edit control.
- Integer
iL - Integer
iT - Integer
iR - Integer
iB - Integer
iEL - Integer
iET - Integer
iER - Integer
iEB - Integer
iGuiLoc - Integer
iGuiLocX - Integer
iGuiLocY
OnComRequestEdit(Variant llRow Variant llColumn Variant llItem Boolean ByRef llCancel)
- Integer
hoRow - Integer
hoItem - Integer
hoCol - Integer
hoForm - Integer
iLocX - Integer
iLocY - Integer
iSizeX - Integer
iSizeY - Integer
iRow - Integer
iCol - Integer
iKey - Integer
iVoid - Integer
iKey2 - Integer
iChar - Integer
hoReportColumn - Integer
hoReportRow - Integer
hoReportItem - Integer
hWnd - Integer
hoFont - Variant
vFont - String
sTypeFace - Integer
iFontSize - Integer
iWeight - Integer
iColor - Integer
iTextColor - Boolean
bItalic - Boolean
bUnderline - Boolean
bSubFocus - Boolean
bCancel - Boolean
bOk - Boolean
bIsCutCopyPaste
- Integer
GetVKeyToAnsi(Integer iVKey Integer iShiftBits)
convert current key press from keydown to ANSI character. Returns 0 in a char
- Integer
iCapsLock - Integer
iAnsi
OnComValueChanged(Variant llRow Variant llColumn Variant llItem)
OnComValueChanged
- Integer
hoRow - Integer
hoItem - Integer
iRow - Integer
iColumn - String
sValue
OnComMouseDown(Short llButton Short llShift Integer llx Integer lly)
OnComMouseDown
augmented to set internal property to false, which may get reset in OnComColumnOrderChangedEx
- Integer
hoFocus
OnComMouseUp(Short llButton Short llShift Integer llx Integer lly)
OnComMouseUp
augment to handle mouse header click
- Integer
hoHitTest - Integer
hoReportColumn - Variant
vHit - Variant
vCol - Integer
iCol - Integer
eHt - Boolean
bPostEntering - Integer
eMouse
OnComColumnOrderChangedEx(Variant llColumn XTPReportColumnOrderChangedReason llReason)
OnComColumnOrderChangedEx
augmented so we know that a header click did resulted in some kind of column move. When this happens
we don't want to treat a mouse up as a simple mouse click
OnCreate()
OnCreate
Called when the COM object is created.
make this private. Use OnCreateGridControl for custom event
OnCreateGridControl()
OnCreateGridControl
OnIdle()
OnIdle
- Boolean
bDirty - Boolean
bCancel - Boolean
bNeedsRedraw - Boolean
bNeedsPostEntry - Integer
hoDataSource - Integer
hoCol - Integer
iRow
BeginEditOnIdle()
OnIdle is done and needs to check if the edit control should take the focus.
We set the focus if pbBeginEditOnIdle is true (set by activate) and the grid has
the focus. ResetEditMode may not activate the edit control. This only does something if
pbEditOnNavigate/pbEditOnClick is true (i.e., aggressive edit mode)
- Boolean
bBeginEdit - Integer
hoFoc
ComRedraw()
- Boolean
OnRowChanging(Integer iCurrentSelectedRow Integer iNewRow)
called before row change. iCurrentSelectedRow is the SelectedRow. Return True to cancel
OnRowChanged(Integer iOldRow Integer iNewSelectedRow)
called after the row change has succeeded. iNewSelectedRow is now the SelectedRow
OnEnterKey()
- Boolean
bEditOnKeyNavigate
OnEscKey()
- Boolean
bIsEdit
Request_Cancel()
OnRelease()
OnRelease
OnHeaderClick(Integer iCol)
- Boolean
bSelectCol - Boolean
bFocusSub - Boolean
bPrompt - Boolean
bCancel - Integer
hoCol - Integer
hoPrompt - Integer
iSel
OnUnknownAreaClick(Integer iX Integer iY)
Handle popping up a click in an unknown area. If autoappend is allowed we will attempt to append
a row to the end of the table. This can be easily cancelled.
- Boolean
bEnterOnClick - Integer
iEL - Integer
iET - Integer
iER - Integer
iEB - Integer
eHt - Integer
iRow - Integer
iBottomRow - Integer
hoHitTest - Integer
hoDatasource - Integer
hoReportRow - Variant
vHit - Variant
vRow
OnHeaderRightClick(Integer iCol)
OnHeaderRightClick
Handle poping up a header context menu
- Integer
hoHeaderContextMenu - Integer
hoReportColumn - Integer
hoColumn - Integer
iIndex
OnRowDoubleClick(Integer iRow Integer iCol)
OnRowRightClick(Integer iRow Integer iCol)
Handle popping up a context menu over a row
- Integer
hoContextMenu - Integer
hoColumn - Integer
hoDataSource - Integer
iSelRow - Integer
iSelCol - Boolean
bFocusSub - Boolean
bCancel
- Boolean
OnExiting(Handle hoDestination)
OnEntering()
- Boolean
OnPostEntering()
OnWrappingRow(Boolean bForwardWrap Handle hoToColumn Boolean ByRef bWrapRow Boolean ByRef bCancel)
When next or previous results in a wrap you can choose to cancel (set bCancel True)
stay within the row (set bWrapRow to False) or activate some other object, row, or column
(just do it and set bCancel True)
RegisterColumn(Handle hoColumn)
RegisterColumn:
Registers a column object in the columns collection.
- Integer
iSize - Integer[]
hoColumnObjects
DeferredRedraw()
tells grid to redraw when idle
- Boolean
RowChange(Integer iNew)
RowChange
handles possible row change. returns false to cancel
- Integer
hoDataSource - Integer
iOld - Integer
iOldCol - Boolean
bCancel - Boolean
bOldCancel
- Integer
SelectedColumn()
SelectedColumn
Call this to get the index of the currently focused column.
- Integer
iIndex - Integer
iRow - Integer
hoDataSource
SetTooltipMargin(Integer iLeft Integer iTop Integer iRight Integer iBottom)
SetTooltipMargin
sets the top, left, bottom, and right margins of the tool tip window. This is the "padding" that is placed around
the tool tip text in the tool tip window.
- Integer
hoTooltipContext
SetWatermark(String sImage Integer iTransparency)
SetWatermark
Sets a watermark bitmap to be shown in the report control background using a bitmap from file or resource.
sImage - Is the resource image name or the image filename.
iTransparency - Level of transparency. Values can be 0-255 with 0 being totally transparent and 255 being totally visible.
- Integer
hBitmap - Integer
iVoid - Boolean
bOk - String
sFileImage
- Handle[]
ColumnObjectsInDisplayOrder()
ColumnObjectsInDisplayOrder
return array of column objects in display order.
This will include non visible objects so you may have to test if the object is visible
- Integer[]
ItemsArrays - Integer[]
ColumnObjects - Integer
iDisplayIndex - Integer
iCols - Integer
iColIndex - Integer
hoReportColumns - Integer
hoReportColumn - Variant
vCol
- Integer
EstimateVisibleRowCount(Handle hoRow Variant llItem)
Must be called from BeforeDrawRow passing the row object and recorditem com pointer.
If variable length row, we change to guess.
- Integer
iTop - Integer
iLeft - Integer
iBottom - Integer
iRight - Integer
iRowTop - Integer
iRowBottom - Integer
iRowLeft - Integer
iRowRight - Integer
iTopRow - Integer
iRowHeight - Integer
iRowCount - Integer
iGridHeight - Integer
iVisibleCount - Number
nVisibleCount - Integer
hoPaintManager - Boolean
bFixedHeight
NewColumn(Integer iColumn)
Selects column without entering exiting messages.
Note that this sets SelectedColumn but it does not synch this with
the grid's focus column. If you misuse this, things will not work
- Integer
hoDataSource - Integer
iRow - Integer
iCount
- Boolean
ForceColumnExit()
Does a column exit without changing the current column.
Is used to force the column exiting events without changing
the column (used during object exiting)
- Integer
iOld - Boolean
bCancel
- Boolean
ColumnChange(Integer iNew)
changes the column
- Boolean
bCancel - Boolean
bIsFocus - Integer
iOld - Integer
hoFocus
- Boolean
ColumnChanging(Integer iOld Integer iNew)
this provides room for us to work within
- Boolean
bCancel - Integer
hoCol
ColumnChanged(Integer iOld Integer iNew)
this provides room for us to work within
- Integer
hoCol
CreateGridControl()
- Variant
vComObject - Variant
vItem - Variant
vEditOptions - Variant
vConstraints - Variant
vFormula - Integer
hoObject - Integer
hoReportColumns - Integer
hoDataSource - Integer
hoPaintManager - Integer
hoColumn - Integer
hoToolTipContext - Integer
hoFormula - Integer
hoReportRecord - Integer
hoReportRecords - Integer
hoReportRows - Integer
hoEditOptions - Integer
hoConstraints - Integer
hoIdle - Integer
iColumn - Integer
icColumn - Integer
iWidth - Integer
iRowCount - Integer
iValue - Integer
iLeft - Integer
iTop - Integer
iRight - Integer
iBottom - String
sCaption - String
sValue - String
sSettings - Boolean
bResizable - Boolean
bValue
SaveEnvironment()
Standard SaveEnvironment Behavior. This is called when the grid is deactivated.
This is good for augmentation if you wish to change the standard save
- String
sKey - String
sSection - String
sSettings - Boolean
bPreserveEnvironment - Boolean
bRestore
LoadEnvironment()
Standard LoadEnvironment Behavior.
This is good for augmentation if you wish to change the standard load.
- String
sKey - String
sSection - String
sSettings - Boolean
bOk - Boolean
bPreserveEnvironment - Boolean
bRestore
RestoreLayout()
restores the gird layout with the original object created layout.
It is an error to call this when the grid is not activated.
- String
sSettings - Integer
iSort - Integer
iTop
StoreOriginalLayout()
Stores the current state as the original layout
- String
sSettings
- String
CurrentLayoutAsXML()
return the current layout as an xml document. We use this instead of ComLoadSettings & ComSaveSettings
because those interfaces don't work as well. When two columns have the same name, it messes things up.
- Integer
hoExchange - Integer
hoExchangePref - Boolean
bOk - String
sSection - String
sName - String
sXmlLayout - Variant
vSection
RestoreLayoutFromXMLString(String sXmlLayout)
restore the grid based on the passed xml layout string.
- Integer
hoExchange - Integer
hoExchangePref - Boolean
bOk - String
sSection - String
sName - Variant
vSection
ReleaseComObject()
- Integer
hoDataSource - Integer
hoObject - Integer
hoIdle - Integer[]
hoColumnObjects - Integer
icColumn - Integer
iColumn
ResetGrid()
does a reset. Clears data. Add columns to datasource
- Integer
hoDataSource - Integer
hoColumn - Integer
hoColumnDataSource - Integer
hoPaint - Integer
iColumn - Integer
icColumn - Integer
iCustomDraw - Boolean
bIsVirtual - Boolean
bUseFocusCell - Boolean
bFixed
BindDataSource()
use this to set any special properties in the datasource that might be
needed for this particular grid and data source
InitializeData(Variant[] DataSource)
initializes the data
- Integer
iCount - Integer
hoDataSource
CreateTemplateRow()
create a template row
- Integer
hoReportRecord - Integer
hoReportRecords - Variant
vComobject - Variant
vItem - Integer
iColumn - Integer
icColumn - Integer
iRows
CreateColumns()
- Integer
hoColumn - Integer[]
hoColumnObjects - Integer
icColumn - Integer
iColumn
- Handle
ColumnObject(Integer iColumn)
returns object for column
- Integer[]
hoColumnObjects
- Handle
SelectedColumnObject()
returns selected column object, 0 if none
- Integer
hoCol - Integer
iCol
- Integer
ColumnCount()
returns number of columns
- Integer[]
hoColumnObjects
Notify_Focus_Change(Integer Fg)
- Integer
Entering()
- Integer
hoEdit - Integer
hoScope - Boolean
bOldVal - Boolean
bNeeds
Set(Integer iPosition)
- Boolean
bFocusSub
PostEntering()
This is called after a focus change is complete during the first idle event
It sends OnEntering which can be cancelled. If cancelled the prior focus object
will be activated. However, if OnEntering changed the focus, it won't do anything
- Integer
hodataSource - Integer
hoColumn - Integer
hoEdit - Integer
hoOld - Boolean
bCancel
EnteringGrid()
- Integer
hodataSource - Integer
hoColumn - Integer
hoEdit - Integer
hoOld - Variant
vVal - Integer
iCol - Integer
iRow - Integer
iRows - Integer
iERow - Integer
iECol - Boolean
bCancel - Boolean
bEdit - Boolean
bSubFocus - Boolean
bAutoAppend - Boolean
bAllowAppend - Boolean
bAllowInsert - Boolean
bReadOnly
- Boolean
ShouldCommitOnObjectExit(Handle hoDestination)
called when you are exiting object. Return true if the selected row should be
committed - either saved or cleared depending on the autosave state. We pass the
destination object so you can use this to determine where you are exiting to. Sometimes
this will influence the decision.
- Integer
Exiting(Handle hoDestination)
it is important that the exiting logic is executed properly, particularly the
custom edit cancellation. For that reason developers are discouraged from augmenting
this method and OnExiting is provided instead
- Boolean
bCancel - Boolean
bCommit - Boolean
bSubFocus - Integer
hoEdit - Integer
iSelRow - Integer
hoDatasource
NotifyEndEdit(Integer iRow Integer iColumn String sValue)
- Integer
hoColumn - Boolean
bChanged
NotifyCustomEndEdit(Integer iCol String sValue)
- Integer
hoDataSource - Integer
iRow
NotifyItemChecked(Integer iRow Integer iColumn)
- Integer
hoColumn - Boolean
bCancel
- Boolean
LoadFirstOrLastRow(Boolean bLast)
- Integer
hoDataSource - Integer
iCount - Boolean
bDirty - Boolean
bCancel
ResetVirtualMode(Integer iCount)
this does the mechanics of resetting info for virtual mode. Note that after
a reset, everything is cleared, Although focusRow is 0, we are setting select row as not defined
- Boolean
bVirtualMode
PageData(Integer iStartRow)
normally sent within BeforeDraw Paint event. The startrow is the top row and last row must be the
approximate last row (so we have number of rows by subtracting the two). Any special caching (and there is some)
will be handled by PageInRows in the datasource
- Integer
iRowsToRead - Integer
iLastRow - Integer
hoDataSource
ReSynchToDataSource()
called to reset datasource rowcount/offset as needed and then
update the report control
- Integer
iNewRowCount - Integer
iTop - Integer
iNewTop - Integer
iRowCount - Integer
iOffsetChange - Integer
iIndex - Integer[]
SelectedRowIndexes - Integer
iSel - Integer
iFoc - Integer
iNewSel - Integer
iNewFoc - Integer
iSels - Integer
hoDataSource - Integer
hoPaint - Integer
hoNav - Boolean
bNoFocusChangeCheck - Boolean
bFixedHeight - Boolean
bIsEdit
RemoveRowAndSelect(Integer iRow)
Removes the row, the row below becomes the selected row unless there are no
rows below and then the row above is selected.
If other rows were selected they are deselected
- Integer
iIndex - Integer
iSelect - Integer
iNewRow - Integer
hoDataSource - Integer
iRowCount - Boolean
bInEdit - Boolean
bInRowChange - Boolean
bRemoveSelected - Boolean
bNoFocusChangeCheck
MoveToRow(Integer iIndex)
Move to a row.
- Integer
hoNav - Integer
hoDataSource - Variant
vNav - Integer
iCurrent - Integer
iSel - Integer
iSelCol - Boolean
bInEdit - Boolean
bEdit - Boolean
bNoFocusChangeCheck - Boolean
bCancel
MovetoLastRow()
Move to last row and select. This is the last row of data, which may not
be the last row of the current datasource. Can be used to refresh the grid
around the last record
- Integer
iRowCount - Integer
hoDataSource - Boolean
bCancel - Boolean
bInEdit
MovetoFirstRow()
Move to first row and select. This is the last row of data, which may not
be the first row of the current datasource. Can be used to refresh the grid
around the first record
- Boolean
bCancel - Boolean
bInEdit
- Boolean
MoveToColumnObject(Handle hoCol)
MoveToColumnObject
Move to the column and set SelectedColumn.
- Integer
hoNav - Integer
hoDataSource - Integer
hoOldCol - Variant
vNav - Integer
iItemCol - Integer
iDispayCol - Integer
iFocusedItemIndex - Integer
iRows - Boolean
bCancel - Boolean
bInfocusChange - Boolean
bFocusable - Boolean
bSubFocus - Boolean
bInEdit
- Handle
FirstEnterableColumn()
returns the first enterable column object, 0 if none
- Integer[]
hoCols - Integer
hoCol - Integer
iCol - Integer
iCols - Boolean
bOk - Boolean
bWrap
- Handle
LastEnterableColumn()
returns the last enterable column object, 0 if none
- Integer[]
hoCols - Integer
hoCol - Integer
iCol - Integer
iCols - Boolean
bOk - Boolean
bWrap
MoveToFirstEnterableColumn()
move to first enterable column
- Integer
hoCol - Boolean
bOk
MoveToLastEnterableColumn()
move to last enterable column
- Integer
hoCol - Boolean
bOk
- String
EditValue()
returns the current value from the active edit control
- Boolean
bEditMode - Integer
iLen - String
sValue - Integer
hWnd - Integer
hoEdit - Integer
hoColumn
- Boolean
IsCustomEditMode()
returns true if VDF edit control is active
- Integer
hoEdit - Integer
hwHnd - Boolean
bEdit
- Boolean
IsEditMode()
returns true if built-in or VDF edit control is active
- Boolean
bEdit
EndEdit()
ends edit mode. If not in edit mode, does nothing
- Integer
hwHnd - Integer
hoEdit - Integer
hoFocus - Boolean
bInEdit - Integer
iVal
LockBeginEdit()
UnlockBeginEdit()
- Boolean
IsBeginEditLocked()
- Integer
iLocked
BeginEdit()
starts edit mode if not already in edit mode
- Boolean
bInEdit - Boolean
bLock - Integer
hoDataSource - Integer
hoNavigator - Integer
hoCol - Integer
iRow - Integer
iCol
CommitFocusField()
Sent to commit the value in an edit control without
needing to close the edit
- Integer
hoCol - Boolean
bEdit - Integer
iCurrentEdit
SetSelectedRow(Integer iIndex Boolean bSet)
sets the selected row in report control. note this is all COM
and the selected rows do not interact with the datasource
- Integer
hoRows - Integer
hoRow - Variant
vRow - Variant
vRows
SetSelectedRowsAll(Boolean bSet)
clear or set all rows selection
- Integer
iCount - Integer
iSels - Integer
iSel - Integer
hoDataSource
SetIndexesForSelectedRows(Integer[] SelectedRowIndexes)
Get array of selected rows. This is not to be confused with
with the Grid's SelectedRow. These are rows that are selected
- Integer
iCount - Integer
iSels - Integer
iSel - Integer
hoDataSource
- Integer[]
GetIndexesForSelectedRows()
Get array of selected rows. This is not to be confused with
with the Grid's SelectedRow. These are rows that are selected
- Integer
iCount - Integer
i - Integer[]
iIndexes - Integer
hoRows - Integer
hoRow - Variant
vRow - Variant
vRows
- Integer
GetSelectedRowsCount()
Get number of selected rows. Normally not needed as GetIndexesForSelectedRows
has the same info.
- Integer
iCount - Integer
hoRows - Variant
vRows
- Integer
GetFocusedRowIndex()
// Sets focused row but does not adjust datasource. Use with care!
Procedure SetFocusedRow Integer iIndex
Variant vRow vrows
Handle horows
Get phoReportRows to horows
Get ComRows to vrows
Set pvComObject of horows to vRows
Get ComRow of horows iIndex to vRow
// setting focused row changes the displayed row and sets selection
Set ComFocusedRow to vRow // set focused row
End_Procedure
get index of focused row. Use carefully. You should use SelectedRow
- Integer
iIndex - Integer
hoRow - Variant
vRow
- Integer
GetFocusedColumnIndex()
get index of focused column. Use carefully. You should use SelectedColumn.
This returns the object item order not display order
- Integer
iIndex - Integer
hoCol - Variant
vCol
ToggleEdit()
ToggleEdit
If we are editing a cell then Enter acts just like pressing Tab. If we are not editing then
Enter will put the cell into Edit mode.
- Integer
hoDataSource - Integer
iRow - Integer
iCol - Boolean
bEditMode
Next()
Next
- Integer
iSelRow - Integer
iRowCount - Integer
iNewSelRow - Integer
hoCol - Integer
hoNewCol - Integer
hoNextCol - Integer
hoDataSource - Boolean
bWrap - Boolean
bCancel - Boolean
bEdit - Boolean
bValidate - Boolean
bInFocusChanging - Boolean
bOk - Boolean
bInEdit - Boolean
bChanged - Boolean
bReadOnly - Boolean
bAutoSaveOnRowChange - Boolean
bAllowInsert - Boolean
bAllowAppend - Boolean
bAutoAppend - Boolean
bNew - Boolean
bAttemptSaveAndAppend
Previous()
- Integer
iRow - Integer
iSelRow - Integer
iNewSelRow - Integer
hoCol - Integer
hoNewCol - Integer
hoNextCol - Integer
hoDataSource - Integer
hoExitTo - Boolean
bWrap - Boolean
bCancel - Boolean
bEdit - Boolean
bInFocusChanging - Boolean
bOk - Boolean
bInEdit
MoveDownRow()
used by down arrow key. Does a row down with the option of
creating a new row at the bottom.
- Integer
hoDataSource - Integer
iSel - Integer
iRows - Integer
iCol - Boolean
bNew - Boolean
bAllowAppend - Boolean
bCancel - Boolean
bReadOnly - Boolean
bCancelCol - Boolean
bEdit - Boolean
bInEdit - Boolean
bDirty
MoveUpRow()
used by up arrow key. Does a row up
- Integer
hoDataSource - Integer
iSel - Integer
iRows - Integer
iCol - Boolean
bNew - Boolean
bAllowAppend - Boolean
bCancel - Boolean
bReadOnly - Boolean
bCancelCol - Boolean
bEdit - Boolean
bInEdit
MovePageDown()
- Integer
hoNav - Boolean
bInEdit
MovePageUp()
- Integer
hoNav - Boolean
bInEdit
- Handle
ValidateRow(Boolean bTakeFocus)
Validates the selected row (which is done by the datasource). Returns column object
of the object that failed validation. If 0, no errors. If bTakeFocus is true it will
give focus to the offending column.
- Integer
hoCol - Integer
hoDataSource - Boolean
bCancel
- Integer
OffSetFromTop()
returns number of rows the selectedRow is from the TopRow. If SelRow is
above, the top, it returns 0.
- Integer
iSel - Integer
iOffset - Integer
iTop - Integer
hoDataSource
SynchronizeGridtoSelectedRow(Integer iRowOffsetPreference)
synchronize the grid to the selected row passing a rowOffset preference
no rowchanging events are triggered by this. The offset preference can
be a row offset or ropTop, ropCenter, ropBotton
- Integer
iRow - Integer
iIndex - Integer
iRows - Integer
hoDataSource - Boolean
bCancel - Boolean
bNoFocusChangeCheck
SynchronizeGridtoSelectedColumn()
synchronize the grid to the selected column
no row/column changing events are triggered by this
currently this is private because I cannot think of any reason this
would be used.
- Integer
hoCol - Boolean
bCancel - Boolean
bNoFocusChangeCheck
- Boolean
CanDeleteRow()
returns true if you are allowed to delete the row
- Integer
hoDataSource - Boolean
bCanDelete - Boolean
bAllowDelete - Boolean
bReadOnly - Integer
iSel
- Boolean
CanAddRow()
returns true if you are allowed to insert a row
- Integer
hoDataSource - Boolean
bReadOnly - Boolean
bCanInsert
- Boolean
CanEditColumn(Integer iCol)
This is called by OnComRequestEdit which means that this is already
editable. This is used as one last chance to stop the edit. Most often
this will be applied to the entire row. We will disable edits if pbReadOnly is True.
When pbReadOnly is true and pbAllowEdit is true (default) edit requests will come
here and we want to disable them. If for some odd reason you wanted to be able to
edit you could augment this message
- Boolean
bReadOnly
- Boolean
CanSaveRow()
returns true if you are allowed to save the row
- Integer
hoDataSource - Boolean
bReadOnly - Boolean
bCanSave - Integer
iSel
- Boolean
RemoveNewSelectedRow()
removes a new selected row and selects the next row
performs a dataloss verify if needed.
Returns True If canceled
- Boolean
bChanged - Boolean
bNewRow - Boolean
bCancel - Integer
iSel - Integer
hoDataSource
- Boolean
RestoreSelectedRow()
restores the selected row back to its pre-edited state
performs a dataloss verify if needed
returns True if canceled
- Integer
iSel - Integer
hoDataSource - Boolean
bChanged - Boolean
bCancel
- Boolean
AddRow(Integer iNewRow)
inserts or appends a new empty row at iNewRow
Pass row number to insert before. If at end, it will append
Existing row is restored or saved as needed with verifications
Returns True if this was cancelled (eitehr not allowed or a verification cancel)
- Integer
hoDataSource - Boolean
bCancel - Boolean
bAllowed - Boolean
bAutoSave - Boolean
bShouldSave - Boolean
bNew - Integer
iSel
- Boolean
DeleteSelectedRow()
deletes the selected row from datasource with verify
returns true if cancelled (either not allowed or cancelled)
- Integer
hoDataSource - Boolean
bCanDelete - Boolean
bCancel - Boolean
bErr - Integer
iSel
- Boolean
SaveSelectedRow()
Save the selected row with verify
returns True if cancelled (either not allowed or cancelled)
- Integer
iSel - Boolean
bChanged - Boolean
bCancel - Boolean
bSave - Integer
hoDataSource - Integer
hoCol
- Boolean
CommitSelectedRow()
this does a commit of the selected row without changing the
actual row. Can be used to save or clear a row without changing the row. If the
row is new and not changed we will remove it. This is normally used in exiting.
- Integer
hoDataSource - Integer
iRow - Boolean
bCancel - Boolean
bChanged - Boolean
bNew
- Boolean
RowChanging(Integer iOld Integer iNew)
- Boolean
bCancel - Boolean
bValidate - Boolean
bChanged - Boolean
bAutoSaveOnrowChange - Boolean
bNew - Boolean
bReadOnly - Integer
hoCol - Integer
hoDataSource
- Integer
Verify_Save()
called to verify a save. Return non zero to cancel
- Integer
Verify_Data_Loss()
called to verify a dataloss from a clear or restore. Return non zero to cancel
- Integer
Verify_Delete()
called to verify a delete. Return non zero to cancel
Request_ClearRow()
Request a "clear row"
This is the table row clearing handler. If:
A. New row / Unchanged: Delete empty row
B. old row / unchanged: ignore
C. New row / changed: verify_loss and clear changes, goto 1st enterable column
D. old row / changed: verify_loss and clear changes, goto 1st enterable column
- Boolean
bChanged - Boolean
bNewRow - Boolean
bCancel - Integer
iSel - Integer
iCount - Integer
hoDataSource - Boolean
bInFocusChanging
Request_InsertRow()
requests an insert row
- Boolean
bChanged - Boolean
bNewRow - Boolean
bCancel - Boolean
bAppend - Integer
iSel - Integer
iCol - Integer
hoDataSource - Boolean
bInFocusChanging - Boolean
bAllowInsert - Boolean
bInEdit
Request_AppendRow()
requests an append row
- Boolean
bChanged - Boolean
bCancel - Boolean
bAllowAppend - Boolean
bInFocusChanging - Boolean
bInEdit - Integer
iSel - Integer
iCol - Integer
iRowCount - Integer
hoDataSource
Request_Clear()
standard request_clear (which is sent to all DEOs).
Does a Request_ClearRow
Request_Delete()
request a delete row
delete row and back end record.
If the record is new, treat this as a remove row request
- Boolean
bCancel - Boolean
bInFocusChanging - Boolean
bIsNew - Boolean
bInEdit - Integer
hoDataSource
Request_Save()
request a save
- Boolean
bCancel - Boolean
bInFocusChanging - Boolean
bInEdit
Prompt()
Does a prompt for selected column. Needed by the rest of the system
- Integer
hoCol
- Handle
Prompt_Object()
returns prompt object for selected column. Needed by the rest of the system
- Integer
hoCol - Integer
hoPrompt
Prompt_Callback(Handle hoPrompt)
- Integer
hoCol
Zoom()
Does a Zoom for selected column. Needed by the rest of the system
- Integer
hoCol
- Handle
Zoom_Object()
returns Zoom object for selected column. Needed by the rest of the system
- Integer
hoCol - Integer
hoZoom
Set(Integer iHeight Integer iWidth)
augmented to remove the custom edit before a resize.
Set(Integer iRowPos Integer iColPos)
augmented to remove the custom edit before a relocate.
- Handle
CreatePropExchangeObject()
create and return a PropExchange COM object
- Integer
hoPropExchange - Integer
hoGlobal - Variant
vPropExchange - Variant
vGlobal
ExchangeLayout(Handle hoExchange String sSection)
does a property exchange. Pass COM exchange objetc and section name
- Variant
vSection - Integer
hoExchangePref - Integer
iBuild - Integer
iIDBuild - Integer
iColumns - Integer
iLastColumns - Boolean
bLoad
- Boolean
LoadGridLayoutFromRegistry(String sKey)
loads grid info from the registry.
It provides a good model for how to do this kind of thing.
- Integer
hoExchange - Boolean
bOk - String
sSection - String
sFullKey - Integer
iSort
SaveGridLayoutToRegistry(String sKey)
save grid info to the registry.
It provides a good model for how to do this kind of thing.
- Integer
hoExchange - Integer
hoRegistry - Boolean
bOk - Boolean
bExists - Boolean
bVoid - String
sSection - String
sFullKey - String
sShortKey
DestroyColumnObjects()
Destroys all column objects. You'd only use this if you are dynamically creating columns. There is no need to send
this during a normal grid destroy. There is no option to destroy individual columns - just destroy them all and start over.
This also resets the datasource. The datasource is not valid when the column objects are destroyed.
- Integer[]
hoColumnObjects - Integer
hoDataSource - Integer
hoReportColumns - Integer
iCols - Integer
i
HeaderReorder(Integer iCol)
request a grid reorder based on bestorder for this header column.
- Integer
hoCol - Integer
iOldCol - Boolean
bHeaderTogglesDirection - Boolean
bHeaderReorders - Boolean
bReverse
SortGridByColumn(Handle hoCol Boolean bDescending)
request a grid datasource for passed column object and ascending/descending flag.
Should mainly be used with a datasource that is fully loaded and static.
If your datasource is cached and not fully loaded it will sort what is there which is
almost never what you.
- Integer
hoDataSource - Integer
hoSelCol - Integer
iCol - Integer
iSelRow - Integer
iOffset - tGridSortRules
SortRules - Boolean
bCancel
Set(Integer iValue)
- Integer
hoSortOrer - Integer
hoCol - Integer
iCount - Integer
iCol - Variant
vCol - Boolean
bAsc
- Integer
piSortColumn()
- Integer
iCol
Set(Boolean bAsc)
- Integer
hoCol - Integer
iCol
- Boolean
pbReverseOrdering()
- Boolean
bReverse
RequestFindColumnValue(Integer iColumn String sValue Boolean bFindGE Integer iStartRow)
Search the value for this column in the datasource and move to that row.
This is meant to be used when all data is loaded. bFindGE determines if this is a EQ (false)
or GE (True) find. iStartRow determines the row to start the search at.
If a GE search and no match move to end of datasource (it makes the most sense)
- Integer
iRow - Integer
iRows - Integer
hoDataSource - Boolean
bReverse
- Handle
ItemToColumnObject(Integer iItem)
required DD/DEO interface
- Integer
hoCol
- Integer
Current_Item()
required Item interface
These are special item/value things that get sent to the focus
object to get or set the current focused control).
required Item interface
- Integer
iItem
- Integer
item_count()
required Item interface
- Integer
iItems
Set(Integer iItem String sVal)
required Item interface
- Integer
hoCol
- String
Value(Integer iItem)
required Item interface
- String
sVal - Integer
hoCol
Set(Integer iItem Integer bChanged)
required Item interface
does nothing with this value
- Integer
Item_Changed_State(Integer iItem)
required Item interface
always returns values
ResetEditMode(Boolean bWasEdit)
- Boolean
bEdit
FreezeColumn(Handle hoCol)
- Integer
iFreeze - Integer
iCol - Integer
iCol0 - Boolean
bVisible - Integer
hoCol0
Request_Status_Help(Boolean bShow)
request status help. First check if their is a column help string
if not, see if the grid has a help string.
- String
sHelp - Integer
hoStatusbar - Integer
hoCol
- Integer
Activate()
augmented to set a flag which tells the idle handler to go into edit mode at the end
of its processes. This is needed so that the grid edit control takes the focus when it is first
activated and when switching between views.
- Boolean
bHasFocus - Integer
iFail
Switch()
make sure the edit control is closed before the change
Switch_Back()
make sure the edit control is closed before the change
RequestColumnSearch(Handle hoCol Integer iKeyCode Integer iKeyShift)
do a popup search request for the passed column. The keys can provide a
seed value - they come from OnComKeyDown
- Integer
hoSearchDialog - Integer
iCol - Boolean
bOk - String
sValue
Request_Search(Integer iKeyCode Integer iKeyShift)
do a popup search request for the sort column. The keys can provide a
seed value - they come from OnComKeyDown
- Integer
iCol - Integer
hoCol
ReInitializeData(Variant[] DataSource Boolean bKeepSelections)
reinitialize the static data in your grid. This is meant to be used where
you have taken the datasource and made a batch change like setting all checkboxes
in a column. The restores the current row, column and selections. This works best
if you keep the same number of rows. If you add or delete rows below the selected row
it will work ok. If you insert rows or delete records above the selected rows you
don't want to use this - Use InitializeData
- Integer
hoDataSource - Integer[]
SelectedRowIndexes - Integer
iRow - Integer
iCol - Integer
iTop - Integer
iOldSize - Integer
iNewSize - Integer
iSels - Integer
iSel - Integer
iNewSel - Boolean
bInitEnable - Boolean
bInEdit