Visual class

Power BI 视觉对象嵌入组件

扩展

继承属性

bookmarksManager

方法

getFilters(FiltersLevel)

获取应用于筛选器级别的筛选器。 默认筛选器级别为视觉级别。

visual.getFilters(filtersLevel)
  .then(filters => {
    ...
  });
getPages()

获取报表中的页面列表 - 视觉对象中不支持

getVisualDescriptor()

获取包含视觉对象名称、类型等的嵌入式视觉描述符对象。

visual.getVisualDescriptor()
  .then(visualDetails => { ... });
removeFilters(FiltersLevel)

从当前筛选器级别删除所有筛选器。 默认筛选器级别为视觉级别。

visual.removeFilters(filtersLevel);
setFilters(IFilter[], FiltersLevel)

在筛选器级别设置筛选器。 默认筛选器级别为视觉级别。

const filters: [
   ...
];

visual.setFilters(filters, filtersLevel)
 .catch(errors => {
   ...
 });
setPage(string)

设置报表的活动页 - 视觉对象不支持

updateFilters(FiltersOperations, IFilter[], FiltersLevel)

更新筛选器级别的筛选器。 默认筛选器级别为视觉级别。

const filters: [
   ...
];

visual.updateFilters(FiltersOperations.Add, filters, filtersLevel)
 .catch(errors => {
   ...
 });

继承的方法

addContextMenuCommand(string, string, string, MenuLocation, string, string, string)

添加上下文菜单扩展命令。

report.addContextMenuCommand(commandName, commandTitle, contextMenuTitle, menuLocation, visualName, visualType, groupName)
 .catch(error => {
     ...
 });
addOptionsMenuCommand(string, string, string, MenuLocation, string, string, string, string)

添加选项菜单扩展命令。

report.addOptionsMenuCommand(commandName, commandTitle, optionsMenuTitle, menuLocation, visualName, visualType, groupName, commandIcon)
 .catch(error => {
     ...
 });
addPage(string)

向报表添加空页

// Add a page to the report with "Sales" as the page display name
report.addPage("Sales");
applyTheme(IReportTheme)

将主题应用于报表

report.applyTheme(theme);
arePersistentFiltersApplied()

如果报表上应用了用户的筛选器、切片器或其他数据视图更改,则返回。 如果永久筛选器处于禁用状态,则返回 false。

report.arePersistentFiltersApplied();
clearSelectedVisuals(boolean)

清除所选的未弹出视觉对象,如果传递标志,将清除所有视觉对象选择。

report.clearSelectedVisuals()
 .then(() => {
     ...
 });
closeAllOverlays()

关闭所有打开的上下文菜单和工具提示。

report.closeAllOverlays()
 .then(() => {
     ...
 });
configChanged(boolean)

处理配置更改。

deletePage(string)

从报表中删除页面

// Delete a page from a report by pageName (PageName is different than the display name and can be acquired from the getPages API)
report.deletePage("ReportSection145");
exitFullscreen()

请求浏览器退出全屏模式。

fullscreen()

请求浏览器以全屏模式呈现组件的 iframe。

getActivePage()

获取活动报表页。

report.getActivePage()
 .then(activePage => {
     ...
 });
getCorrelationId()

获取当前嵌入会话的 correlationId。

// Get the correlationId for the current embed session
report.getCorrelationId()
  .then(correlationId => {
    ...
  });
getId()

从第一个可用位置获取报表 ID:选项、属性、嵌入 URL。

getPageByName(string)

按报表页的名称获取报表页。

report.getPageByName(pageName)
 .then(page => {
     ...
 });
getTheme()

获取报表的主题

report.getTheme();
getZoom()

返回报表的当前缩放级别。

isSaved()

检查报表是否已保存。

report.isSaved()
moveVisual(string, string, number, number, number)

更新视觉对象在页面中的位置。

report.moveVisual(pageName, visualName, x, y, z)
  .catch(error => { ... });
off<T>(string, IEventHandler<T>)

从处理程序列表中删除一个或多个事件处理程序。 如果指定了对现有句柄函数的引用,请删除特定的处理程序。 如果未指定处理程序,请删除指定事件名称的所有处理程序。

report.off('pageChanged')

or

const logHandler = function (event) {
   console.log(event);
};

report.off('pageChanged', logHandler);
on<T>(string, IEventHandler<T>)

为特定事件添加事件处理程序。

report.on('pageChanged', (event) => {
  console.log('PageChanged: ', event.page.name);
});
print()

通过在嵌入 iframe 组件上调用 window.print() 来打印报表的活动页。

