Back to Devexpress

IDashboardControl Members

dashboard-devexpress-dot-dashboardwin-dot-idashboardcontrol-dot-underscore-members.md

latest55.9 KB
Original Source

IDashboardControl Members

Provides API members that are common for DashboardDesigner and DashboardViewer.

Properties

NameDescription
AllowInspectAggregatedDataGets or sets whether to display aggregated data in the Data Inspector.
AllowInspectRawDataGets or sets whether to display raw data in the Data Inspector.
AllowMaximizeAnimationGets or sets whether to enable the animation when you maximize or restore dashboard items.
AllowMaximizeDashboardItemsGets or sets whether end users can maximize dashboard items.
AllowPrintDashboardGets or sets whether end-users can print or export a dashboard.
AllowPrintDashboardItemsGets or sets whether end-users can print or export dashboard items.
AsyncModeGets or sets whether DashboardViewer/DashboardDesigner operates in asynchronous mode.
CalculateHiddenTotalsGets or sets whether to calculate totals for the hidden data items.
CustomDBCommandInterceptorSpecifies the IDBCommandInterceptor object for the Dashboard control.
CustomDBConnectionInterceptorSpecifies the IDBConnectionInterceptor object for the Dashboard control.
CustomDBSchemaProviderExAllows you to specify a custom schema for the SQL Data Source.
DashboardGets or sets the currently opened dashboard.
DataSourceOptionsProvides access to options that define the data source options of a DashboardViewer / DashboardDesigner.
EnableWaitFormGets or sets whether the DashboardViewer / DashboardDesigner displays a Wait Form when a time-consuming operation is performed.
ExcelExportOptionsProvides access to options related to exporting a dashboard item to Excel format.
GridBestFitMaxRowCountGets or sets the number of the Grid dashboard item’s data rows whose content is processed to apply best fit to columns.
ImageExportOptionsProvides access to options related to exporting a dashboard/dashboard item to an image.
MaximizedDashboardItemNameGets the name of the maximized dashboard item.
ParametersProvides access to dashboard parameter settings and metadata.
PdfExportOptionsProvides access to options related to exporting a dashboard/dashboard item to PDF format.
PrintPreviewOptionsProvides access to options related to printing a dashboard/dashboard item.
PrintPreviewTypeGets or sets the type of Print Preview used to preview dashboard items or the entire dashboard.
UseNeutralFilterModeGets or sets whether to show all items in the filter elements deselected by default.
UserActionGets the end-user action performed on the DashboardViewer/DashboardDesigner.

Methods

