Back to Devexpress

BaseView Members

windowsforms-devexpress-dot-xtragrid-dot-views-dot-base-dot-baseview-dot-underscore-members.md

latest52.0 KB
Original Source

BaseView Members

Serves as the base for objects representing Views in a grid control.

Constructors

NameDescription
BaseView()Creates a new instance of the BaseView class.

Fields

NameDescription
MaxRowCopyCount staticAllows you to limit the maximum number of rows that are copied to the Clipboard when the BaseView.CopyToClipboard method is called, or when an end-user presses the CTRL+C shortcut.

Properties

NameDescription
AccessibleDescriptionGets or sets the object’s description used by accessibility client applications.
AccessibleNameReturns the object’s name used by accessibility client applications.
AccessibleRoleGets or sets the object’s accessible role.
ActiveEditorGets the active editor within a View.
AppearanceProvides access to the properties that control the appearance of the View’s elements.
AppearancePrintProvides access to the properties that specify the appearances of View elements when they are printed/exported.
BaseInfoGets an object providing information for creating and initializing the View.
BorderStyleGets or sets the border style for the current View.
CanRaiseEvents protectedGets a value indicating whether the component can raise an event. Inherited from Component.
ContainerGets the IContainer that contains the Component. Inherited from Component.
DataControllerGets the data controller which implements data-aware operations.
DataRowCountGets how many data rows are contained within the View.
DataSourceGets the data source whose data is displayed by a View.
DesignMode protectedGets a value that indicates whether the Component is currently in design mode. Inherited from Component.
DetailHeightGets or sets the maximum height of a View when it serves as a detail View.
DetailLevelGets the nesting level of a View.
DetailTabHeaderLocationGets or sets the position of detail tabs within detail sections.
EditableDetermines whether end-users can modify the View’s cell values.
Events protectedGets the list of event handlers that are attached to this Component. Inherited from Component.
ForceDoubleClickGets or sets whether double-clicking within the View fires the DoubleClick event, even if a data cell has been double-clicked and its editor has been invoked on the first click.
FormatConditionsGets the collection of style format conditions for a View.
GridControlGets the grid control that owns a specific View.
HtmlImagesGets or sets a collection of images that can be embedded in column/band headers, group rows and cells using the image tag.
IsDefaultStateGets a value indicating whether the View is in normal state.
IsDetailViewGets a value indicating whether the current View is a detail View.
IsDisposingGets whether the current object is being disposed of.
IsDraggingStateGets a value indicating whether a View element is currently being dragged.
IsEditingGets a value indicating whether a View is in edit mode.
IsFocusedViewGets a value indicating whether a View is currently focused.
IsLevelDefaultGets whether the current View object is associated with a node within the GridControl.LevelTree at a non-root level.
IsLoadingGets a value indicating whether a specific View is being initialized at present time.
IsServerModeGets whether the View obtains data in Server Mode.
IsSizingStateGets a value indicating whether a View element is currently being resized.
IsVisibleGets a value indicating whether a View is visible.
IsZoomedViewGets a value indicating whether the current View is maximized.
LevelNameGets the name of the master-detail relationship corresponding to the current detail View.
LinkCountGets how many objects are connected to the View.
LookUpOwner
NameGets or sets the View name.
OptionsLayoutProvides options that control how the current View’s layout is stored to/restored from a stream, xml file or system registry.
OptionsPrintProvides options that control how the View is printed/exported.
PaintAppearanceProvides access to the appearance settings currently used to paint the View’s elements.
PaintStyleNameThis member is not supported.
ParentViewGets or sets a master View for the current View.
RowCountGets a count of the total number of visible rows contained within the current View.
SiteGets or sets the ISite of the Component. Inherited from Component.
SourceRowGets a master row for a View.
SourceRowHandleGets the handle of a master row for a View.
SourceViewGets the pattern View used to create a clone View.
SynchronizeClonesGets or sets a value specifying whether this View’s clones have synchronized appearance and data representation settings.
TagGets or sets the data associated with the current View.
ViewCaptionGets or sets the View Caption.
ViewRectGets the bounding rectangle of the View’s visible area.
ViewRepositoryGets the View repository that owns the current View.
WorkAsLookupThis member supports the .NET Framework infrastructure and is not intended to be used directly from your code.

Methods

