# WindowParams class 参考 (/zh-CN/api-reference/whiteboard/whiteboard-sdk/harmonyos/class-window-params) > For AI agents: see the complete documentation index at [llms.txt](/llms.txt). ## 详细描述 [#详细描述] 适用版本:**@shengwang/whiteboard 0.2.11**。 多窗口入房配置;支持属性和链式 setter。 可从 @shengwang/whiteboard 直接导入 WindowParams。 ## 类型结构(源码声明) [#类型结构源码声明] 下方源码文件的 export 声明不等同于 SDK 包入口导出;业务导入方式以上方说明为准。 ```text export class WindowParams ``` | [containerSizeRatio](/zh-CN/api-reference/whiteboard/whiteboard-sdk/harmonyos/class-window-params#a997d1d272371471cde939eb1d6584515) | `containerSizeRatio?: number` | | --- | --- | | [chessboard](/zh-CN/api-reference/whiteboard/whiteboard-sdk/harmonyos/class-window-params#a3d78a48246b5e96114bfa4a2052cf3b6) | `chessboard?: boolean` | | [collectorStyles](/zh-CN/api-reference/whiteboard/whiteboard-sdk/harmonyos/class-window-params#a6991047500369f16cddef87c7e65bd0d) | `collectorStyles?: Record` | | [overwriteStyles](/zh-CN/api-reference/whiteboard/whiteboard-sdk/harmonyos/class-window-params#ac298db20eb019d2226a99d20575e2662) | `overwriteStyles?: string` | | [debug](/zh-CN/api-reference/whiteboard/whiteboard-sdk/harmonyos/class-window-params#afa40b9c7c578d43b9f432e0c380faf60) | `debug?: boolean` | | [prefersColorScheme](/zh-CN/api-reference/whiteboard/whiteboard-sdk/harmonyos/class-window-params#a94c1b4395e5a92edc6d9b550089fc404) | `prefersColorScheme?: WindowPrefersColorScheme` | | [fullscreen](/zh-CN/api-reference/whiteboard/whiteboard-sdk/harmonyos/class-window-params#a4201ea4cd8e2a5540600e19085ec44de) | `fullscreen?: boolean` | | [polling](/zh-CN/api-reference/whiteboard/whiteboard-sdk/harmonyos/class-window-params#a067402c886461dc74c6c924e3f5a4f24) | `polling?: boolean` | | [useBoxesStatus](/zh-CN/api-reference/whiteboard/whiteboard-sdk/harmonyos/class-window-params#aa24eab00830ec2055814f7849804f457) | `useBoxesStatus?: boolean` | | [forceMaximized](/zh-CN/api-reference/whiteboard/whiteboard-sdk/harmonyos/class-window-params#ab1e7a35c57e68503c3ab13b5ce0e7a26) | `forceMaximized?: boolean` | | [lazySetupInMaximizedMode](/zh-CN/api-reference/whiteboard/whiteboard-sdk/harmonyos/class-window-params#ad47df3866cf955bc0564863a4fe138c0) | `lazySetupInMaximizedMode?: boolean` | | [maxCachedAppsInMaximizedMode](/zh-CN/api-reference/whiteboard/whiteboard-sdk/harmonyos/class-window-params#a017d8967d3f39c050211ab96df674c45) | `maxCachedAppsInMaximizedMode?: number` | | [builtinAppOptions](/zh-CN/api-reference/whiteboard/whiteboard-sdk/harmonyos/class-window-params#ae235ff050e954fe0ffd525dc64ebc133) | `builtinAppOptions?: BuiltinAppOptions` | | [originSize](/zh-CN/api-reference/whiteboard/whiteboard-sdk/harmonyos/class-window-params#a2d309b158606df79270e2427bbce5cc7) | `originSize?: WindowOriginSize` | | [pageScaleRange](/zh-CN/api-reference/whiteboard/whiteboard-sdk/harmonyos/class-window-params#ab23cb72b7d4cbb0467517c8c9a57eb5d) | `pageScaleRange?: PageScaleRange` | | [setContainerSizeRatio](/zh-CN/api-reference/whiteboard/whiteboard-sdk/harmonyos/class-window-params#a6b01ba18c3f15db7f9c3e85a5203a1ac) | `setContainerSizeRatio(containerSizeRatio: number) : WindowParams` | | [setChessboard](/zh-CN/api-reference/whiteboard/whiteboard-sdk/harmonyos/class-window-params#a4edefc885a636cc4c9456c3d3d9eb611) | `setChessboard(chessboard: boolean) : WindowParams` | | [setDebug](/zh-CN/api-reference/whiteboard/whiteboard-sdk/harmonyos/class-window-params#aa72a99ea6b133987e85b651ab21a44ac) | `setDebug(debug: boolean) : WindowParams` | | [setCollectorStyles](/zh-CN/api-reference/whiteboard/whiteboard-sdk/harmonyos/class-window-params#a958071891113c42739eabef2b45df0a4) | `setCollectorStyles(collectorStyles: Record) : WindowParams` | | [setOverwriteStyles](/zh-CN/api-reference/whiteboard/whiteboard-sdk/harmonyos/class-window-params#a81de4652dd0f89087a759586b53aa014) | `setOverwriteStyles(overwriteStyles: string) : WindowParams` | | [setPrefersColorScheme](/zh-CN/api-reference/whiteboard/whiteboard-sdk/harmonyos/class-window-params#ab3598e5c2d28d166de8e33ba0a7c6577) | `setPrefersColorScheme(prefersColorScheme: WindowPrefersColorScheme) : WindowParams` | | [setFullscreen](/zh-CN/api-reference/whiteboard/whiteboard-sdk/harmonyos/class-window-params#ad845a8d56feeab8f8224f96d857e483f) | `setFullscreen(fullscreen: boolean) : WindowParams` | | [setPolling](/zh-CN/api-reference/whiteboard/whiteboard-sdk/harmonyos/class-window-params#a173def2f13e4429bc1a851e167e270c9) | `setPolling(polling: boolean) : WindowParams` | | [setUseBoxesStatus](/zh-CN/api-reference/whiteboard/whiteboard-sdk/harmonyos/class-window-params#a4532380efbecae7df58d5d27072b0d4a) | `setUseBoxesStatus(useBoxesStatus: boolean) : WindowParams` | | [setForceMaximized](/zh-CN/api-reference/whiteboard/whiteboard-sdk/harmonyos/class-window-params#a8df213ed8c855704d496d49262e04253) | `setForceMaximized(forceMaximized: boolean) : WindowParams` | | [setLazySetupInMaximizedMode](/zh-CN/api-reference/whiteboard/whiteboard-sdk/harmonyos/class-window-params#a5b15e09b0d9dd136bb6b862bab344546) | `setLazySetupInMaximizedMode(lazySetupInMaximizedMode: boolean) : WindowParams` | | [setMaxCachedAppsInMaximizedMode](/zh-CN/api-reference/whiteboard/whiteboard-sdk/harmonyos/class-window-params#ad9c5990088ff829956d14f2d6d11d223) | `setMaxCachedAppsInMaximizedMode(maxCachedAppsInMaximizedMode: number) : WindowParams` | | [setBuiltinAppOptions](/zh-CN/api-reference/whiteboard/whiteboard-sdk/harmonyos/class-window-params#a44b03b00f0fc68f1bc8407ee63f0bda2) | `setBuiltinAppOptions(builtinAppOptions: BuiltinAppOptions) : WindowParams` | | [setOriginSize](/zh-CN/api-reference/whiteboard/whiteboard-sdk/harmonyos/class-window-params#ac8ea3904ac7c81547b8c63deefca3aa5) | `setOriginSize(originSize: WindowOriginSize) : WindowParams` | | [setPageScaleRange](/zh-CN/api-reference/whiteboard/whiteboard-sdk/harmonyos/class-window-params#ae7f57e95df345ebd84b2f500cb1436b6) | `setPageScaleRange(pageScaleRange: PageScaleRange) : WindowParams` | ## 变量说明 [#变量说明] ### containerSizeRatio [#containersizeratio] ```text containerSizeRatio?: number ``` 各个端本地显示多窗口内容时,高与宽比例,默认为 9\:16 ### chessboard [#chessboard] ```text chessboard?: boolean ``` 多窗口区域(主窗口)以外的空间显示 PS 棋盘背景,默认 true ### collectorStyles [#collectorstyles] ```text collectorStyles?: Record ``` 驼峰形式的 CSS,透传给多窗口时,最小化 div 的 css ### overwriteStyles [#overwritestyles] ```text overwriteStyles?: string ``` 窗口样式覆盖 ### debug [#debug] ```text debug?: boolean ``` 是否在网页控制台打印日志 ### prefersColorScheme [#preferscolorscheme] ```text prefersColorScheme?: WindowPrefersColorScheme ``` 窗口配色模式 ### fullscreen [#fullscreen] ```text fullscreen?: boolean ``` 是否全屏 ### polling [#polling] ```text polling?: boolean ``` 是否轮询 ### useBoxesStatus [#useboxesstatus] ```text useBoxesStatus?: boolean ``` 每个窗口独立同步最大化/最小化状态;在入房前配置,同房间客户端保持一致。与 forceMaximized 策略不兼容。 ### forceMaximized [#forcemaximized] ```text forceMaximized?: boolean ``` 房间级强制最大化;可写端开启后同步到房间。两者不能同时生效;继承房间强制最大化或有效 lazy 模式时忽略本地 useBoxesStatus,否则同时请求两者时独立窗口状态优先。 ### lazySetupInMaximizedMode [#lazysetupinmaximizedmode] ```text lazySetupInMaximizedMode?: boolean ``` 本地按焦点初始化 App;仅在房间已强制最大化且处于 maximized/minimized 时生效,否则使用 eager 初始化。默认关闭。 ### maxCachedAppsInMaximizedMode [#maxcachedappsinmaximizedmode] ```text maxCachedAppsInMaximizedMode?: number ``` lazy 模式本地 App runtime 缓存容量;内嵌 Window Manager 默认 4,按 LRU 管理。不是房间 App 数量上限,Slide 保留 runtime 的行为由播放器活动状态管理。 ### builtinAppOptions [#builtinappoptions] ```text builtinAppOptions?: BuiltinAppOptions ``` 本地内置 App 配置,不同步到房间;其中 Presentation 配置用于恢复存量 App 前注册。 ### originSize [#originsize] ```text originSize?: WindowOriginSize ``` 正数 width/height 组成的归一化参考尺寸。WindowParams 用于 MainView;WindowAppParam 用于 Slide/Presentation 并写入 attributes.originSize。 ### pageScaleRange [#pagescalerange] ```text pageScaleRange?: PageScaleRange ``` 相对适配尺寸的 minScale/maxScale 范围;未配置边界不增加业务限制。 ## 函数说明 [#函数说明] ### setContainerSizeRatio [#setcontainersizeratio] ```text setContainerSizeRatio(containerSizeRatio: number) : WindowParams ``` setContainerSizeRatio:WindowParams 的公开成员。参数和返回类型见下方签名。 ### setChessboard [#setchessboard] ```text setChessboard(chessboard: boolean) : WindowParams ``` setChessboard:WindowParams 的公开成员。参数和返回类型见下方签名。 ### setDebug [#setdebug] ```text setDebug(debug: boolean) : WindowParams ``` setDebug:WindowParams 的公开成员。参数和返回类型见下方签名。 ### setCollectorStyles [#setcollectorstyles] ```text setCollectorStyles(collectorStyles: Record) : WindowParams ``` setCollectorStyles:WindowParams 的公开成员。参数和返回类型见下方签名。 ### setOverwriteStyles [#setoverwritestyles] ```text setOverwriteStyles(overwriteStyles: string) : WindowParams ``` setOverwriteStyles:WindowParams 的公开成员。参数和返回类型见下方签名。 ### setPrefersColorScheme [#setpreferscolorscheme] ```text setPrefersColorScheme(prefersColorScheme: WindowPrefersColorScheme) : WindowParams ``` setPrefersColorScheme:WindowParams 的公开成员。参数和返回类型见下方签名。 ### setFullscreen [#setfullscreen] ```text setFullscreen(fullscreen: boolean) : WindowParams ``` setFullscreen:WindowParams 的公开成员。参数和返回类型见下方签名。 ### setPolling [#setpolling] ```text setPolling(polling: boolean) : WindowParams ``` setPolling:WindowParams 的公开成员。参数和返回类型见下方签名。 ### setUseBoxesStatus [#setuseboxesstatus] ```text setUseBoxesStatus(useBoxesStatus: boolean) : WindowParams ``` 每个窗口独立同步最大化/最小化状态;在入房前配置,同房间客户端保持一致。与 forceMaximized 策略不兼容。 ### setForceMaximized [#setforcemaximized] ```text setForceMaximized(forceMaximized: boolean) : WindowParams ``` 房间级强制最大化;可写端开启后同步到房间。两者不能同时生效;继承房间强制最大化或有效 lazy 模式时忽略本地 useBoxesStatus,否则同时请求两者时独立窗口状态优先。 ### setLazySetupInMaximizedMode [#setlazysetupinmaximizedmode] ```text setLazySetupInMaximizedMode(lazySetupInMaximizedMode: boolean) : WindowParams ``` 本地按焦点初始化 App;仅在房间已强制最大化且处于 maximized/minimized 时生效,否则使用 eager 初始化。默认关闭。 ### setMaxCachedAppsInMaximizedMode [#setmaxcachedappsinmaximizedmode] ```text setMaxCachedAppsInMaximizedMode(maxCachedAppsInMaximizedMode: number) : WindowParams ``` lazy 模式本地 App runtime 缓存容量;内嵌 Window Manager 默认 4,按 LRU 管理。不是房间 App 数量上限,Slide 保留 runtime 的行为由播放器活动状态管理。 ### setBuiltinAppOptions [#setbuiltinappoptions] ```text setBuiltinAppOptions(builtinAppOptions: BuiltinAppOptions) : WindowParams ``` 本地内置 App 配置,不同步到房间;其中 Presentation 配置用于恢复存量 App 前注册。 ### setOriginSize [#setoriginsize] ```text setOriginSize(originSize: WindowOriginSize) : WindowParams ``` 正数 width/height 组成的归一化参考尺寸。WindowParams 用于 MainView;WindowAppParam 用于 Slide/Presentation 并写入 attributes.originSize。 ### setPageScaleRange [#setpagescalerange] ```text setPageScaleRange(pageScaleRange: PageScaleRange) : WindowParams ``` 相对适配尺寸的 minScale/maxScale 范围;未配置边界不增加业务限制。