refresh()

刷新报表的数据源。

report.refresh();
reload()

使用现有配置重新加载嵌入。 例如,对于报表,这会有效地清除所有筛选器,并使第一页处于活动状态,从而模拟将报表重置回加载状态。

report.reload();
removeComponentTabIndex(number)

删除元素的 tabindex 属性

removeContextMenuCommand(string, string)

删除上下文菜单扩展命令。

report.removeContextMenuCommand(commandName, contextMenuTitle)
 .catch(error => {
     ...
 });
removeOptionsMenuCommand(string, string)

删除选项菜单扩展命令。

report.removeOptionsMenuCommand(commandName, optionsMenuTitle)
 .then({
     ...
 });
renamePage(string, string)

从报表重命名页面

// Rename a page from a report by changing displayName (pageName is different from the display name and can be acquired from the getPages API)
report.renamePage("ReportSection145", "Sales");
resetPersistentFilters()

将用户的筛选器、切片器和其他数据视图更改重置为报表的默认状态

report.resetPersistentFilters();
resetTheme()

重置并应用报表的默认主题

report.resetTheme();
resizeActivePage(PageSizeType, number, number)

更新报表中活动页的大小。

report.resizeActivePage(pageSizeType, width, height)
  .catch(error => { ... });
resizeVisual(string, string, number, number)

调整页面中的视觉对象的大小。

report.resizeVisual(pageName, visualName, width, height)
  .catch(error => { ... });
save()

保存报表。

saveAs(ISaveAsParameters)

SaveAs 报表。

savePersistentFilters()

保存用户的筛选器、切片器和其他报表数据视图更改

report.savePersistentFilters();
setAccessToken(string)

设置 accessToken。

setComponentTabIndex(number)

设置元素的 tabindex 属性

setComponentTitle(string)

设置辅助功能的组件标题。 对于 iframe,此方法将更改 iframe 标题。

setVisualDisplayState(string, string, VisualContainerDisplayMode)

更新页面中视觉对象的显示状态。

report.setVisualDisplayState(pageName, visualName, displayState)
  .catch(error => { ... });
setZoom(number)

设置报表的缩放级别。

switchLayout(LayoutType)

更新报表布局

report.switchLayout(layoutType);
switchMode(string | ViewMode)

切换报表视图模式。

updateSettings(ISettings)

更新筛选器窗格和页面导航窗格的可见性设置。

const newSettings = {
  panes: {
    filters: {
      visible: false
    }
  }
};

report.updateSettings(newSettings)
  .catch(error => { ... });

继承属性详细信息

bookmarksManager

bookmarksManager: BookmarksManager

属性值

继承自Report.bookmarksManager

方法详细信息

getFilters(FiltersLevel)

获取应用于筛选器级别的筛选器。 默认筛选器级别为视觉级别。

visual.getFilters(filtersLevel)
  .then(filters => {
    ...
  });
function getFilters(filtersLevel?: FiltersLevel): Promise<IFilter[]>

参数

filtersLevel
FiltersLevel

返回

Promise<IFilter[]>

getPages()

获取报表中的页面列表 - 视觉对象中不支持

function getPages(): Promise<Page[]>

返回

Promise<Page[]>

getVisualDescriptor()

获取包含视觉对象名称、类型等的嵌入式视觉描述符对象。

visual.getVisualDescriptor()
  .then(visualDetails => { ... });
function getVisualDescriptor(): Promise<VisualDescriptor>

返回

Promise<VisualDescriptor>

removeFilters(FiltersLevel)

从当前筛选器级别删除所有筛选器。 默认筛选器级别为视觉级别。

visual.removeFilters(filtersLevel);
function removeFilters(filtersLevel?: FiltersLevel): Promise<IHttpPostMessageResponse<void>>

参数

filtersLevel
FiltersLevel

返回

Promise<IHttpPostMessageResponse<void>>

setFilters(IFilter[], FiltersLevel)

在筛选器级别设置筛选器。 默认筛选器级别为视觉级别。

const filters: [
   ...
];

visual.setFilters(filters, filtersLevel)
 .catch(errors => {
   ...
 });
function setFilters(filters: IFilter[], filtersLevel?: FiltersLevel): Promise<IHttpPostMessageResponse<void>>

参数

filters

IFilter[]

filtersLevel
FiltersLevel

返回

Promise<IHttpPostMessageResponse<void>>

setPage(string)

设置报表的活动页 - 视觉对象不支持

function setPage(_pageName: string): Promise<IHttpPostMessageResponse<void>>

参数

_pageName

string