NameDescription
BeginUpdateParameters()Locks the DashboardParameters object until the DashboardViewer.EndUpdateParameters/DashboardDesigner.EndUpdateParameters method call.
CanClearMasterFilter(String)Returns whether the specified master filter can be cleared in the current state.
CanPerformDrillDown(String)Returns whether drill down is possible in the current state of the specified dashboard item.
CanPerformDrillUp(String)Returns whether drill up is possible in the current state of the specified dashboard item.
CanSetMasterFilter(String)Returns whether the master filter item allows users to select one or more elements.
CanSetMultiValueMasterFilter(String)Returns whether the master filter item allows users to select multiple elements.
ClearMasterFilter(String)Clears the specified master filter item.
ClearMasterFilterAsync(String, CancellationToken)Clears the specified master filter item in asynchronous mode.
ClearMasterFilterAsync(String)Clears the specified master filter item in asynchronous mode.
EndUpdateParameters()Unlocks the DashboardParameters object after a call to the DashboardViewer.BeginUpdateParameters method and applies changes made to the parameter settings.
ExportDashboardItemToExcel(String, Stream, DashboardExcelExportOptions)Exports the dashboard item to the specified stream in Excel format.
ExportDashboardItemToExcel(String, String, DashboardExcelExportOptions)Exports the dashboard item to the specified file in Excel format using the specified export options.
ExportDashboardItemToImage(String, Stream, DashboardImageExportOptions)Exports the dashboard item to the specified stream in Image format using the specified image options.
ExportDashboardItemToImage(String, Stream)Exports the dashboard item to the specified stream in Image format.
ExportDashboardItemToImage(String, String, DashboardImageExportOptions)Exports the dashboard item to the image file using the specified image options.
ExportDashboardItemToImage(String, String)Exports the dashboard item to the specified file in Image format.
ExportDashboardItemToPdf(String, Stream, DashboardPdfExportOptions)Exports the dashboard item to the specified stream in PDF format using the specified PDF-specific options.
ExportDashboardItemToPdf(String, Stream)Exports the dashboard item to the specified stream in PDF format.
ExportDashboardItemToPdf(String, String, DashboardPdfExportOptions)Exports the dashboard item to the specified file in PDF format using the specified PDF-specific options.
ExportDashboardItemToPdf(String, String)Exports the dashboard item to the specified file in PDF format.
ExportToExcel(Stream, DashboardExcelExportOptions)Exports dashboard data to the specified stream in Excel format.
ExportToExcel(Stream)Exports dashboard data to the specified stream in Excel format.
ExportToExcel(String, DashboardExcelExportOptions)Exports dashboard data to the specified file in Excel format.
ExportToExcel(String)Exports dashboard data to the specified file in Excel format.
ExportToImage(Stream, DashboardImageExportOptions)Exports a dashboard to the specified stream in Image format using the specified image-specific options.
ExportToImage(Stream)Exports a dashboard to the specified stream in Image format.
ExportToImage(String, DashboardImageExportOptions)Exports a dashboard to the specified image file using the specified image-specific options.
ExportToImage(String)Exports a dashboard to the specified file in Image format.
ExportToPdf(Stream, DashboardPdfExportOptions)Exports a dashboard to the specified stream in PDF format using the specified PDF-specific options.
ExportToPdf(Stream)Exports a dashboard to the specified stream in PDF format.
ExportToPdf(String, DashboardPdfExportOptions)Exports a dashboard to the specified file in PDF format using the specified PDF-specific options.
ExportToPdf(String)Exports a dashboard to the specified file in PDF format.
GetAvailableDrillDownValues(String)Returns data identifying the elements that can be used to perform drill-down in the specified dashboard item.
GetAvailableDrillDownValuesAsync(String)Returns data identifying the elements that can be used to perform drill-down in the specified dashboard item. Asynchronous method.
GetAvailableFilterValues(String)Returns axis point tuples identifying elements that can be selected in the current state of the master filter item.
GetAvailableFilterValuesAsync(String)Gets the data (axis point tuples) that identifies selectable elements in the current state of the master filter item.
GetAvailablePredefinedRanges(String)Returns names of the predefined ranges available for the specified Range Filter / Date Filter.
GetCurrentDrillDownValues(String)Returns an axis point tuple identifying the current drill-down state.
GetCurrentFilterValues(String)Returns axis point tuples identifying currently selected elements in the master filter item.
GetCurrentPredefinedRange(String)Returns the name of the currently selected predefined range.
GetCurrentRange(String)Returns the selected range for the specified Range Filter or Date Filter dashboard item.
GetCurrentSelection(String)Returns records identifying currently selected elements in the master filter item.
GetDashboardState()Gets the current dashboard state.
GetEntireRange(String)Returns the visible range for the specified Range Filter or Date Filter dashboard item.
GetEntireRangeAsync(String)Returns the visible range for the specified Range Filter or Date Filter dashboard item.
GetItemData(String)Returns the client data for the specified dashboard item.
GetItemDataAsync(String)Obtains the displayed data for the specified dashboard item asynchronously.
GetPrintableControl(String)Gets a printable control corresponding to the specified dashboard item.
GetSelectedTabPage(String)Gets the selected page in the specified tab container.
GetSelectedTabPageIndex(String)Gets the index of the selected page in the specified tab container.
GetUnderlyingControl(String)Gets the underlying control used to visualize data within the specified dashboard item.
GetUnderlyingControls()Gets the underlying controls used to visualize data within the dashboard items.
GetUnderlyingData(String, IList<AxisPoint>, IList<String>)Returns underlying data for the specified dashboard item by the specified axis points.
GetUnderlyingData(String, IList<AxisPoint>)Returns underlying data for the specified dashboard item by the specified axis points.
GetUnderlyingData(String, IList<UnderlyingDataTargetValue>, IList<String>)Returns underlying data for the specified dashboard item by the specified dimension values.
GetUnderlyingData(String, IList<UnderlyingDataTargetValue>)Returns underlying data for the specified dashboard item by the specified dimension values.
GetUnderlyingData(String, IList<String>)Returns underlying data for the specified dashboard item by the specified data members.
GetUnderlyingData(String)Returns underlying data for the specified dashboard item.
LoadDashboard(Stream)Loads a dashboard from a stream.
LoadDashboard(String)Loads a dashboard from an XML file.
LoadDashboardLayout(Stream)Loads a dashboard layout (layout items and layout containers) from a stream.
LoadDashboardLayout(String)Loads a dashboard layout from an XML file.
MaximizeDashboardItem(String)Expands the specified dashboard item to the entire dashboard size to examine data in greater detail.
MaximizeDashboardItemAsync(String)Expands the specified dashboard item to the entire dashboard size in an asynchronous task.
PerformDrillDown(String, DashboardDataRow)Performs a drill-down for the required element.
PerformDrillDown(String, AxisPointTuple)Performs a drill-down for the required element.
PerformDrillDown(String, Object)Performs a drill-down for the required element by its value.
PerformDrillDownAsync(String, DashboardDataRow, CancellationToken)Performs a drill-down for the required element asynchronously.
PerformDrillDownAsync(String, DashboardDataRow)Performs a drill-down for the required element asynchronously.
PerformDrillDownAsync(String, AxisPointTuple, CancellationToken)Performs a drill-down for the required element asynchronously.
PerformDrillDownAsync(String, AxisPointTuple)Performs a drill-down for the required element asynchronously.
PerformDrillDownAsync(String, Object, CancellationToken)Performs a drill-down for the required element asynchronously.
PerformDrillDownAsync(String, Object)Performs a drill-down for the required element asynchronously.
PerformDrillUp(String)Performs a drill-up in the specified dashboard item.
PerformDrillUpAsync(String, CancellationToken)Performs a drill-up in the specified dashboard item asynchronously.
PerformDrillUpAsync(String)Performs a drill-down for the required element asynchronously.
ReloadData()Reloads data in the data sources.
ReloadData(Boolean)Reloads data in the data sources.
ReloadData(String)Reloads data from the data source for the specified dashboard item.
ReloadDataAsync()Reloads data in the data sources asynchronously.
ReloadDataAsync(String)Reloads data from the data source for the specified dashboard item asynchronously.
ReloadDataAsync(CancellationToken)Reloads data in the data sources asynchronously.
ReloadDataSource(IDashboardDataSource)Reloads data from the specified data source instance.
ReloadDataSource(String)Reloads data from the specified data source. Accepts data source component name as the parameter.
ReloadDataSourceAsync(IDashboardDataSource, CancellationToken)Reloads data from the specified data source instance. The operation is asynchronous. You can propagate a notification to cancel it.
ReloadDataSourceAsync(IDashboardDataSource)Reloads data from the specified data source. Accepts data source object as the parameter. The operation is asynchronous.
ReloadDataSourceAsync(String, CancellationToken)Reloads data from the specified data source. Accepts data source component name as the parameter. The operation is asynchronous. You can propagate a notification to cancel it.
ReloadDataSourceAsync(String)Reloads data from the specified data source. Accepts data source component name as the parameter. The operation is asynchronous.
RestoreDashboardItem()Restores the item size if an item is expanded to the entire dashboard size (maximized).
RestoreDashboardItemAsync()Restores the item size if an item is expanded to the entire dashboard size (maximized) in an asynchronous task.
SaveDashboardLayout(Stream)Saves a dashboard layout (layout items and layout containers) to a stream.
SaveDashboardLayout(String)Saves a dashboard layout to a separate XML file.
SetDashboardState(DashboardState)Applies the dashboard state to the loaded dashboard.
SetDashboardStateAsync(DashboardState, CancellationToken)Applies the dashboard state to the dashboard, asynchronously.
SetDashboardStateAsync(DashboardState)Applies the dashboard state to the dashboard, asynchronously.
SetMasterFilter(String, AxisPointTuple)Selects required elements in the specified master filter item.
SetMasterFilter(String, IEnumerable<DashboardDataRow>)Selects required elements in the specified master filter item.
SetMasterFilter(String, IEnumerable<AxisPointTuple>)Selects required elements in the specified master filter item.
SetMasterFilter(String, Object)Selects the elements by their values in the specified master filter item.
SetMasterFilterAsync(String, AxisPointTuple, CancellationToken)Selects the specified elements in the specified master filter item.
SetMasterFilterAsync(String, AxisPointTuple)Selects the specified elements in the specified master filter item.
SetMasterFilterAsync(String, IEnumerable<DashboardDataRow>, CancellationToken)Selects the specified elements in the specified master filter item.
SetMasterFilterAsync(String, IEnumerable<DashboardDataRow>)Selects the specified elements in the specified master filter item.
SetMasterFilterAsync(String, IEnumerable<AxisPointTuple>, CancellationToken)Selects the specified elements in the specified master filter item.
SetMasterFilterAsync(String, IEnumerable<AxisPointTuple>)Selects the specified elements in the specified master filter item.
SetMasterFilterAsync(String, Object, CancellationToken)Selects the specified elements in the specified master filter item.
SetMasterFilterAsync(String, Object)Selects the specified elements in the specified master filter item.
SetRange(String, RangeFilterSelection)Selects the required range in the specified Range Filter or Date Filter dashboard item.
SetRange(String, String)Selects the specified range in the specified Range Filter or Date Filter dashboard item.
SetRangeAsync(String, RangeFilterSelection, CancellationToken)Selects the specified range in the specified Range Filter or Date Filter dashboard item asynchronously.
SetRangeAsync(String, RangeFilterSelection)Selects the specified range in the specified Range Filter or Date Filter dashboard item asynchronously.
SetRangeAsync(String, String, CancellationToken)Selects the specified range in the specified Range Filter or Date Filter dashboard item asynchronously.
SetRangeAsync(String, String)Selects the specified range in the specified Range Filter or Date Filter dashboard item asynchronously.
SetSelectedTabPage(String, Int32)Selects the tab page specified by its index in the specified tab container.
SetSelectedTabPage(String)Selects the specified tab page.
ShowDashboardParametersForm()Invokes the Dashboard Parameters dialog in the DashboardViewer.
ShowDataInspector(String, InspectedType)Invokes the Data Inspector dialog with a defined data type for the specified dashboard item.
ShowDataInspector(String)Invokes the Data Inspector dialog for the specified dashboard item.
ShowDataInspectorAsync(String, InspectedType)Invokes the Data Inspector dialog with a defined data type for the specified dashboard item asynchronously.
ShowDataInspectorAsync(String)Invokes the Data Inspector dialog for the specified dashboard item asynchronously.
ShowExportDashboardDialog(DashboardExportFormat)Invokes the dialog that allows end-users to export the entire dashboard to the specified format.
ShowExportDashboardItemDialog(String, DashboardExportFormat)Invokes the dialog that allows end-users to export the dashboard item to the specified format.
ShowPrintPreview()Invokes the Print Preview, which shows the print preview of the dashboard.
ShowPrintPreview(String)Invokes the Print Preview window for the specified dashboard item.
ShowRibbonPrintPreview()Invokes the Ribbon Print Preview Form, which shows the print preview of the dashboard.
ShowRibbonPrintPreview(String)Invokes the Ribbon Print Preview window for the specified dashboard item.
UpdateDashboardItemCaption(String)Fires the DashboardViewer.CustomizeDashboardItemCaption/DashboardDesigner.CustomizeDashboardItemCaption event that allows you to customize the dashboard item caption content.
UpdateDashboardTitle()Fires the DashboardViewer.CustomizeDashboardTitle/DashboardDesigner.CustomizeDashboardTitle event that allows you to customize the dashboard title content.
UpdateExtractDataSourcesAsync(Action<String, ExtractUpdateResult>, Action<String, ExtractUpdateResult>, String[])Updates the specified extract data sources in the current dashboard asynchronously. Allows you to set custom actions to perform after updating the data and file.
UpdateExtractDataSourcesAsync(Action<String, ExtractUpdateResult>, Action<String, ExtractUpdateResult>)Updates all extract data sources in the current dashboard asynchronously. Allows you to specify custom actions to perform after updating the data and file.