NameDescription
Assign(BaseView, Boolean)Copies the settings of a View object to the current one.
BeginDataUpdate()Prevents visual and internal data updates until the BaseView.EndDataUpdate method is called.
BeginInit()Starts the runtime View initialization.
BeginSelection()Prevents selection updates until the BaseView.EndSelection or the BaseView.CancelSelection method is called.
BeginUpdate()Locks the BaseView object by preventing visual updates of the object and its elements until the EndUpdate method is called.
CalcHitInfo(Point)Returns information about the View elements located at the specified point.
CalcHitInfo(Int32, Int32)Returns information about the View elements located at the specified point.
CancelSelection()Enables selection updates after the BaseView.BeginSelection method call, but doesn’t force an immediate update.
CheckLoaded()Forces the grid control to finish its initialization.
ClearDocument()Clears a previously generated document for printing/exporting.
CloseEditor()Hides the active editor saving changes made.
Connect(Object)Connects the View to the specified object.
CopyToClipboard()Copies the selected record(s) to the Clipboard as text.
CreateDocument()Creates a print/export document from the View’s data.
CreateExportLink(IExportProvider)Returns an object that enables you to export a View’s data in a number of different formats.
CreateObjRef(Type)Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object. Inherited from MarshalByRefObject.
Disconnect(Object)Removes the connection between the View and the specified object.
Dispose()Releases all resources used by the Component. Inherited from Component.
EndDataUpdate()Enables visual and internal data updates after the BaseView.BeginDataUpdate method call, and forces an immediate View update.
EndInit()Ends the runtime View initialization.
EndSelection()Enables selection updates after calling the BaseView.BeginSelection method and forces an immediate update.
EndUpdate()Unlocks the BaseView object after a call to the BeginUpdate method and causes an immediate visual update.
Equals(Object, Object) staticDetermines whether the specified object instances are considered equal. Inherited from Object.
Equals(Object)Determines whether the specified object is equal to the current object. Inherited from Object.
Export(ExportTarget, Stream, ExportOptionsBase)Exports the data displayed by the GridControl.DefaultView (the GridControl.MainView or the currently maximized detail View) in the specified format to a stream, using the specified options.
Export(ExportTarget, Stream)Exports the data displayed by the GridControl.DefaultView (the GridControl.MainView or the currently maximized detail View) in the specified format to a stream.
Export(ExportTarget, String, ExportOptionsBase)Exports the data displayed by the GridControl.DefaultView (the GridControl.MainView or the currently maximized detail View) in the specified format to a file, using the specified options.
Export(ExportTarget, String)Exports the data displayed by the GridControl.DefaultView (the GridControl.MainView or the currently maximized detail View) in the specified format to a file.
ExportToCsv(Stream, CsvExportOptions)Exports the control’s data to the specified stream in CSV format using the specified options.
ExportToCsv(Stream)Exports the control’s data to the specified stream in CSV format.
ExportToCsv(String, CsvExportOptions)Exports the control’s data to the specified file in CSV format using the specified options.
ExportToCsv(String)Exports the control’s data to the specified file in CSV format.
ExportToDocx(Stream, DocxExportOptions)Exports the view’s data in the Office Open XML format (DOCX file) and sends it to the specified stream.
ExportToDocx(Stream)Exports the view’s data in the Office Open XML file format (DOCX file) and sends it to the specified stream.
ExportToDocx(String, DocxExportOptions)Exports the view’s data in the Office Open XML format and saves it to the specified DOCX file.
ExportToDocx(String)Exports the view’s data in the Office Open XML file format and saves it to the specified DOCX file.
ExportToExcelOld(String)Obsolete. Exports the GridControl.DefaultView‘s data to the specified file in MS Excel format.
ExportToHtml(Stream, HtmlExportOptions)Exports the GridControl.DefaultView‘s data to the specified stream in HTML format using the specified options.
ExportToHtml(Stream, String, String, Boolean)Obsolete. Exports the GridControl.DefaultView‘s data to a stream in HTML format using the specified character encoding, with the specified title. The output file can be compressed (secondary characters e.g. spaces are removed) if required.
ExportToHtml(Stream)Exports the GridControl.DefaultView‘s data to a stream in HTML format.
ExportToHtml(String, HtmlExportOptions)Exports the GridControl.DefaultView‘s data to the specified file in HTML format using the specified options.
ExportToHtml(String, String, String, Boolean)Obsolete. Exports the GridControl.DefaultView‘s data to the specified HTML file with the specified title, using the specified character encoding. The output file can be compressed (secondary characters e.g. spaces are removed) if required.
ExportToHtml(String, String)Obsolete. Exports the GridControl.DefaultView‘s data to an HTML file using the specified character encoding.
ExportToHtml(String)Exports the GridControl.DefaultView‘s data to the specified file in HTML format.
ExportToHtmlOld(String)Obsolete. Exports the GridControl.DefaultView‘s data to the specified file in HTML format.
ExportToMht(Stream, MhtExportOptions)Exports the GridControl.DefaultView‘s data to the specified stream in MHT format using the specified options.
ExportToMht(Stream, String, String, Boolean)Obsolete. Exports the GridControl.DefaultView‘s data to a stream in MHT format using the specified character encoding, with the specified title. The output file can be compressed (secondary characters e.g. spaces are removed) if required.
ExportToMht(String, MhtExportOptions)Exports the GridControl.DefaultView‘s data to the specified file in MHT format using the specified options.
ExportToMht(String, String, String, Boolean)Obsolete. Exports the GridControl.DefaultView‘s data to the specified file in MHT format using the specified character encoding, with the specified title. The output file can be compressed (secondary characters e.g. spaces are removed) if required.
ExportToMht(String, String)Obsolete. Exports the GridControl.DefaultView‘s data to the specified file in MHT format using the specified character encoding.
ExportToMht(String)Exports the GridControl.DefaultView‘s data to the specified file in MHT format.
ExportToPdf(Stream)Exports the GridControl.DefaultView‘s data to a stream in PDF format.
ExportToPdf(String, PdfExportOptions)Exports the GridControl.DefaultView‘s data to the specified file in PDF format.
ExportToPdf(String)Exports the GridControl.DefaultView‘s data to the specified file in PDF format.
ExportToRtf(Stream, RtfExportOptions)Exports the view’s data to a stream in RTF format.
ExportToRtf(Stream)Exports the GridControl.DefaultView‘s data to a stream in RTF format.
ExportToRtf(String, RtfExportOptions)Exports the view’s data to a file in RTF format.
ExportToRtf(String)Exports the GridControl.DefaultView‘s data to a file in RTF format.
ExportToText(Stream, TextExportOptions)Exports the GridControl.DefaultView‘s data to the specified stream in Text format using the specified options.
ExportToText(Stream, String, Boolean, Encoding)Obsolete. Exports the GridControl.DefaultView‘s data to a stream in TXT format using the specified separator string, quotation and text encoding settings.
ExportToText(Stream, String, Boolean)Obsolete. Exports the GridControl.DefaultView‘s data to a stream in TXT format using the specified separator string and quotation settings.
ExportToText(Stream, String)Obsolete. Exports the GridControl.DefaultView‘s data to a stream in TXT format using the specified separator string.
ExportToText(Stream)Exports the GridControl.DefaultView‘s data to a stream in TXT format.
ExportToText(String, TextExportOptions)Exports the GridControl.DefaultView‘s data to the specified file in Text format using the specified options.
ExportToText(String, String, Boolean, Encoding)Obsolete. Exports the GridControl.DefaultView‘s data to a file in TXT format using the specified separator string, quotation and text encoding settings.
ExportToText(String, String, Boolean)Obsolete. Exports the GridControl.DefaultView‘s data to a file in TXT format using the specified separator string and quotation settings.
ExportToText(String, String)Obsolete. Exports the GridControl.DefaultView‘s data to a file in TXT format using the specified separator string.
ExportToText(String)Exports the GridControl.DefaultView‘s data to the specified file in TXT format.
ExportToTextOld(String)Obsolete. Exports the GridControl.DefaultView‘s data to the specified file in TXT format.
ExportToXls(Stream, XlsExportOptions)Exports the GridControl.DefaultView‘s data to the specified stream in XLS format using the specified options.
ExportToXls(Stream, Boolean)Obsolete. Exports the GridControl.DefaultView‘s data to a stream in XLS format with the specified formatting settings.
ExportToXls(Stream)Exports the GridControl.DefaultView‘s data to a stream in XLS format
ExportToXls(String, XlsExportOptions)Exports the GridControl.DefaultView‘s data to the specified file in XLS format using the specified options.
ExportToXls(String, Boolean)Obsolete. Exports the GridControl.DefaultView‘s data to a file in XLS format with the specified formatting settings.
ExportToXls(String)Exports the GridControl.DefaultView‘s data to a file in XLS format.
ExportToXlsx(Stream, XlsxExportOptions)Exports the GridControl.DefaultView‘s data to the specified stream in XLSX (MS Excel 2007) format using the specified options.
ExportToXlsx(Stream)Exports the GridControl.DefaultView‘s data to the specified stream in XLSX (MS Excel 2007) format.
ExportToXlsx(String, XlsxExportOptions)Exports the GridControl.DefaultView‘s data to the specified file in XLSX (MS Excel 2007) format using the specified options.
ExportToXlsx(String)Exports the GridControl.DefaultView‘s data to the specified file in XLSX (MS Excel 2007) format.
Focus()Focuses the Grid Control and current View within it.
GetHashCode()Serves as the default hash function. Inherited from Object.
GetLifetimeService()Retrieves the current lifetime service object that controls the lifetime policy for this instance. Inherited from MarshalByRefObject.
GetRow(Int32)Returns an object representing a row specified by its handle.
GetService(Type) protectedReturns an object that represents a service provided by the Component or by its Container. Inherited from Component.
GetType()Gets the Type of the current instance. Inherited from Object.
GetViewCaption()Gets the View’s display caption.
GetViewInfo()Returns the object which contains the internal information used to render the View.
HideEditor()Hides the currently active editor discarding changes made.
InitializeLifetimeService()Obtains a lifetime service object to control the lifetime policy for this instance. Inherited from MarshalByRefObject.
Invalidate()Invalidates the region occupied by the current View (adds it to the control’s update region that will be repainted during the next paint operation), and causes a paint message to be sent to the grid control.
InvalidateHitObject(BaseHitInfo)Invalidates the View element located at the point specified by the hit information object.
InvalidateRect(Rectangle)Invalidates the specified region of a View (adds it to the control’s update region, which will be repainted during the next paint operation), and causes a paint message to be sent to the grid control.
LayoutChanged()Updates the current View.
MemberwiseClone() protectedCreates a shallow copy of the current Object. Inherited from Object.
MemberwiseClone(Boolean) protectedCreates a shallow copy of the current MarshalByRefObject object. Inherited from MarshalByRefObject.
NormalView()Restores View layout after the View has been maximized.
PopulateColumns()Creates grid columns/card fields for fields in the View’s bound data source.
PostEditor()Saves the modified cell value to the data source. If the GridOptionsView.RowAutoHeight setting is disabled, the currently active cell editor remains opened.
Print()Prints the grid control’s GridControl.DefaultView (the GridControl.MainView or the currently maximized detail View) without showing a print preview or print dialog.
PrintDialog()Displays the standard Print dialog to print the data displayed in the Grid Control’s GridControl.DefaultView.
QueryMoreRows()Sends a request to a data source to load more records in virtual (event-based) server mode.
ReferenceEquals(Object, Object) staticDetermines whether the specified Object instances are the same instance. Inherited from Object.
RefreshData()Reloads data into View from the data source.
ResetCursor()Sets the mouse cursor to the grid’s Cursor property value.
RestoreLayoutFromJson(Stream, OptionsLayoutBase)Loads the View’s layout settings specified by the options parameter from a file in JSON format.
RestoreLayoutFromJson(Stream)Loads the View’s layout settings specified by the View’s OptionsLayout property from a file in JSON format.
RestoreLayoutFromRegistry(String, OptionsLayoutBase)Restores the View’s layout using the specified settings stored at the specified system registry path.
RestoreLayoutFromRegistry(String)Restores a View’s layout stored at the specified system registry path.
RestoreLayoutFromStream(Stream, OptionsLayoutBase)Restores the View’s layout using the specified settings which are stored in the specified stream.
RestoreLayoutFromStream(Stream)Restores a View’s layout from the specified stream.
RestoreLayoutFromXml(String, OptionsLayoutBase)Restores the View’s layout using the specified settings from the specified XML file.
RestoreLayoutFromXml(String)Restores a View’s layout from a specific XML file.
SaveLayoutToJson(Stream, OptionsLayoutBase)Saves the View’s layout settings specified by the options parameter to a file in JSON format.
SaveLayoutToJson(Stream)Saves the View’s layout settings specified by the View’s OptionsLayout property to a file in JSON format.
SaveLayoutToRegistry(String, OptionsLayoutBase)Saves the View’s layout using the specified settings to the specified system registry path.
SaveLayoutToRegistry(String)Saves a View’s layout to a system registry path.
SaveLayoutToStream(Stream, OptionsLayoutBase)Saves the View’s layout using the specified settings to the specified stream.
SaveLayoutToStream(Stream)Saves a View’s layout to a specific stream.
SaveLayoutToXml(String, OptionsLayoutBase)Saves the View’s layout using the specified settings to the specified XML file.
SaveLayoutToXml(String)Saves a View’s layout to a specific XML file.
ShowEditor()Activates the focused cell’s editor.
ShowEditorByKey(KeyEventArgs)Activates an editor for the focused row cell and passes a specific key to it.
ShowEditorByKeyPress(KeyPressEventArgs)Activates an editor for the focused row cell and passes a specific key to it.
ShowEditorByMouse(DXMouseEventArgs)Activates an editor for the focused row cell and passes a mouse click to it.
ShowPrintPreview()Opens the Print Preview window with a Bars UI.
ShowRibbonPrintPreview()Displays the Print Preview window with a Ribbon UI.
Synchronize(BaseView, SynchronizationMode)Copies the specified settings of a View to the current View.
Synchronize(BaseView)Copies the visual and data representation settings of a specific View to the current View.
SynchronizeData(BaseView)Synchronizes the data representation settings of the current view with a another View object.
SynchronizeVisual(BaseView)Synchronizes the visual representation settings of the current view with a specific View object.
ToString()Returns a String containing the name of the Component, if any. This method should not be overridden. Inherited from Component.
UpdateCurrentRow()Validates the currently focused row’s value/data.
ValidateEditor()Validates the active editor.
ZoomView()Maximizes the current detail View.