返回

Promise<IHttpPostMessageResponse<void>>

updateFilters(FiltersOperations, IFilter[], FiltersLevel)

更新筛选器级别的筛选器。 默认筛选器级别为视觉级别。

const filters: [
   ...
];

visual.updateFilters(FiltersOperations.Add, filters, filtersLevel)
 .catch(errors => {
   ...
 });
function updateFilters(operation: FiltersOperations, filters: IFilter[], filtersLevel?: FiltersLevel): Promise<IHttpPostMessageResponse<void>>

参数

operation
FiltersOperations
filters

IFilter[]

filtersLevel
FiltersLevel

返回

Promise<IHttpPostMessageResponse<void>>

继承的方法详细信息

addContextMenuCommand(string, string, string, MenuLocation, string, string, string)

添加上下文菜单扩展命令。

report.addContextMenuCommand(commandName, commandTitle, contextMenuTitle, menuLocation, visualName, visualType, groupName)
 .catch(error => {
     ...
 });
function addContextMenuCommand(commandName: string, commandTitle: string, contextMenuTitle: string, menuLocation: MenuLocation, visualName: string, visualType: string, groupName?: string): Promise<IHttpPostMessageResponse<void>>

参数

commandName

string

commandTitle

string

contextMenuTitle

string

menuLocation
MenuLocation
visualName

string

visualType

string

groupName

string

返回

Promise<IHttpPostMessageResponse<void>>

继承自Report.addContextMenuCommand

addOptionsMenuCommand(string, string, string, MenuLocation, string, string, string, string)

添加选项菜单扩展命令。

report.addOptionsMenuCommand(commandName, commandTitle, optionsMenuTitle, menuLocation, visualName, visualType, groupName, commandIcon)
 .catch(error => {
     ...
 });
function addOptionsMenuCommand(commandName: string, commandTitle: string, optionsMenuTitle?: string, menuLocation?: MenuLocation, visualName?: string, visualType?: string, groupName?: string, commandIcon?: string): Promise<IHttpPostMessageResponse<void>>

参数

commandName

string

commandTitle

string

optionsMenuTitle

string

menuLocation
MenuLocation
visualName

string

visualType

string

groupName

string

commandIcon

string

返回

Promise<IHttpPostMessageResponse<void>>

继承自Report.addOptionsMenuCommand

addPage(string)

向报表添加空页

// Add a page to the report with "Sales" as the page display name
report.addPage("Sales");
function addPage(displayName?: string): Promise<Page>

参数

displayName

string

返回

Promise<Page>

继承自Report.addPage

applyTheme(IReportTheme)

将主题应用于报表

report.applyTheme(theme);
function applyTheme(theme: IReportTheme): Promise<void>

参数

theme
IReportTheme

返回

Promise<void>

继承自Report.applyTheme

arePersistentFiltersApplied()

如果报表上应用了用户的筛选器、切片器或其他数据视图更改,则返回。 如果永久筛选器处于禁用状态,则返回 false。

report.arePersistentFiltersApplied();
function arePersistentFiltersApplied(): Promise<boolean>

返回

Promise<boolean>

继承自Report.arePersistentFiltersApplied

clearSelectedVisuals(boolean)

清除所选的未弹出视觉对象,如果传递标志,将清除所有视觉对象选择。

report.clearSelectedVisuals()
 .then(() => {
     ...
 });
function clearSelectedVisuals(clearPopOutState?: boolean): Promise<void>

参数

clearPopOutState

boolean

如果某个视觉对象处于弹出状态(在焦点中,显示为表格,聚光灯...),则不会清除 false/未定义的视觉对象选择。

返回

Promise<void>

继承自Report.clearSelectedVisuals

closeAllOverlays()

关闭所有打开的上下文菜单和工具提示。

report.closeAllOverlays()
 .then(() => {
     ...
 });
function closeAllOverlays(): Promise<void>

返回

Promise<void>

继承自report.closeAllOverlays

configChanged(boolean)

处理配置更改。

function configChanged(isBootstrap: boolean)

参数

isBootstrap

boolean

继承自 report.configChanged 的

deletePage(string)

从报表中删除页面

// Delete a page from a report by pageName (PageName is different than the display name and can be acquired from the getPages API)
report.deletePage("ReportSection145");
function deletePage(pageName: string): Promise<void>

参数

pageName

string

返回

Promise<void>

继承自Report.deletePage

exitFullscreen()

请求浏览器退出全屏模式。

function exitFullscreen()

继承自Report.exitFullscreen

fullscreen()

请求浏览器以全屏模式呈现组件的 iframe。

