Version

UltraGridBand Class Members

The following tables list the members exposed by UltraGridBand.

Protected Fields
 NameDescription
Protected FieldtagValue (Inherited from Infragistics.Shared.SubObjectBase)
Public Properties
 NameDescription
Public PropertyAddButtonCaptionReturns or sets the caption text of the Band's Add button.  
Public PropertyAddButtonToolTipTextReturns or sets the text used as the Add button's tool tip  
Public PropertyAutoPreviewEnabledReturns or sets a value that determines whether the AutoPreview area will be displayed.  
Public PropertyAutoPreviewFieldReturns or sets the name of the field used to supply the text for the AutoPreview area.  
Public PropertyAutoPreviewIndentationReturns or sets the amount of horizontal indentation for a row's AutoPreview area.  
Public PropertyAutoPreviewMaxLinesReturns or sets the maximum number of lines to be auto-previewed  
Public PropertyBorderStyleHeaderResolvedReturns the resolved border style of the headers in this Band.  
Public PropertyBorderStyleSummaryFooterCaptionResolvedReturns the resolved value, if the band's Override value is default it will call the Layout's BorderStyleSummaryFooterCaptionDefault property.  
Public PropertyBorderStyleSummaryValueResolvedReturns the resolved value, if the band's Override value is default it will call the Layout's BorderStyleSummaryValueDefault property.  
Public PropertyCardLabelWidthResolvedThe width of the card label area  
Public PropertyCardSettingsReturns a UltraGridCardSettings object that contains information specifying how the band will appear when in card view mode.  
Public PropertyCardViewReturns or sets a value that determines whether the band is Card View mode.  
Public PropertyCardWidthResolvedThe width of a single card  
Public PropertyColHeaderLinesReturns or sets the number of lines to display for column headers.  
Public PropertyColHeadersVisibleDetermines if column headers are visible.  
Public PropertyColumnFiltersColumn filters for filtering all the rows in this band. NOTE: They will apply only if the UltraGridOverride.RowFilterMode is set to AllRowsInBand.  
Public PropertyColumnsReturns the ColumnsCollection of UltraGridColumns that make up the band. This property is read-only.  
Public PropertyDisposed (Inherited from Infragistics.Shared.DisposableObject)
Public PropertyExcludeFromColumnChooserForces the band to be excluded from the column chooser control. Default is resolved to False.  
Public PropertyExpandableReturns or sets a value that determines if the band is expandable.  
Public PropertyFormulaRowIndexSourceResolvedGets the resolved formula source index.  
Public PropertyGroupHeaderLinesReturns or sets the number of lines of text to display for groups headers.  
Public PropertyGroupHeadersVisibleDetermines if group headers are visible.  
Public PropertyGroupsReturns the GroupsCollection of UltraGridGroup objects that are present in the band. This property is read-only.  
Public PropertyHasCardSettingsReturns true if a CardSettings object has been created.  
Public PropertyHasOverrideReturns true if an Override object has been created.  
Public PropertyHasSortedColumnsReturns true if there are any sorted columns in the band.  
Public PropertyHeaderReturns the associated BandHeader object which represents this band's header.  
Public PropertyHeaderPlacementResolvedReturns the resolved header placement.  
Public PropertyHeaderVisibleDetermines if band headers are visible.  
Public PropertyHiddenDetermines whether the object will be displayed. This property is not available at design-time.  
Public PropertyHiddenResolvedReturns true if the Hidden property for this band is set to true or any of this band's ancestor bands have their hidden property set to true.  
Public PropertyIndentationReturns or sets a value that determines the amount of indenting used for this band.  
Public PropertyIndentationGroupByRowGets/sets the number of pixels that the band's groupby rows will be offset. The default value is -1, which means that the grid will determine the offset.  
Public PropertyIndentationGroupByRowExpansionIndicatorGets/sets the number of pixels that the expansion indicators in the band's groupby rows will be offset. The default value is -1, which means that the grid will determine the offset.  
Public PropertyIndentationGroupByRowResolvedReturns the resolved IndentationGroupByRow for this band.  
Public PropertyIndexNumber that specifies the band's position in the Bands collection..  
Public PropertyKeyOverridden. The internally assigned key value for the band. The Key property is read-only for the Band object.  
Public PropertyLayoutReturns the associated UltraGridLayout object.  
Public PropertyLevelCountReturns or sets the number of levels that will be displayed for a single record.  
Public PropertyMaxRowsGets/sets the maximum number of rows allowed in the band. This value is inclusive. The default is practical infinity (Int32.MaxValue).  
Public PropertyMinRowsGets/sets the minimum number of rows allowed in the band. This value is inclusive. The default is 0. If an attempt is made to delete rows from a band and the remaining number of rows would be less than MinRows, the rows are not deleted and the UltraGrid.Error event will fire.  
Public PropertyOverrideReturns or sets the UltraGridOverride obejct that specifies the formatting and behavior of the band.  
Public PropertyParentBandReturns the parent UltraGridBand object of the current band (if it is a child band) or Null for band 0. This property is read-only.  
Public PropertyParentColumnReturns the UltraGridColumn object for the chaptered column in the current band's parent (if the current band is a child band) or Null for band 0. This property is read-only.  
Public PropertyRowEditTemplateGets or sets the template used for editing rows in the band.  
Public PropertyRowFilterActionResolvedResolved RowFilterAction.  
Public PropertyRowLayoutLabelPositionGets or sets the label position. Label position indicates the position of the column labels in the row layout mode.  
Public PropertyRowLayoutLabelStyleGets or sets the row-layout label style. Row-layout label style specifies whether the column labels are shown in a separate area above the rows or with the cells in each row. Default is Separate.  
Public PropertyRowLayoutsReturns an instance of RowLayoutsCollection to which you can add new RowLayout objects using method.  
Public PropertyRowLayoutStyleEnables row-layout functionality in the band.  
Public PropertyRowSelectorHeaderStyleResolvedReturns the resolved value, if the band's Override value is default it will use the Layout's RowSelectorHeaderStyleDefault property.  
Public PropertyRowSelectorWidthResolvedReturns the resolved row selector width. Returns 0 if the row selectors are not visible.  
Public PropertyScrollTipFieldScrollTipField specifies the key of the column contents of which UltraGrid will use to display the scroll tips.  
Public PropertySortedColumnsReturns the SortedColumnsCollection which contains all the UltraGridColumn objects that are currently being sorted in the band.  
Public PropertySortedIndexNumber that specifies the band's position in the SortedBands collection.  
Public PropertySpecialRowPromptFieldSpecifies the key of the column whose cell to position the special row prompts in. Default value is null which specifies that the prompt should not be positioned in any particular cell but rather it should be overlaid on the special row spanning multiple cells if necessary.  
Public PropertySummariesA collection of SummarySettings objects. Use this collection to add new summaries as well as remove any existing summaries.  
Public PropertySummaryFooterCaptionGets or sets summary footer caption substitution string.  
Public PropertyTag (Inherited from Infragistics.Shared.SubObjectBase)
Public PropertyTotalHeaderHeightReturns the total height of all the headers. (Column headers, group headers and band header). If the headers are not visible, then it returns 0.  
Public PropertyVisiblePositionDetermines the position of the band relative to its siblings.  
Protected Properties
 NameDescription