Events

NameDescription
BeforeLoadLayoutOccurs before a layout is restored from storage (a stream, xml file or the system registry).
ClickOccurs when a View is clicked.
DataSourceChangedOccurs when the data source of the current View changes.
DisposedOccurs when the component is disposed by a call to the Dispose() method. Inherited from Component.
DoubleClickOccurs when a View is double-clicked.
GotFocusOccurs when a View receives focus.
InvalidValueExceptionEnables you to provide a proper response to entering an invalid cell value.
KeyDownFires when a user presses a key while the View has focus.
KeyPressFires when a character key is pressed while the View has focus.
KeyUpOccurs when releasing the pressed key.
LayoutFires immediately after a View’s layout has been changed.
LayoutUpgradeOccurs when a layout is restored from storage (a stream, xml file or system registry) and its version differs from the version of the current View’s layout.
LostFocusOccurs when a View loses focus.
MouseDownOccurs when the mouse pointer is over a View and a mouse button is pressed.
MouseEnterOccurs when the mouse pointer enters the View.
MouseLeaveOccurs when the mouse pointer leaves the View.
MouseMoveOccurs when the mouse pointer moves over a View.
MouseUpOccurs when the mouse button is released if it was pressed within a View.
MouseWheelOccurs when the mouse wheel is moved while a View has focus.
PaintStyleChangedFires after the View’s paint style has changed.
PrintExportCompletedAllows you to determine whether the view data was printed or exported without errors.
PrintExportProgressFires repeatedly while the View’s data is being printed/exported.
PrintInitializeAllows you to customize general print/export settings when the View is about to be printed/exported.
PropertyDeserializingAllows you to restore certain settings previously saved in the layout.
PropertySerializingAllows you to include certain settings in the layout when you save it.
RowCountChangedOccurs when the number of visible records is changed within a View.
ValidatingEditorFires when a user edits a row cell value and attempts to select another cell. Handle this event to check whether this new value is valid, and if not, choose the required behavior (discard edits, show a warning message, ignore errors, or keep the focus on this cell until a user enters valid values). This event allows you to track edits made in the Edit Form.

See Also

BaseView Class

DevExpress.XtraGrid.Views.Base Namespace