Events

NameDescription
AsyncDataLoadingAllows you to provide data for the DashboardObjectDataSource in asynchronous mode.
AsyncExcelDataSourceBeforeFillAllows you to change options used to extract data from Microsoft Excel workbooks (XLS, XLSX or XLSM files) or CSV files asynchronously.
AsyncValidateCustomSqlQueryAllows you to validate a custom SQL query of the DashboardSqlDataSource in asynchronous mode.
BeforeExportDocumentAllows you to hide specific dashboard items when printing or exporting the entire dashboard.
ConfigureDataConnectionAllows you to customize connection settings before the DashboardViewer/DashboardDesigner connects to a data store (database, OLAP cube, etc.).
ConnectionErrorAllows to override the default behavior if data store connection fails with current connection parameters.
CustomAssemblyLoadingOccurs before a custom assembly is loaded for use as DashboardEFDataSource.
CustomDashboardItemControlCreatingOccurs when a dashboard control visualizes a custom item.
CustomExportAllows you to customize the exported document.
CustomFilterExpressionAllows you to include WHERE clauses into DashboardSqlDataSource queries.
CustomizeDashboardItemCaptionAllows you to customize the dashboard item caption at runtime.
CustomizeDashboardTitleAllows you to customize the dashboard title at runtime.
CustomizeExportDocumentAllows you to customize the exported document.
CustomPaletteAllows you to substitute the default palette containing colors used to paint dashboard item elements.
CustomParametersOccurs before data is loaded from the data store and allows you to customize dashboard parameters that are used for data processing.
DashboardChangedOccurs after a dashboard has been opened.
DashboardCustomPropertyChangedOccurs when the custom property value in the Dashboard Viewer / Dashboard Designer is changed.
DashboardItemBeforeControlDisposedAllows you to access underlying WinForms controls.
DashboardItemClickOccurs when an end user clicks a dashboard item.
DashboardItemControlCreatedAllows you to access underlying WinForms controls.
DashboardItemControlUpdatedAllows you to access underlying WinForms controls.
DashboardItemDoubleClickOccurs when an end user double-clicks a dashboard item.
DashboardItemElementCustomColorAllows you to color the required dashboard item elements using the specified colors.
DashboardItemMaximizedStateChangedFires when an item becomes maximized or restores its original size.
DashboardItemMouseDownOccurs when the mouse pointer is over the dashboard item and a mouse button is pressed.
DashboardItemMouseEnterOccurs when the mouse pointer enters the dashboard item.
DashboardItemMouseHoverOccurs when the mouse pointer rests on the dashboard item.
DashboardItemMouseLeaveOccurs when the mouse pointer leaves the dashboard item.
DashboardItemMouseMoveOccurs when the mouse pointer is moved over the dashboard item.
DashboardItemMouseUpOccurs when the mouse pointer is over the dashboard item and a mouse button is released.
DashboardItemMouseWheelOccurs when the mouse wheel moves while the dashboard item has focus.
DashboardItemSelectionChangedOccurs after the selection within the dashboard item is changed.
DashboardItemVisualInteractivityAllows you to provide custom visual interactivity for data-bound dashboard items that support element selection and highlighting.
DashboardLoadedOccurs after the dashboard is loaded to the DashboardViewer / DashboardDesigner.
DashboardStateChangedOccurs after the current dashboard state in the DashboardViewer / DashboardDesigner is changed.
DataInspectorFormClosingOccurs before the Data Inspector window closes. Allows you to access the window’s grid controls.
DataInspectorFormLoadOccurs before the Data Inspector window displays. Allows you to access the window’s grid controls and change their settings.
DataLoadingAllows you to provide data for the DashboardObjectDataSource.
DataLoadingErrorAllows you to suppress the form containing errors that occur during data loading.
DrillDownPerformedOccurs after drill-down is performed.
DrillUpPerformedOccurs after a drill-up is performed.
ExportFormShowingOccurs when the Export Form is about to be displayed, and allows you to cancel the action.
InitializedHandle this event to get the dashboard item data, and apply master filter and dashboard state in asynchronous mode.
LayoutChangedOccurs after the dashboard layout is changed.
MasterFilterClearedOccurs when an end user clears the selection in the master filter item.
MasterFilterDefaultValuesAllows you to apply default filtering to master filter items.
MasterFilterSetOccurs when an end user changes the state of the master filter.
PopupMenuShowingAllows you to customize the pop-up menu that users invoke in the dashboard control.
PrintPreviewShowingAllows you to customize the Print Preview window at runtime.
RangeFilterDefaultValueAllows you to specify the default selected range in the Range Filter dashboard item.
SelectedTabPageChangedOccurs when the selected tab page is changed.
SetInitialDashboardStateAllows you to specify the initial dashboard state when loading a dashboard.
ValidateCustomSqlQueryAllows you to validate a custom SQL query of the DashboardSqlDataSource.

See Also

IDashboardControl Interface

DevExpress.DashboardWin Namespace