Protected PropertyKeyLowercaseInterned (Inherited from Infragistics.Shared.KeyedSubObjectBase)
Protected PropertyPrimaryCollection (Inherited from Infragistics.Shared.KeyedSubObjectBase)
Protected PropertySubObjectPropChangeHandler (Inherited from Infragistics.Shared.SubObjectBase)
Public Methods
 NameDescription
Public MethodAddNewDisplays the AddNew row for the band. If the current ActiveRow does not provide enough context, an error occurs.  
Public MethodCalcGroupByConnectorsExtentFigures out the amount by which to extend left the headers in order to have them occupy the space over the group-by row connectors.  
Public MethodCalcGroupBySummariesIndentReturns a value that specifies the amount by which to indent the summaries in the summary footers of the specified group-by row collection.  
Public MethodClearGroupByColumnsRemoves all the Group-By columns, ungrouping the rows in the band.  
Public MethodCreateObjRefCreates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object. (Inherited from System.MarshalByRefObject)
Public MethodDispose (Inherited from Infragistics.Shared.DisposableObject)
Public MethodGetColumnHeaderHeightReturns the total height of the column headers for the band.  
Public MethodGetExtentOverloaded. Returns the absolute width of the band.  
Public MethodGetFirstVisibleColOverloaded. Returns the first visible column in the passed in column scrolling region.  
Public MethodGetLifetimeServiceRetrieves the current lifetime service object that controls the lifetime policy for this instance. (Inherited from System.MarshalByRefObject)
Public MethodGetOriginOverloaded. Returns the absolute coordinate of the leftmost point on the band, taking into consideration the control's entire virtual area.  
Public MethodGetRowEnumeratorGets the rows associated with this band.  
Public MethodInitializeLifetimeServiceObtains a lifetime service object to control the lifetime policy for this instance. (Inherited from System.MarshalByRefObject)
Public MethodNotifyPropChangeOverloaded.  (Inherited from Infragistics.Shared.SubObjectBase)
Public MethodPerformAutoResizeCardsResizes the width of all cards in the band based on cell values in all rows.  
Public MethodPerformAutoResizeColumnsOverloaded. Resizes all columns in the band based on cell values in either currently visible rows or all rows depending on the value of autoSizeType argument.  
Public MethodResetResets all properties on this object and all of its sub objects to their default value  
Public MethodResetAddButtonCaptionResets AddButtoCaption to its default value (null).  
Public MethodResetAddButtonToolTipTextResets AddButtonToolTip Text to its default value (null).  
Public MethodResetAutoPreviewEnabledResets AutoPreviewEnabled to its default value (False).  
Public MethodResetAutoPreviewFieldResets AutoPreviewField to its default value (null).  
Public MethodResetAutoPreviewIndentationResets AutoPreviewIndentation to its default value (0).  
Public MethodResetAutoPreviewMaxLinesResets AutoPreviewMaxLines to its default value (3).  
Public MethodResetCardSettingsResets the card settings  
Public MethodResetCardViewResets CardView to its default value (false).  
Public MethodResetColHeaderLinesResets ColumnHeaderLines to its default value (1).  
Public MethodResetColHeadersVisibleResets ColumnHeaderVisible to its default value (True).  
Public MethodResetColumnsResets the Columns collection for the band.  
Public MethodResetExcludeFromColumnChooserResets the property to its default value.  
Public MethodResetExpandableResets Expandable to its default value (True).  
Public MethodResetGroupHeaderLinesResets GroupHeaderLines to its default value (1).  
Public MethodResetGroupHeadersVisibleResets GroupHeadersVisible to its default value (True).  
Public MethodResetGroupsResets the Groups collection for the band.  
Public MethodResetHeaderResets Header  
Public MethodResetHeaderVisibleResets HeaderVisible to its default value (False).  
Public MethodResetHiddenResets Hidden to its default value (False).  
Public MethodResetIndentationResets Indentation its default value (-1).  
Public MethodResetIndentationGroupByRowResets IndentationGroupByRow its default value (-1).  
Public MethodResetIndentationGroupByRowExpansionIndicatorResets IndentationGroupByRowExpansionIndicator its default value (-1).  
Public MethodResetKeyOverridden. Resets the key to its default value. This method does nothing for the Band object since the band key can never be changed.  
Public MethodResetLevelCountResets LevelCount to its default value (1).  
Public MethodResetMaxRowsResets MaxRows its default value (Int32.MaxValue).  
Public MethodResetMinRowsResets MinRows its default value (0).  
Public MethodResetOverrideResets the Override  
Public MethodResetRowEditTemplateResets the RowEditTemplate property to its default value  
Public MethodResetRowLayoutLabelPositionResets the RowLayoutLabelPosition property to its default value of Default.  
Public MethodResetRowLayoutLabelStyleResets the property to its default value of Separate.  
Public MethodResetRowLayoutsResets RowLayouts property to its default value.  
Public MethodResetRowLayoutStyleResets RowLayoutStyle property to its default value.  
Public MethodResetScrollTipFieldResets ScrollTipField to its default value (null).  
Public MethodResetSortedColumnsResets the sorted column's collection.  
Public MethodResetSpecialRowPromptFieldResets the property to its default value.  
Public MethodResetSummariesResets Summaries property to its default value.  
Public MethodResetSummaryFooterCaptionResets SummaryFooterCaption property to its default value.  
Public MethodResetUseRowLayoutResets UseRowLayout property to its default value.  
Public MethodResetVisiblePositionResets VisiblePosition to its default value (0).  
Public MethodShouldSerializeKeyOverridden. Returns true if this property is not set to its default value. ShouldSerializeKey always returns False for the Band object since the band key can never be changed.  
Public MethodShouldSerializeTag (Inherited from Infragistics.Shared.SubObjectBase)
Public MethodToStringReturns the key property  
Public MethodUnfixAllHeadersUnfixes all the headers in this band.  
Public MethodVerifyNotDisposed (Inherited from Infragistics.Shared.DisposableObject)
Protected Methods
 NameDescription