function fullscreen()

继承自Report.fullscreen

getActivePage()

获取活动报表页。

report.getActivePage()
 .then(activePage => {
     ...
 });
function getActivePage(): Promise<Page>

返回

Promise<Page>

继承自Report.getActivePage

getCorrelationId()

获取当前嵌入会话的 correlationId。

// Get the correlationId for the current embed session
report.getCorrelationId()
  .then(correlationId => {
    ...
  });
function getCorrelationId(): Promise<string>

返回

Promise<string>

继承自Report.getCorrelationId

getId()

从第一个可用位置获取报表 ID:选项、属性、嵌入 URL。

function getId(): string

返回

string

继承自Report.getId

getPageByName(string)

按报表页的名称获取报表页。

report.getPageByName(pageName)
 .then(page => {
     ...
 });
function getPageByName(pageName: string): Promise<Page>

参数

pageName

string

返回

Promise<Page>

继承自Report.getPageByName

getTheme()

获取报表的主题

report.getTheme();
function getTheme(): Promise<IReportTheme>

返回

Promise<IReportTheme>

继承自Report.getTheme

getZoom()

返回报表的当前缩放级别。

function getZoom(): Promise<number>

返回

Promise<number>

继承自Report.getZoom

isSaved()

检查报表是否已保存。

report.isSaved()
function isSaved(): Promise<boolean>

返回

Promise<boolean>

继承自Report.isSaved

moveVisual(string, string, number, number, number)

更新视觉对象在页面中的位置。

report.moveVisual(pageName, visualName, x, y, z)
  .catch(error => { ... });
function moveVisual(pageName: string, visualName: string, x: number, y: number, z?: number): Promise<IHttpPostMessageResponse<void>>

参数

pageName

string

visualName

string

x

number

y

number

z

number

返回

Promise<IHttpPostMessageResponse<void>>

继承自Report.moveVisual

off<T>(string, IEventHandler<T>)

从处理程序列表中删除一个或多个事件处理程序。 如果指定了对现有句柄函数的引用,请删除特定的处理程序。 如果未指定处理程序,请删除指定事件名称的所有处理程序。

report.off('pageChanged')

or

const logHandler = function (event) {
   console.log(event);
};

report.off('pageChanged', logHandler);
function off<T>(eventName: string, handler?: IEventHandler<T>)

参数

eventName

string

handler

IEventHandler<T>

继承自Report.off

on<T>(string, IEventHandler<T>)

为特定事件添加事件处理程序。

report.on('pageChanged', (event) => {
  console.log('PageChanged: ', event.page.name);
});
function on<T>(eventName: string, handler: IEventHandler<T>)

参数

eventName

string

handler

IEventHandler<T>

继承自Report.on

print()

通过在嵌入 iframe 组件上调用 window.print() 来打印报表的活动页。

function print(): Promise<void>

返回

Promise<void>

继承自Report.print

refresh()

刷新报表的数据源。

report.refresh();
function refresh(): Promise<void>

返回

Promise<void>

继承自Report.refresh

reload()

使用现有配置重新加载嵌入。 例如,对于报表,这会有效地清除所有筛选器,并使第一页处于活动状态,从而模拟将报表重置回加载状态。

report.reload();
function reload(): Promise<void>

返回

Promise<void>

继承自Report.reload

removeComponentTabIndex(number)

删除元素的 tabindex 属性

function removeComponentTabIndex(_tabIndex?: number)

参数

_tabIndex

number

继承自Report.removeComponentTabIndex

removeContextMenuCommand(string, string)

删除上下文菜单扩展命令。

report.removeContextMenuCommand(commandName, contextMenuTitle)
 .catch(error => {
     ...
 });
function removeContextMenuCommand(commandName: string, contextMenuTitle: string): Promise<IHttpPostMessageResponse<void>>

参数

commandName

string

contextMenuTitle

string

返回

Promise<IHttpPostMessageResponse<void>>

继承自Report.removeContextMenuCommand

removeOptionsMenuCommand(string, string)

删除选项菜单扩展命令。

report.removeOptionsMenuCommand(commandName, optionsMenuTitle)
 .then({
     ...
 });
function removeOptionsMenuCommand(commandName: string, optionsMenuTitle: string): Promise<IHttpPostMessageResponse<void>>

参数

commandName

string

optionsMenuTitle

string

返回

Promise<IHttpPostMessageResponse<void>>

继承自Report.removeOptionsMenuCommand

renamePage(string, string)

从报表重命名页面