Protected MethodDeserializeTagOverloaded.  (Inherited from Infragistics.Shared.SubObjectBase)
Protected MethodInitializeTag (Inherited from Infragistics.Shared.SubObjectBase)
Protected MethodMemberwiseCloneOverloaded. Creates a shallow copy of the current System.MarshalByRefObject object. (Inherited from System.MarshalByRefObject)
Protected MethodOnAddedToCollection (Inherited from Infragistics.Shared.KeyedSubObjectBase)
Protected MethodOnDisposeOverridden. Called when the object is disposed of  
Protected MethodOnObjectPropChanged (Inherited from Infragistics.Shared.SubObjectBase)
Protected MethodOnRemovedFromCollection (Inherited from Infragistics.Shared.KeyedSubObjectBase)
Protected MethodOnSubObjectPropChangedOverridden. Called when a property has changed on a sub object  
Protected MethodResetInternedKey (Inherited from Infragistics.Shared.KeyedSubObjectBase)
Protected MethodResetTag (Inherited from Infragistics.Shared.SubObjectBase)
Protected MethodSerializeTagOverloaded.  (Inherited from Infragistics.Shared.SubObjectBase)
Protected MethodShouldSerializeAddButtonCaptionReturns true if this property is not set to its default value.  
Protected MethodShouldSerializeAddButtonToolTipTextReturns true if this property is not set to its default value.  
Protected MethodShouldSerializeAutoPreviewEnabledReturns true if this property is not set to its default value.  
Protected MethodShouldSerializeAutoPreviewFieldReturns true if this property is not set to its default value.  
Protected MethodShouldSerializeAutoPreviewIndentationReturns true if this property is not set to its default value.  
Protected MethodShouldSerializeAutoPreviewMaxLinesReturns true if this property is not set to its default value.  
Protected MethodShouldSerializeCardSettingsReturns true if this property is not set to its default value.  
Protected MethodShouldSerializeCardViewReturns true if this property is not set to its default value.  
Protected MethodShouldSerializeColHeaderLinesReturns true if this property is not set to its default value.  
Protected MethodShouldSerializeColHeadersVisibleReturns true if this property is not set to its default value.  
Protected MethodShouldSerializeColumnsReturns true if this property is not set to its default value.  
Protected MethodShouldSerializeExpandableReturns true if this property is not set to its default value.  
Protected MethodShouldSerializeGroupHeaderLinesReturns true if this property is not set to its default value.  
Protected MethodShouldSerializeGroupHeadersVisibleReturns true if this property is not set to its default value.  
Protected MethodShouldSerializeGroupsReturns true if this property is not set to its default value.  
Protected MethodShouldSerializeHeaderReturns true if this property is not set to its default value.  
Protected MethodShouldSerializeHeaderVisibleReturns true if this property is not set to its default value.  
Protected MethodShouldSerializeHiddenReturns true if this property is not set to its default value.  
Protected MethodShouldSerializeIndentationReturns true if this property is not set to its default value.  
Protected MethodShouldSerializeIndentationGroupByRowReturns true if this property is not set to its default value.  
Protected MethodShouldSerializeIndentationGroupByRowExpansionIndicatorReturns true if this property is not set to its default value.  
Protected MethodShouldSerializeLevelCountReturns true if this property is not set to its default value.  
Protected MethodShouldSerializeMaxRowsReturns true if this property is not set to its default value.  
Protected MethodShouldSerializeMinRowsReturns true if this property is not set to its default value.  
Protected MethodShouldSerializeOverrideReturns true if this property is not set to its default value.  
Protected MethodShouldSerializeRowEditTemplateReturns whether the RowEditTemplate property is set to a non-default value.  
Protected MethodShouldSerializeRowLayoutLabelPositionReturns true if the RowLayoutLabelPosition property is set to a value other than the default value of Default.  
Protected MethodShouldSerializeRowLayoutLabelStyleRetruns true if the property is set to a non-default value.  
Protected MethodShouldSerializeRowLayoutsReturns true if this property is not set to its default value.  
Protected MethodShouldSerializeRowLayoutStyleReturns true if this property is not set to its default value  
Protected MethodShouldSerializeScrollTipFieldReturns true if this property is not set to its default value.  
Protected MethodShouldSerializeSortedColumnsReturns true if this property is not set to its default value.  
Protected MethodShouldSerializeSpecialRowPromptFieldReturns true if the property is set to a non-default value.  
Protected MethodShouldSerializeSummariesReturns true if this property is not set to its default value.  
Protected MethodShouldSerializeSummaryFooterCaptionReturns true if this property is not set to its default value.  
Protected MethodShouldSerializeUseRowLayoutReturns true if this property is not set to its default value  
Protected MethodShouldSerializeVisiblePositionReturns true if this property is not set to its default value.  
Public Events
 NameDescription
Public EventSubObjectDisposed (Inherited from Infragistics.Shared.SubObjectBase)
Public EventSubObjectPropChanged (Inherited from Infragistics.Shared.SubObjectBase)
See Also