// Rename a page from a report by changing displayName (pageName is different from the display name and can be acquired from the getPages API)
report.renamePage("ReportSection145", "Sales");
function renamePage(pageName: string, displayName: string): Promise<void>

参数

pageName

string

displayName

string

返回

Promise<void>

继承自Report.renamePage

resetPersistentFilters()

将用户的筛选器、切片器和其他数据视图更改重置为报表的默认状态

report.resetPersistentFilters();
function resetPersistentFilters(): Promise<IHttpPostMessageResponse<void>>

返回

Promise<IHttpPostMessageResponse<void>>

继承自Report.resetPersistentFilters

resetTheme()

重置并应用报表的默认主题

report.resetTheme();
function resetTheme(): Promise<void>

返回

Promise<void>

继承自Report.resetTheme

resizeActivePage(PageSizeType, number, number)

更新报表中活动页的大小。

report.resizeActivePage(pageSizeType, width, height)
  .catch(error => { ... });
function resizeActivePage(pageSizeType: PageSizeType, width?: number, height?: number): Promise<IHttpPostMessageResponse<void>>

参数

pageSizeType
PageSizeType
width

number

height

number

返回

Promise<IHttpPostMessageResponse<void>>

继承自Report.resizeActivePage

resizeVisual(string, string, number, number)

调整页面中的视觉对象的大小。

report.resizeVisual(pageName, visualName, width, height)
  .catch(error => { ... });
function resizeVisual(pageName: string, visualName: string, width: number, height: number): Promise<IHttpPostMessageResponse<void>>

参数

pageName

string

visualName

string

width

number

height

number

返回

Promise<IHttpPostMessageResponse<void>>

继承自Report.resizeVisual

save()

保存报表。

function save(): Promise<void>

返回

Promise<void>

继承自Report.save

saveAs(ISaveAsParameters)

SaveAs 报表。

function saveAs(saveAsParameters: ISaveAsParameters): Promise<void>

参数

saveAsParameters
ISaveAsParameters

返回

Promise<void>

继承自Report.saveAs

savePersistentFilters()

保存用户的筛选器、切片器和其他报表数据视图更改

report.savePersistentFilters();
function savePersistentFilters(): Promise<IHttpPostMessageResponse<void>>

返回

Promise<IHttpPostMessageResponse<void>>

继承自Report.savePersistentFilters

setAccessToken(string)

设置 accessToken。

function setAccessToken(accessToken: string): Promise<void>

参数

accessToken

string

返回

Promise<void>

继承自report.setAccessToken

setComponentTabIndex(number)

设置元素的 tabindex 属性

function setComponentTabIndex(tabIndex?: number)

参数

tabIndex

number

继承自Report.setComponentTabIndex

setComponentTitle(string)

设置辅助功能的组件标题。 对于 iframe,此方法将更改 iframe 标题。

function setComponentTitle(title: string)

参数

title

string

继承自Report.setComponentTitle

setVisualDisplayState(string, string, VisualContainerDisplayMode)

更新页面中视觉对象的显示状态。

report.setVisualDisplayState(pageName, visualName, displayState)
  .catch(error => { ... });
function setVisualDisplayState(pageName: string, visualName: string, displayState: VisualContainerDisplayMode): Promise<IHttpPostMessageResponse<void>>

参数

pageName

string

visualName

string

返回

Promise<IHttpPostMessageResponse<void>>

继承自report.setVisualDisplayState

setZoom(number)

设置报表的缩放级别。

function setZoom(zoomLevel: number): Promise<void>

参数

zoomLevel

number

要设置的缩放级别

返回

Promise<void>

继承自Report.setZoom

switchLayout(LayoutType)

更新报表布局

report.switchLayout(layoutType);
function switchLayout(layoutType: LayoutType): Promise<IHttpPostMessageResponse<void>>

参数

layoutType
LayoutType

返回

Promise<IHttpPostMessageResponse<void>>

继承自Report.switchLayout

switchMode(string | ViewMode)

切换报表视图模式。

function switchMode(viewMode: string | ViewMode): Promise<void>

参数

viewMode

string | ViewMode

返回

Promise<void>

继承自Report.switchMode

updateSettings(ISettings)

更新筛选器窗格和页面导航窗格的可见性设置。

const newSettings = {
  panes: {
    filters: {
      visible: false
    }
  }
};

report.updateSettings(newSettings)
  .catch(error => { ... });
function updateSettings(settings: ISettings): Promise<IHttpPostMessageResponse<void>>

参数

settings
ISettings

返回

Promise<IHttpPostMessageResponse<void>>

继承自Report.updateSettings