1/* 2 * Copyright (c) 2023-2024 Huawei Device Co., Ltd. 3 * Licensed under the Apache License, Version 2.0 (the "License"); 4 * you may not use this file except in compliance with the License. 5 * You may obtain a copy of the License at 6 * 7 * http://www.apache.org/licenses/LICENSE-2.0 8 * 9 * Unless required by applicable law or agreed to in writing, software 10 * distributed under the License is distributed on an "AS IS" BASIS, 11 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 12 * See the License for the specific language governing permissions and 13 * limitations under the License. 14 */ 15 16/** 17 * @file 18 * @kit ArkUI 19 */ 20 21 22import font from './@ohos.font'; 23import mediaQuery from './@ohos.mediaquery'; 24import type inspector from './@ohos.arkui.inspector'; 25import promptAction, { LevelOrder } from './@ohos.promptAction'; 26import router from './@ohos.router'; 27import type componentUtils from './@ohos.arkui.componentUtils'; 28/*** if arkts 1.1 */ 29import { ComponentContent, FrameNode, Frame } from './@ohos.arkui.node'; 30import type { AnimatorOptions, AnimatorResult } from './@ohos.animator'; 31import type observer from './@ohos.arkui.observer'; 32/*** endif */ 33import { SimpleAnimatorOptions } from './@ohos.animator'; 34import type { Callback, AsyncCallback } from './@ohos.base'; 35import { MeasureOptions } from './@ohos.measure'; 36import type componentSnapshot from './@ohos.arkui.componentSnapshot'; 37import type dragController from './@ohos.arkui.dragController'; 38import image from './@ohos.multimedia.image'; 39import type common from './@ohos.app.ability.common'; 40import type pointer from './@ohos.multimodalInput.pointer'; 41 42/*** if arkts 1.2 */ 43import { ComponentContent, FrameNode, Frame } from '@ohos.arkui.node'; 44import type observer from '@ohos.arkui.observer'; 45import { AnimatorOptions, AnimatorResult } from './@ohos.animator'; 46import { 47 ClickEvent, ExpectedFrameRateRange, DragItemInfo, AnimateParam, KeyframeAnimateParam, 48 KeyframeState, SheetOptions, PopupCommonOptions, MenuOptions, KeyEvent, Optional 49} from './arkui/component/common'; 50import { CustomBuilder } from './arkui/component/builder'; 51import { GestureEvent, GestureRecognizer } from './arkui/component/gesture'; 52import { ResourceStr, SizeOptions, VoidCallback } from './arkui/component/units'; 53import { Nullable, Color, FontStyle, WidthBreakpoint, HeightBreakpoint, PixelRoundMode } from './arkui/component/enums'; 54import { TimePickerDialogOptions } from './arkui/component/timePicker'; 55import { AlertDialogParamWithConfirm, AlertDialogParamWithButtons, AlertDialogParamWithOptions } from './arkui/component/alertDialog'; 56import { ActionSheetOptions } from './arkui/component/actionSheet'; 57import { TextPickerDialogOptions } from './arkui/component/textPicker'; 58import { LocalStorage } from './arkui/stateManagement/storages/localStorage'; 59import { DatePickerDialogOptions } from './arkui/component/datePicker'; 60import { TabsController } from './arkui/component/tabs'; 61import { Scroller } from './arkui/component/scroll'; 62import { KeyProcessingMode } from './arkui/component/focus'; 63import { TextMenuOptions } from './arkui/component/textCommon'; 64/*** endif */ 65/** 66 * class Font 67 * 68 * @syscap SystemCapability.ArkUI.ArkUI.Full 69 * @crossplatform 70 * @since 10 71 */ 72/** 73 * class Font 74 * 75 * <p><strong>NOTE</strong>: 76 * <br>You must first use getFont() in UIContext to obtain a Font instance, 77 * and then call the APIs using the obtained instance. 78 * </p> 79 * 80 * @syscap SystemCapability.ArkUI.ArkUI.Full 81 * @crossplatform 82 * @atomicservice 83 * @since arkts { '1.1':'11','1.2':'20' } 84 * @arkts 1.1&1.2 85 */ 86export declare class Font { 87 /** 88 * Register a customized font in the FontManager. 89 * 90 * @param { font.FontOptions } options - FontOptions 91 * @syscap SystemCapability.ArkUI.ArkUI.Full 92 * @crossplatform 93 * @since 10 94 */ 95 /** 96 * Register a customized font in the FontManager. 97 * 98 * @param { font.FontOptions } options - FontOptions 99 * @syscap SystemCapability.ArkUI.ArkUI.Full 100 * @crossplatform 101 * @atomicservice 102 * @since arkts { '1.1':'11','1.2':'20' } 103 * @arkts 1.1&1.2 104 */ 105 registerFont(options: font.FontOptions): void; 106 107 /** 108 * Gets a list of fonts supported by system. 109 * @returns { Array<string> } A list of font names 110 * @syscap SystemCapability.ArkUI.ArkUI.Full 111 * @since 10 112 */ 113 /** 114 * Gets a list of fonts supported by system. 115 * 116 * <p><strong>NOTE</strong>: 117 * <br>This API takes effect only on 2-in-1 devices. 118 * </p> 119 * 120 * @returns { Array<string> } A list of font names 121 * @syscap SystemCapability.ArkUI.ArkUI.Full 122 * @atomicservice 123 * @since arkts { '1.1':'11','1.2':'20' } 124 * @arkts 1.1&1.2 125 */ 126 getSystemFontList(): Array<string>; 127 128 /** 129 * Get font details according to the font name. 130 * @param { string } fontName - font name 131 * @returns { font.FontInfo } Returns the font info 132 * @syscap SystemCapability.ArkUI.ArkUI.Full 133 * @since 10 134 */ 135 /** 136 * Get font details according to the font name. 137 * @param { string } fontName - font name 138 * @returns { font.FontInfo } Returns the font info 139 * @syscap SystemCapability.ArkUI.ArkUI.Full 140 * @atomicservice 141 * @since arkts { '1.1':'11','1.2':'20' } 142 * @arkts 1.1&1.2 143 */ 144 getFontByName(fontName: string): font.FontInfo; 145} 146 147/** 148 * class MediaQuery 149 * 150 * @syscap SystemCapability.ArkUI.ArkUI.Full 151 * @crossplatform 152 * @since 10 153 */ 154/** 155 * class MediaQuery 156 * 157 * @syscap SystemCapability.ArkUI.ArkUI.Full 158 * @crossplatform 159 * @atomicservice 160 * @since arkts { '1.1':'11','1.2':'20' } 161 * @arkts 1.1&1.2 162 */ 163export declare class MediaQuery { 164 /** 165 * Sets the media query criteria and returns the corresponding listening handle 166 * 167 * @param { string } condition - media conditions 168 * @returns { mediaQuery.MediaQueryListener } the corresponding listening handle 169 * @syscap SystemCapability.ArkUI.ArkUI.Full 170 * @crossplatform 171 * @since 10 172 */ 173 /** 174 * Sets the media query criteria and returns the corresponding listening handle 175 * 176 * @param { string } condition - media conditions 177 * @returns { mediaQuery.MediaQueryListener } the corresponding listening handle 178 * @syscap SystemCapability.ArkUI.ArkUI.Full 179 * @crossplatform 180 * @atomicservice 181 * @since arkts { '1.1':'11','1.2':'20' } 182 * @arkts 1.1&1.2 183 */ 184 matchMediaSync(condition: string): mediaQuery.MediaQueryListener; 185} 186 187/** 188 * class UIInspector 189 * @syscap SystemCapability.ArkUI.ArkUI.Full 190 * @crossplatform 191 * @since 10 192 */ 193/** 194 * class UIInspector 195 * @syscap SystemCapability.ArkUI.ArkUI.Full 196 * @crossplatform 197 * @atomicservice 198 * @since arkts { '1.1':'11','1.2':'20' } 199 * @arkts 1.1&1.2 200 */ 201export declare class UIInspector { 202 /** 203 * Sets the component after layout or draw criteria and returns the corresponding listening handle 204 * @param { string } id - component id. 205 * @returns { inspector.ComponentObserver } create listener for observer component event. 206 * @syscap SystemCapability.ArkUI.ArkUI.Full 207 * @crossplatform 208 * @since 10 209 */ 210 /** 211 * Sets the component after layout or draw criteria and returns the corresponding listening handle 212 * @param { string } id - component id. 213 * @returns { inspector.ComponentObserver } create listener for observer component event. 214 * @syscap SystemCapability.ArkUI.ArkUI.Full 215 * @crossplatform 216 * @atomicservice 217 * @since arkts { '1.1':'11','1.2':'20' } 218 * @arkts 1.1&1.2 219 */ 220 createComponentObserver(id: string): inspector.ComponentObserver; 221} 222 223/** 224 * class Router 225 * 226 * @syscap SystemCapability.ArkUI.ArkUI.Full 227 * @crossplatform 228 * @since 10 229 */ 230/** 231 * class Router 232 * 233 * @syscap SystemCapability.ArkUI.ArkUI.Full 234 * @crossplatform 235 * @atomicservice 236 * @since 11 237 */ 238/** 239 * class Router 240 * 241 * @syscap SystemCapability.ArkUI.ArkUI.Full 242 * @crossplatform 243 * @atomicservice 244 * @since arkts { '1.1':'12','1.2':'20' } 245 * @arkts 1.1&1.2 246 */ 247export declare class Router { 248 /** 249 * Navigates to a specified page in the application. 250 * 251 * @param { router.RouterOptions } options - Page routing parameters. 252 * @param { AsyncCallback<void> } callback - Callback used to return the result. 253 * @throws { BusinessError } 401 - Parameter error. Possible causes: 254 * <br> 1. Mandatory parameters are left unspecified. 255 * <br> 2. Incorrect parameters types. 256 * <br> 3. Parameter verification failed. 257 * @throws { BusinessError } 100001 - Internal error. 258 * @throws { BusinessError } 100002 - Uri error. The URI of the page to redirect is incorrect or does not exist 259 * @throws { BusinessError } 100003 - Page stack error. Too many pages are pushed. 260 * @syscap SystemCapability.ArkUI.ArkUI.Full 261 * @crossplatform 262 * @since 10 263 */ 264 /** 265 * Navigates to a specified page in the application. 266 * 267 * @param { router.RouterOptions } options - Page routing parameters. 268 * @param { AsyncCallback<void> } callback - Callback used to return the result. 269 * @throws { BusinessError } 401 - Parameter error. Possible causes: 270 * <br> 1. Mandatory parameters are left unspecified. 271 * <br> 2. Incorrect parameters types. 272 * <br> 3. Parameter verification failed. 273 * @throws { BusinessError } 100001 - Internal error. 274 * @throws { BusinessError } 100002 - Uri error. The URI of the page to redirect is incorrect or does not exist 275 * @throws { BusinessError } 100003 - Page stack error. Too many pages are pushed. 276 * @syscap SystemCapability.ArkUI.ArkUI.Full 277 * @crossplatform 278 * @atomicservice 279 * @since arkts { '1.1':'11','1.2':'20' } 280 * @arkts 1.1&1.2 281 */ 282 pushUrl(options: router.RouterOptions, callback: AsyncCallback<void>): void; 283 284 /** 285 * Navigates to a specified page in the application. This API uses a promise to return the result. 286 * 287 * @param { router.RouterOptions } options - Page routing parameters. 288 * @returns { Promise<void> } Promise used to return the result. 289 * @throws { BusinessError } 401 - Parameter error. Possible causes: 290 * <br> 1. Mandatory parameters are left unspecified. 291 * <br> 2. Incorrect parameters types. 292 * <br> 3. Parameter verification failed. 293 * @throws { BusinessError } 100001 - Internal error. 294 * @throws { BusinessError } 100002 - Uri error. The URI of the page to redirect is incorrect or does not exist 295 * @throws { BusinessError } 100003 - Page stack error. Too many pages are pushed. 296 * @syscap SystemCapability.ArkUI.ArkUI.Full 297 * @crossplatform 298 * @since 10 299 */ 300 /** 301 * Navigates to a specified page in the application. This API uses a promise to return the result. 302 * 303 * @param { router.RouterOptions } options - Page routing parameters. 304 * @returns { Promise<void> } Promise used to return the result. 305 * @throws { BusinessError } 401 - Parameter error. Possible causes: 306 * <br> 1. Mandatory parameters are left unspecified. 307 * <br> 2. Incorrect parameters types. 308 * <br> 3. Parameter verification failed. 309 * @throws { BusinessError } 100001 - Internal error. 310 * @throws { BusinessError } 100002 - Uri error. The URI of the page to redirect is incorrect or does not exist 311 * @throws { BusinessError } 100003 - Page stack error. Too many pages are pushed. 312 * @syscap SystemCapability.ArkUI.ArkUI.Full 313 * @crossplatform 314 * @atomicservice 315 * @since arkts { '1.1':'11','1.2':'20' } 316 * @arkts 1.1&1.2 317 */ 318 pushUrl(options: router.RouterOptions): Promise<void>; 319 320 /** 321 * Navigates to a specified page in the application. 322 * 323 * @param { router.RouterOptions } options - Page routing parameters. 324 * @param { router.RouterMode } mode - Routing mode. 325 * @param { AsyncCallback<void> } callback - Callback used to return the result. 326 * @throws { BusinessError } 401 - Parameter error. Possible causes: 327 * <br> 1. Mandatory parameters are left unspecified. 328 * <br> 2. Incorrect parameters types. 329 * <br> 3. Parameter verification failed. 330 * @throws { BusinessError } 100001 - Internal error. 331 * @throws { BusinessError } 100002 - Uri error. The URI of the page to redirect is incorrect or does not exist 332 * @throws { BusinessError } 100003 - Page stack error. Too many pages are pushed. 333 * @syscap SystemCapability.ArkUI.ArkUI.Full 334 * @crossplatform 335 * @since 10 336 */ 337 /** 338 * Navigates to a specified page in the application. 339 * 340 * @param { router.RouterOptions } options - Page routing parameters. 341 * @param { router.RouterMode } mode - Routing mode. 342 * @param { AsyncCallback<void> } callback - Callback used to return the result. 343 * @throws { BusinessError } 401 - Parameter error. Possible causes: 344 * <br> 1. Mandatory parameters are left unspecified. 345 * <br> 2. Incorrect parameters types. 346 * <br> 3. Parameter verification failed. 347 * @throws { BusinessError } 100001 - Internal error. 348 * @throws { BusinessError } 100002 - Uri error. The URI of the page to redirect is incorrect or does not exist 349 * @throws { BusinessError } 100003 - Page stack error. Too many pages are pushed. 350 * @syscap SystemCapability.ArkUI.ArkUI.Full 351 * @crossplatform 352 * @atomicservice 353 * @since arkts { '1.1':'11','1.2':'20' } 354 * @arkts 1.1&1.2 355 */ 356 pushUrl(options: router.RouterOptions, mode: router.RouterMode, callback: AsyncCallback<void>): void; 357 358 /** 359 * Navigates to a specified page in the application. This API uses a promise to return the result. 360 * 361 * @param { router.RouterOptions } options - Page routing parameters. 362 * @param { router.RouterMode } mode - Routing mode. 363 * @returns { Promise<void> } Promise used to return the result. 364 * @throws { BusinessError } 401 - Parameter error. Possible causes: 365 * <br> 1. Mandatory parameters are left unspecified. 366 * <br> 2. Incorrect parameters types. 367 * <br> 3. Parameter verification failed. 368 * @throws { BusinessError } 100001 - Internal error. 369 * @throws { BusinessError } 100002 - Uri error. The URI of the page to redirect is incorrect or does not exist 370 * @throws { BusinessError } 100003 - Page stack error. Too many pages are pushed. 371 * @syscap SystemCapability.ArkUI.ArkUI.Full 372 * @crossplatform 373 * @since 10 374 */ 375 /** 376 * Navigates to a specified page in the application. This API uses a promise to return the result. 377 * 378 * @param { router.RouterOptions } options - Page routing parameters. 379 * @param { router.RouterMode } mode - Routing mode. 380 * @returns { Promise<void> } Promise used to return the result. 381 * @throws { BusinessError } 401 - Parameter error. Possible causes: 382 * <br> 1. Mandatory parameters are left unspecified. 383 * <br> 2. Incorrect parameters types. 384 * <br> 3. Parameter verification failed. 385 * @throws { BusinessError } 100001 - Internal error. 386 * @throws { BusinessError } 100002 - Uri error. The URI of the page to redirect is incorrect or does not exist 387 * @throws { BusinessError } 100003 - Page stack error. Too many pages are pushed. 388 * @syscap SystemCapability.ArkUI.ArkUI.Full 389 * @crossplatform 390 * @atomicservice 391 * @since arkts { '1.1':'11','1.2':'20' } 392 * @arkts 1.1&1.2 393 */ 394 pushUrl(options: router.RouterOptions, mode: router.RouterMode): Promise<void>; 395 396 /** 397 * Replaces the current page with another one in the application. The current page is destroyed after replacement. 398 * 399 * @param { router.RouterOptions } options - Options. 400 * @param { AsyncCallback<void> } callback - the callback of replaceUrl. 401 * @throws { BusinessError } 401 - Parameter error. Possible causes: 402 * <br> 1. Mandatory parameters are left unspecified. 403 * <br> 2. Incorrect parameters types. 404 * <br> 3. Parameter verification failed. 405 * @throws { BusinessError } 100001 - The UI execution context is not found. This error code is thrown only in the standard system. 406 * @throws { BusinessError } 200002 - Uri error. The URI of the page to be used for replacement is incorrect or does not exist. 407 * @syscap SystemCapability.ArkUI.ArkUI.Full 408 * @crossplatform 409 * @since 10 410 */ 411 /** 412 * Replaces the current page with another one in the application. The current page is destroyed after replacement. 413 * 414 * @param { router.RouterOptions } options - Options. 415 * @param { AsyncCallback<void> } callback - the callback of replaceUrl. 416 * @throws { BusinessError } 401 - Parameter error. Possible causes: 417 * <br> 1. Mandatory parameters are left unspecified. 418 * <br> 2. Incorrect parameters types. 419 * <br> 3. Parameter verification failed. 420 * @throws { BusinessError } 100001 - The UI execution context is not found. This error code is thrown only in the standard system. 421 * @throws { BusinessError } 200002 - Uri error. The URI of the page to be used for replacement is incorrect or does not exist. 422 * @syscap SystemCapability.ArkUI.ArkUI.Full 423 * @crossplatform 424 * @atomicservice 425 * @since arkts { '1.1':'11','1.2':'20' } 426 * @arkts 1.1&1.2 427 */ 428 replaceUrl(options: router.RouterOptions, callback: AsyncCallback<void>): void; 429 430 /** 431 * Replaces the current page with another one in the application. The current page is destroyed after replacement. 432 * 433 * @param { router.RouterOptions } options - Options. 434 * @returns { Promise<void> } the promise returned by the function. 435 * @throws { BusinessError } 401 - Parameter error. Possible causes: 436 * <br> 1. Mandatory parameters are left unspecified. 437 * <br> 2. Incorrect parameters types. 438 * <br> 3. Parameter verification failed. 439 * @throws { BusinessError } 100001 - The UI execution context is not found. This error code is thrown only in the standard system. 440 * @throws { BusinessError } 200002 - Uri error. The URI of the page to be used for replacement is incorrect or does not exist. 441 * @syscap SystemCapability.ArkUI.ArkUI.Full 442 * @crossplatform 443 * @since 10 444 */ 445 /** 446 * Replaces the current page with another one in the application. The current page is destroyed after replacement. 447 * 448 * @param { router.RouterOptions } options - Options. 449 * @returns { Promise<void> } the promise returned by the function. 450 * @throws { BusinessError } 401 - Parameter error. Possible causes: 451 * <br> 1. Mandatory parameters are left unspecified. 452 * <br> 2. Incorrect parameters types. 453 * <br> 3. Parameter verification failed. 454 * @throws { BusinessError } 100001 - The UI execution context is not found. This error code is thrown only in the standard system. 455 * @throws { BusinessError } 200002 - Uri error. The URI of the page to be used for replacement is incorrect or does not exist. 456 * @syscap SystemCapability.ArkUI.ArkUI.Full 457 * @crossplatform 458 * @atomicservice 459 * @since arkts { '1.1':'11','1.2':'20' } 460 * @arkts 1.1&1.2 461 */ 462 replaceUrl(options: router.RouterOptions): Promise<void>; 463 464 /** 465 * Replaces the current page with another one in the application. The current page is destroyed after replacement. 466 * 467 * @param { router.RouterOptions } options - Options. 468 * @param { router.RouterMode } mode - RouterMode. 469 * @param { AsyncCallback<void> } callback - the callback of replaceUrl. 470 * @throws { BusinessError } 401 - Parameter error. Possible causes: 471 * <br> 1. Mandatory parameters are left unspecified. 472 * <br> 2. Incorrect parameters types. 473 * <br> 3. Parameter verification failed. 474 * @throws { BusinessError } 100001 - The UI execution context is not found. This error code is thrown only in the standard system. 475 * @throws { BusinessError } 200002 - Uri error. The URI of the page to be used for replacement is incorrect or does not exist. 476 * @syscap SystemCapability.ArkUI.ArkUI.Full 477 * @crossplatform 478 * @since 10 479 */ 480 /** 481 * Replaces the current page with another one in the application. The current page is destroyed after replacement. 482 * 483 * @param { router.RouterOptions } options - Options. 484 * @param { router.RouterMode } mode - RouterMode. 485 * @param { AsyncCallback<void> } callback - the callback of replaceUrl. 486 * @throws { BusinessError } 401 - Parameter error. Possible causes: 487 * <br> 1. Mandatory parameters are left unspecified. 488 * <br> 2. Incorrect parameters types. 489 * <br> 3. Parameter verification failed. 490 * @throws { BusinessError } 100001 - The UI execution context is not found. This error code is thrown only in the standard system. 491 * @throws { BusinessError } 200002 - Uri error. The URI of the page to be used for replacement is incorrect or does not exist. 492 * @syscap SystemCapability.ArkUI.ArkUI.Full 493 * @crossplatform 494 * @atomicservice 495 * @since arkts { '1.1':'11','1.2':'20' } 496 * @arkts 1.1&1.2 497 */ 498 replaceUrl(options: router.RouterOptions, mode: router.RouterMode, callback: AsyncCallback<void>): void; 499 500 /** 501 * Replaces the current page with another one in the application. The current page is destroyed after replacement. 502 * 503 * @param { router.RouterOptions } options - Options. 504 * @param { router.RouterMode } mode - RouterMode. 505 * @returns { Promise<void> } the promise returned by the function. 506 * @throws { BusinessError } 401 - Parameter error. Possible causes: 507 * <br> 1. Mandatory parameters are left unspecified. 508 * <br> 2. Incorrect parameters types. 509 * <br> 3. Parameter verification failed. 510 * @throws { BusinessError } 100001 - Failed to get the delegate. This error code is thrown only in the standard system. 511 * @throws { BusinessError } 200002 - Uri error. The URI of the page to be used for replacement is incorrect or does not exist. 512 * @syscap SystemCapability.ArkUI.ArkUI.Full 513 * @crossplatform 514 * @since 10 515 */ 516 /** 517 * Replaces the current page with another one in the application. The current page is destroyed after replacement. 518 * 519 * @param { router.RouterOptions } options - Options. 520 * @param { router.RouterMode } mode - RouterMode. 521 * @returns { Promise<void> } the promise returned by the function. 522 * @throws { BusinessError } 401 - Parameter error. Possible causes: 523 * <br> 1. Mandatory parameters are left unspecified. 524 * <br> 2. Incorrect parameters types. 525 * <br> 3. Parameter verification failed. 526 * @throws { BusinessError } 100001 - Failed to get the delegate. This error code is thrown only in the standard system. 527 * @throws { BusinessError } 200002 - Uri error. The URI of the page to be used for replacement is incorrect or does not exist. 528 * @syscap SystemCapability.ArkUI.ArkUI.Full 529 * @crossplatform 530 * @atomicservice 531 * @since arkts { '1.1':'11','1.2':'20' } 532 * @arkts 1.1&1.2 533 */ 534 replaceUrl(options: router.RouterOptions, mode: router.RouterMode): Promise<void>; 535 536 /** 537 * Returns to the previous page or a specified page. 538 * 539 * @param { router.RouterOptions } options - Description of the page. 540 * <br>The **url** parameter indicates the URL of the page to return to. 541 * <br>If the specified page does not exist in the page stack, the application does not respond. 542 * <br>If no URL is set, the application returns to the previous page, and the page is not rebuilt. 543 * <br>The page in the page stack is not reclaimed. It will be reclaimed after being popped up. 544 * @syscap SystemCapability.ArkUI.ArkUI.Full 545 * @crossplatform 546 * @since 10 547 */ 548 /** 549 * Returns to the previous page or a specified page. 550 * 551 * @param { router.RouterOptions } options - Description of the page. 552 * <br>The **url** parameter indicates the URL of the page to return to. 553 * <br>If the specified page does not exist in the page stack, the application does not respond. 554 * <br>If no URL is set, the application returns to the previous page, and the page is not rebuilt. 555 * <br>The page in the page stack is not reclaimed. It will be reclaimed after being popped up. 556 * @syscap SystemCapability.ArkUI.ArkUI.Full 557 * @crossplatform 558 * @atomicservice 559 * @since arkts { '1.1':'11','1.2':'20' } 560 * @arkts 1.1&1.2 561 */ 562 back(options?: router.RouterOptions): void; 563 564 /** 565 * Returns to the specified page. 566 * 567 * @param { number } index - Index of the target page to navigate to. 568 * @param { Object } [params] - Parameters carried when returning to the page. 569 * @syscap SystemCapability.ArkUI.ArkUI.Full 570 * @crossplatform 571 * @atomicservice 572 * @since arkts { '1.1':'12','1.2':'20' } 573 * @arkts 1.1&1.2 574 */ 575 back(index: number, params?: Object): void; 576 577 /** 578 * Clears all historical pages and retains only the current page at the top of the stack. 579 * 580 * @syscap SystemCapability.ArkUI.ArkUI.Full 581 * @crossplatform 582 * @since 10 583 */ 584 /** 585 * Clears all historical pages and retains only the current page at the top of the stack. 586 * 587 * @syscap SystemCapability.ArkUI.ArkUI.Full 588 * @crossplatform 589 * @atomicservice 590 * @since arkts { '1.1':'11','1.2':'20' } 591 * @arkts 1.1&1.2 592 */ 593 clear(): void; 594 595 /** 596 * Obtains the number of pages in the current stack. 597 * 598 * @returns { string } Number of pages in the stack. The maximum value is 32. 599 * @syscap SystemCapability.ArkUI.ArkUI.Full 600 * @crossplatform 601 * @since 10 602 */ 603 /** 604 * Obtains the number of pages in the current stack. 605 * 606 * @returns { string } Number of pages in the stack. The maximum value is 32. 607 * @syscap SystemCapability.ArkUI.ArkUI.Full 608 * @crossplatform 609 * @atomicservice 610 * @since arkts { '1.1':'11','1.2':'20' } 611 * @arkts 1.1&1.2 612 */ 613 getLength(): string; 614 615 /** 616 * Obtains information about the current page state. 617 * 618 * @returns { router.RouterState } Page routing state. 619 * @syscap SystemCapability.ArkUI.ArkUI.Full 620 * @crossplatform 621 * @since 10 622 */ 623 /** 624 * Obtains information about the current page state. 625 * 626 * @returns { router.RouterState } Page routing state. 627 * @syscap SystemCapability.ArkUI.ArkUI.Full 628 * @crossplatform 629 * @atomicservice 630 * @since arkts { '1.1':'11','1.2':'20' } 631 * @arkts 1.1&1.2 632 */ 633 getState(): router.RouterState; 634 635 /** 636 * Obtains page information by index. 637 * 638 * @param { number } index - Index of page. 639 * @returns { router.RouterState | undefined } Page state. 640 * @syscap SystemCapability.ArkUI.ArkUI.Full 641 * @crossplatform 642 * @atomicservice 643 * @since arkts { '1.1':'12','1.2':'20' } 644 * @arkts 1.1&1.2 645 */ 646 getStateByIndex(index: number): router.RouterState | undefined; 647 648 /** 649 * Obtains page information by url. 650 * 651 * @param { string } url - URL of page. 652 * @returns { Array<router.RouterState> } Page state. 653 * @syscap SystemCapability.ArkUI.ArkUI.Full 654 * @crossplatform 655 * @atomicservice 656 * @since arkts { '1.1':'12','1.2':'20' } 657 * @arkts 1.1&1.2 658 */ 659 getStateByUrl(url: string): Array<router.RouterState>; 660 661 /** 662 * Pop up alert dialog to ask whether to back. 663 * 664 * @param { router.EnableAlertOptions } options - Options. 665 * @throws { BusinessError } 401 - Parameter error. Possible causes: 666 * <br> 1. Mandatory parameters are left unspecified. 667 * <br> 2. Incorrect parameters types. 668 * <br> 3. Parameter verification failed. 669 * @throws { BusinessError } 100001 - Internal error. 670 * @syscap SystemCapability.ArkUI.ArkUI.Full 671 * @crossplatform 672 * @since 10 673 */ 674 /** 675 * Pop up alert dialog to ask whether to back. 676 * 677 * @param { router.EnableAlertOptions } options - Options. 678 * @throws { BusinessError } 401 - Parameter error. Possible causes: 679 * <br> 1. Mandatory parameters are left unspecified. 680 * <br> 2. Incorrect parameters types. 681 * <br> 3. Parameter verification failed. 682 * @throws { BusinessError } 100001 - Internal error. 683 * @syscap SystemCapability.ArkUI.ArkUI.Full 684 * @crossplatform 685 * @atomicservice 686 * @since arkts { '1.1':'11','1.2':'20' } 687 * @arkts 1.1&1.2 688 */ 689 showAlertBeforeBackPage(options: router.EnableAlertOptions): void; 690 691 /** 692 * Hide alert before back page. 693 * 694 * @syscap SystemCapability.ArkUI.ArkUI.Full 695 * @crossplatform 696 * @since 10 697 */ 698 /** 699 * Hide alert before back page. 700 * 701 * @syscap SystemCapability.ArkUI.ArkUI.Full 702 * @crossplatform 703 * @atomicservice 704 * @since arkts { '1.1':'11','1.2':'20' } 705 * @arkts 1.1&1.2 706 */ 707 hideAlertBeforeBackPage(): void; 708 709 /** 710 * Obtains information about the current page params. 711 * 712 * @returns { Object } Page params. 713 * @syscap SystemCapability.ArkUI.ArkUI.Full 714 * @crossplatform 715 * @since 10 716 */ 717 /** 718 * Obtains information about the current page params. 719 * 720 * @returns { Object } Page params. 721 * @syscap SystemCapability.ArkUI.ArkUI.Full 722 * @crossplatform 723 * @atomicservice 724 * @since arkts { '1.1':'11','1.2':'20' } 725 * @arkts 1.1&1.2 726 */ 727 getParams(): Object; 728 729 /** 730 * Navigates to a page using the named route. This API uses a promise to return the result. 731 * @param { router.NamedRouterOptions } options - Page routing parameters. 732 * @param { AsyncCallback<void> } callback - Callback used to return the result. 733 * @throws { BusinessError } 401 - Parameter error. Possible causes: 734 * <br> 1. Mandatory parameters are left unspecified. 735 * <br> 2. Incorrect parameters types. 736 * <br> 3. Parameter verification failed. 737 * @throws { BusinessError } 100001 - Internal error. 738 * @throws { BusinessError } 100003 - Page stack error. Too many pages are pushed. 739 * @throws { BusinessError } 100004 - Named route error. The named route does not exist. 740 * @syscap SystemCapability.ArkUI.ArkUI.Full 741 * @crossplatform 742 * @since 10 743 */ 744 /** 745 * Navigates to a page using the named route. This API uses a promise to return the result. 746 * @param { router.NamedRouterOptions } options - Page routing parameters. 747 * @param { AsyncCallback<void> } callback - Callback used to return the result. 748 * @throws { BusinessError } 401 - Parameter error. Possible causes: 749 * <br> 1. Mandatory parameters are left unspecified. 750 * <br> 2. Incorrect parameters types. 751 * <br> 3. Parameter verification failed. 752 * @throws { BusinessError } 100001 - Internal error. 753 * @throws { BusinessError } 100003 - Page stack error. Too many pages are pushed. 754 * @throws { BusinessError } 100004 - Named route error. The named route does not exist. 755 * @syscap SystemCapability.ArkUI.ArkUI.Full 756 * @crossplatform 757 * @atomicservice 758 * @since arkts { '1.1':'11','1.2':'20' } 759 * @arkts 1.1&1.2 760 */ 761 pushNamedRoute(options: router.NamedRouterOptions, callback: AsyncCallback<void>): void; 762 763 /** 764 * Navigates to a page using the named route. This API uses a promise to return the result. 765 * @param { router.NamedRouterOptions } options - Page routing parameters. 766 * @returns { Promise<void> } Promise used to return the result. 767 * @throws { BusinessError } 401 - Parameter error. Possible causes: 768 * <br> 1. Mandatory parameters are left unspecified. 769 * <br> 2. Incorrect parameters types. 770 * <br> 3. Parameter verification failed. 771 * @throws { BusinessError } 100001 - Internal error. 772 * @throws { BusinessError } 100003 - Page stack error. Too many pages are pushed. 773 * @throws { BusinessError } 100004 - Named route error. The named route does not exist. 774 * @syscap SystemCapability.ArkUI.ArkUI.Full 775 * @crossplatform 776 * @since 10 777 */ 778 /** 779 * Navigates to a page using the named route. This API uses a promise to return the result. 780 * @param { router.NamedRouterOptions } options - Page routing parameters. 781 * @returns { Promise<void> } Promise used to return the result. 782 * @throws { BusinessError } 401 - Parameter error. Possible causes: 783 * <br> 1. Mandatory parameters are left unspecified. 784 * <br> 2. Incorrect parameters types. 785 * <br> 3. Parameter verification failed. 786 * @throws { BusinessError } 100001 - Internal error. 787 * @throws { BusinessError } 100003 - Page stack error. Too many pages are pushed. 788 * @throws { BusinessError } 100004 - Named route error. The named route does not exist. 789 * @syscap SystemCapability.ArkUI.ArkUI.Full 790 * @crossplatform 791 * @atomicservice 792 * @since arkts { '1.1':'11','1.2':'20' } 793 * @arkts 1.1&1.2 794 */ 795 pushNamedRoute(options: router.NamedRouterOptions): Promise<void>; 796 797 /** 798 * Navigates to a page using the named route. This API uses a promise to return the result. 799 * @param { router.NamedRouterOptions } options - Page routing parameters. 800 * @param { router.RouterMode } mode - Routing mode. 801 * @param { AsyncCallback<void> } callback - Callback used to return the result. 802 * @throws { BusinessError } 401 - Parameter error. Possible causes: 803 * <br> 1. Mandatory parameters are left unspecified. 804 * <br> 2. Incorrect parameters types. 805 * <br> 3. Parameter verification failed. 806 * @throws { BusinessError } 100001 - Internal error. 807 * @throws { BusinessError } 100003 - Page stack error. Too many pages are pushed. 808 * @throws { BusinessError } 100004 - Named route error. The named route does not exist. 809 * @syscap SystemCapability.ArkUI.ArkUI.Full 810 * @crossplatform 811 * @since 10 812 */ 813 /** 814 * Navigates to a page using the named route. This API uses a promise to return the result. 815 * @param { router.NamedRouterOptions } options - Page routing parameters. 816 * @param { router.RouterMode } mode - Routing mode. 817 * @param { AsyncCallback<void> } callback - Callback used to return the result. 818 * @throws { BusinessError } 401 - Parameter error. Possible causes: 819 * <br> 1. Mandatory parameters are left unspecified. 820 * <br> 2. Incorrect parameters types. 821 * <br> 3. Parameter verification failed. 822 * @throws { BusinessError } 100001 - Internal error. 823 * @throws { BusinessError } 100003 - Page stack error. Too many pages are pushed. 824 * @throws { BusinessError } 100004 - Named route error. The named route does not exist. 825 * @syscap SystemCapability.ArkUI.ArkUI.Full 826 * @crossplatform 827 * @atomicservice 828 * @since arkts { '1.1':'11','1.2':'20' } 829 * @arkts 1.1&1.2 830 */ 831 pushNamedRoute(options: router.NamedRouterOptions, mode: router.RouterMode, callback: AsyncCallback<void>): void; 832 833 /** 834 * Navigates to a page using the named route. This API uses a promise to return the result. 835 * @param { router.NamedRouterOptions } options - Page routing parameters. 836 * @param { router.RouterMode } mode - Routing mode. 837 * @returns { Promise<void> } Promise used to return the result. 838 * @throws { BusinessError } 401 - Parameter error. Possible causes: 839 * <br> 1. Mandatory parameters are left unspecified. 840 * <br> 2. Incorrect parameters types. 841 * <br> 3. Parameter verification failed. 842 * @throws { BusinessError } 100001 - Internal error. 843 * @throws { BusinessError } 100003 - Page stack error. Too many pages are pushed. 844 * @throws { BusinessError } 100004 - Named route error. The named route does not exist. 845 * @syscap SystemCapability.ArkUI.ArkUI.Full 846 * @crossplatform 847 * @since 10 848 */ 849 /** 850 * Navigates to a page using the named route. This API uses a promise to return the result. 851 * @param { router.NamedRouterOptions } options - Page routing parameters. 852 * @param { router.RouterMode } mode - Routing mode. 853 * @returns { Promise<void> } Promise used to return the result. 854 * @throws { BusinessError } 401 - Parameter error. Possible causes: 855 * <br> 1. Mandatory parameters are left unspecified. 856 * <br> 2. Incorrect parameters types. 857 * <br> 3. Parameter verification failed. 858 * @throws { BusinessError } 100001 - Internal error. 859 * @throws { BusinessError } 100003 - Page stack error. Too many pages are pushed. 860 * @throws { BusinessError } 100004 - Named route error. The named route does not exist. 861 * @syscap SystemCapability.ArkUI.ArkUI.Full 862 * @crossplatform 863 * @atomicservice 864 * @since arkts { '1.1':'11','1.2':'20' } 865 * @arkts 1.1&1.2 866 */ 867 pushNamedRoute(options: router.NamedRouterOptions, mode: router.RouterMode): Promise<void>; 868 869 /** 870 * Replaces the current page with another one in the application. The current page is destroyed after replacement. 871 * @param { router.NamedRouterOptions } options - Options. 872 * @param { AsyncCallback<void> } callback - the callback of replaceNamedRoute. 873 * @throws { BusinessError } 401 - Parameter error. Possible causes: 874 * <br> 1. Mandatory parameters are left unspecified. 875 * <br> 2. Incorrect parameters types. 876 * <br> 3. Parameter verification failed. 877 * @throws { BusinessError } 100001 - The UI execution context is not found. This error code is thrown only in the standard system. 878 * @throws { BusinessError } 100004 - Named route error. The named route does not exist. 879 * @syscap SystemCapability.ArkUI.ArkUI.Full 880 * @crossplatform 881 * @since 10 882 */ 883 /** 884 * Replaces the current page with another one in the application. The current page is destroyed after replacement. 885 * @param { router.NamedRouterOptions } options - Options. 886 * @param { AsyncCallback<void> } callback - the callback of replaceNamedRoute. 887 * @throws { BusinessError } 401 - Parameter error. Possible causes: 888 * <br> 1. Mandatory parameters are left unspecified. 889 * <br> 2. Incorrect parameters types. 890 * <br> 3. Parameter verification failed. 891 * @throws { BusinessError } 100001 - The UI execution context is not found. This error code is thrown only in the standard system. 892 * @throws { BusinessError } 100004 - Named route error. The named route does not exist. 893 * @syscap SystemCapability.ArkUI.ArkUI.Full 894 * @crossplatform 895 * @atomicservice 896 * @since arkts { '1.1':'11','1.2':'20' } 897 * @arkts 1.1&1.2 898 */ 899 replaceNamedRoute(options: router.NamedRouterOptions, callback: AsyncCallback<void>): void; 900 901 /** 902 * Replaces the current page with another one in the application. The current page is destroyed after replacement. 903 * @param { router.NamedRouterOptions } options - Options. 904 * @returns { Promise<void> } the promise returned by the function. 905 * @throws { BusinessError } 401 - Parameter error. Possible causes: 906 * <br> 1. Mandatory parameters are left unspecified. 907 * <br> 2. Incorrect parameters types. 908 * <br> 3. Parameter verification failed. 909 * @throws { BusinessError } 100001 - The UI execution context is not found. This error code is thrown only in the standard system. 910 * @throws { BusinessError } 100004 - Named route error. The named route does not exist. 911 * @syscap SystemCapability.ArkUI.ArkUI.Full 912 * @crossplatform 913 * @since 10 914 */ 915 /** 916 * Replaces the current page with another one in the application. The current page is destroyed after replacement. 917 * @param { router.NamedRouterOptions } options - Options. 918 * @returns { Promise<void> } the promise returned by the function. 919 * @throws { BusinessError } 401 - if the number of parameters is less than 1 or the type of the url parameter is not string. 920 * @throws { BusinessError } 100001 - The UI execution context is not found. This error code is thrown only in the standard system. 921 * @throws { BusinessError } 100004 - Named route error. The named route does not exist. 922 * @syscap SystemCapability.ArkUI.ArkUI.Full 923 * @crossplatform 924 * @atomicservice 925 * @since arkts { '1.1':'11','1.2':'20' } 926 * @arkts 1.1&1.2 927 */ 928 replaceNamedRoute(options: router.NamedRouterOptions): Promise<void>; 929 930 /** 931 * Replaces the current page with another one in the application. The current page is destroyed after replacement. 932 * @param { router.NamedRouterOptions } options - Options. 933 * @param { router.RouterMode } mode - RouterMode. 934 * @param { AsyncCallback<void> } callback - the callback of replaceNamedRoute. 935 * @throws { BusinessError } 401 - Parameter error. Possible causes: 936 * <br> 1. Mandatory parameters are left unspecified. 937 * <br> 2. Incorrect parameters types. 938 * <br> 3. Parameter verification failed. 939 * @throws { BusinessError } 100001 - The UI execution context is not found. This error code is thrown only in the standard system. 940 * @throws { BusinessError } 100004 - Named route error. The named route does not exist. 941 * @syscap SystemCapability.ArkUI.ArkUI.Full 942 * @crossplatform 943 * @since 10 944 */ 945 /** 946 * Replaces the current page with another one in the application. The current page is destroyed after replacement. 947 * @param { router.NamedRouterOptions } options - Options. 948 * @param { router.RouterMode } mode - RouterMode. 949 * @param { AsyncCallback<void> } callback - the callback of replaceNamedRoute. 950 * @throws { BusinessError } 401 - if the number of parameters is less than 1 or the type of the url parameter is not string. 951 * @throws { BusinessError } 100001 - The UI execution context is not found. This error code is thrown only in the standard system. 952 * @throws { BusinessError } 100004 - Named route error. The named route does not exist. 953 * @syscap SystemCapability.ArkUI.ArkUI.Full 954 * @crossplatform 955 * @atomicservice 956 * @since arkts { '1.1':'11','1.2':'20' } 957 * @arkts 1.1&1.2 958 */ 959 replaceNamedRoute(options: router.NamedRouterOptions, mode: router.RouterMode, callback: AsyncCallback<void>): void; 960 961 /** 962 * Replaces the current page with another one in the application. The current page is destroyed after replacement. 963 * @param { router.NamedRouterOptions } options - Options. 964 * @param { router.RouterMode } mode - RouterMode. 965 * @returns { Promise<void> } the promise returned by the function. 966 * @throws { BusinessError } 401 - Parameter error. Possible causes: 967 * <br> 1. Mandatory parameters are left unspecified. 968 * <br> 2. Incorrect parameters types. 969 * <br> 3. Parameter verification failed. 970 * @throws { BusinessError } 100001 - Failed to get the delegate. This error code is thrown only in the standard system. 971 * @throws { BusinessError } 100004 - Named route error. The named route does not exist. 972 * @syscap SystemCapability.ArkUI.ArkUI.Full 973 * @crossplatform 974 * @since 10 975 */ 976 /** 977 * Replaces the current page with another one in the application. The current page is destroyed after replacement. 978 * @param { router.NamedRouterOptions } options - Options. 979 * @param { router.RouterMode } mode - RouterMode. 980 * @returns { Promise<void> } the promise returned by the function. 981 * @throws { BusinessError } 401 - Parameter error. Possible causes: 982 * <br> 1. Mandatory parameters are left unspecified. 983 * <br> 2. Incorrect parameters types. 984 * <br> 3. Parameter verification failed. 985 * @throws { BusinessError } 100001 - Failed to get the delegate. This error code is thrown only in the standard system. 986 * @throws { BusinessError } 100004 - Named route error. The named route does not exist. 987 * @syscap SystemCapability.ArkUI.ArkUI.Full 988 * @crossplatform 989 * @atomicservice 990 * @since arkts { '1.1':'11','1.2':'20' } 991 * @arkts 1.1&1.2 992 */ 993 replaceNamedRoute(options: router.NamedRouterOptions, mode: router.RouterMode): Promise<void>; 994} 995 996/** 997 * Defines the custom builder with id. 998 * 999 * @typedef { function } CustomBuilderWithId 1000 * @syscap SystemCapability.ArkUI.ArkUI.Full 1001 * @crossplatform 1002 * @atomicservice 1003 * @since arkts { '1.1':'18','1.2':'20' } 1004 * @arkts 1.1&1.2 1005 */ 1006declare type CustomBuilderWithId = (id: number) => void; 1007 1008/** 1009 * Defines the target info. 1010 * 1011 * @interface TargetInfo 1012 * @syscap SystemCapability.ArkUI.ArkUI.Full 1013 * @crossplatform 1014 * @atomicservice 1015 * @since arkts { '1.1':'18','1.2':'20' } 1016 * @arkts 1.1&1.2 1017 */ 1018export interface TargetInfo { 1019 /** 1020 * ID of target node. 1021 * 1022 * @type { string | number } 1023 * @syscap SystemCapability.ArkUI.ArkUI.Full 1024 * @crossplatform 1025 * @atomicservice 1026 * @since arkts { '1.1':'18','1.2':'20' } 1027 * @arkts 1.1&1.2 1028 */ 1029 id: string | number; 1030 1031 /** 1032 * Unique ID that generated by framework. This ID used to constrain range of target. 1033 * 1034 * @type { ?number } 1035 * @syscap SystemCapability.ArkUI.ArkUI.Full 1036 * @crossplatform 1037 * @atomicservice 1038 * @since arkts { '1.1':'18','1.2':'20' } 1039 * @arkts 1.1&1.2 1040 */ 1041 componentId?: number; 1042} 1043 1044/** 1045 * class PromptAction 1046 * 1047 * @syscap SystemCapability.ArkUI.ArkUI.Full 1048 * @crossplatform 1049 * @since 10 1050 */ 1051/** 1052 * class PromptAction 1053 * 1054 * @syscap SystemCapability.ArkUI.ArkUI.Full 1055 * @crossplatform 1056 * @atomicservice 1057 * @since arkts { '1.1':'11','1.2':'20' } 1058 * @arkts 1.1&1.2 1059 */ 1060export declare class PromptAction { 1061 /** 1062 * Displays the notification text. 1063 * 1064 * @param { promptAction.ShowToastOptions } options - Options. 1065 * @throws { BusinessError } 401 - Parameter error. Possible causes: 1066 * <br> 1. Mandatory parameters are left unspecified. 1067 * <br> 2. Incorrect parameters types. 1068 * <br> 3. Parameter verification failed. 1069 * @throws { BusinessError } 100001 - Internal error. 1070 * @syscap SystemCapability.ArkUI.ArkUI.Full 1071 * @crossplatform 1072 * @since 10 1073 */ 1074 /** 1075 * Shows a toast in the given settings. 1076 * 1077 * @param { promptAction.ShowToastOptions } options - Toast options. 1078 * @throws { BusinessError } 401 - Parameter error. Possible causes: 1079 * <br> 1. Mandatory parameters are left unspecified. 1080 * <br> 2. Incorrect parameters types. 1081 * <br> 3. Parameter verification failed. 1082 * @throws { BusinessError } 100001 - Internal error. 1083 * @syscap SystemCapability.ArkUI.ArkUI.Full 1084 * @crossplatform 1085 * @atomicservice 1086 * @since arkts { '1.1':'11','1.2':'20' } 1087 * @arkts 1.1&1.2 1088 */ 1089 showToast(options: promptAction.ShowToastOptions): void; 1090 1091 /** 1092 * Displays the notification text. 1093 * 1094 * @param { promptAction.ShowToastOptions } options - Options. 1095 * @returns { Promise<number> } return the toast id that will be used by closeToast. 1096 * @throws { BusinessError } 401 - Parameter error. Possible causes: 1097 * <br> 1. Mandatory parameters are left unspecified. 1098 * <br> 2. Incorrect parameters types. 1099 * <br> 3. Parameter verification failed. 1100 * @throws { BusinessError } 100001 - Internal error. 1101 * @syscap SystemCapability.ArkUI.ArkUI.Full 1102 * @crossplatform 1103 * @atomicservice 1104 * @since arkts { '1.1':'18','1.2':'20' } 1105 * @arkts 1.1&1.2 1106 */ 1107 openToast(options: promptAction.ShowToastOptions): Promise<number>; 1108 1109 /** 1110 * Close the notification text. 1111 * 1112 * @param { number } toastId - the toast id that returned by openToast. 1113 * @throws { BusinessError } 401 - Parameter error. Possible causes: 1114 * <br> 1. Mandatory parameters are left unspecified. 1115 * <br> 2. Incorrect parameters types. 1116 * <br> 3. Parameter verification failed. 1117 * @throws { BusinessError } 100001 - Internal error. 1118 * @throws { BusinessError } 103401 - Cannot find the toast. 1119 * @syscap SystemCapability.ArkUI.ArkUI.Full 1120 * @crossplatform 1121 * @atomicservice 1122 * @since arkts { '1.1':'18','1.2':'20' } 1123 * @arkts 1.1&1.2 1124 */ 1125 closeToast(toastId: number): void; 1126 1127 /** 1128 * Displays the dialog box. 1129 * 1130 * @param { promptAction.ShowDialogOptions } options - Options. 1131 * @param { AsyncCallback<promptAction.ShowDialogSuccessResponse> } callback - the callback of showDialog. 1132 * @throws { BusinessError } 401 - Parameter error. Possible causes: 1133 * <br> 1. Mandatory parameters are left unspecified. 1134 * <br> 2. Incorrect parameters types. 1135 * <br> 3. Parameter verification failed. 1136 * @throws { BusinessError } 100001 - Internal error. 1137 * @syscap SystemCapability.ArkUI.ArkUI.Full 1138 * @crossplatform 1139 * @since 10 1140 */ 1141 /** 1142 * Displays the dialog box. 1143 * 1144 * @param { promptAction.ShowDialogOptions } options - Options. 1145 * @param { AsyncCallback<promptAction.ShowDialogSuccessResponse> } callback - the callback of showDialog. 1146 * @throws { BusinessError } 401 - Parameter error. Possible causes: 1147 * <br> 1. Mandatory parameters are left unspecified. 1148 * <br> 2. Incorrect parameters types. 1149 * <br> 3. Parameter verification failed. 1150 * @throws { BusinessError } 100001 - Internal error. 1151 * @syscap SystemCapability.ArkUI.ArkUI.Full 1152 * @crossplatform 1153 * @atomicservice 1154 * @since 11 1155 */ 1156 /** 1157 * Shows a dialog box in the given settings. This API uses an asynchronous callback to return the result. 1158 * 1159 * @param { promptAction.ShowDialogOptions } options - Dialog box options. 1160 * @param { AsyncCallback<promptAction.ShowDialogSuccessResponse> } callback - Callback used to return the dialog 1161 * box response result. 1162 * @throws { BusinessError } 401 - Parameter error. Possible causes: 1163 * <br> 1. Mandatory parameters are left unspecified. 1164 * <br> 2. Incorrect parameters types. 1165 * <br> 3. Parameter verification failed. 1166 * @throws { BusinessError } 100001 - Internal error. 1167 * @syscap SystemCapability.ArkUI.ArkUI.Full 1168 * @crossplatform 1169 * @atomicservice 1170 * @since arkts { '1.1':'12','1.2':'20' } 1171 * @arkts 1.1&1.2 1172 */ 1173 showDialog(options: promptAction.ShowDialogOptions, callback: AsyncCallback<promptAction.ShowDialogSuccessResponse>): void; 1174 1175 /** 1176 * Displays the dialog box. 1177 * 1178 * @param { promptAction.ShowDialogOptions } options - Options. 1179 * @returns { Promise<promptAction.ShowDialogSuccessResponse> } the promise returned by the function. 1180 * @throws { BusinessError } 401 - Parameter error. Possible causes: 1181 * <br> 1. Mandatory parameters are left unspecified. 1182 * <br> 2. Incorrect parameters types. 1183 * <br> 3. Parameter verification failed. 1184 * @throws { BusinessError } 100001 - Internal error. 1185 * @syscap SystemCapability.ArkUI.ArkUI.Full 1186 * @crossplatform 1187 * @since 10 1188 */ 1189 /** 1190 * Shows a dialog box. This API uses a promise to return the result. 1191 * 1192 * @param { promptAction.ShowDialogOptions } options - Dialog box options. 1193 * @returns { Promise<promptAction.ShowDialogSuccessResponse> } Promise used to return the dialog 1194 * box response result. 1195 * @throws { BusinessError } 401 - Parameter error. Possible causes: 1196 * <br> 1. Mandatory parameters are left unspecified. 1197 * <br> 2. Incorrect parameters types. 1198 * <br> 3. Parameter verification failed. 1199 * @throws { BusinessError } 100001 - Internal error. 1200 * @syscap SystemCapability.ArkUI.ArkUI.Full 1201 * @crossplatform 1202 * @atomicservice 1203 * @since arkts { '1.1':'11','1.2':'20' } 1204 * @arkts 1.1&1.2 1205 */ 1206 showDialog(options: promptAction.ShowDialogOptions): Promise<promptAction.ShowDialogSuccessResponse>; 1207 1208 /** 1209 * Shows an action menu in the given settings. This API uses an asynchronous callback to return the result. 1210 * 1211 * @param { promptAction.ActionMenuOptions } options - Action menu options. 1212 * @param { promptAction.ActionMenuSuccessResponse } callback - Callback used to return the action menu 1213 * response result. 1214 * @throws { BusinessError } 401 - Parameter error. Possible causes: 1215 * <br> 1. Mandatory parameters are left unspecified. 1216 * <br> 2. Incorrect parameters types. 1217 * <br> 3. Parameter verification failed. 1218 * @throws { BusinessError } 100001 - Internal error. 1219 * @syscap SystemCapability.ArkUI.ArkUI.Full 1220 * @crossplatform 1221 * @since 10 1222 * @deprecated since 11 1223 * @useinstead showActionMenu 1224 */ 1225 showActionMenu(options: promptAction.ActionMenuOptions, callback: promptAction.ActionMenuSuccessResponse): void; 1226 1227 /** 1228 * Shows an action menu in the given settings. This API uses an asynchronous callback to return the result. 1229 * 1230 * @param { promptAction.ActionMenuOptions } options - Action menu options. 1231 * @param { AsyncCallback<promptAction.ActionMenuSuccessResponse> } callback - Callback used to return the action 1232 * menu response result. 1233 * @throws { BusinessError } 401 - Parameter error. Possible causes: 1234 * <br> 1. Mandatory parameters are left unspecified. 1235 * <br> 2. Incorrect parameters types. 1236 * <br> 3. Parameter verification failed. 1237 * @throws { BusinessError } 100001 - Internal error. 1238 * @syscap SystemCapability.ArkUI.ArkUI.Full 1239 * @crossplatform 1240 * @atomicservice 1241 * @since arkts { '1.1':'11','1.2':'20' } 1242 * @arkts 1.1&1.2 1243 */ 1244 showActionMenu(options: promptAction.ActionMenuOptions, callback: AsyncCallback<promptAction.ActionMenuSuccessResponse>): void; 1245 1246 /** 1247 * Displays the menu. 1248 * 1249 * @param { promptAction.ActionMenuOptions } options - Options. 1250 * @returns { Promise<promptAction.ActionMenuSuccessResponse> } callback - the callback of showActionMenu. 1251 * @throws { BusinessError } 401 - Parameter error. Possible causes: 1252 * <br> 1. Mandatory parameters are left unspecified. 1253 * <br> 2. Incorrect parameters types. 1254 * <br> 3. Parameter verification failed. 1255 * @throws { BusinessError } 100001 - Internal error. 1256 * @syscap SystemCapability.ArkUI.ArkUI.Full 1257 * @crossplatform 1258 * @since 10 1259 */ 1260 /** 1261 * Shows an action menu in the given settings. This API uses an asynchronous callback to return the result. 1262 * 1263 * @param { promptAction.ActionMenuOptions } options - Action menu options. 1264 * @returns { Promise<promptAction.ActionMenuSuccessResponse> } callback - Promise used to return the action 1265 * menu response result. 1266 * @throws { BusinessError } 401 - Parameter error. Possible causes: 1267 * <br> 1. Mandatory parameters are left unspecified. 1268 * <br> 2. Incorrect parameters types. 1269 * <br> 3. Parameter verification failed. 1270 * @throws { BusinessError } 100001 - Internal error. 1271 * @syscap SystemCapability.ArkUI.ArkUI.Full 1272 * @crossplatform 1273 * @atomicservice 1274 * @since arkts { '1.1':'11','1.2':'20' } 1275 * @arkts 1.1&1.2 1276 */ 1277 showActionMenu(options: promptAction.ActionMenuOptions): Promise<promptAction.ActionMenuSuccessResponse>; 1278 1279 /** 1280 * Open the custom dialog with frameNode. 1281 * 1282 * @param { ComponentContent<T> } dialogContent - the content of custom dialog. 1283 * @param { promptAction.BaseDialogOptions } options - Options. 1284 * @returns { Promise<void> } the promise returned by the function. 1285 * @throws { BusinessError } 401 - Parameter error. Possible causes: 1286 * <br> 1. Mandatory parameters are left unspecified. 1287 * <br> 2. Incorrect parameters types. 1288 * <br> 3. Parameter verification failed. 1289 * @throws { BusinessError } 103301 - Dialog content error. The ComponentContent is incorrect. 1290 * @throws { BusinessError } 103302 - Dialog content already exist. The ComponentContent has already been opened. 1291 * @syscap SystemCapability.ArkUI.ArkUI.Full 1292 * @crossplatform 1293 * @atomicservice 1294 * @since arkts { '1.1':'12','1.2':'20' } 1295 * @arkts 1.1&1.2 1296 */ 1297 openCustomDialog<T extends Object>(dialogContent: ComponentContent<T>, options?: promptAction.BaseDialogOptions): Promise<void>; 1298 1299 /** 1300 * Open the custom dialog with frameNode and controller. 1301 * 1302 * isModal = true and showInSubWindow = true cannot be used at the same time. 1303 * 1304 * @param { ComponentContent<T> } dialogContent - the content of custom dialog. 1305 * @param { promptAction.DialogController } controller - Dialog controller. 1306 * @param { promptAction.BaseDialogOptions } [options] - Options. 1307 * @returns { Promise<void> } the promise returned by the function. 1308 * @throws { BusinessError } 401 - Parameter error. Possible causes: 1309 * <br> 1. Mandatory parameters are left unspecified. 1310 * <br> 2. Incorrect parameters types. 1311 * <br> 3. Parameter verification failed. 1312 * @throws { BusinessError } 103301 - Dialog content error. The ComponentContent is incorrect. 1313 * @throws { BusinessError } 103302 - Dialog content already exist. The ComponentContent has already been opened. 1314 * @syscap SystemCapability.ArkUI.ArkUI.Full 1315 * @crossplatform 1316 * @atomicservice 1317 * @since arkts { '1.1':'18','1.2':'20' } 1318 * @arkts 1.1&1.2 1319 */ 1320 openCustomDialogWithController<T extends Object>(dialogContent: ComponentContent<T>, controller: promptAction.DialogController, 1321 options?: promptAction.BaseDialogOptions): Promise<void>; 1322 1323 /** 1324 * Update the custom dialog with frameNode. 1325 * 1326 * @param { ComponentContent<T> } dialogContent - the content of custom dialog. 1327 * @param { promptAction.BaseDialogOptions } options - Options. 1328 * only alignment, offset, autoCancel, and maskColor can be updated. 1329 * @returns { Promise<void> } the promise returned by the function. 1330 * @throws { BusinessError } 401 - Parameter error. Possible causes: 1331 * <br> 1. Mandatory parameters are left unspecified. 1332 * <br> 2. Incorrect parameters types. 1333 * <br> 3. Parameter verification failed. 1334 * @throws { BusinessError } 103301 - Dialog content error. The ComponentContent is incorrect. 1335 * @throws { BusinessError } 103303 - Dialog content not found. The ComponentContent cannot be found. 1336 * @syscap SystemCapability.ArkUI.ArkUI.Full 1337 * @crossplatform 1338 * @atomicservice 1339 * @since arkts { '1.1':'12','1.2':'20' } 1340 * @arkts 1.1&1.2 1341 */ 1342 updateCustomDialog<T extends Object>(dialogContent: ComponentContent<T>, options: promptAction.BaseDialogOptions): Promise<void>; 1343 1344 /** 1345 * Closes a custom dialog box corresponding to dialogContent. This API uses a promise to return the result. 1346 * 1347 * @param { ComponentContent<T> } dialogContent - Content of the custom dialog box. 1348 * @returns { Promise<void> } Promise used to return the result. 1349 * @throws { BusinessError } 401 - Parameter error. Possible causes: 1350 * <br> 1. Mandatory parameters are left unspecified. 1351 * <br> 2. Incorrect parameters types. 1352 * <br> 3. Parameter verification failed. 1353 * @throws { BusinessError } 103301 - Dialog content error. The ComponentContent is incorrect. 1354 * @throws { BusinessError } 103303 - Dialog content not found. The ComponentContent cannot be found. 1355 * @syscap SystemCapability.ArkUI.ArkUI.Full 1356 * @crossplatform 1357 * @atomicservice 1358 * @since 12 1359 */ 1360 closeCustomDialog<T extends Object>(dialogContent: ComponentContent<T>): Promise<void>; 1361 1362 /** 1363 * Open the custom dialog. 1364 * 1365 * isModal = true and showInSubWindow = true cannot be used at the same time. 1366 * 1367 * @param { promptAction.CustomDialogOptions } options - Options. 1368 * @returns { Promise<number> } return the dialog id that will be used by closeCustomDialog. 1369 * @throws { BusinessError } 401 - Parameter error. Possible causes: 1370 * <br> 1. Mandatory parameters are left unspecified. 1371 * <br> 2. Incorrect parameters types. 1372 * <br> 3. Parameter verification failed. 1373 * @throws { BusinessError } 100001 - Internal error. 1374 * @syscap SystemCapability.ArkUI.ArkUI.Full 1375 * @crossplatform 1376 * @atomicservice 1377 * @since arkts { '1.1':'12','1.2':'20' } 1378 * @arkts 1.1&1.2 1379 */ 1380 openCustomDialog(options: promptAction.CustomDialogOptions): Promise<number>; 1381 1382 /** 1383 * Present the custom dialog with controller. 1384 * 1385 * isModal = true and showInSubWindow = true cannot be used at the same time. 1386 * 1387 * @param { CustomBuilder | CustomBuilderWithId } builder - Dialog builder. 1388 * @param { promptAction.DialogController } [controller] - Dialog controller. 1389 * @param { promptAction.DialogOptions } [options] - Options. 1390 * @returns { Promise<number> } return the dialog id that will be used by closeCustomDialog. 1391 * @throws { BusinessError } 401 - Parameter error. Possible causes: 1392 * <br> 1. Mandatory parameters are left unspecified. 1393 * <br> 2. Incorrect parameters types. 1394 * <br> 3. Parameter verification failed. 1395 * @throws { BusinessError } 100001 - Internal error. 1396 * @syscap SystemCapability.ArkUI.ArkUI.Full 1397 * @crossplatform 1398 * @atomicservice 1399 * @since arkts { '1.1':'18','1.2':'20' } 1400 * @arkts 1.1&1.2 1401 */ 1402 presentCustomDialog(builder: CustomBuilder | CustomBuilderWithId, controller?: promptAction.DialogController, 1403 options?: promptAction.DialogOptions): Promise<number>; 1404 1405 /** 1406 * Close the custom dialog. 1407 * 1408 * @param { number } dialogId - the dialog id that returned by openCustomDialog. 1409 * @throws { BusinessError } 401 - Parameter error. Possible causes: 1410 * <br> 1. Mandatory parameters are left unspecified. 1411 * <br> 2. Incorrect parameters types. 1412 * <br> 3. Parameter verification failed. 1413 * @throws { BusinessError } 100001 - Internal error. 1414 * @syscap SystemCapability.ArkUI.ArkUI.Full 1415 * @crossplatform 1416 * @atomicservice 1417 * @since arkts { '1.1':'12','1.2':'20' } 1418 * @arkts 1.1&1.2 1419 */ 1420 closeCustomDialog(dialogId: number): void; 1421 1422 /** 1423 * Get order value of top dialog. 1424 * 1425 * @returns { LevelOrder } the display order. 1426 * @syscap SystemCapability.ArkUI.ArkUI.Full 1427 * @crossplatform 1428 * @atomicservice 1429 * @since arkts { '1.1':'18','1.2':'20' } 1430 * @arkts 1.1&1.2 1431 */ 1432 getTopOrder(): LevelOrder; 1433 1434 /** 1435 * Get order value of bottom dialog. 1436 * 1437 * @returns { LevelOrder } the display order. 1438 * @syscap SystemCapability.ArkUI.ArkUI.Full 1439 * @crossplatform 1440 * @atomicservice 1441 * @since arkts { '1.1':'18','1.2':'20' } 1442 * @arkts 1.1&1.2 1443 */ 1444 getBottomOrder(): LevelOrder; 1445 1446 /** 1447 * Open popup with frameNode. 1448 * 1449 * @param { ComponentContent<T> } content - The content of popup. 1450 * @param { TargetInfo } target - The target of popup. 1451 * @param { PopupCommonOptions } [options] - Options. 1452 * @returns { Promise<void> } the promise returned by the function. 1453 * @throws { BusinessError } 401 - Parameter error. Possible causes: 1454 * <br> 1. Mandatory parameters are left unspecified. 1455 * <br> 2. Incorrect parameters types. 1456 * <br> 3. Parameter verification failed. 1457 * @throws { BusinessError } 103301 - The ComponentContent is incorrect. 1458 * @throws { BusinessError } 103302 - The ComponentContent already exists. 1459 * @throws { BusinessError } 103304 - The targetId does not exist. 1460 * @throws { BusinessError } 103305 - The node of targetId is not in the component tree. 1461 * @syscap SystemCapability.ArkUI.ArkUI.Full 1462 * @crossplatform 1463 * @atomicservice 1464 * @since arkts { '1.1':'18','1.2':'20' } 1465 * @arkts 1.1&1.2 1466 */ 1467 openPopup<T extends Object>(content: ComponentContent<T>, target: TargetInfo, options?: PopupCommonOptions): Promise<void>; 1468 1469 /** 1470 * Update popup with frameNode. 1471 * 1472 * @param { ComponentContent<T> } content - The content of popup. 1473 * @param { PopupCommonOptions } options - Options. 1474 * @param { boolean } [partialUpdate] - If true, only the specified properties in the options are updated, 1475 * otherwise the rest of the properties are overwritten with the default values. 1476 * Default value is false. 1477 * @returns { Promise<void> } the promise returned by the function. 1478 * @throws { BusinessError } 401 - Parameter error. Possible causes: 1479 * <br> 1. Mandatory parameters are left unspecified. 1480 * <br> 2. Incorrect parameters types. 1481 * <br> 3. Parameter verification failed. 1482 * @throws { BusinessError } 103301 - The ComponentContent is incorrect. 1483 * @throws { BusinessError } 103303 - The ComponentContent cannot be found. 1484 * @syscap SystemCapability.ArkUI.ArkUI.Full 1485 * @crossplatform 1486 * @atomicservice 1487 * @since arkts { '1.1':'18','1.2':'20' } 1488 * @arkts 1.1&1.2 1489 */ 1490 updatePopup<T extends Object>(content: ComponentContent<T>, options: PopupCommonOptions, partialUpdate?: boolean): Promise<void>; 1491 1492 /** 1493 * Close popup with frameNode. 1494 * 1495 * @param { ComponentContent<T> } content - The content of popup. 1496 * @returns { Promise<void> } the promise returned by the function. 1497 * @throws { BusinessError } 401 - Parameter error. Possible causes: 1498 * <br> 1. Mandatory parameters are left unspecified. 1499 * <br> 2. Incorrect parameters types. 1500 * <br> 3. Parameter verification failed. 1501 * @throws { BusinessError } 103301 - The ComponentContent is incorrect. 1502 * @throws { BusinessError } 103303 - The ComponentContent cannot be found. 1503 * @syscap SystemCapability.ArkUI.ArkUI.Full 1504 * @crossplatform 1505 * @atomicservice 1506 * @since arkts { '1.1':'18','1.2':'20' } 1507 * @arkts 1.1&1.2 1508 */ 1509 closePopup<T extends Object>(content: ComponentContent<T>): Promise<void>; 1510 1511 /** 1512 * Open menu with frameNode. 1513 * 1514 * @param { ComponentContent<T> } content - The content of menu. 1515 * @param { TargetInfo } target - The target of menu. 1516 * @param { MenuOptions } [options] - Options. 1517 * @returns { Promise<void> } the promise returned by the function. 1518 * @throws { BusinessError } 401 - Parameter error. Possible causes: 1519 * <br> 1. Mandatory parameters are left unspecified. 1520 * <br> 2. Incorrect parameters types. 1521 * <br> 3. Parameter verification failed. 1522 * @throws { BusinessError } 103301 - The ComponentContent is incorrect. 1523 * @throws { BusinessError } 103302 - The ComponentContent already exists. 1524 * @throws { BusinessError } 103304 - The targetId does not exist. 1525 * @throws { BusinessError } 103305 - The node of targetId is not in the component tree. 1526 * @syscap SystemCapability.ArkUI.ArkUI.Full 1527 * @crossplatform 1528 * @atomicservice 1529 * @since arkts { '1.1':'18','1.2':'20' } 1530 * @arkts 1.1&1.2 1531 */ 1532 openMenu<T extends Object>(content: ComponentContent<T>, target: TargetInfo, options?: MenuOptions): Promise<void>; 1533 1534 /** 1535 * Update menu with frameNode. 1536 * 1537 * @param { ComponentContent<T> } content - The content of menu. 1538 * @param { MenuOptions } options - Options. 1539 * @param { boolean } [partialUpdate] - If true, only the specified properties in the MenuOptions are updated, 1540 * otherwise the rest of the properties are overwritten with the default values. 1541 * Default value is false. 1542 * @returns { Promise<void> } the promise returned by the function. 1543 * @throws { BusinessError } 401 - Parameter error. Possible causes: 1544 * <br> 1. Mandatory parameters are left unspecified. 1545 * <br> 2. Incorrect parameters types. 1546 * <br> 3. Parameter verification failed. 1547 * @throws { BusinessError } 103301 - The ComponentContent is incorrect. 1548 * @throws { BusinessError } 103303 - The ComponentContent cannot be found. 1549 * @syscap SystemCapability.ArkUI.ArkUI.Full 1550 * @crossplatform 1551 * @atomicservice 1552 * @since arkts { '1.1':'18','1.2':'20' } 1553 * @arkts 1.1&1.2 1554 */ 1555 updateMenu<T extends Object>(content: ComponentContent<T>, options: MenuOptions, partialUpdate?: boolean): Promise<void>; 1556 1557 /** 1558 * Close menu with frameNode. 1559 * 1560 * @param { ComponentContent<T> } content - The content of menu. 1561 * @returns { Promise<void> } the promise returned by the function. 1562 * @throws { BusinessError } 401 - Parameter error. Possible causes: 1563 * <br> 1. Mandatory parameters are left unspecified. 1564 * <br> 2. Incorrect parameters types. 1565 * <br> 3. Parameter verification failed. 1566 * @throws { BusinessError } 103301 - The ComponentContent is incorrect. 1567 * @throws { BusinessError } 103303 - The ComponentContent cannot be found. 1568 * @syscap SystemCapability.ArkUI.ArkUI.Full 1569 * @crossplatform 1570 * @atomicservice 1571 * @since arkts { '1.1':'18','1.2':'20' } 1572 * @arkts 1.1&1.2 1573 */ 1574 closeMenu<T extends Object>(content: ComponentContent<T>): Promise<void>; 1575} 1576 1577/** 1578 * Defines the callback type used in UIObserver watch click event. 1579 * The value of event indicates the information of ClickEvent. 1580 * The value of node indicates the frameNode which will receive the event. 1581 * 1582 * @typedef { function } ClickEventListenerCallback 1583 * @param { ClickEvent } event - the information of ClickEvent 1584 * @param { FrameNode } [node] - the information of frameNode 1585 * @syscap SystemCapability.ArkUI.ArkUI.Full 1586 * @crossplatform 1587 * @atomicservice 1588 * @since arkts { '1.1':'12','1.2':'20' } 1589 * @arkts 1.1&1.2 1590 */ 1591declare type ClickEventListenerCallback = (event: ClickEvent, node?: FrameNode) => void; 1592 1593/** 1594 * Defines the callback type used in UIObserver watch pan event. 1595 * The value of event indicates the information of pan event. 1596 * The value of node indicates the frameNode which will receive the event. 1597 * 1598 * @typedef { function } PanListenerCallback 1599 * @param { GestureEvent } event - the information of pan event 1600 * @param { GestureRecognizer } current - the information of panRecognizer 1601 * @param { FrameNode } [node] - the information of frameNode 1602 * @syscap SystemCapability.ArkUI.ArkUI.Full 1603 * @crossplatform 1604 * @atomicservice 1605 * @since arkts { '1.1':'19','1.2':'20' } 1606 * @arkts 1.1&1.2 1607 */ 1608declare type PanListenerCallback = (event: GestureEvent, current: GestureRecognizer, node?: FrameNode) => void; 1609 1610/** 1611 * Defines the callback type used in UIObserver watch gesture. 1612 * The value of event indicates the information of gesture. 1613 * The value of node indicates the frameNode which will receive the event. 1614 * 1615 * @typedef { function } GestureEventListenerCallback 1616 * @param { GestureEvent } event - the information of GestureEvent 1617 * @param { FrameNode } [node] - the information of frameNode 1618 * @syscap SystemCapability.ArkUI.ArkUI.Full 1619 * @crossplatform 1620 * @atomicservice 1621 * @since arkts { '1.1':'12','1.2':'20' } 1622 * @arkts 1.1&1.2 1623 */ 1624declare type GestureEventListenerCallback = (event: GestureEvent, node?: FrameNode) => void; 1625 1626/** 1627 * Defines the type can be used for identiting the node, for the string type, it's the inspector id 1628 * set through .id attribute, and for the number type, it's the unique ID got from the FrameNode by 1629 * getUniqueID method. 1630 * 1631 * @typedef { string | number } NodeIdentity 1632 * @syscap SystemCapability.ArkUI.ArkUI.Full 1633 * @crossplatform 1634 * @atomicservice 1635 * @since 20 1636 */ 1637export declare type NodeIdentity = string | number; 1638 1639/** 1640 * Defines the callback type used in UIObserver to monitor one specific node's render state. 1641 * 1642 * @typedef { function } NodeRenderStateChangeCallback 1643 * @param { NodeRenderState } state - the node's render state 1644 * @param { FrameNode } [node] - the information of frameNode 1645 * @syscap SystemCapability.ArkUI.ArkUI.Full 1646 * @crossplatform 1647 * @atomicservice 1648 * @since 20 1649 */ 1650export declare type NodeRenderStateChangeCallback = (state: NodeRenderState, node?: FrameNode) => void; 1651 1652/** 1653 * Defines the callback type used in UIObserver to monitor specific gesture triggered information. 1654 * 1655 * @typedef { function } GestureListenerCallback 1656 * @param { GestureTriggerInfo } info - the gesture details triggered with user interaction 1657 * @syscap SystemCapability.ArkUI.ArkUI.Full 1658 * @crossplatform 1659 * @atomicservice 1660 * @since 20 1661 */ 1662export declare type GestureListenerCallback = (info: GestureTriggerInfo) => void; 1663 1664/** 1665 * Defines the PageInfo type. 1666 * The value of routerPageInfo indicates the information of the router page, or undefined if the 1667 * frameNode does not have router page information. And the value of navDestinationInfo indicates 1668 * the information of the navDestination, or undefined if the frameNode does not have navDestination 1669 * information. 1670 * 1671 * @interface PageInfo 1672 * @syscap SystemCapability.ArkUI.ArkUI.Full 1673 * @crossplatform 1674 * @atomicservice 1675 * @since arkts { '1.1':'12','1.2':'20' } 1676 * @arkts 1.1&1.2 1677 */ 1678export interface PageInfo { 1679 /** 1680 * the property of router page information. 1681 * 1682 * @type { ?observer.RouterPageInfo } 1683 * @syscap SystemCapability.ArkUI.ArkUI.Full 1684 * @atomicservice 1685 * @since arkts { '1.1':'12','1.2':'20' } 1686 * @arkts 1.1&1.2 1687 */ 1688 routerPageInfo?: observer.RouterPageInfo; 1689 1690 /** 1691 * the property of navDestination information. 1692 * 1693 * @type { ?observer.NavDestinationInfo } 1694 * @syscap SystemCapability.ArkUI.ArkUI.Full 1695 * @atomicservice 1696 * @since arkts { '1.1':'12','1.2':'20' } 1697 * @arkts 1.1&1.2 1698 */ 1699 navDestinationInfo?: observer.NavDestinationInfo; 1700} 1701 1702/** 1703 * the property of OverlayManager. 1704 * 1705 * @interface OverlayManagerOptions 1706 * @syscap SystemCapability.ArkUI.ArkUI.Full 1707 * @crossplatform 1708 * @atomicservice 1709 * @since arkts { '1.1':'15','1.2':'20' } 1710 * @arkts 1.1&1.2 1711 */ 1712export interface OverlayManagerOptions { 1713 /** 1714 * the render property of overlay node. 1715 * 1716 * @type { ?boolean } 1717 * @default true 1718 * @syscap SystemCapability.ArkUI.ArkUI.Full 1719 * @crossplatform 1720 * @atomicservice 1721 * @since arkts { '1.1':'15','1.2':'20' } 1722 * @arkts 1.1&1.2 1723 */ 1724 renderRootOverlay?: boolean; 1725 1726 /** 1727 * Set whether support backPressed event or not. 1728 * 1729 * @type { ?boolean } 1730 * @default false 1731 * @syscap SystemCapability.ArkUI.ArkUI.Full 1732 * @atomicservice 1733 * @since 19 1734 */ 1735 /** 1736 * Set whether support backPressed event or not. 1737 * 1738 * @type { ?boolean } 1739 * @default false 1740 * @syscap SystemCapability.ArkUI.ArkUI.Full 1741 * @crossplatform 1742 * @atomicservice 1743 * @since 20 1744 * @arkts 1.1&1.2 1745 */ 1746 enableBackPressedEvent?: boolean; 1747} 1748 1749/** 1750 * Register callbacks to observe ArkUI behavior. 1751 * In the following API examples, you must first use getUIObserver() in UIContext to obtain a UIObserver instance, and 1752 * then call the APIs using the obtained instance. 1753 * 1754 * @syscap SystemCapability.ArkUI.ArkUI.Full 1755 * @crossplatform 1756 * @since 11 1757 */ 1758/** 1759 * Register callbacks to observe ArkUI behavior. 1760 * In the following API examples, you must first use getUIObserver() in UIContext to obtain a UIObserver instance, and 1761 * then call the APIs using the obtained instance. 1762 * 1763 * @syscap SystemCapability.ArkUI.ArkUI.Full 1764 * @crossplatform 1765 * @atomicservice 1766 * @since 12 1767 */ 1768/** 1769 * Register callbacks to observe ArkUI behavior. 1770 * 1771 * @syscap SystemCapability.ArkUI.ArkUI.Full 1772 * @crossplatform 1773 * @atomicservice 1774 * @since 20 1775 * @arkts 1.1&1.2 1776 */ 1777export declare class UIObserver { 1778 /** 1779 * Subscribes to status changes of this **NavDestination** component. 1780 * 1781 * @param { 'navDestinationUpdate' } type - Event type. 1782 * The value is fixed at **'navDestinationUpdate'**, which indicates the state change event 1783 * <br>of the **NavDestination** component. 1784 * @param { object } options - ID of the target **NavDestination** component. 1785 * @param { Callback<observer.NavDestinationInfo> } callback - Callback used to return the current 1786 * <br>state of the **NavDestination** component. 1787 * @syscap SystemCapability.ArkUI.ArkUI.Full 1788 * @crossplatform 1789 * @since 11 1790 */ 1791 /** 1792 * Subscribes to status changes of this **NavDestination** component. 1793 * 1794 * @param { 'navDestinationUpdate' } type - Event type. 1795 * The value is fixed at **'navDestinationUpdate'**, which indicates the state change event 1796 * <br>of the **NavDestination** component. 1797 * @param { object } options - ID of the target **NavDestination** component. 1798 * @param { Callback<observer.NavDestinationInfo> } callback - Callback used to return the current 1799 * <br>state of the **NavDestination** component. 1800 * @syscap SystemCapability.ArkUI.ArkUI.Full 1801 * @crossplatform 1802 * @atomicservice 1803 * @since 12 1804 */ 1805 on(type: 'navDestinationUpdate', options: { navigationId: ResourceStr }, callback: Callback<observer.NavDestinationInfo>): void; 1806 1807 /** 1808 * Registers a callback function to be called when the navigation destination is updated. 1809 * 1810 * @param { 'navDestinationUpdate' } type - The type of event to listen for. Must be 'navDestinationUpdate'. 1811 * @param { observer.NavDestinationSwitchObserverOptions } options - The options object. 1812 * @param { Callback<observer.NavDestinationInfo> } callback - The callback function to be called when the navigation destination is updated. 1813 * @syscap SystemCapability.ArkUI.ArkUI.Full 1814 * @crossplatform 1815 * @atomicservice 1816 * @since 20 1817 * @arkts 1.2 1818 */ 1819 on( 1820 type: 'navDestinationUpdate', 1821 options: observer.NavDestinationSwitchObserverOptions, 1822 callback: Callback<observer.NavDestinationInfo> 1823 ): void; 1824 1825 /** 1826 * Removes a callback function that was previously registered with `on()`. 1827 * 1828 * @param { 'navDestinationUpdate' } type - The type of event to remove the listener for. Must be 'navDestinationUpdate'. 1829 * @param { object } options - Specify the id of observed navigation. 1830 * @param { Callback<observer.NavDestinationInfo> } callback - The callback function to remove. If not provided, all callbacks for the given event type and 1831 * navigation ID will be removed. 1832 * @syscap SystemCapability.ArkUI.ArkUI.Full 1833 * @crossplatform 1834 * @since 11 1835 */ 1836 /** 1837 * Removes a callback function that was previously registered with `on()`. 1838 * 1839 * @param { 'navDestinationUpdate' } type - The type of event to remove the listener for. Must be 'navDestinationUpdate'. 1840 * @param { object } options - The options object. 1841 * @param { Callback<observer.NavDestinationInfo> } callback - The callback function to remove. If not provided, all callbacks for the given event type and 1842 * navigation ID will be removed. 1843 * @syscap SystemCapability.ArkUI.ArkUI.Full 1844 * @crossplatform 1845 * @atomicservice 1846 * @since 12 1847 */ 1848 off(type: 'navDestinationUpdate', options: { navigationId: ResourceStr }, callback?: Callback<observer.NavDestinationInfo>): void; 1849 1850 /** 1851 * Removes a callback function that was previously registered with `on()`. 1852 * 1853 * @param { 'navDestinationUpdate' } type - The type of event to remove the listener for. Must be 'navDestinationUpdate'. 1854 * @param { observer.NavDestinationSwitchObserverOptions } options - The options object. 1855 * @param { Callback<observer.NavDestinationInfo> } callback - The callback function to remove. If not provided, all callbacks for the given event type and 1856 * navigation ID will be removed. 1857 * @syscap SystemCapability.ArkUI.ArkUI.Full 1858 * @crossplatform 1859 * @atomicservice 1860 * @since 20 1861 * @arkts 1.2 1862 */ 1863 off( 1864 type: 'navDestinationUpdate', 1865 options: observer.NavDestinationSwitchObserverOptions, 1866 callback?: Callback<observer.NavDestinationInfo> 1867 ): void; 1868 1869 /** 1870 * Subscribes to status changes of this **NavDestination** component. 1871 * 1872 * @param { 'navDestinationUpdate' } type - Event type. 1873 * The value is fixed at **'navDestinationUpdate'**, which indicates the state change event of 1874 * <br>the **NavDestination** component. 1875 * @param { Callback<observer.NavDestinationInfo> } callback - Callback used to return the current state of 1876 * <brthe **NavDestination** component. 1877 * @syscap SystemCapability.ArkUI.ArkUI.Full 1878 * @crossplatform 1879 * @since 11 1880 */ 1881 /** 1882 * Subscribes to status changes of this **NavDestination** component. 1883 * 1884 * @param { 'navDestinationUpdate' } type - Event type. 1885 * The value is fixed at **'navDestinationUpdate'**, 1886 * <br>which indicates the state change event of the **NavDestination** component. 1887 * @param { Callback<observer.NavDestinationInfo> } callback - Callback used to return the current state of 1888 * <br>the **NavDestination** component. 1889 * @syscap SystemCapability.ArkUI.ArkUI.Full 1890 * @crossplatform 1891 * @atomicservice 1892 * @since arkts { '1.1':'12','1.2':'20' } 1893 * @arkts 1.1&1.2 1894 */ 1895 on(type: 'navDestinationUpdate', callback: Callback<observer.NavDestinationInfo>): void; 1896 1897 /** 1898 * Removes a callback function that was previously registered with `on()`. 1899 * 1900 * @param { 'navDestinationUpdate'} type - The type of event to remove the listener for. Must be 'navDestinationUpdate'. 1901 * @param { Callback<observer.NavDestinationInfo> } [callback] - The callback function to remove. If not provided, all callbacks for the given event type 1902 * will be removed. 1903 * @syscap SystemCapability.ArkUI.ArkUI.Full 1904 * @crossplatform 1905 * @since 11 1906 */ 1907 /** 1908 * Removes a callback function that was previously registered with `on()`. 1909 * 1910 * @param { 'navDestinationUpdate'} type - The type of event to remove the listener for. Must be 'navDestinationUpdate'. 1911 * @param { Callback<observer.NavDestinationInfo> } [callback] - The callback function to remove. If not provided, all callbacks for the given event type 1912 * will be removed. 1913 * @syscap SystemCapability.ArkUI.ArkUI.Full 1914 * @crossplatform 1915 * @atomicservice 1916 * @since arkts { '1.1':'12','1.2':'20' } 1917 * @arkts 1.1&1.2 1918 */ 1919 off(type: 'navDestinationUpdate', callback?: Callback<observer.NavDestinationInfo>): void; 1920 1921 /** 1922 * Registers a callback function to be called when the navigation destination is updated. 1923 * 1924 * @param { 'navDestinationUpdateByUniqueId' } type - The type of event to listen for. Must be 'navDestinationUpdateByUniqueId'. 1925 * @param { number } navigationUniqueId - The uniqueId of the navigation. 1926 * @param { Callback<observer.NavDestinationInfo> } callback - The callback function to be called when the navigation destination is updated. 1927 * @syscap SystemCapability.ArkUI.ArkUI.Full 1928 * @crossplatform 1929 * @atomicservice 1930 * @since 20 1931 */ 1932 on(type: 'navDestinationUpdateByUniqueId', navigationUniqueId: number, callback: Callback<observer.NavDestinationInfo>): void; 1933 1934 /** 1935 * Removes a callback function that was previously registered with `on()`. 1936 * 1937 * @param { 'navDestinationUpdateByUniqueId'} type - The type of event to remove the listener for. Must be 'navDestinationUpdateByUniqueId'. 1938 * @param { number } navigationUniqueId - The uniqueId of the navigation. 1939 * @param { Callback<observer.NavDestinationInfo> } [callback] - The callback function to remove. If not provided, all callbacks for the given event type 1940 * will be removed. 1941 * @syscap SystemCapability.ArkUI.ArkUI.Full 1942 * @crossplatform 1943 * @atomicservice 1944 * @since 20 1945 */ 1946 off(type: 'navDestinationUpdateByUniqueId', navigationUniqueId: number, callback?: Callback<observer.NavDestinationInfo>): void; 1947 1948 /** 1949 * Registers a callback function to be called when the scroll event start or stop. 1950 * 1951 * @param { 'scrollEvent' } type - The type of event to listen for. Must be 'scrollEvent'. 1952 * @param { observer.ObserverOptions } options - The options object. 1953 * @param { Callback<observer.ScrollEventInfo> } callback - The callback function to be called when the scroll event start or stop. 1954 * @syscap SystemCapability.ArkUI.ArkUI.Full 1955 * @crossplatform 1956 * @atomicservice 1957 * @since arkts { '1.1':'12','1.2':'20' } 1958 * @arkts 1.1&1.2 1959 */ 1960 on(type: 'scrollEvent', options: observer.ObserverOptions, callback: Callback<observer.ScrollEventInfo>): void; 1961 1962 /** 1963 * Removes a callback function that was previously registered with `on()`. 1964 * 1965 * @param { 'scrollEvent' } type - The type of event to remove the listener for. Must be 'scrollEvent'. 1966 * @param { observer.ObserverOptions } options - The options object. 1967 * @param { Callback<observer.ScrollEventInfo> } callback - The callback function to remove. If not provided, all callbacks for the given event type and 1968 * scroll ID will be removed. 1969 * @syscap SystemCapability.ArkUI.ArkUI.Full 1970 * @crossplatform 1971 * @atomicservice 1972 * @since arkts { '1.1':'12','1.2':'20' } 1973 * @arkts 1.1&1.2 1974 */ 1975 off(type: 'scrollEvent', options: observer.ObserverOptions, callback?: Callback<observer.ScrollEventInfo>): void; 1976 1977 /** 1978 * Registers a callback function to be called when the scroll event start or stop. 1979 * 1980 * @param { 'scrollEvent' } type - The type of event to listen for. Must be 'scrollEvent'. 1981 * @param { Callback<observer.ScrollEventInfo> } callback - The callback function to be called when the scroll event start or stop. 1982 * @syscap SystemCapability.ArkUI.ArkUI.Full 1983 * @crossplatform 1984 * @atomicservice 1985 * @since arkts { '1.1':'12','1.2':'20' } 1986 * @arkts 1.1&1.2 1987 */ 1988 on(type: 'scrollEvent', callback: Callback<observer.ScrollEventInfo>): void; 1989 1990 /** 1991 * Removes a callback function that was previously registered with `on()`. 1992 * 1993 * @param { 'scrollEvent'} type - The type of event to remove the listener for. Must be 'scrollEvent'. 1994 * @param { Callback<observer.ScrollEventInfo> } [callback] - The callback function to remove. If not provided, all callbacks for the given event type 1995 * will be removed. 1996 * @syscap SystemCapability.ArkUI.ArkUI.Full 1997 * @crossplatform 1998 * @atomicservice 1999 * @since arkts { '1.1':'12','1.2':'20' } 2000 * @arkts 1.1&1.2 2001 */ 2002 off(type: 'scrollEvent', callback?: Callback<observer.ScrollEventInfo>): void; 2003 2004 /** 2005 * Unsubscribes to state changes of the page in the router. 2006 * 2007 * @param { 'routerPageUpdate' } type - Event type. 2008 * <br>The value is fixed at 'routerPageUpdate', which indicates the state change event of the page in the router. 2009 * @param { Callback<observer.RouterPageInfo> } callback - Callback to be unregistered. 2010 * @syscap SystemCapability.ArkUI.ArkUI.Full 2011 * @crossplatform 2012 * @since 11 2013 */ 2014 /** 2015 * Unsubscribes to state changes of the page in the router. 2016 * 2017 * @param { 'routerPageUpdate' } type - Event type. 2018 * <br>The value is fixed at 'routerPageUpdate', which indicates the state change event of the page in the router. 2019 * @param { Callback<observer.RouterPageInfo> } callback - Callback to be unregistered. 2020 * @syscap SystemCapability.ArkUI.ArkUI.Full 2021 * @crossplatform 2022 * @atomicservice 2023 * @since arkts { '1.1':'12','1.2':'20' } 2024 * @arkts 1.1&1.2 2025 */ 2026 on(type: 'routerPageUpdate', callback: Callback<observer.RouterPageInfo>): void; 2027 2028 /** 2029 * Removes a callback function that was previously registered with `on()`. 2030 * 2031 * @param { 'routerPageUpdate' } type - The type of event to remove the listener for. Must be 'routerPageUpdate'. 2032 * @param { Callback<observer.RouterPageInfo> } [callback] - The callback function to remove. If not provided, all callbacks for the given event type 2033 * will be removed. 2034 * @syscap SystemCapability.ArkUI.ArkUI.Full 2035 * @crossplatform 2036 * @since 11 2037 */ 2038 /** 2039 * Removes a callback function that was previously registered with `on()`. 2040 * 2041 * @param { 'routerPageUpdate' } type - The type of event to remove the listener for. Must be 'routerPageUpdate'. 2042 * @param { Callback<observer.RouterPageInfo> } [callback] - The callback function to remove. If not provided, all callbacks for the given event type 2043 * will be removed. 2044 * @syscap SystemCapability.ArkUI.ArkUI.Full 2045 * @crossplatform 2046 * @atomicservice 2047 * @since arkts { '1.1':'12','1.2':'20' } 2048 * @arkts 1.1&1.2 2049 */ 2050 off(type: 'routerPageUpdate', callback?: Callback<observer.RouterPageInfo>): void; 2051 2052 /** 2053 * Registers a callback function to be called when the screen density in a ui context is updated. 2054 * 2055 * @param { 'densityUpdate' } type - The type of event to listen for. Must be 'densityUpdate'. 2056 * @param { Callback<observer.DensityInfo> } callback - The callback function to be called when the screen density is updated. 2057 * @syscap SystemCapability.ArkUI.ArkUI.Full 2058 * @crossplatform 2059 * @atomicservice 2060 * @since arkts { '1.1':'12','1.2':'20' } 2061 * @arkts 1.1&1.2 2062 */ 2063 on(type: 'densityUpdate', callback: Callback<observer.DensityInfo>): void; 2064 2065 /** 2066 * Removes a callback function that was previously registered with `on()`. 2067 * 2068 * @param { 'densityUpdate' } type - The type of event to remove the listener for. Must be 'densityUpdate'. 2069 * @param { Callback<observer.DensityInfo> } [callback] - The callback function to remove. If not provided, all callbacks for the given event type 2070 * will be removed. 2071 * @syscap SystemCapability.ArkUI.ArkUI.Full 2072 * @crossplatform 2073 * @atomicservice 2074 * @since arkts { '1.1':'12','1.2':'20' } 2075 * @arkts 1.1&1.2 2076 */ 2077 off(type: 'densityUpdate', callback?: Callback<observer.DensityInfo>): void; 2078 2079 /** 2080 * Registers a callback function to be called when the draw command will be drawn. 2081 * 2082 * @param { 'willDraw' } type - The type of event to listen for. Must be 'willDraw'. 2083 * @param { Callback<void> } callback - The callback function to be called when the draw command will be drawn. 2084 * @syscap SystemCapability.ArkUI.ArkUI.Full 2085 * @crossplatform 2086 * @atomicservice 2087 * @since arkts { '1.1':'12','1.2':'20' } 2088 * @arkts 1.1&1.2 2089 */ 2090 on(type: 'willDraw', callback: Callback<void>): void; 2091 2092 /** 2093 * Removes a callback function that was previously registered with `on()`. 2094 * 2095 * @param { 'willDraw' } type - The type of event to remove the listener for. Must be 'willDraw'. 2096 * @param { Callback<void> } [callback] - The callback function to remove. If not provided, all callbacks for the given event type 2097 * will be removed. 2098 * @syscap SystemCapability.ArkUI.ArkUI.Full 2099 * @crossplatform 2100 * @atomicservice 2101 * @since arkts { '1.1':'12','1.2':'20' } 2102 * @arkts 1.1&1.2 2103 */ 2104 off(type: 'willDraw', callback?: Callback<void>): void; 2105 2106 /** 2107 * Registers a callback function to be called when the layout is done. 2108 * 2109 * @param { 'didLayout' } type - The type of event to listen for. Must be 'didLayout'. 2110 * @param { Callback<void> } callback - The callback function to be called when the layout is done. 2111 * @syscap SystemCapability.ArkUI.ArkUI.Full 2112 * @crossplatform 2113 * @atomicservice 2114 * @since arkts { '1.1':'12','1.2':'20' } 2115 * @arkts 1.1&1.2 2116 */ 2117 on(type: 'didLayout', callback: Callback<void>): void; 2118 2119 /** 2120 * Removes a callback function that was previously registered with `on()`. 2121 * 2122 * @param { 'didLayout' } type - The type of event to remove the listener for. Must be 'didLayout'. 2123 * @param { Callback<void> } [callback] - The callback function to remove. If not provided, all callbacks for the given event type 2124 * will be removed. 2125 * @syscap SystemCapability.ArkUI.ArkUI.Full 2126 * @crossplatform 2127 * @atomicservice 2128 * @since arkts { '1.1':'12','1.2':'20' } 2129 * @arkts 1.1&1.2 2130 */ 2131 off(type: 'didLayout', callback?: Callback<void>): void; 2132 2133 /** 2134 * Registers a callback function to be called when the navigation switched to a new navDestination. 2135 * 2136 * @param { 'navDestinationSwitch' } type - The type of event to listen for. Must be 'navDestinationSwitch'. 2137 * @param { Callback<observer.NavDestinationSwitchInfo> } callback - The callback function to be called when 2138 * the navigation switched to a new navDestination. 2139 * @syscap SystemCapability.ArkUI.ArkUI.Full 2140 * @crossplatform 2141 * @atomicservice 2142 * @since arkts { '1.1':'12','1.2':'20' } 2143 * @arkts 1.1&1.2 2144 */ 2145 on( 2146 type: 'navDestinationSwitch', 2147 callback: Callback<observer.NavDestinationSwitchInfo> 2148 ): void; 2149 2150 /** 2151 * Removes a callback function that was previously registered with `on()`. 2152 * 2153 * @param { 'navDestinationSwitch' } type - The type of event to remove the listener for. Must be 'navDestinationSwitch'. 2154 * @param { Callback<observer.NavDestinationSwitchInfo> } [callback] - The callback function to remove. If not provided, 2155 * all callbacks for the given event type will be removed. 2156 * @syscap SystemCapability.ArkUI.ArkUI.Full 2157 * @crossplatform 2158 * @atomicservice 2159 * @since arkts { '1.1':'12','1.2':'20' } 2160 * @arkts 1.1&1.2 2161 */ 2162 off( 2163 type: 'navDestinationSwitch', 2164 callback?: Callback<observer.NavDestinationSwitchInfo> 2165 ): void; 2166 2167 /** 2168 * Registers a callback function to be called when the navigation switched to a new navDestination. 2169 * 2170 * @param { 'navDestinationSwitch' } type - The type of event to listen for. Must be 'navDestinationSwitch'. 2171 * @param { observer.NavDestinationSwitchObserverOptions } observerOptions - Options. 2172 * @param { Callback<observer.NavDestinationSwitchInfo> } callback - The callback function to be called when the 2173 * navigation switched to a new navDestination. 2174 * @syscap SystemCapability.ArkUI.ArkUI.Full 2175 * @crossplatform 2176 * @atomicservice 2177 * @since arkts { '1.1':'12','1.2':'20' } 2178 * @arkts 1.1&1.2 2179 */ 2180 on( 2181 type: 'navDestinationSwitch', 2182 observerOptions: observer.NavDestinationSwitchObserverOptions, 2183 callback: Callback<observer.NavDestinationSwitchInfo> 2184 ): void; 2185 2186 /** 2187 * Removes a callback function that was previously registered with `on()`. 2188 * 2189 * @param { 'navDestinationSwitch' } type - The type of event to remove the listener for. Must be 'navDestinationSwitch'. 2190 * @param { observer.NavDestinationSwitchObserverOptions } observerOptions - Options. 2191 * @param { Callback<observer.NavDestinationSwitchInfo> } [callback] - The callback function to remove. If not provided, 2192 * all callbacks for the given event type will be removed. 2193 * @syscap SystemCapability.ArkUI.ArkUI.Full 2194 * @crossplatform 2195 * @atomicservice 2196 * @since arkts { '1.1':'12','1.2':'20' } 2197 * @arkts 1.1&1.2 2198 */ 2199 off( 2200 type: 'navDestinationSwitch', 2201 observerOptions: observer.NavDestinationSwitchObserverOptions, 2202 callback?: Callback<observer.NavDestinationSwitchInfo> 2203 ): void; 2204 2205 /** 2206 * Registers a callback function to be called before clickEvent is called. 2207 * 2208 * @param { 'willClick' } type - The type of event to listen for. 2209 * @param { ClickEventListenerCallback } callback - The callback function to be called 2210 * when the clickEvent will be trigger or after. 2211 * @syscap SystemCapability.ArkUI.ArkUI.Full 2212 * @crossplatform 2213 * @atomicservice 2214 * @since arkts { '1.1':'12','1.2':'20' } 2215 * @arkts 1.1&1.2 2216 */ 2217 on(type: 'willClick', callback: ClickEventListenerCallback): void; 2218 2219 /** 2220 * Removes a callback function to be called before clickEvent is called. 2221 * 2222 * @param { 'willClick' } type - The type of event to remove the listener for. 2223 * @param { ClickEventListenerCallback } [callback] - The callback function to remove. If not provided, 2224 * all callbacks for the given event type will be removed. 2225 * @syscap SystemCapability.ArkUI.ArkUI.Full 2226 * @crossplatform 2227 * @atomicservice 2228 * @since arkts { '1.1':'12','1.2':'20' } 2229 * @arkts 1.1&1.2 2230 */ 2231 off(type: 'willClick', callback?: ClickEventListenerCallback): void; 2232 2233 /** 2234 * Registers a callback function to be called after clickEvent is called. 2235 * 2236 * @param { 'didClick' } type - The type of event to listen for. 2237 * @param { ClickEventListenerCallback } callback - The callback function to be called 2238 * when the clickEvent will be trigger or after. 2239 * @syscap SystemCapability.ArkUI.ArkUI.Full 2240 * @crossplatform 2241 * @atomicservice 2242 * @since arkts { '1.1':'12','1.2':'20' } 2243 * @arkts 1.1&1.2 2244 */ 2245 on(type: 'didClick', callback: ClickEventListenerCallback): void; 2246 2247 /** 2248 * Removes a callback function to be called after clickEvent is called. 2249 * 2250 * @param { 'didClick' } type - The type of event to remove the listener for. 2251 * @param { ClickEventListenerCallback } [callback] - The callback function to remove. If not provided, 2252 * all callbacks for the given event type will be removed. 2253 * @syscap SystemCapability.ArkUI.ArkUI.Full 2254 * @crossplatform 2255 * @atomicservice 2256 * @since arkts { '1.1':'12','1.2':'20' } 2257 * @arkts 1.1&1.2 2258 */ 2259 off(type: 'didClick', callback?: ClickEventListenerCallback): void; 2260 2261 /** 2262 * Registers a callback function to be called before tapGesture is called. 2263 * 2264 * @param { 'willClick' } type - The type of event to listen for. 2265 * @param { GestureEventListenerCallback } callback - The callback function to be called 2266 * when the clickEvent will be trigger or after. 2267 * @syscap SystemCapability.ArkUI.ArkUI.Full 2268 * @crossplatform 2269 * @atomicservice 2270 * @since arkts { '1.1':'12','1.2':'20' } 2271 * @arkts 1.1&1.2 2272 */ 2273 on(type: 'willClick', callback: GestureEventListenerCallback): void; 2274 2275 /** 2276 * Removes a callback function to be called before tapGesture is called. 2277 * 2278 * @param { 'willClick' } type - The type of event to remove the listener for. 2279 * @param { GestureEventListenerCallback } [callback] - The callback function to remove. If not provided, 2280 * all callbacks for the given event type will be removed. 2281 * @syscap SystemCapability.ArkUI.ArkUI.Full 2282 * @crossplatform 2283 * @atomicservice 2284 * @since arkts { '1.1':'12','1.2':'20' } 2285 * @arkts 1.1&1.2 2286 */ 2287 off(type: 'willClick', callback?: GestureEventListenerCallback): void; 2288 2289 /** 2290 * Registers a callback function to be called after tapGesture is called. 2291 * 2292 * @param { 'didClick' } type - The type of event to listen for. 2293 * @param { GestureEventListenerCallback } callback - The callback function to be called 2294 * when the clickEvent will be trigger or after. 2295 * @syscap SystemCapability.ArkUI.ArkUI.Full 2296 * @crossplatform 2297 * @atomicservice 2298 * @since arkts { '1.1':'12','1.2':'20' } 2299 * @arkts 1.1&1.2 2300 */ 2301 on(type: 'didClick', callback: GestureEventListenerCallback): void; 2302 2303 /** 2304 * Removes a callback function to be called after tapGesture is called. 2305 * 2306 * @param { 'didClick' } type - The type of event to remove the listener for. 2307 * @param { GestureEventListenerCallback } [callback] - The callback function to remove. If not provided, 2308 * all callbacks for the given event type will be removed. 2309 * @syscap SystemCapability.ArkUI.ArkUI.Full 2310 * @crossplatform 2311 * @atomicservice 2312 * @since arkts { '1.1':'12','1.2':'20' } 2313 * @arkts 1.1&1.2 2314 */ 2315 off(type: 'didClick', callback?: GestureEventListenerCallback): void; 2316 2317 /** 2318 * Registers a callback function to be called before panGesture onActionStart is called. 2319 * 2320 * @param { 'beforePanStart' } type - The type of event to listen for. 2321 * @param { PanListenerCallback } callback - The callback function to be called 2322 * when the panGesture will be trigger or after. 2323 * @syscap SystemCapability.ArkUI.ArkUI.Full 2324 * @crossplatform 2325 * @atomicservice 2326 * @since arkts { '1.1':'19','1.2':'20' } 2327 * @arkts 1.1&1.2 2328 */ 2329 on(type: 'beforePanStart', callback: PanListenerCallback): void; 2330 2331 /** 2332 * Removes a callback function to be called before panGesture onActionStart is called. 2333 * 2334 * @param { 'beforePanStart' } type - The type of event to remove the listener for. 2335 * @param { PanListenerCallback } [callback] - The callback function to remove. If not provided, 2336 * all callbacks for the given event type will be removed. 2337 * @syscap SystemCapability.ArkUI.ArkUI.Full 2338 * @crossplatform 2339 * @atomicservice 2340 * @since arkts { '1.1':'19','1.2':'20' } 2341 * @arkts 1.1&1.2 2342 */ 2343 off(type: 'beforePanStart', callback?: PanListenerCallback): void; 2344 2345 /** 2346 * Registers a callback function to be called before panGesture onActionEnd is called. 2347 * 2348 * @param { 'beforePanEnd' } type - The type of event to listen for. 2349 * @param { PanListenerCallback } callback - The callback function to be called 2350 * when the panGesture will be trigger or after. 2351 * @syscap SystemCapability.ArkUI.ArkUI.Full 2352 * @crossplatform 2353 * @atomicservice 2354 * @since arkts { '1.1':'19','1.2':'20' } 2355 * @arkts 1.1&1.2 2356 */ 2357 on(type: 'beforePanEnd', callback: PanListenerCallback): void; 2358 2359 /** 2360 * Removes a callback function to be called before panGesture onActionEnd is called. 2361 * 2362 * @param { 'beforePanEnd' } type - The type of event to remove the listener for. 2363 * @param { PanListenerCallback } [callback] - The callback function to remove. If not provided, 2364 * all callbacks for the given event type will be removed. 2365 * @syscap SystemCapability.ArkUI.ArkUI.Full 2366 * @crossplatform 2367 * @atomicservice 2368 * @since arkts { '1.1':'19','1.2':'20' } 2369 * @arkts 1.1&1.2 2370 */ 2371 off(type: 'beforePanEnd', callback?: PanListenerCallback): void; 2372 2373 /** 2374 * Registers a callback function to be called after panGesture onActionStart is called. 2375 * 2376 * @param { 'afterPanStart' } type - The type of event to listen for. 2377 * @param { PanListenerCallback } callback - The callback function to be called 2378 * when the panGesture will be trigger or after. 2379 * @syscap SystemCapability.ArkUI.ArkUI.Full 2380 * @crossplatform 2381 * @atomicservice 2382 * @since arkts { '1.1':'19','1.2':'20' } 2383 * @arkts 1.1&1.2 2384 */ 2385 on(type: 'afterPanStart', callback: PanListenerCallback): void; 2386 2387 /** 2388 * Removes a callback function to be called after panGesture onActionStart is called. 2389 * 2390 * @param { 'afterPanStart' } type - The type of event to remove the listener for. 2391 * @param { PanListenerCallback } [callback] - The callback function to remove. If not provided, 2392 * all callbacks for the given event type will be removed. 2393 * @syscap SystemCapability.ArkUI.ArkUI.Full 2394 * @crossplatform 2395 * @atomicservice 2396 * @since arkts { '1.1':'19','1.2':'20' } 2397 * @arkts 1.1&1.2 2398 */ 2399 off(type: 'afterPanStart', callback?: PanListenerCallback): void; 2400 2401 /** 2402 * Registers a callback function to be called after panGesture onActionEnd is called. 2403 * 2404 * @param { 'afterPanEnd' } type - The type of event to listen for. 2405 * @param { PanListenerCallback } callback - The callback function to be called 2406 * when the panGesture will be trigger or after. 2407 * @syscap SystemCapability.ArkUI.ArkUI.Full 2408 * @crossplatform 2409 * @atomicservice 2410 * @since arkts { '1.1':'19','1.2':'20' } 2411 * @arkts 1.1&1.2 2412 */ 2413 on(type: 'afterPanEnd', callback: PanListenerCallback): void; 2414 2415 /** 2416 * Removes a callback function to be called after panGesture onActionEnd is called. 2417 * 2418 * @param { 'afterPanEnd' } type - The type of event to remove the listener for. 2419 * @param { PanListenerCallback } [callback] - The callback function to remove. If not provided, 2420 * all callbacks for the given event type will be removed. 2421 * @syscap SystemCapability.ArkUI.ArkUI.Full 2422 * @crossplatform 2423 * @atomicservice 2424 * @since arkts { '1.1':'19','1.2':'20' } 2425 * @arkts 1.1&1.2 2426 */ 2427 off(type: 'afterPanEnd', callback?: PanListenerCallback): void; 2428 2429 /** 2430 * Registers a callback function to be called when the tabContent is showed or hidden. 2431 * 2432 * @param { 'tabContentUpdate' } type - The type of event to listen for. Must be 'tabContentUpdate'. 2433 * @param { observer.ObserverOptions } options - The options object. 2434 * @param { Callback<observer.TabContentInfo> } callback - The callback function to be called 2435 * when the tabContent show or hide. 2436 * @syscap SystemCapability.ArkUI.ArkUI.Full 2437 * @crossplatform 2438 * @atomicservice 2439 * @since arkts { '1.1':'12','1.2':'20' } 2440 * @arkts 1.1&1.2 2441 */ 2442 on(type: 'tabContentUpdate', options: observer.ObserverOptions, callback: Callback<observer.TabContentInfo>): void; 2443 2444 /** 2445 * Removes a callback function that was previously registered with `on()`. 2446 * 2447 * @param { 'tabContentUpdate' } type - The type of event to remove the listener for. Must be 'tabContentUpdate'. 2448 * @param { observer.ObserverOptions } options - The options object. 2449 * @param { Callback<observer.TabContentInfo> } callback - The callback function to remove. If not provided, 2450 * all callbacks for the given event type and Tabs ID will be removed. 2451 * @syscap SystemCapability.ArkUI.ArkUI.Full 2452 * @crossplatform 2453 * @atomicservice 2454 * @since arkts { '1.1':'12','1.2':'20' } 2455 * @arkts 1.1&1.2 2456 */ 2457 off(type: 'tabContentUpdate', options: observer.ObserverOptions, callback?: Callback<observer.TabContentInfo>): void; 2458 2459 /** 2460 * Registers a callback function to be called when the tabContent is showed or hidden. 2461 * 2462 * @param { 'tabContentUpdate' } type - The type of event to listen for. Must be 'tabContentUpdate'. 2463 * @param { Callback<observer.TabContentInfo> } callback - The callback function to be called 2464 * when the tabContent is showed or hidden. 2465 * @syscap SystemCapability.ArkUI.ArkUI.Full 2466 * @crossplatform 2467 * @atomicservice 2468 * @since arkts { '1.1':'12','1.2':'20' } 2469 * @arkts 1.1&1.2 2470 */ 2471 on(type: 'tabContentUpdate', callback: Callback<observer.TabContentInfo>): void; 2472 2473 /** 2474 * Removes a callback function that was previously registered with `on()`. 2475 * 2476 * @param { 'tabContentUpdate'} type - The type of event to remove the listener for. Must be 'tabContentUpdate'. 2477 * @param { Callback<observer.TabContentInfo> } callback - The callback function to remove. If not provided, 2478 * all callbacks for the given event type and Tabs ID will be removed. 2479 * @syscap SystemCapability.ArkUI.ArkUI.Full 2480 * @crossplatform 2481 * @atomicservice 2482 * @since arkts { '1.1':'12','1.2':'20' } 2483 * @arkts 1.1&1.2 2484 */ 2485 off(type: 'tabContentUpdate', callback?: Callback<observer.TabContentInfo>): void; 2486 2487 /** 2488 * Registers a callback function to be called when the specific node's render state changed. 2489 * This callback will be executed once immediately when the register is successful. 2490 * [Notes]: 2491 * 1. Be aware of the limit on the number of nodes: 2492 * For performance considerations, the system has imposed a limit on the number of 2493 * nodes that can be registered for monitoring in a single UI instance, exception will be thrown 2494 * if overmuch. Please use this interface with caution. 2495 * 2. Understanding scenarios where notifications may not occur: 2496 * In general, within container components that have view or page switching functionality, 2497 * when a view or page within the screen is moved outside the screen, the components previously 2498 * within the screen should be removed from the render tree and should receive a RENDER_OUT 2499 * notification. However, this is not always the case, as some scenarios involve views or components 2500 * being moved outside the screen's display range without triggering a RENDER_OUT notification. 2501 * For example, some components with caching capabilities may affect this behavior, and swiper is one 2502 * such component. The cacheCount property of the swiper component allows you to force, via its second 2503 * parameter isShow, that even if the current page is moved outside the display range, it remains in the 2504 * render tree. This can be useful in scenarios where multiple pages are displayed on the screen simultaneously. 2505 * Another example is scrolling components like list or scroll, where their internal content remains in the 2506 * render tree even if it is scrolled outside the screen's display range, provided that lazyForEach/Repeat is 2507 * not used. As a result, there will be no changes to the render state. Once you understand the principles 2508 * behind the triggers for render state changes, these scenarios will become easier to comprehend. 2509 * 2510 * @param { 'nodeRenderState' } type - The type of event to listen for. 2511 * @param { NodeIdentity } nodeIdentity - The identity of the target node 2512 * @param { NodeRenderStateChangeCallback } callback - The callback function to be called 2513 * when the clickEvent will be trigger or after. 2514 * @throws { BusinessError } 161001 - The count of nodes monitoring render state is over the limitation. 2515 * @syscap SystemCapability.ArkUI.ArkUI.Full 2516 * @crossplatform 2517 * @atomicservice 2518 * @since 20 2519 */ 2520 on(type: 'nodeRenderState', nodeIdentity: NodeIdentity, callback: NodeRenderStateChangeCallback): void; 2521 2522 /** 2523 * Removes a callback function to be called before tapGesture is called. 2524 * 2525 * @param { 'nodeRenderState' } type - The type of event to remove the listener for. 2526 * @param { NodeIdentity } nodeIdentity - The identity of the target node 2527 * @param { NodeRenderStateChangeCallback } [callback] - The callback function to remove. If not provided, 2528 * all callbacks for the given event type will be removed. 2529 * @syscap SystemCapability.ArkUI.ArkUI.Full 2530 * @crossplatform 2531 * @atomicservice 2532 * @since 20 2533 */ 2534 off(type: 'nodeRenderState', nodeIdentity: NodeIdentity, callback?: NodeRenderStateChangeCallback): void; 2535 2536 /** 2537 * Registers a callback to monitor the gesture trigger information. 2538 * 2539 * @param { GestureListenerType } type - The type of gesture to monitor. 2540 * @param { GestureObserverConfigs } option - The options when bind the global listener. 2541 * @param { GestureListenerCallback } callback - The callback function to be called when any gesture's state 2542 * is updated. 2543 * @syscap SystemCapability.ArkUI.ArkUI.Full 2544 * @crossplatform 2545 * @atomicservice 2546 * @since 20 2547 */ 2548 addGlobalGestureListener(type: GestureListenerType, 2549 option: GestureObserverConfigs, callback: GestureListenerCallback): void; 2550 /** 2551 * Removes a callback function for one gesture listener type. 2552 * 2553 * @param { GestureListenerType } type - The type of event to remove the listener for. 2554 * @param { GestureListenerCallback } [callback] - The callback function to be removed. If not provided, 2555 * all callbacks for the given gesture type will be removed. 2556 * @syscap SystemCapability.ArkUI.ArkUI.Full 2557 * @crossplatform 2558 * @atomicservice 2559 * @since 20 2560 */ 2561 removeGlobalGestureListener(type: GestureListenerType, callback?: GestureListenerCallback): void; 2562} 2563 2564/** 2565 * class ComponentUtils 2566 * @syscap SystemCapability.ArkUI.ArkUI.Full 2567 * @crossplatform 2568 * @since 10 2569 */ 2570/** 2571 * class ComponentUtils 2572 * @syscap SystemCapability.ArkUI.ArkUI.Full 2573 * @crossplatform 2574 * @atomicservice 2575 * @since arkts { '1.1':'11','1.2':'20' } 2576 * @arkts 1.1&1.2 2577 */ 2578export declare class ComponentUtils { 2579 /** 2580 * Provide the ability to obtain the coordinates and size of component drawing areas. 2581 * 2582 * @param { string } id - ID of the component whose attributes are to be obtained. 2583 * @returns { componentUtils.ComponentInfo } the object of ComponentInfo. 2584 * @throws { BusinessError } 100001 - UI execution context not found. 2585 * @syscap SystemCapability.ArkUI.ArkUI.Full 2586 * @since 10 2587 */ 2588 /** 2589 * Provide the ability to obtain the coordinates and size of component drawing areas. 2590 * 2591 * @param { string } id - ID of the component whose attributes are to be obtained. 2592 * @returns { componentUtils.ComponentInfo } the object of ComponentInfo. 2593 * @throws { BusinessError } 100001 - UI execution context not found. 2594 * @syscap SystemCapability.ArkUI.ArkUI.Full 2595 * @atomicservice 2596 * @since arkts { '1.1':'11','1.2':'20' } 2597 * @arkts 1.1&1.2 2598 */ 2599 getRectangleById(id: string): componentUtils.ComponentInfo; 2600} 2601 2602/** 2603 * class OverlayManager 2604 * @syscap SystemCapability.ArkUI.ArkUI.Full 2605 * @crossplatform 2606 * @atomicservice 2607 * @since arkts { '1.1':'12','1.2':'20' } 2608 * @arkts 1.1&1.2 2609 */ 2610export declare class OverlayManager { 2611 /** 2612 * Adds a specified ComponentContent node to the OverlayManager. 2613 * 2614 * @param { ComponentContent } content - Content to add to the new node on the OverlayManager. 2615 * <p><strong>NOTE</strong>: 2616 * <br>By default, the new node is centered on the page and stacked according to its stacking level. 2617 * </p> 2618 * 2619 * @param { number } [ index ] - Stacking level of the new node on the OverlayManager. 2620 * <p><strong>NOTE</strong>: 2621 * <br>If the value is greater than or equal to 0, a larger value indicates a higher stacking level; for those that 2622 * have the same index, the one that is added at a later time has a higher stacking level. If the value is less than 2623 * 0 or is null or undefined, the ComponentContent node is added at the highest level by default. If the same 2624 * ComponentContent node is added multiple times, only the last added one is retained. 2625 * </p> 2626 * 2627 * @syscap SystemCapability.ArkUI.ArkUI.Full 2628 * @crossplatform 2629 * @atomicservice 2630 * @since arkts { '1.1':'12','1.2':'20' } 2631 * @arkts 1.1&1.2 2632 */ 2633 addComponentContent(content: ComponentContent, index?: number): void; 2634 2635 /** 2636 * Creates a floating layer node with the specified display order. 2637 * This API allows you to define the stacking order of the nodes when they are created. 2638 * 2639 * @param { ComponentContent } content - Content to add to the new node on the OverlayManager. 2640 * <p><strong>NOTE</strong>: 2641 * <br>By default, the new node is centered on the page and stacked according to its stacking level. 2642 * </p> 2643 * 2644 * @param { LevelOrder } [ levelOrder ] - The display order of the ComponentContDisplay order of the new floating 2645 * layer node, default is LevelOrder.clamp(0) 2646 * @syscap SystemCapability.ArkUI.ArkUI.Full 2647 * @crossplatform 2648 * @atomicservice 2649 * @since arkts { '1.1':'18','1.2':'20' } 2650 * @arkts 1.1&1.2 2651 */ 2652 addComponentContentWithOrder(content: ComponentContent, levelOrder?: LevelOrder): void; 2653 2654 /** 2655 * Removes a specified ComponentContent node from the OverlayManager 2656 * 2657 * @param { ComponentContent } content - Content to remove from the OverlayManager. 2658 * @syscap SystemCapability.ArkUI.ArkUI.Full 2659 * @crossplatform 2660 * @atomicservice 2661 * @since arkts { '1.1':'12','1.2':'20' } 2662 * @arkts 1.1&1.2 2663 */ 2664 removeComponentContent(content: ComponentContent): void; 2665 2666 /** 2667 * Show the ComponentContent. 2668 * 2669 * @param { ComponentContent } content - The content will be shown. 2670 * @syscap SystemCapability.ArkUI.ArkUI.Full 2671 * @crossplatform 2672 * @atomicservice 2673 * @since arkts { '1.1':'12','1.2':'20' } 2674 * @arkts 1.1&1.2 2675 */ 2676 showComponentContent(content: ComponentContent): void; 2677 2678 /** 2679 * Hide the ComponentContent. 2680 * 2681 * @param { ComponentContent } content - The content will be hidden. 2682 * @syscap SystemCapability.ArkUI.ArkUI.Full 2683 * @crossplatform 2684 * @atomicservice 2685 * @since arkts { '1.1':'12','1.2':'20' } 2686 * @arkts 1.1&1.2 2687 */ 2688 hideComponentContent(content: ComponentContent): void; 2689 2690 /** 2691 * Show all ComponentContents on the OverlayManager. 2692 * 2693 * @syscap SystemCapability.ArkUI.ArkUI.Full 2694 * @crossplatform 2695 * @atomicservice 2696 * @since arkts { '1.1':'12','1.2':'20' } 2697 * @arkts 1.1&1.2 2698 */ 2699 showAllComponentContents(): void; 2700 2701 /** 2702 * Hide all ComponentContents on the OverlayManager. 2703 * 2704 * @syscap SystemCapability.ArkUI.ArkUI.Full 2705 * @crossplatform 2706 * @atomicservice 2707 * @since arkts { '1.1':'12','1.2':'20' } 2708 * @arkts 1.1&1.2 2709 */ 2710 hideAllComponentContents(): void; 2711} 2712 2713/** 2714 * interface AtomicServiceBar 2715 * @interface AtomicServiceBar 2716 * @syscap SystemCapability.ArkUI.ArkUI.Full 2717 * @crossplatform 2718 * @since 11 2719 */ 2720/** 2721 * interface AtomicServiceBar 2722 * @interface AtomicServiceBar 2723 * @syscap SystemCapability.ArkUI.ArkUI.Full 2724 * @crossplatform 2725 * @atomicservice 2726 * @since arkts { '1.1':'12','1.2':'20' } 2727 * @arkts 1.1&1.2 2728 */ 2729export interface AtomicServiceBar { 2730 /** 2731 * Set the visibility of the bar, except the icon. 2732 * 2733 * @param { boolean } visible - whether this bar is visible. 2734 * @syscap SystemCapability.ArkUI.ArkUI.Full 2735 * @atomicservice 2736 * @since arkts { '1.1':'11','1.2':'20' } 2737 * @arkts 1.1&1.2 2738 */ 2739 setVisible(visible: boolean): void; 2740 2741 /** 2742 * Set the background color of the bar. 2743 * 2744 * @param { Nullable< Color | number | string> } color - the color to set, undefined indicates using default. 2745 * @syscap SystemCapability.ArkUI.ArkUI.Full 2746 * @since 11 2747 */ 2748 /** 2749 * Set the background color of the bar. 2750 * 2751 * @param { Nullable< Color | number | string> } color - the color to set, undefined indicates using default. 2752 * @syscap SystemCapability.ArkUI.ArkUI.Full 2753 * @atomicservice 2754 * @since arkts { '1.1':'12','1.2':'20' } 2755 * @arkts 1.1&1.2 2756 */ 2757 setBackgroundColor(color: Nullable< Color | number | string>): void; 2758 2759 /** 2760 * Set the title of the bar. 2761 * 2762 * @param { string } content - the content of the bar. 2763 * @syscap SystemCapability.ArkUI.ArkUI.Full 2764 * @since 11 2765 */ 2766 /** 2767 * Set the title of the bar. 2768 * 2769 * @param { string } content - the content of the bar. 2770 * @syscap SystemCapability.ArkUI.ArkUI.Full 2771 * @atomicservice 2772 * @since arkts { '1.1':'12','1.2':'20' } 2773 * @arkts 1.1&1.2 2774 */ 2775 setTitleContent(content: string): void; 2776 2777 /** 2778 * Set the font style of the bar's title. 2779 * 2780 * @param { FontStyle } font - the font style of the bar's title. 2781 * @syscap SystemCapability.ArkUI.ArkUI.Full 2782 * @since 11 2783 */ 2784 /** 2785 * Set the font style of the bar's title. 2786 * 2787 * @param { FontStyle } font - the font style of the bar's title. 2788 * @syscap SystemCapability.ArkUI.ArkUI.Full 2789 * @atomicservice 2790 * @since arkts { '1.1':'12','1.2':'20' } 2791 * @arkts 1.1&1.2 2792 */ 2793 setTitleFontStyle(font: FontStyle): void; 2794 2795 /** 2796 * Set the color of the icon on the bar. 2797 * 2798 * @param { Nullable< Color | number | string> } color - the color to set to icon, undefined indicates using default. 2799 * @syscap SystemCapability.ArkUI.ArkUI.Full 2800 * @since 11 2801 */ 2802 /** 2803 * Set the color of the icon on the bar. 2804 * 2805 * @param { Nullable< Color | number | string> } color - the color to set to icon, undefined indicates using default. 2806 * @syscap SystemCapability.ArkUI.ArkUI.Full 2807 * @atomicservice 2808 * @since arkts { '1.1':'12','1.2':'20' } 2809 * @arkts 1.1&1.2 2810 */ 2811 setIconColor(color: Nullable< Color | number | string>): void; 2812 2813 /** 2814 * Get size and position of the bar. 2815 * 2816 * @returns { Frame } The size and position of bar in vp relative to window. 2817 * @syscap SystemCapability.ArkUI.ArkUI.Full 2818 * @crossplatform 2819 * @atomicservice 2820 * @since arkts { '1.1':'15','1.2':'20' } 2821 * @arkts 1.1&1.2 2822 */ 2823 getBarRect(): Frame; 2824} 2825 2826/** 2827 * The information when one gesture specific callback is triggered. 2828 * 2829 * @interface GestureTriggerInfo 2830 * @syscap SystemCapability.ArkUI.ArkUI.Full 2831 * @crossplatform 2832 * @atomicservice 2833 * @since 20 2834 */ 2835export interface GestureTriggerInfo { 2836 /** 2837 * The gesture event object. 2838 * 2839 * @type { GestureEvent } 2840 * @syscap SystemCapability.ArkUI.ArkUI.Full 2841 * @crossplatform 2842 * @atomicservice 2843 * @since 20 2844 */ 2845 event: GestureEvent; 2846 /** 2847 * The gesture recognizer object. You can obtain the detailed information of the gesture from it, 2848 * but please do not keep this object locally, as it might be unavailable when the node is released. 2849 * 2850 * @type { GestureRecognizer } 2851 * @syscap SystemCapability.ArkUI.ArkUI.Full 2852 * @crossplatform 2853 * @atomicservice 2854 * @since 20 2855 */ 2856 current: GestureRecognizer; 2857 /** 2858 * The gesture action callback phase. 2859 * 2860 * @type { GestureActionPhase } 2861 * @syscap SystemCapability.ArkUI.ArkUI.Full 2862 * @crossplatform 2863 * @atomicservice 2864 * @since 20 2865 */ 2866 currentPhase: GestureActionPhase; 2867 /** 2868 * The node which the gesture is being triggered on. 2869 * 2870 * @type { ?FrameNode } 2871 * @syscap SystemCapability.ArkUI.ArkUI.Full 2872 * @crossplatform 2873 * @atomicservice 2874 * @since 20 2875 */ 2876 node?: FrameNode; 2877} 2878 2879/** 2880 * The observer options for global gesture listener. 2881 * 2882 * @interface GestureObserverConfigs 2883 * @syscap SystemCapability.ArkUI.ArkUI.Full 2884 * @crossplatform 2885 * @atomicservice 2886 * @since 20 2887 */ 2888export interface GestureObserverConfigs { 2889 /** 2890 * The gesture callback phases want to monitor. Only the specific action phases can be notified when the gesture is triggered. 2891 * If empty array provided, the register will has no any effect. 2892 * 2893 * @type { Array<GestureActionPhase> } 2894 * @syscap SystemCapability.ArkUI.ArkUI.Full 2895 * @crossplatform 2896 * @atomicservice 2897 * @since 20 2898 */ 2899 actionPhases: Array<GestureActionPhase>; 2900} 2901 2902/** 2903 * Represents a dynamic synchronization scene. 2904 * 2905 * @syscap SystemCapability.ArkUI.ArkUI.Full 2906 * @atomicservice 2907 * @since arkts { '1.1':'12','1.2':'20' } 2908 * @arkts 1.1&1.2 2909 */ 2910export declare class DynamicSyncScene { 2911 /** 2912 * Sets the FrameRateRange of the DynamicSyncScene. 2913 * 2914 * @param { ExpectedFrameRateRange } range - The range of frameRate. 2915 * @syscap SystemCapability.ArkUI.ArkUI.Full 2916 * @atomicservice 2917 * @since arkts { '1.1':'12','1.2':'20' } 2918 * @arkts 1.1&1.2 2919 */ 2920 setFrameRateRange(range: ExpectedFrameRateRange): void; 2921 2922 /** 2923 * Gets the FrameRateRange of the DynamicSyncScene. 2924 * 2925 * @returns { ExpectedFrameRateRange } The range of frameRate. 2926 * @syscap SystemCapability.ArkUI.ArkUI.Full 2927 * @atomicservice 2928 * @since arkts { '1.1':'12','1.2':'20' } 2929 * @arkts 1.1&1.2 2930 */ 2931 getFrameRateRange(): ExpectedFrameRateRange; 2932} 2933 2934/** 2935 * Represents a dynamic synchronization scene of Swiper. 2936 * 2937 * @extends DynamicSyncScene 2938 * @syscap SystemCapability.ArkUI.ArkUI.Full 2939 * @atomicservice 2940 * @since arkts { '1.1':'12','1.2':'20' } 2941 * @arkts 1.1&1.2 2942 */ 2943export declare class SwiperDynamicSyncScene extends DynamicSyncScene { 2944 /** 2945 * Type of the SwiperDynamicSyncSceneType. 2946 * @type { SwiperDynamicSyncSceneType } 2947 * @readonly 2948 * @syscap SystemCapability.ArkUI.ArkUI.Full 2949 * @atomicservice 2950 * @since arkts { '1.1':'12','1.2':'20' } 2951 * @arkts 1.1&1.2 2952 */ 2953 readonly type: SwiperDynamicSyncSceneType; 2954} 2955 2956/** 2957 * Represents a dynamic synchronization scene of Marquee. 2958 * 2959 * @extends DynamicSyncScene 2960 * @syscap SystemCapability.ArkUI.ArkUI.Full 2961 * @atomicservice 2962 * @since arkts { '1.1':'14','1.2':'20' } 2963 * @arkts 1.1&1.2 2964 */ 2965export declare class MarqueeDynamicSyncScene extends DynamicSyncScene { 2966 /** 2967 * Type of the MarqueeDynamicSyncSceneType. 2968 * @type { MarqueeDynamicSyncSceneType } 2969 * @readonly 2970 * @syscap SystemCapability.ArkUI.ArkUI.Full 2971 * @atomicservice 2972 * @since arkts { '1.1':'14','1.2':'20' } 2973 * @arkts 1.1&1.2 2974 */ 2975 readonly type: MarqueeDynamicSyncSceneType; 2976} 2977 2978/** 2979 * class DragController 2980 * @syscap SystemCapability.ArkUI.ArkUI.Full 2981 * @since 11 2982 */ 2983/** 2984 * class DragController 2985 * @syscap SystemCapability.ArkUI.ArkUI.Full 2986 * @atomicservice 2987 * @since 12 2988 */ 2989/** 2990 * class DragController 2991 * @syscap SystemCapability.ArkUI.ArkUI.Full 2992 * @crossplatform 2993 * @atomicservice 2994 * @since arkts { '1.1':'18','1.2':'20' } 2995 * @arkts 1.1&1.2 2996 */ 2997export declare class DragController { 2998 /** 2999 * Execute a drag event. 3000 * @param { CustomBuilder | DragItemInfo } custom - Object used for prompts displayed when the object is dragged. 3001 * @param { dragController.DragInfo } dragInfo - Information about the drag event. 3002 * @param { AsyncCallback<{ event: DragEvent, extraParams: string }> } callback - Callback that contains 3003 * the drag event information. 3004 * @throws { BusinessError } 401 - Parameter error. Possible causes: 3005 * <br> 1. Mandatory parameters are left unspecified. 3006 * <br> 2. Incorrect parameters types. 3007 * <br> 3. Parameter verification failed. 3008 * @throws { BusinessError } 100001 - Internal handling failed. 3009 * @syscap SystemCapability.ArkUI.ArkUI.Full 3010 * @since 11 3011 */ 3012 /** 3013 * Execute a drag event. 3014 * @param { CustomBuilder | DragItemInfo } custom - Object used for prompts displayed when the object is dragged. 3015 * @param { dragController.DragInfo } dragInfo - Information about the drag event. 3016 * @param { AsyncCallback<dragController.DragEventParam> } callback - Callback that contains 3017 * the drag event information. 3018 * @throws { BusinessError } 401 - Parameter error. Possible causes: 3019 * <br> 1. Mandatory parameters are left unspecified. 3020 * <br> 2. Incorrect parameters types. 3021 * <br> 3. Parameter verification failed. 3022 * @throws { BusinessError } 100001 - Internal handling failed. 3023 * @syscap SystemCapability.ArkUI.ArkUI.Full 3024 * @atomicservice 3025 * @since 12 3026 */ 3027 /** 3028 * Execute a drag event. 3029 * @param { CustomBuilder | DragItemInfo } custom - Object used for prompts displayed when the object is dragged. 3030 * @param { dragController.DragInfo } dragInfo - Information about the drag event. 3031 * @param { AsyncCallback<dragController.DragEventParam> } callback - Callback that contains 3032 * the drag event information. 3033 * @throws { BusinessError } 401 - Parameter error. Possible causes: 3034 * <br> 1. Mandatory parameters are left unspecified. 3035 * <br> 2. Incorrect parameters types. 3036 * <br> 3. Parameter verification failed. 3037 * @throws { BusinessError } 100001 - Internal handling failed. 3038 * @syscap SystemCapability.ArkUI.ArkUI.Full 3039 * @crossplatform 3040 * @atomicservice 3041 * @since arkts { '1.1':'18','1.2':'20' } 3042 * @arkts 1.1&1.2 3043 */ 3044 executeDrag(custom: CustomBuilder | DragItemInfo, dragInfo: dragController.DragInfo, 3045 callback: AsyncCallback<dragController.DragEventParam>): void; 3046 3047 /** 3048 * Execute a drag event. 3049 * @param { CustomBuilder | DragItemInfo } custom - Object used for prompts displayed when the object is dragged. 3050 * @param { dragController.DragInfo } dragInfo - Information about the drag event. 3051 * @returns { Promise<{ event: DragEvent, extraParams: string }> } A Promise with the drag event information. 3052 * @throws { BusinessError } 401 - Parameter error. Possible causes: 3053 * <br> 1. Mandatory parameters are left unspecified. 3054 * <br> 2. Incorrect parameters types. 3055 * <br> 3. Parameter verification failed. 3056 * @throws { BusinessError } 100001 - Internal handling failed. 3057 * @syscap SystemCapability.ArkUI.ArkUI.Full 3058 * @since 11 3059 */ 3060 /** 3061 * Execute a drag event. 3062 * @param { CustomBuilder | DragItemInfo } custom - Object used for prompts displayed when the object is dragged. 3063 * @param { dragController.DragInfo } dragInfo - Information about the drag event. 3064 * @returns { Promise<dragController.DragEventParam> } A Promise with the drag event information. 3065 * @throws { BusinessError } 401 - Parameter error. Possible causes: 3066 * <br> 1. Mandatory parameters are left unspecified. 3067 * <br> 2. Incorrect parameters types. 3068 * <br> 3. Parameter verification failed. 3069 * @throws { BusinessError } 100001 - Internal handling failed. 3070 * @syscap SystemCapability.ArkUI.ArkUI.Full 3071 * @atomicservice 3072 * @since 12 3073 */ 3074 /** 3075 * Execute a drag event. 3076 * @param { CustomBuilder | DragItemInfo } custom - Object used for prompts displayed when the object is dragged. 3077 * @param { dragController.DragInfo } dragInfo - Information about the drag event. 3078 * @returns { Promise<dragController.DragEventParam> } A Promise with the drag event information. 3079 * @throws { BusinessError } 401 - Parameter error. Possible causes: 3080 * <br> 1. Mandatory parameters are left unspecified. 3081 * <br> 2. Incorrect parameters types. 3082 * <br> 3. Parameter verification failed. 3083 * @throws { BusinessError } 100001 - Internal handling failed. 3084 * @syscap SystemCapability.ArkUI.ArkUI.Full 3085 * @crossplatform 3086 * @atomicservice 3087 * @since arkts { '1.1':'18','1.2':'20' } 3088 * @arkts 1.1&1.2 3089 */ 3090 executeDrag(custom: CustomBuilder | DragItemInfo, dragInfo: dragController.DragInfo) 3091 : Promise<dragController.DragEventParam>; 3092 3093 /** 3094 * Create one drag action object, which can be used for starting drag later or monitoring the drag status after drag started. 3095 * @param { Array<CustomBuilder | DragItemInfo> } customArray - Objects used for prompts displayed when the objects are dragged. 3096 * @param { dragController.DragInfo } dragInfo - Information about the drag event. 3097 * @returns { dragController.DragAction } one drag action object 3098 * @throws { BusinessError } 401 - Parameter error. Possible causes: 3099 * <br> 1. Mandatory parameters are left unspecified. 3100 * <br> 2. Incorrect parameters types. 3101 * <br> 3. Parameter verification failed. 3102 * @throws { BusinessError } 100001 - Internal handling failed. 3103 * @syscap SystemCapability.ArkUI.ArkUI.Full 3104 * @since 11 3105 */ 3106 /** 3107 * Create one drag action object, which can be used for starting drag later or monitoring the drag status after drag started. 3108 * @param { Array<CustomBuilder | DragItemInfo> } customArray - Objects used for prompts displayed when the objects are dragged. 3109 * @param { dragController.DragInfo } dragInfo - Information about the drag event. 3110 * @returns { dragController.DragAction } one drag action object 3111 * @throws { BusinessError } 401 - Parameter error. Possible causes: 3112 * <br> 1. Mandatory parameters are left unspecified. 3113 * <br> 2. Incorrect parameters types. 3114 * <br> 3. Parameter verification failed. 3115 * @throws { BusinessError } 100001 - Internal handling failed. 3116 * @syscap SystemCapability.ArkUI.ArkUI.Full 3117 * @atomicservice 3118 * @since 12 3119 */ 3120 /** 3121 * Create one drag action object, which can be used for starting drag later or monitoring the drag status after drag started. 3122 * @param { Array<CustomBuilder | DragItemInfo> } customArray - Objects used for prompts displayed when the objects are dragged. 3123 * @param { dragController.DragInfo } dragInfo - Information about the drag event. 3124 * @returns { dragController.DragAction } one drag action object 3125 * @throws { BusinessError } 401 - Parameter error. Possible causes: 3126 * <br> 1. Mandatory parameters are left unspecified. 3127 * <br> 2. Incorrect parameters types. 3128 * <br> 3. Parameter verification failed. 3129 * @throws { BusinessError } 100001 - Internal handling failed. 3130 * @syscap SystemCapability.ArkUI.ArkUI.Full 3131 * @crossplatform 3132 * @atomicservice 3133 * @since arkts { '1.1':'18','1.2':'20' } 3134 * @arkts 1.1&1.2 3135 */ 3136 createDragAction(customArray: Array<CustomBuilder | DragItemInfo>, dragInfo: dragController.DragInfo): dragController.DragAction; 3137 3138 /** 3139 * Get a drag preview object, which provides the functions of setting color or updating animation and has no effect in OnDrop and OnDragEnd callback. 3140 * @returns { dragController.DragPreview } A drag preview object. 3141 * @syscap SystemCapability.ArkUI.ArkUI.Full 3142 * @since 11 3143 */ 3144 /** 3145 * Get a drag preview object. 3146 * @returns { dragController.DragPreview } A drag preview object. 3147 * @syscap SystemCapability.ArkUI.ArkUI.Full 3148 * @atomicservice 3149 * @since 12 3150 */ 3151 /** 3152 * Get a drag preview object. 3153 * @returns { dragController.DragPreview } A drag preview object. 3154 * @syscap SystemCapability.ArkUI.ArkUI.Full 3155 * @crossplatform 3156 * @atomicservice 3157 * @since arkts { '1.1':'18','1.2':'20' } 3158 * @arkts 1.1&1.2 3159 */ 3160 getDragPreview(): dragController.DragPreview; 3161 3162 /** 3163 * Enable drag event strict reporting for drag enter and leave notification in nested situation. 3164 * For example, the parent and child both register the onDragEnter/onDragLeave events, if this 3165 * flag is enabled, the parent will be notified with leave event, and the child will notified with 3166 * enter event at the same time, when user drag action is passing through the parent and enter the 3167 * scope of the child. 3168 * Please be noted, the default value of the flag is false, it means, for the same situation, the 3169 * parent will not receive the leave notification, just the child can get the enter event, which is 3170 * not fully strict. 3171 * @param { boolean } enable - Indicating enable drag event strict reporting or not. 3172 * @syscap SystemCapability.ArkUI.ArkUI.Full 3173 * @atomicservice 3174 * @since arkts { '1.1':'12','1.2':'20' } 3175 * @arkts 1.1&1.2 3176 */ 3177 setDragEventStrictReportingEnabled(enable: boolean): void; 3178 3179 /** 3180 * Notify the drag start request to specific pending or continue. 3181 * @param { dragController.DragStartRequestStatus } requestStatus - Status about the drag start behavior. 3182 * @syscap SystemCapability.ArkUI.ArkUI.Full 3183 * @atomicservice 3184 * @since arkts { '1.1':'18','1.2':'20' } 3185 * @arkts 1.1&1.2 3186 */ 3187 notifyDragStartRequest(requestStatus: dragController.DragStartRequestStatus): void; 3188 3189 /** 3190 * Cancel the UDMF data sync process by passing in the data key as the identify, can only be used after the drop. 3191 * 3192 * @param { string } key - The data key returned by startDataLoading method. 3193 * @throws { BusinessError } 401 - Parameter error. 3194 * @throws { BusinessError } 190004 - Operation failed. 3195 * @syscap SystemCapability.ArkUI.ArkUI.Full 3196 * @atomicservice 3197 * @since arkts { '1.1':'15','1.2':'20' } 3198 * @arkts 1.1&1.2 3199 */ 3200 cancelDataLoading(key: string): void; 3201 3202 /** 3203 * Sets whether to enable the disallow badge icon show. 3204 * 3205 * Typically, when a component can receive or process data dragged by the user, or when it declares to the 3206 * system that data should be processed in COPY way by returning DragBehavior.COPY, the system will display 3207 * a plus sign together with the data number on the upper-left corner of the dragged object; if returning 3208 * DragBehavior.MOVE to the system to declare that data should be processed in CUT way, the system will only 3209 * display the data number on the upper-left corner of the dragged object. 3210 * 3211 * In some cases, when the system determines or the component explicitly declares that it cannot handle the 3212 * data that the user is dragging, the system displays a badge icon in the same way as it does for DragBehavior.MOVE. 3213 * So if you want to show the more clearly status, you can call this method on the UI instance in advance to force 3214 * the system to display a clear prohibition icon on the upper left corner in such cases, and the user can clearly 3215 * know that data cannot be dropped here. 3216 * 3217 * @param { boolean } enabled - Indicating enable the disallow status showing or not. 3218 * @syscap SystemCapability.ArkUI.ArkUI.Full 3219 * @atomicservice 3220 * @since 20 3221 */ 3222 enableDropDisallowedBadge(enabled: boolean): void; 3223} 3224 3225/** 3226 * class MeasureUtils 3227 * 3228 * <p><strong>NOTE</strong>: 3229 * <br>You must first use getMeasureUtils() in UIContext to obtain a MeasureUtils instance, 3230 * and then call the APIs using the obtained instance. 3231 * </p> 3232 * 3233 * @syscap SystemCapability.ArkUI.ArkUI.Full 3234 * @crossplatform 3235 * @atomicservice 3236 * @since arkts { '1.1':'12','1.2':'20' } 3237 * @arkts 1.1&1.2 3238 */ 3239export declare class MeasureUtils { 3240 /** 3241 * Obtains the width of the specified text in a single line layout. 3242 * 3243 * @param { MeasureOptions } options - Options. 3244 * @returns { number } - The unit is px. 3245 * @syscap SystemCapability.ArkUI.ArkUI.Full 3246 * @crossplatform 3247 * @atomicservice 3248 * @since arkts { '1.1':'12','1.2':'20' } 3249 * @arkts 1.1&1.2 3250 */ 3251 measureText(options: MeasureOptions): number; 3252 3253 /** 3254 * Obtains the width and height of the specified text in a single line layout. 3255 * 3256 * @param { MeasureOptions } options - Options of measure area occupied by text. 3257 * @returns { SizeOptions } width and height for text to display.The return values for text width and height are both in px. 3258 * @syscap SystemCapability.ArkUI.ArkUI.Full 3259 * @crossplatform 3260 * @atomicservice 3261 * @since arkts { '1.1':'12','1.2':'20' } 3262 * @arkts 1.1&1.2 3263 */ 3264 measureTextSize(options: MeasureOptions): SizeOptions; 3265 3266 /** 3267 * Get layout info of the styled string. 3268 * 3269 * @param { StyledString } styledString - The styled string value. 3270 * @param { TextLayoutOptions } [options] - The layout options. 3271 * @returns { Array<Paragraph> } paragraph result 3272 * @syscap SystemCapability.ArkUI.ArkUI.Full 3273 * @since 20 3274 */ 3275 getParagraphs(styledString: StyledString, options?: TextLayoutOptions): Array<Paragraph>; 3276} 3277 3278/** 3279 * class FocusController 3280 * @syscap SystemCapability.ArkUI.ArkUI.Full 3281 * @atomicservice 3282 * @since arkts { '1.1':'12','1.2':'20' } 3283 * @arkts 1.1&1.2 3284 */ 3285export declare class FocusController { 3286 /** 3287 * clear focus to the root container. 3288 * @syscap SystemCapability.ArkUI.ArkUI.Full 3289 * @atomicservice 3290 * @since arkts { '1.1':'12','1.2':'20' } 3291 * @arkts 1.1&1.2 3292 */ 3293 clearFocus(): void; 3294 3295 /** 3296 * request focus to the specific component. 3297 * @param { string } key - the inspector key of the component. 3298 * @throws { BusinessError } 150001 - the component cannot be focused. 3299 * @throws { BusinessError } 150002 - This component has an unfocusable ancestor. 3300 * @throws { BusinessError } 150003 - the component is not on tree or does not exist. 3301 * @syscap SystemCapability.ArkUI.ArkUI.Full 3302 * @atomicservice 3303 * @since arkts { '1.1':'12','1.2':'20' } 3304 * @arkts 1.1&1.2 3305 */ 3306 requestFocus(key: string): void; 3307 3308 /** 3309 * Activate focus style. 3310 * @param { boolean } isActive - activate/deactivate the focus style. 3311 * @param { boolean } [autoInactive] - deactivate the focus style when touch event or mouse event triggers, the default value is true. 3312 * @syscap SystemCapability.ArkUI.ArkUI.Full 3313 * @crossplatform 3314 * @atomicservice 3315 * @since arkts { '1.1':'14','1.2':'20' } 3316 * @arkts 1.1&1.2 3317 */ 3318 activate(isActive: boolean, autoInactive?: boolean): void; 3319 3320 /** 3321 * Get whether the focus style is active. 3322 * @returns { boolean } Whether the focus style is active. 3323 * @syscap SystemCapability.ArkUI.ArkUI.Full 3324 * @crossplatform 3325 * @atomicservice 3326 * @since 20 3327 */ 3328 isActive(): boolean; 3329 3330 /** 3331 * Set whether to enable autofocus transfer. 3332 * @param { boolean } isAutoFocusTransfer - A Boolean value that indicates whether autofocus transfer is enabled. 3333 * @syscap SystemCapability.ArkUI.ArkUI.Full 3334 * @crossplatform 3335 * @atomicservice 3336 * @since arkts { '1.1':'14','1.2':'20' } 3337 * @arkts 1.1&1.2 3338 */ 3339 setAutoFocusTransfer(isAutoFocusTransfer: boolean): void; 3340 3341 /** 3342 * Set the priority of key event processing when component cannot handle the key event.. 3343 * @param { KeyProcessingMode } mode - Key processing mode. 3344 * @syscap SystemCapability.ArkUI.ArkUI.Full 3345 * @crossplatform 3346 * @atomicservice 3347 * @since arkts { '1.1':'15','1.2':'20' } 3348 * @arkts 1.1&1.2 3349 */ 3350 setKeyProcessingMode(mode: KeyProcessingMode): void; 3351} 3352 3353/** 3354 * Pointer style. 3355 * 3356 * @typedef {pointer.PointerStyle} PointerStyle 3357 * @syscap SystemCapability.MultimodalInput.Input.Pointer 3358 * @atomicservice 3359 * @since arkts { '1.1':'12','1.2':'20' } 3360 * @arkts 1.1&1.2 3361 */ 3362export type PointerStyle = pointer.PointerStyle; 3363 3364/** 3365 * class CursorController 3366 * 3367 * @syscap SystemCapability.ArkUI.ArkUI.Full 3368 * @crossplatform 3369 * @atomicservice 3370 * @since arkts { '1.1':'12','1.2':'20' } 3371 * @arkts 1.1&1.2 3372 */ 3373export declare class CursorController { 3374 /** 3375 * Restore default cursor. 3376 * 3377 * @syscap SystemCapability.ArkUI.ArkUI.Full 3378 * @crossplatform 3379 * @atomicservice 3380 * @since arkts { '1.1':'12','1.2':'20' } 3381 * @arkts 1.1&1.2 3382 */ 3383 restoreDefault(): void; 3384 /** 3385 * Set cursor style. 3386 * 3387 * @param { PointerStyle } value - cursor style enum. 3388 * @syscap SystemCapability.ArkUI.ArkUI.Full 3389 * @crossplatform 3390 * @atomicservice 3391 * @since arkts { '1.1':'12','1.2':'20' } 3392 * @arkts 1.1&1.2 3393 */ 3394 setCursor(value: PointerStyle): void; 3395} 3396 3397/** 3398 * class ContextMenuController 3399 * 3400 * @syscap SystemCapability.ArkUI.ArkUI.Full 3401 * @crossplatform 3402 * @atomicservice 3403 * @since arkts { '1.1':'12','1.2':'20' } 3404 * @arkts 1.1&1.2 3405 */ 3406export declare class ContextMenuController { 3407 /** 3408 * Close context menu. 3409 * 3410 * @syscap SystemCapability.ArkUI.ArkUI.Full 3411 * @crossplatform 3412 * @atomicservice 3413 * @since arkts { '1.1':'12','1.2':'20' } 3414 * @arkts 1.1&1.2 3415 */ 3416 close(): void; 3417} 3418 3419/** 3420 * Class FrameCallback 3421 * 3422 * @syscap SystemCapability.ArkUI.ArkUI.Full 3423 * @crossplatform 3424 * @atomicservice 3425 * @since 12 3426 */ 3427/** 3428 * Class FrameCallback 3429 * 3430 * @syscap SystemCapability.ArkUI.ArkUI.Full 3431 * @crossplatform 3432 * @atomicservice 3433 * @since 20 3434 * @arkts 1.1&1.2 3435 */ 3436export declare abstract class FrameCallback { 3437 /** 3438 * Call when a new display frame is being rendered. 3439 * 3440 * @param { number } frameTimeInNano - The frame time in nanoseconds. 3441 * Value range: [0, +∞) 3442 * @syscap SystemCapability.ArkUI.ArkUI.Full 3443 * @crossplatform 3444 * @atomicservice 3445 * @since arkts { '1.1':'12','1.2':'20' } 3446 * @arkts 1.1&1.2 3447 */ 3448 onFrame(frameTimeInNano: number): void; 3449 3450 /** 3451 * Called at the end of the next idle frame. If there is no next frame, will request one automatically. 3452 * 3453 * @param { number } timeLeftInNano - The remaining time from the deadline for this frame, in nanoseconds. 3454 * Value range: [0, +∞) 3455 * @syscap SystemCapability.ArkUI.ArkUI.Full 3456 * @crossplatform 3457 * @atomicservice 3458 * @since arkts { '1.1':'12','1.2':'20' } 3459 * @arkts 1.1&1.2 3460 */ 3461 onIdle(timeLeftInNano: number): void; 3462} 3463 3464/** 3465 * The base context of an ability or an application. It allows access to 3466 * application-specific resources. 3467 * 3468 * @typedef { common.Context } Context 3469 * @syscap SystemCapability.Ability.AbilityRuntime.Core 3470 * @StageModelOnly 3471 * @crossplatform 3472 * @atomicservice 3473 * @since arkts { '1.1':'12','1.2':'20' } 3474 * @arkts 1.1&1.2 3475 */ 3476export type Context = common.Context; 3477 3478/** 3479 * class ComponentSnapshot 3480 * @syscap SystemCapability.ArkUI.ArkUI.Full 3481 * @atomicservice 3482 * @since arkts { '1.1':'12','1.2':'20' } 3483 * @arkts 1.1&1.2 3484 */ 3485export declare class ComponentSnapshot { 3486 /** 3487 * Get a component snapshot by component id. 3488 * 3489 * @param { string } id - Target component ID, set by developer through .id attribute. 3490 * @param { AsyncCallback<image.PixelMap> } callback - Callback that contains the snapshot in PixelMap format. 3491 * @param { componentSnapshot.SnapshotOptions } [options] - Define the snapshot options. 3492 * @throws { BusinessError } 401 - Parameter error. Possible causes: 3493 * <br> 1. Mandatory parameters are left unspecified. 3494 * <br> 2. Incorrect parameters types. 3495 * <br> 3. Parameter verification failed. 3496 * @throws { BusinessError } 100001 - Invalid ID. 3497 * @syscap SystemCapability.ArkUI.ArkUI.Full 3498 * @crossplatform 3499 * @atomicservice 3500 * @since arkts { '1.1':'12','1.2':'20' } 3501 * @arkts 1.1&1.2 3502 */ 3503 get(id: string, callback: AsyncCallback<image.PixelMap>, options?: componentSnapshot.SnapshotOptions): void; 3504 3505 /** 3506 * Get a component snapshot by component id. 3507 * 3508 * @param { string } id - Target component ID, set by developer through .id attribute. 3509 * @param { componentSnapshot.SnapshotOptions } [options] - Define the snapshot options. 3510 * @returns { Promise<image.PixelMap> } A Promise with the snapshot in PixelMap format. 3511 * @throws { BusinessError } 401 - Parameter error. Possible causes: 3512 * <br> 1. Mandatory parameters are left unspecified. 3513 * <br> 2. Incorrect parameters types. 3514 * <br> 3. Parameter verification failed. 3515 * @throws { BusinessError } 100001 - Invalid ID. 3516 * @syscap SystemCapability.ArkUI.ArkUI.Full 3517 * @crossplatform 3518 * @atomicservice 3519 * @since arkts { '1.1':'12','1.2':'20' } 3520 * @arkts 1.1&1.2 3521 */ 3522 get(id: string, options?: componentSnapshot.SnapshotOptions): Promise<image.PixelMap>; 3523 3524 /** 3525 * Generate a snapshot from a custom component builder. 3526 * 3527 * @param { CustomBuilder } builder - Builder function of a custom component. 3528 * @param { AsyncCallback<image.PixelMap> } callback - Callback that contains the snapshot in PixelMap format. 3529 * @param { number } [delay] - Defines the delay time to render the snapshot. 3530 * @param { boolean } [checkImageStatus] - Defines if check the image decoding status before taking snapshot. 3531 * @param { componentSnapshot.SnapshotOptions } [options] - Define the snapshot options. 3532 * @throws { BusinessError } 401 - Parameter error. Possible causes: 3533 * <br> 1. Mandatory parameters are left unspecified. 3534 * <br> 2. Incorrect parameters types. 3535 * <br> 3. Parameter verification failed. 3536 * @throws { BusinessError } 100001 - The builder is not a valid build function. 3537 * @throws { BusinessError } 160001 - An image component in builder is not ready for taking a snapshot. The check for 3538 * the ready state is required when the checkImageStatus option is enabled. 3539 * @syscap SystemCapability.ArkUI.ArkUI.Full 3540 * @crossplatform 3541 * @atomicservice 3542 * @since arkts { '1.1':'12','1.2':'20' } 3543 * @arkts 1.1&1.2 3544 */ 3545 createFromBuilder(builder: CustomBuilder, callback: AsyncCallback<image.PixelMap>, 3546 delay?: number, checkImageStatus?: boolean, options?: componentSnapshot.SnapshotOptions): void; 3547 3548 /** 3549 * Generate a snapshot from a custom component builder. 3550 * 3551 * @param { CustomBuilder } builder - Builder function of a custom component. 3552 * @param { number } [delay] - Defines the delay time to render the snapshot. 3553 * @param { boolean } [checkImageStatus] - Defines if check the image decoding status before taking snapshot. 3554 * @param { componentSnapshot.SnapshotOptions } [options] - Define the snapshot options. 3555 * @returns { Promise<image.PixelMap> } A Promise with the snapshot in PixelMap format. 3556 * @throws { BusinessError } 401 - Parameter error. Possible causes: 3557 * <br> 1. Mandatory parameters are left unspecified. 3558 * <br> 2. Incorrect parameters types. 3559 * <br> 3. Parameter verification failed. 3560 * @throws { BusinessError } 100001 - The builder is not a valid build function. 3561 * @throws { BusinessError } 160001 - An image component in builder is not ready for taking a snapshot. The check for 3562 * the ready state is required when the checkImageStatus option is enabled. 3563 * @syscap SystemCapability.ArkUI.ArkUI.Full 3564 * @crossplatform 3565 * @atomicservice 3566 * @since arkts { '1.1':'12','1.2':'20' } 3567 * @arkts 1.1&1.2 3568 */ 3569 createFromBuilder(builder: CustomBuilder, delay?: number, 3570 checkImageStatus?: boolean, options?: componentSnapshot.SnapshotOptions): Promise<image.PixelMap>; 3571 3572 /** 3573 * Take a screenshot of the specified component in synchronous mode, 3574 * this mode will block the main thread, please use it with caution, the maximum 3575 * waiting time of the interface is 3s, if it does not return after 3s, an exception will be thrown. 3576 * 3577 * @param { string } id - Target component ID, set by developer through .id attribute. 3578 * @param { componentSnapshot.SnapshotOptions } [options] - Define the snapshot options. 3579 * @returns { image.PixelMap } The snapshot result in PixelMap format. 3580 * @throws { BusinessError } 401 - Parameter error. Possible causes: 3581 * <br> 1. Mandatory parameters are left unspecified. 3582 * <br> 2. Incorrect parameters types. 3583 * <br> 3. Parameter verification failed. 3584 * @throws { BusinessError } 100001 - Invalid ID. 3585 * @throws { BusinessError } 160002 - Timeout. 3586 * @syscap SystemCapability.ArkUI.ArkUI.Full 3587 * @crossplatform 3588 * @atomicservice 3589 * @since arkts { '1.1':'12','1.2':'20' } 3590 * @arkts 1.1&1.2 3591 */ 3592 getSync(id: string, options?: componentSnapshot.SnapshotOptions): image.PixelMap; 3593 3594 /** 3595 * Get a component snapshot by uniqueId. 3596 * 3597 * @param { number } uniqueId - The uniqueId of the node, can get through getUniqueId. 3598 * @param { componentSnapshot.SnapshotOptions } [options] - Define the snapshot options. 3599 * @returns { Promise<image.PixelMap> } A Promise with the snapshot in PixelMap format. 3600 * @throws { BusinessError } 401 - Parameter error. Possible causes: 3601 * <br> 1. Mandatory parameters are left unspecified. 3602 * <br> 2. Incorrect parameters types. 3603 * <br> 3. Parameter verification failed. 3604 * @throws { BusinessError } 100001 - Invalid ID. 3605 * @syscap SystemCapability.ArkUI.ArkUI.Full 3606 * @crossplatform 3607 * @atomicservice 3608 * @since arkts { '1.1':'15','1.2':'20' } 3609 * @arkts 1.1&1.2 3610 */ 3611 getWithUniqueId(uniqueId: number, options?: componentSnapshot.SnapshotOptions): Promise<image.PixelMap>; 3612 3613 /** 3614 * Take a screenshot of the specified component in synchronous mode, 3615 * this mode will block the main thread, please use it with caution, the maximum 3616 * waiting time of the interface is 3s, if it does not return after 3s, an exception will be thrown. 3617 * 3618 * @param { number } uniqueId - The uniqueId of the node, can get through getUniqueId. 3619 * @param { componentSnapshot.SnapshotOptions } [options] - Define the snapshot options. 3620 * @returns { image.PixelMap } The snapshot result in PixelMap format. 3621 * @throws { BusinessError } 401 - Parameter error. Possible causes: 3622 * <br> 1. Mandatory parameters are left unspecified. 3623 * <br> 2. Incorrect parameters types. 3624 * <br> 3. Parameter verification failed. 3625 * @throws { BusinessError } 100001 - Invalid ID. 3626 * @throws { BusinessError } 160002 - Timeout. 3627 * @syscap SystemCapability.ArkUI.ArkUI.Full 3628 * @crossplatform 3629 * @atomicservice 3630 * @since arkts { '1.1':'15','1.2':'20' } 3631 * @arkts 1.1&1.2 3632 */ 3633 getSyncWithUniqueId(uniqueId: number, options?: componentSnapshot.SnapshotOptions): image.PixelMap; 3634 3635 /** 3636 * Generate a snapshot from a custom component content. 3637 * 3638 * @param { ComponentContent<T> } content - The content to be taken snapshot. 3639 * @param { number } [delay] - Defines the delay time to render the snapshot. 3640 * @param { boolean } [checkImageStatus] - Defines if check the image decoding status before taking snapshot. 3641 * @param { componentSnapshot.SnapshotOptions } [options] - Define the snapshot options. 3642 * @returns { Promise<image.PixelMap> } A Promise with the snapshot in PixelMap format. 3643 * @throws { BusinessError } 401 - Parameter error. Possible causes: 3644 * <br> 1. Mandatory parameters are left unspecified. 3645 * <br> 2. Incorrect parameters types. 3646 * <br> 3. Parameter verification failed. 3647 * @throws { BusinessError } 100001 - The builder is not a valid build function. 3648 * @throws { BusinessError } 160001 - An image component in builder is not ready for taking a snapshot. The check for 3649 * the ready state is required when the checkImageStatus option is enabled. 3650 * @syscap SystemCapability.ArkUI.ArkUI.Full 3651 * @crossplatform 3652 * @atomicservice 3653 * @since arkts { '1.1':'18','1.2':'20' } 3654 * @arkts 1.1&1.2 3655 */ 3656 createFromComponent<T extends Object>(content: ComponentContent<T>, delay?: number, 3657 checkImageStatus?: boolean, options?: componentSnapshot.SnapshotOptions): Promise<image.PixelMap>; 3658 3659 /** 3660 * Get a component snapshot by component range. 3661 * 3662 * @param { NodeIdentity } start - the start component ID, set by developer through .id attribute or the unique ID 3663 * get from FrameNode. 3664 * @param { NodeIdentity } end - the end component ID, set by developer through.id attribute or the unique ID 3665 * get from FrameNode. 3666 * @param { boolean } isStartRect - indicating the snapshot rect to use, true for using the 3667 * rect of the start component, false for using the rect of the end component. 3668 * @param { componentSnapshot.SnapshotOptions } [options] - Define the snapshot options. 3669 * @returns { Promise<image.PixelMap> } A Promise with the snapshot in PixelMap format. 3670 * @throws { BusinessError } 202 - The caller is not a system application. 3671 * @throws { BusinessError } 100001 - Invalid ID detected. 3672 * @syscap SystemCapability.ArkUI.ArkUI.Full 3673 * @systemapi 3674 * @since 20 3675 */ 3676 getWithRange(start: NodeIdentity, end: NodeIdentity, isStartRect: boolean, 3677 options?: componentSnapshot.SnapshotOptions): Promise<image.PixelMap>; 3678} 3679 3680/** 3681 * class UIContext 3682 * 3683 * @syscap SystemCapability.ArkUI.ArkUI.Full 3684 * @crossplatform 3685 * @since 10 3686 */ 3687/** 3688 * class UIContext 3689 * 3690 * @syscap SystemCapability.ArkUI.ArkUI.Full 3691 * @crossplatform 3692 * @atomicservice 3693 * @since 11 3694 */ 3695/** 3696 * class UIContext 3697 * 3698 * @syscap SystemCapability.ArkUI.ArkUI.Full 3699 * @crossplatform 3700 * @atomicservice 3701 * @since 20 3702 * @arkts 1.1&1.2 3703 */ 3704export declare class UIContext { 3705 /** 3706 * Checks whether the UiContext object ia available. 3707 * 3708 * @returns { boolean } Returns true if the UIConetxt object is available. 3709 * @syscap SystemCapability.ArkUI.ArkUI.Full 3710 * @crossplatform 3711 * @atomicservice 3712 * @since 20 3713 */ 3714 isAvailable(): boolean; 3715 3716 /** 3717 * get object font. 3718 * 3719 * @returns { Font } object Font. 3720 * @syscap SystemCapability.ArkUI.ArkUI.Full 3721 * @crossplatform 3722 * @since 10 3723 */ 3724 /** 3725 * get object font. 3726 * 3727 * @returns { Font } object Font. 3728 * @syscap SystemCapability.ArkUI.ArkUI.Full 3729 * @crossplatform 3730 * @atomicservice 3731 * @since arkts { '1.1':'11','1.2':'20' } 3732 * @arkts 1.1&1.2 3733 */ 3734 getFont(): Font; 3735 3736 /** 3737 * get object mediaQuery. 3738 * 3739 * @returns { MediaQuery } object MediaQuery. 3740 * @syscap SystemCapability.ArkUI.ArkUI.Full 3741 * @crossplatform 3742 * @since 10 3743 */ 3744 /** 3745 * get object mediaQuery. 3746 * 3747 * @returns { MediaQuery } object MediaQuery. 3748 * @syscap SystemCapability.ArkUI.ArkUI.Full 3749 * @crossplatform 3750 * @atomicservice 3751 * @since arkts { '1.1':'11','1.2':'20' } 3752 * @arkts 1.1&1.2 3753 */ 3754 getMediaQuery(): MediaQuery; 3755 3756 /** 3757 * get object UIInspector. 3758 * @returns { UIInspector } object UIInspector. 3759 * @syscap SystemCapability.ArkUI.ArkUI.Full 3760 * @crossplatform 3761 * @since 10 3762 */ 3763 /** 3764 * get object UIInspector. 3765 * @returns { UIInspector } object UIInspector. 3766 * @syscap SystemCapability.ArkUI.ArkUI.Full 3767 * @crossplatform 3768 * @atomicservice 3769 * @since arkts { '1.1':'11','1.2':'20' } 3770 * @arkts 1.1&1.2 3771 */ 3772 getUIInspector(): UIInspector; 3773 3774 /** 3775 * get the filtered attributes of the component tree. 3776 * @param { Array<string> } [filters] - the list of filters used to filter out component tree to be obtained. 3777 * @returns { string } the specified attributes of the component tree in json string. 3778 * @throws { BusinessError } 401 - Parameter error. Possible causes: 3779 * <br> 1. Mandatory parameters are left unspecified. 3780 * <br> 2. Incorrect parameters types. 3781 * <br> 3. Parameter verification failed. 3782 * @syscap SystemCapability.ArkUI.ArkUI.Full 3783 * @crossplatform 3784 * @atomicservice 3785 * @since arkts { '1.1':'12','1.2':'20' } 3786 * @arkts 1.1&1.2 3787 */ 3788 getFilteredInspectorTree(filters?: Array<string>): string; 3789 3790 /** 3791 * get the filtered attributes of the component tree with the specified id and depth 3792 * @param { string } id - ID of the specified component tree to be obtained. 3793 * @param { number } depth - depth of the component tree to be obtained. 3794 * @param { Array<string> } [filters] - the list of filters used to filter out component tree to be obtained. 3795 * @returns { string } the specified attributes of the component tree in json string. 3796 * @throws { BusinessError } 401 - Parameter error. Possible causes: 3797 * <br> 1. Mandatory parameters are left unspecified. 3798 * <br> 2. Incorrect parameters types. 3799 * <br> 3. Parameter verification failed. 3800 * @syscap SystemCapability.ArkUI.ArkUI.Full 3801 * @crossplatform 3802 * @atomicservice 3803 * @since arkts { '1.1':'12','1.2':'20' } 3804 * @arkts 1.1&1.2 3805 */ 3806 getFilteredInspectorTreeById(id: string, depth: number, filters?: Array<string>): string; 3807 3808 /** 3809 * Obtains a Router object. 3810 * 3811 * @returns { Router } Router object. 3812 * @syscap SystemCapability.ArkUI.ArkUI.Full 3813 * @crossplatform 3814 * @since 10 3815 */ 3816 /** 3817 * Obtains a Router object. 3818 * 3819 * @returns { Router } Router object. 3820 * @syscap SystemCapability.ArkUI.ArkUI.Full 3821 * @crossplatform 3822 * @atomicservice 3823 * @since arkts { '1.1':'11','1.2':'20' } 3824 * @arkts 1.1&1.2 3825 */ 3826 getRouter(): Router; 3827 3828 /** 3829 * get object PromptAction. 3830 * 3831 * @returns { PromptAction } object PromptAction. 3832 * @syscap SystemCapability.ArkUI.ArkUI.Full 3833 * @crossplatform 3834 * @since 10 3835 */ 3836 /** 3837 * Obtains a PromptAction object. 3838 * 3839 * @returns { PromptAction } PromptAction object. 3840 * @syscap SystemCapability.ArkUI.ArkUI.Full 3841 * @crossplatform 3842 * @atomicservice 3843 * @since arkts { '1.1':'11','1.2':'20' } 3844 * @arkts 1.1&1.2 3845 */ 3846 getPromptAction(): PromptAction; 3847 3848 /** 3849 * get object ComponentUtils. 3850 * @returns { ComponentUtils } object ComponentUtils. 3851 * @syscap SystemCapability.ArkUI.ArkUI.Full 3852 * @crossplatform 3853 * @since 10 3854 */ 3855 /** 3856 * get object ComponentUtils. 3857 * @returns { ComponentUtils } object ComponentUtils. 3858 * @syscap SystemCapability.ArkUI.ArkUI.Full 3859 * @crossplatform 3860 * @atomicservice 3861 * @since arkts { '1.1':'11','1.2':'20' } 3862 * @arkts 1.1&1.2 3863 */ 3864 getComponentUtils(): ComponentUtils; 3865 3866 /** 3867 * Get the UI observer. 3868 * 3869 * @returns { UIObserver } The UI observer. 3870 * @syscap SystemCapability.ArkUI.ArkUI.Full 3871 * @crossplatform 3872 * @since 11 3873 */ 3874 /** 3875 * Get the UI observer. 3876 * 3877 * @returns { UIObserver } The UI observer. 3878 * @syscap SystemCapability.ArkUI.ArkUI.Full 3879 * @crossplatform 3880 * @atomicservice 3881 * @since arkts { '1.1':'12','1.2':'20' } 3882 * @arkts 1.1&1.2 3883 */ 3884 getUIObserver(): UIObserver; 3885 3886 /** 3887 * Obtains the OverlayManager object. 3888 * 3889 * @returns { OverlayManager } OverlayManager instance obtained. 3890 * @syscap SystemCapability.ArkUI.ArkUI.Full 3891 * @crossplatform 3892 * @atomicservice 3893 * @since arkts { '1.1':'12','1.2':'20' } 3894 * @arkts 1.1&1.2 3895 */ 3896 getOverlayManager(): OverlayManager; 3897 3898 /** 3899 * Init OverlayManager. 3900 * 3901 * @param { OverlayManagerOptions } options - Options. 3902 * @returns { boolean } Returns true if it is called first and before getting an OverlayManager instance; returns false otherwise. 3903 * @syscap SystemCapability.ArkUI.ArkUI.Full 3904 * @crossplatform 3905 * @atomicservice 3906 * @since arkts { '1.1':'15','1.2':'20' } 3907 * @arkts 1.1&1.2 3908 */ 3909 setOverlayManagerOptions(options: OverlayManagerOptions): boolean; 3910 3911 /** 3912 * Get object OverlayManagerOptions. 3913 * 3914 * @returns { OverlayManagerOptions } object OverlayManagerOptions. 3915 * @syscap SystemCapability.ArkUI.ArkUI.Full 3916 * @crossplatform 3917 * @atomicservice 3918 * @since arkts { '1.1':'15','1.2':'20' } 3919 * @arkts 1.1&1.2 3920 */ 3921 getOverlayManagerOptions(): OverlayManagerOptions; 3922 3923 /** 3924 * Create an animator object for custom animation. 3925 * 3926 * @param { AnimatorOptions } options - Options. 3927 * @returns { AnimatorResult } 3928 * @throws { BusinessError } 401 - Parameter error. Possible causes: 3929 * <br> 1. Mandatory parameters are left unspecified. 3930 * <br> 2. Incorrect parameters types. 3931 * <br> 3. Parameter verification failed. 3932 * @syscap SystemCapability.ArkUI.ArkUI.Full 3933 * @crossplatform 3934 * @since 10 3935 */ 3936 /** 3937 * Create an animator object for custom animation. 3938 * 3939 * @param { AnimatorOptions } options - Options. 3940 * @returns { AnimatorResult } 3941 * @throws { BusinessError } 401 - Parameter error. Possible causes: 3942 * <br> 1. Mandatory parameters are left unspecified. 3943 * <br> 2. Incorrect parameters types. 3944 * <br> 3. Parameter verification failed. 3945 * @syscap SystemCapability.ArkUI.ArkUI.Full 3946 * @crossplatform 3947 * @atomicservice 3948 * @since arkts { '1.1':'11','1.2':'20' } 3949 * @arkts 1.1&1.2 3950 */ 3951 createAnimator(options: AnimatorOptions): AnimatorResult; 3952 3953 /** 3954 * Create an animator object for custom animation. 3955 * 3956 * @param { AnimatorOptions | SimpleAnimatorOptions } options - Options. 3957 * @returns { AnimatorResult } 3958 * @throws { BusinessError } 401 - Parameter error. Possible causes: 3959 * <br> 1. Mandatory parameters are left unspecified. 3960 * <br> 2. Incorrect parameters types. 3961 * <br> 3. Parameter verification failed. 3962 * @syscap SystemCapability.ArkUI.ArkUI.Full 3963 * @crossplatform 3964 * @atomicservice 3965 * @since arkts { '1.1':'18','1.2':'20' } 3966 * @arkts 1.1&1.2 3967 */ 3968 createAnimator(options: AnimatorOptions | SimpleAnimatorOptions): AnimatorResult; 3969 3970 /** 3971 * Defining animation function 3972 * 3973 * @param { AnimateParam } value - parameters for animation. 3974 * @param { function } event - the closure base on which, the system will create animation automatically 3975 * @syscap SystemCapability.ArkUI.ArkUI.Full 3976 * @crossplatform 3977 * @since 10 3978 */ 3979 /** 3980 * Defining animation function 3981 * 3982 * @param { AnimateParam } value - parameters for animation. 3983 * @param { function } event - the closure base on which, the system will create animation automatically 3984 * @syscap SystemCapability.ArkUI.ArkUI.Full 3985 * @crossplatform 3986 * @atomicservice 3987 * @since arkts { '1.1':'11','1.2':'20' } 3988 * @arkts 1.1&1.2 3989 */ 3990 animateTo(value: AnimateParam, event: () => void): void; 3991 3992 /** 3993 * alertDialog display. 3994 * 3995 * @param { AlertDialogParamWithConfirm | AlertDialogParamWithButtons | AlertDialogParamWithOptions } options - Options. 3996 * @syscap SystemCapability.ArkUI.ArkUI.Full 3997 * @crossplatform 3998 * @since 10 3999 */ 4000 /** 4001 * Shows an alert dialog box. 4002 * 4003 * @param { AlertDialogParamWithConfirm | AlertDialogParamWithButtons | AlertDialogParamWithOptions } options - Shows 4004 * an AlertDialog component in the given settings. 4005 * @syscap SystemCapability.ArkUI.ArkUI.Full 4006 * @crossplatform 4007 * @atomicservice 4008 * @since arkts { '1.1':'11','1.2':'20' } 4009 * @arkts 1.1&1.2 4010 */ 4011 showAlertDialog(options: AlertDialogParamWithConfirm | AlertDialogParamWithButtons | AlertDialogParamWithOptions): void; 4012 4013 /** 4014 * actionSheet display. 4015 * 4016 * @param { ActionSheetOptions } value - Options. 4017 * @syscap SystemCapability.ArkUI.ArkUI.Full 4018 * @crossplatform 4019 * @since 10 4020 */ 4021 /** 4022 * Shows an action sheet in the given settings. 4023 * 4024 * @param { ActionSheetOptions } value - Parameters of the action sheet. 4025 * @syscap SystemCapability.ArkUI.ArkUI.Full 4026 * @crossplatform 4027 * @atomicservice 4028 * @since arkts { '1.1':'11','1.2':'20' } 4029 * @arkts 1.1&1.2 4030 */ 4031 showActionSheet(value: ActionSheetOptions): void; 4032 4033 /** 4034 * datePickerDialog display. 4035 * 4036 * @param { DatePickerDialogOptions } options - Options. 4037 * @syscap SystemCapability.ArkUI.ArkUI.Full 4038 * @crossplatform 4039 * @since 10 4040 */ 4041 /** 4042 * datePickerDialog display. 4043 * 4044 * @param { DatePickerDialogOptions } options - Options. 4045 * @syscap SystemCapability.ArkUI.ArkUI.Full 4046 * @crossplatform 4047 * @atomicservice 4048 * @since arkts { '1.1':'11','1.2':'20' } 4049 * @arkts 1.1&1.2 4050 */ 4051 showDatePickerDialog(options: DatePickerDialogOptions): void; 4052 4053 /** 4054 * timePickerDialog display. 4055 * 4056 * @param { TimePickerDialogOptions } options - Options. 4057 * @syscap SystemCapability.ArkUI.ArkUI.Full 4058 * @crossplatform 4059 * @since 10 4060 */ 4061 /** 4062 * timePickerDialog display. 4063 * 4064 * @param { TimePickerDialogOptions } options - Options. 4065 * @syscap SystemCapability.ArkUI.ArkUI.Full 4066 * @crossplatform 4067 * @atomicservice 4068 * @since arkts { '1.1':'11','1.2':'20' } 4069 * @arkts 1.1&1.2 4070 */ 4071 showTimePickerDialog(options: TimePickerDialogOptions): void; 4072 4073 /** 4074 * textPickerDialog display. 4075 * 4076 * @param { TextPickerDialogOptions } options - Options. 4077 * @syscap SystemCapability.ArkUI.ArkUI.Full 4078 * @crossplatform 4079 * @since 10 4080 */ 4081 /** 4082 * textPickerDialog display. 4083 * 4084 * @param { TextPickerDialogOptions } options - Options. 4085 * @syscap SystemCapability.ArkUI.ArkUI.Full 4086 * @crossplatform 4087 * @atomicservice 4088 * @since arkts { '1.1':'11','1.2':'20' } 4089 * @arkts 1.1&1.2 4090 */ 4091 showTextPickerDialog(options: TextPickerDialogOptions): void; 4092 4093 /** 4094 * textPickerDialog display. 4095 * 4096 * @param { TextPickerDialogOptions | TextPickerDialogOptionsExt } style - Dialog style. 4097 * @syscap SystemCapability.ArkUI.ArkUI.Full 4098 * @crossplatform 4099 * @atomicservice 4100 * @since 20 4101 */ 4102 showTextPickerDialog(style: TextPickerDialogOptions | TextPickerDialogOptionsExt): void; 4103 4104 /** 4105 * Run custom functions inside the UIContext scope. 4106 * 4107 * @param { function } callback - The function called through UIContext. 4108 * @syscap SystemCapability.ArkUI.ArkUI.Full 4109 * @crossplatform 4110 * @since 10 4111 */ 4112 /** 4113 * Run custom functions inside the UIContext scope. 4114 * 4115 * @param { function } callback - The function called through UIContext. 4116 * @syscap SystemCapability.ArkUI.ArkUI.Full 4117 * @crossplatform 4118 * @atomicservice 4119 * @since arkts { '1.1':'11','1.2':'20' } 4120 * @arkts 1.1&1.2 4121 */ 4122 runScopedTask(callback: () => void): void; 4123 4124 /** 4125 * Sets the avoidance mode for the virtual keyboard.<br> 4126 * Default mode: **KeyboardAvoidMode.OFFSET**. 4127 * 4128 * @param { KeyboardAvoidMode } value - The mode of keyboard avoid. 4129 * @syscap SystemCapability.ArkUI.ArkUI.Full 4130 * @crossplatform 4131 * @atomicservice 4132 * @since arkts { '1.1':'11','1.2':'20' } 4133 * @arkts 1.1&1.2 4134 */ 4135 setKeyboardAvoidMode(value: KeyboardAvoidMode): void; 4136 4137 /** 4138 * Obtains the avoidance mode of the virtual keyboard. 4139 * @returns { KeyboardAvoidMode } The mode of keyboard avoid. 4140 * @syscap SystemCapability.ArkUI.ArkUI.Full 4141 * @crossplatform 4142 * @atomicservice 4143 * @since arkts { '1.1':'11','1.2':'20' } 4144 * @arkts 1.1&1.2 4145 */ 4146 getKeyboardAvoidMode(): KeyboardAvoidMode; 4147 4148 /** 4149 * Set the pixel round mode of the system. The default mode is PixelRoundMode.PIXEL_ROUND_ON_LAYOUT_FINISH. 4150 * 4151 * @param { PixelRoundMode } mode - The mode of pixel round. 4152 * @syscap SystemCapability.ArkUI.ArkUI.Full 4153 * @crossplatform 4154 * @atomicservice 4155 * @since arkts { '1.1':'18','1.2':'20' } 4156 * @arkts 1.1&1.2 4157 */ 4158 setPixelRoundMode(mode: PixelRoundMode): void; 4159 4160 /** 4161 * Get the pixel round mode of the system. 4162 * 4163 * @returns { PixelRoundMode } the mode of pixel round. 4164 * @syscap SystemCapability.ArkUI.ArkUI.Full 4165 * @crossplatform 4166 * @atomicservice 4167 * @since arkts { '1.1':'18','1.2':'20' } 4168 * @arkts 1.1&1.2 4169 */ 4170 getPixelRoundMode(): PixelRoundMode; 4171 4172 /** 4173 * Dispach keyboard event to the frameNode with inspector key. 4174 * 4175 * @param { number | string } node - The uniqueId or inspector key of the target FrameNode. 4176 * @param { KeyEvent } event - The key event to be sent. 4177 * @returns { boolean } Returns whether the key event is consumed. 4178 * @syscap SystemCapability.ArkUI.ArkUI.Full 4179 * @crossplatform 4180 * @atomicservice 4181 * @since arkts { '1.1':'15','1.2':'20' } 4182 * @arkts 1.1&1.2 4183 */ 4184 dispatchKeyEvent(node: number | string, event: KeyEvent): boolean; 4185 4186 /** 4187 * Get AtomicServiceBar. 4188 * @returns { Nullable<AtomicServiceBar> } The atomic service bar. 4189 * @syscap SystemCapability.ArkUI.ArkUI.Full 4190 * @crossplatform 4191 * @atomicservice 4192 * @since arkts { '1.1':'11','1.2':'20' } 4193 * @arkts 1.1&1.2 4194 */ 4195 getAtomicServiceBar(): Nullable<AtomicServiceBar>; 4196 4197 /** 4198 * Get DragController. 4199 * @returns { DragController } the DragController 4200 * @syscap SystemCapability.ArkUI.ArkUI.Full 4201 * @since 11 4202 */ 4203 /** 4204 * Get DragController. 4205 * @returns { DragController } the DragController 4206 * @syscap SystemCapability.ArkUI.ArkUI.Full 4207 * @atomicservice 4208 * @since 12 4209 */ 4210 /** 4211 * Get DragController. 4212 * @returns { DragController } the DragController 4213 * @syscap SystemCapability.ArkUI.ArkUI.Full 4214 * @crossplatform 4215 * @atomicservice 4216 * @since arkts { '1.1':'18','1.2':'20' } 4217 * @arkts 1.1&1.2 4218 */ 4219 getDragController(): DragController; 4220 4221 /** 4222 * Get MeasureUtils. 4223 * @returns { MeasureUtils } the MeasureUtils 4224 * @syscap SystemCapability.ArkUI.ArkUI.Full 4225 * @crossplatform 4226 * @atomicservice 4227 * @since arkts { '1.1':'12','1.2':'20' } 4228 * @arkts 1.1&1.2 4229 */ 4230 getMeasureUtils(): MeasureUtils; 4231 4232 /** 4233 * Generates a key frame animation. 4234 * 4235 * @param { KeyframeAnimateParam } param - Global parameters of the keyframe animation. 4236 * @param { Array<KeyframeState> } keyframes - Array of keyframes. 4237 * @syscap SystemCapability.ArkUI.ArkUI.Full 4238 * @crossplatform 4239 * @since 11 4240 */ 4241 /** 4242 * Generates a key frame animation. 4243 * 4244 * @param { KeyframeAnimateParam } param - Global parameters of the keyframe animation. 4245 * @param { Array<KeyframeState> } keyframes - Array of keyframes. 4246 * @syscap SystemCapability.ArkUI.ArkUI.Full 4247 * @crossplatform 4248 * @atomicservice 4249 * @since arkts { '1.1':'12','1.2':'20' } 4250 * @arkts 1.1&1.2 4251 */ 4252 keyframeAnimateTo(param: KeyframeAnimateParam, keyframes: Array<KeyframeState>): void; 4253 4254 /** 4255 * Get FocusController. 4256 * @returns { FocusController } the FocusController 4257 * @syscap SystemCapability.ArkUI.ArkUI.Full 4258 * @atomicservice 4259 * @since arkts { '1.1':'12','1.2':'20' } 4260 * @arkts 1.1&1.2 4261 */ 4262 getFocusController(): FocusController; 4263 4264 /** 4265 * Define animation functions for immediate distribution. 4266 * 4267 * @param { AnimateParam } param - Set animation effect parameters. 4268 * @param { Callback<void> } event - Specify the closure function that displays dynamic effects, 4269 * and the system will automatically insert transition animations for state changes caused by the closure function. 4270 * @syscap SystemCapability.ArkUI.ArkUI.Full 4271 * @systemapi 4272 * @since arkts { '1.1':'12','1.2':'20' } 4273 * @arkts 1.1&1.2 4274 */ 4275 animateToImmediately(param: AnimateParam, event: Callback<void>): void; 4276 4277 /** 4278 * Get FrameNode by id. 4279 * 4280 * @param { string } id - The id of FrameNode. 4281 * @returns { FrameNode | null } The instance of FrameNode. 4282 * @syscap SystemCapability.ArkUI.ArkUI.Full 4283 * @crossplatform 4284 * @atomicservice 4285 * @since arkts { '1.1':'12','1.2':'20' } 4286 * @arkts 1.1&1.2 4287 */ 4288 getFrameNodeById(id: string): FrameNode | null; 4289 4290 /** 4291 * Get the FrameNode attached to current window by id. 4292 * 4293 * @param { string } id - The id of FrameNode. 4294 * @returns { FrameNode | null } The instance of FrameNode. 4295 * @syscap SystemCapability.ArkUI.ArkUI.Full 4296 * @crossplatform 4297 * @atomicservice 4298 * @since arkts { '1.1':'12','1.2':'20' } 4299 * @arkts 1.1&1.2 4300 */ 4301 getAttachedFrameNodeById(id: string): FrameNode | null; 4302 4303 /** 4304 * Get FrameNode by uniqueId. 4305 * Obtains the entity node, FrameNode, of a component on the component tree using its uniqueId. 4306 * The return value depends on the type of component associated with the uniqueId. 4307 * 1. If the uniqueId corresponds to a built-in component, the associated FrameNode is returned. 4308 * 2. If the uniqueId corresponds to a custom component: If the component has rendered content, its root node is 4309 * returned, with the type __Common__; if the component has no rendered content, the FrameNode of its first child 4310 * component is returned. 4311 * 3. If the uniqueId does not correspond to any component, null is returned. 4312 * 4313 * @param { number } id - The uniqueId of the FrameNode. 4314 * @returns { FrameNode | null } - The FrameNode with the target uniqueId, or null if the frameNode is not existed. 4315 * @syscap SystemCapability.ArkUI.ArkUI.Full 4316 * @crossplatform 4317 * @atomicservice 4318 * @since arkts { '1.1':'12','1.2':'20' } 4319 * @arkts 1.1&1.2 4320 */ 4321 getFrameNodeByUniqueId(id: number): FrameNode | null; 4322 4323 /** 4324 * Get page information of the frameNode with uniqueId. 4325 * 4326 * @param { number } id - The uniqueId of the target FrameNode. 4327 * @returns { PageInfo } - The page information of the frameNode with the target uniqueId, includes 4328 * navDestination and router page information. If the frame node does not have navDestination and 4329 * router page information, it will return an empty object. 4330 * @syscap SystemCapability.ArkUI.ArkUI.Full 4331 * @crossplatform 4332 * @atomicservice 4333 * @since arkts { '1.1':'12','1.2':'20' } 4334 * @arkts 1.1&1.2 4335 */ 4336 getPageInfoByUniqueId(id: number): PageInfo; 4337 4338 /** 4339 * Get navigation information of the frameNode with uniqueId. 4340 * 4341 * @param { number } id - The uniqueId of the target FrameNode. 4342 * @returns { observer.NavigationInfo | undefined } - The navigation information of the frameNode with the 4343 * target uniqueId, or undefined if the frameNode is not existed or does not have navigation information. 4344 * @syscap SystemCapability.ArkUI.ArkUI.Full 4345 * @crossplatform 4346 * @atomicservice 4347 * @since arkts { '1.1':'12','1.2':'20' } 4348 * @arkts 1.1&1.2 4349 */ 4350 getNavigationInfoByUniqueId(id: number): observer.NavigationInfo | undefined; 4351 4352 /** 4353 * Dynamic dimming. 4354 * 4355 * @param { string } id - The id of FrameNode. 4356 * @param { number } value - Compared to the original level of dimming.value range [0,1], 4357 * set values less than 0 to 0 and values greater than 1 to 1. 4358 * @syscap SystemCapability.ArkUI.ArkUI.Full 4359 * @systemapi 4360 * @since arkts { '1.1':'12','1.2':'20' } 4361 * @arkts 1.1&1.2 4362 */ 4363 setDynamicDimming(id: string, value: number): void; 4364 4365 /** 4366 * Get object cursor controller. 4367 * 4368 * @returns { CursorController } object cursor controller. 4369 * @syscap SystemCapability.ArkUI.ArkUI.Full 4370 * @crossplatform 4371 * @atomicservice 4372 * @since arkts { '1.1':'12','1.2':'20' } 4373 * @arkts 1.1&1.2 4374 */ 4375 getCursorController(): CursorController; 4376 4377 /** 4378 * Get object context menu controller. 4379 * 4380 * @returns { ContextMenuController } object context menu controller. 4381 * @syscap SystemCapability.ArkUI.ArkUI.Full 4382 * @crossplatform 4383 * @atomicservice 4384 * @since arkts { '1.1':'12','1.2':'20' } 4385 * @arkts 1.1&1.2 4386 */ 4387 getContextMenuController(): ContextMenuController; 4388 4389 /** 4390 * Get ComponentSnapshot. 4391 * @returns { ComponentSnapshot } the ComponentSnapshot 4392 * @syscap SystemCapability.ArkUI.ArkUI.Full 4393 * @atomicservice 4394 * @since arkts { '1.1':'12','1.2':'20' } 4395 * @arkts 1.1&1.2 4396 */ 4397 getComponentSnapshot(): ComponentSnapshot; 4398 4399 /** 4400 * Converts a value in vp units to a value in px. 4401 * @param { number } value 4402 * @returns { number } 4403 * @syscap SystemCapability.ArkUI.ArkUI.Full 4404 * @atomicservice 4405 * @since arkts { '1.1':'12','1.2':'20' } 4406 * @arkts 1.1&1.2 4407 */ 4408 vp2px(value: number): number; 4409 4410 /** 4411 * Converts a value in px units to a value in vp. 4412 * @param { number } value 4413 * @returns { number } 4414 * @syscap SystemCapability.ArkUI.ArkUI.Full 4415 * @atomicservice 4416 * @since arkts { '1.1':'12','1.2':'20' } 4417 * @arkts 1.1&1.2 4418 */ 4419 px2vp(value: number): number; 4420 4421 /** 4422 * Converts a value in fp units to a value in px. 4423 * @param { number } value 4424 * @returns { number } 4425 * @syscap SystemCapability.ArkUI.ArkUI.Full 4426 * @atomicservice 4427 * @since arkts { '1.1':'12','1.2':'20' } 4428 * @arkts 1.1&1.2 4429 */ 4430 fp2px(value: number): number; 4431 4432 /** 4433 * Converts a value in px units to a value in fp. 4434 * @param { number } value 4435 * @returns { number } 4436 * @syscap SystemCapability.ArkUI.ArkUI.Full 4437 * @atomicservice 4438 * @since arkts { '1.1':'12','1.2':'20' } 4439 * @arkts 1.1&1.2 4440 */ 4441 px2fp(value: number): number; 4442 4443 /** 4444 * Converts a value in lpx units to a value in px. 4445 * @param { number } value 4446 * @returns { number } 4447 * @syscap SystemCapability.ArkUI.ArkUI.Full 4448 * @atomicservice 4449 * @since arkts { '1.1':'12','1.2':'20' } 4450 * @arkts 1.1&1.2 4451 */ 4452 lpx2px(value: number): number; 4453 4454 /** 4455 * Converts a value in px units to a value in lpx. 4456 * @param { number } value 4457 * @returns { number } 4458 * @syscap SystemCapability.ArkUI.ArkUI.Full 4459 * @atomicservice 4460 * @since arkts { '1.1':'12','1.2':'20' } 4461 * @arkts 1.1&1.2 4462 */ 4463 px2lpx(value: number): number; 4464 4465 /** 4466 * Obtains the LocalStorage instance shared by this stage. 4467 * 4468 * @returns { LocalStorage | undefined } 4469 * @syscap SystemCapability.ArkUI.ArkUI.Full 4470 * @stagemodelonly 4471 * @crossplatform 4472 * @atomicservice 4473 * @since arkts { '1.1':'12','1.2':'20' } 4474 * @arkts 1.1&1.2 4475 */ 4476 getSharedLocalStorage(): LocalStorage | undefined; 4477 4478 /** 4479 * Obtains context of the ability. 4480 * 4481 * @returns { Context | undefined } 4482 * @syscap SystemCapability.ArkUI.ArkUI.Full 4483 * @stagemodelonly 4484 * @crossplatform 4485 * @atomicservice 4486 * @since arkts { '1.1':'12','1.2':'20' } 4487 * @arkts 1.1&1.2 4488 */ 4489 getHostContext(): Context | undefined; 4490 4491 /** 4492 * Get the name of current window. 4493 * 4494 * @returns { string | undefined } The name of current window, or undefined if the window doesn't exist. 4495 * @syscap SystemCapability.ArkUI.ArkUI.Full 4496 * @crossplatform 4497 * @atomicservice 4498 * @since arkts { '1.1':'12','1.2':'20' } 4499 * @arkts 1.1&1.2 4500 */ 4501 getWindowName(): string | undefined; 4502 4503 /** 4504 * Get the width breakpoint of current window. 4505 * 4506 * @returns { WidthBreakpoint } The width breakpoint of current window. 4507 * @syscap SystemCapability.ArkUI.ArkUI.Full 4508 * @atomicservice 4509 * @since arkts { '1.1':'13','1.2':'20' } 4510 * @arkts 1.1&1.2 4511 */ 4512 getWindowWidthBreakpoint(): WidthBreakpoint; 4513 4514 /** 4515 * Get the height breakpoint of current window. 4516 * 4517 * @returns { HeightBreakpoint } The height breakpoint of current window. 4518 * @syscap SystemCapability.ArkUI.ArkUI.Full 4519 * @atomicservice 4520 * @since arkts { '1.1':'13','1.2':'20' } 4521 * @arkts 1.1&1.2 4522 */ 4523 getWindowHeightBreakpoint(): HeightBreakpoint; 4524 4525 /** 4526 * Creates a sheet whose content is as defined in bindSheetContent and displays the sheet. 4527 * This API uses a promise to return the result. 4528 * 4529 * @param { ComponentContent<T> } bindSheetContent - Content to display on the sheet. 4530 * @param { SheetOptions } sheetOptions - Style of the sheet. 4531 * <p>**NOTE**: 4532 * <br>1. SheetOptions.uiContext cannot be set. Its value is fixed to the UIContext object of the current instance. 4533 * <br>2.If targetId is not passed in, SheetOptions.preferType cannot be set to POPUP; if POPUP is set, it will be 4534 * replaced with CENTER. 4535 * <br>3. If targetId is not passed in, SheetOptions.mode cannot be set to EMBEDDED; the default mode is OVERLAY. 4536 * <br>4. For the default values of other attributes, @see SheetOptions. 4537 * </p> 4538 * @param { number } targetId - ID of the component to be bound. If this parameter is not set, no component is bound. 4539 * @returns { Promise<void> } Promise used to return the result. 4540 * @throws { BusinessError } 401 - Parameter error. Possible causes: 4541 * <br> 1. Mandatory parameters are left unspecified. 4542 * <br> 2. Incorrect parameters types. 4543 * <br> 3. Parameter verification failed. 4544 * @throws { BusinessError } 120001 - The bindSheetContent is incorrect. 4545 * @throws { BusinessError } 120002 - The bindSheetContent already exists. 4546 * @throws { BusinessError } 120004 - The targetId does not exist. 4547 * @throws { BusinessError } 120005 - The node of targetId is not in the component tree. 4548 * @throws { BusinessError } 120006 - The node of targetId is not a child of the page node or NavDestination node. 4549 * @syscap SystemCapability.ArkUI.ArkUI.Full 4550 * @crossplatform 4551 * @atomicservice 4552 * @since arkts { '1.1':'12','1.2':'20' } 4553 * @arkts 1.1&1.2 4554 */ 4555 openBindSheet<T extends Object>(bindSheetContent: ComponentContent<T>, sheetOptions?: SheetOptions, targetId?: number): Promise<void>; 4556 4557 /** 4558 * Update the BindSheet with sheetOptions. 4559 * 4560 * @param { ComponentContent<T> } bindSheetContent - The content of BindSheet. 4561 * @param { SheetOptions } sheetOptions - The update options of sheet. 4562 * @param { boolean } partialUpdate - If true, only the specified properties in the sheetOptions are updated, 4563 * otherwise the rest of the properties are overwritten with the default values. 4564 * Default value is false. 4565 * @returns { Promise<void> } The promise returned by the function. 4566 * @throws { BusinessError } 401 - Parameter error. Possible causes: 4567 * <br> 1. Mandatory parameters are left unspecified. 4568 * <br> 2. Incorrect parameters types. 4569 * <br> 3. Parameter verification failed. 4570 * @throws { BusinessError } 120001 - The bindSheetContent is incorrect. 4571 * @throws { BusinessError } 120003 - The bindSheetContent cannot be found. 4572 * @syscap SystemCapability.ArkUI.ArkUI.Full 4573 * @crossplatform 4574 * @atomicservice 4575 * @since arkts { '1.1':'12','1.2':'20' } 4576 * @arkts 1.1&1.2 4577 */ 4578 updateBindSheet<T extends Object>(bindSheetContent: ComponentContent<T>, sheetOptions: SheetOptions, partialUpdate?: boolean): Promise<void>; 4579 4580 /** 4581 * Closes the sheet corresponding to bindSheetContent. This API uses a promise to return the result. 4582 * <p>**NOTE**: 4583 * <br>Closing a sheet using this API will not invoke the shouldDismiss callback. 4584 * </p> 4585 * 4586 * @param { ComponentContent<T> } bindSheetContent - Content to display on the sheet. 4587 * @returns { Promise<void> } Promise used to return the result. 4588 * @throws { BusinessError } 401 - Parameter error. Possible causes: 4589 * <br> 1. Mandatory parameters are left unspecified. 4590 * <br> 2. Incorrect parameters types. 4591 * <br> 3. Parameter verification failed. 4592 * @throws { BusinessError } 120001 - The bindSheetContent is incorrect. 4593 * @throws { BusinessError } 120003 - The bindSheetContent cannot be found. 4594 * @syscap SystemCapability.ArkUI.ArkUI.Full 4595 * @crossplatform 4596 * @atomicservice 4597 * @since arkts { '1.1':'12','1.2':'20' } 4598 * @arkts 1.1&1.2 4599 */ 4600 closeBindSheet<T extends Object>(bindSheetContent: ComponentContent<T>): Promise<void>; 4601 4602 /** 4603 * Post a frame callback to run on the next frame. 4604 * 4605 * @param { FrameCallback } frameCallback - The frame callback to run on the next frame. 4606 * @syscap SystemCapability.ArkUI.ArkUI.Full 4607 * @atomicservice 4608 * @since arkts { '1.1':'12','1.2':'20' } 4609 * @arkts 1.1&1.2 4610 */ 4611 postFrameCallback(frameCallback: FrameCallback): void; 4612 4613 /** 4614 * Post a frame callback to run on the next frame after the specified delay. 4615 * 4616 * @param { FrameCallback } frameCallback - The frame callback to run on the next frame. 4617 * @param { number } delayTime - The delay time in milliseconds, 4618 * @syscap SystemCapability.ArkUI.ArkUI.Full 4619 * @atomicservice 4620 * @since arkts { '1.1':'12','1.2':'20' } 4621 * @arkts 1.1&1.2 4622 */ 4623 postDelayedFrameCallback(frameCallback: FrameCallback, delayTime: number): void; 4624 4625 /** 4626 * Require DynamicSyncScene by id. 4627 * 4628 * @param { string } id - The id of DynamicSyncScene. 4629 * @returns { Array<DynamicSyncScene>} The instance of SwiperDynamicSyncScene. 4630 * @syscap SystemCapability.ArkUI.ArkUI.Full 4631 * @atomicservice 4632 * @since arkts { '1.1':'12','1.2':'20' } 4633 * @arkts 1.1&1.2 4634 */ 4635 requireDynamicSyncScene(id: string): Array<DynamicSyncScene>; 4636 4637 /** 4638 * Clear the cache generated by using $r/$rawfile to retrieve resources. This cache is used to accelerate the process 4639 * of repeatedly loading resources. Clearing this cache may slow down the loading speed of resources during page overload. 4640 * 4641 * @throws { BusinessError } 202 - The caller is not a system application. 4642 * @syscap SystemCapability.ArkUI.ArkUI.Full 4643 * @systemapi 4644 * @atomicservice 4645 * @since 12 4646 */ 4647 /** 4648 * Clear the cache generated by using $r/$rawfile to retrieve resources. This cache is used to accelerate the process 4649 * of repeatedly loading resources. Clearing this cache may slow down the loading speed of resources during page overload. 4650 * 4651 * @throws { BusinessError } 202 - The caller is not a system application. 4652 * @syscap SystemCapability.ArkUI.ArkUI.Full 4653 * @systemapi 4654 * @since arkts { '1.1':'13','1.2':'20' } 4655 * @arkts 1.1&1.2 4656 */ 4657 clearResourceCache(): void; 4658 4659 /** 4660 * Checks whether current font scale follows the system. 4661 * 4662 * @returns { boolean } Returns true if current font scale follows the system; returns false otherwise. 4663 * @syscap SystemCapability.ArkUI.ArkUI.Full 4664 * @crossplatform 4665 * @atomicservice 4666 * @since arkts { '1.1':'13','1.2':'20' } 4667 * @arkts 1.1&1.2 4668 */ 4669 isFollowingSystemFontScale(): boolean; 4670 4671 /** 4672 * Get the max font scale. 4673 * 4674 * @returns { number } The max font scale. 4675 * @syscap SystemCapability.ArkUI.ArkUI.Full 4676 * @crossplatform 4677 * @atomicservice 4678 * @since arkts { '1.1':'13','1.2':'20' } 4679 * @arkts 1.1&1.2 4680 */ 4681 getMaxFontScale(): number; 4682 4683 /** 4684 * Bind tabs to scrollable container component to automatically hide tab bar. 4685 * 4686 * @param { TabsController } tabsController - The controller of the tabs. 4687 * @param { Scroller } scroller - The controller of the scrollable container component. 4688 * @syscap SystemCapability.ArkUI.ArkUI.Full 4689 * @crossplatform 4690 * @atomicservice 4691 * @since arkts { '1.1':'13','1.2':'20' } 4692 * @arkts 1.1&1.2 4693 */ 4694 bindTabsToScrollable(tabsController: TabsController, scroller: Scroller): void; 4695 4696 /** 4697 * Unbind tabs from scrollable container component. 4698 * 4699 * @param { TabsController } tabsController - The controller of the tabs. 4700 * @param { Scroller } scroller - The controller of the scrollable container component. 4701 * @syscap SystemCapability.ArkUI.ArkUI.Full 4702 * @crossplatform 4703 * @atomicservice 4704 * @since arkts { '1.1':'13','1.2':'20' } 4705 * @arkts 1.1&1.2 4706 */ 4707 unbindTabsFromScrollable(tabsController: TabsController, scroller: Scroller): void; 4708 4709 /** 4710 * Bind tabs to nested scrollable container components to automatically hide tab bar. 4711 * 4712 * @param { TabsController } tabsController - The controller of the tabs. 4713 * @param { Scroller } parentScroller - The controller of the parent scrollable container component. 4714 * @param { Scroller } childScroller - The controller of the child scrollable container component. 4715 * @syscap SystemCapability.ArkUI.ArkUI.Full 4716 * @crossplatform 4717 * @atomicservice 4718 * @since arkts { '1.1':'13','1.2':'20' } 4719 * @arkts 1.1&1.2 4720 */ 4721 bindTabsToNestedScrollable(tabsController: TabsController, parentScroller: Scroller, childScroller: Scroller): void; 4722 4723 /** 4724 * Unbind tabs from nested scrollable container components. 4725 * 4726 * @param { TabsController } tabsController - The controller of the tabs. 4727 * @param { Scroller } parentScroller - The controller of the parent scrollable container component. 4728 * @param { Scroller } childScroller - The controller of the child scrollable container component. 4729 * @syscap SystemCapability.ArkUI.ArkUI.Full 4730 * @crossplatform 4731 * @atomicservice 4732 * @since arkts { '1.1':'13','1.2':'20' } 4733 * @arkts 1.1&1.2 4734 */ 4735 unbindTabsFromNestedScrollable(tabsController: TabsController, parentScroller: Scroller, childScroller: Scroller): void; 4736 4737 /** 4738 * whether to enable or disable swipe to back event. 4739 * 4740 * @param { Optional<boolean> } enabled - enable or disable swipe to back event. 4741 * @syscap SystemCapability.ArkUI.ArkUI.Circle 4742 * @atomicservice 4743 * @since arkts { '1.1':'18','1.2':'20' } 4744 * @arkts 1.1&1.2 4745 */ 4746 enableSwipeBack(enabled: Optional<boolean>): void; 4747 4748 /** 4749 * Sets the component freezing flag based on the component id to prevent the 4750 * UI component from marking and updating dirty areas. 4751 * @param { string } id - Id of the frame node. 4752 * @param { boolean } isFrozen - whether the component is frozen. 4753 * @throws { BusinessError } 202 - The caller is not a system application. 4754 * @syscap SystemCapability.ArkUI.ArkUI.Full 4755 * @systemapi 4756 * @since arkts { '1.1':'18','1.2':'20' } 4757 * @arkts 1.1&1.2 4758 */ 4759 freezeUINode(id: string, isFrozen: boolean): void; 4760 4761 /** 4762 * Sets the component freezing flag based on the component uniqueId to prevent the 4763 * UI component from marking and updating dirty areas. 4764 * @param { number } uniqueId - Unique Id of the frame node. 4765 * @param { boolean } isFrozen - whether the component is frozen. 4766 * @throws { BusinessError } 202 - The caller is not a system application. 4767 * @syscap SystemCapability.ArkUI.ArkUI.Full 4768 * @systemapi 4769 * @since arkts { '1.1':'18','1.2':'20' } 4770 * @arkts 1.1&1.2 4771 */ 4772 freezeUINode(uniqueId: number, isFrozen: boolean): void; 4773 4774 /** 4775 * Get object text menu controller. 4776 * 4777 * @returns { TextMenuController } object text menu controller. 4778 * @syscap SystemCapability.ArkUI.ArkUI.Full 4779 * @crossplatform 4780 * @atomicservice 4781 * @since arkts { '1.1':'16','1.2':'20' } 4782 * @arkts 1.1&1.2 4783 */ 4784 getTextMenuController(): TextMenuController; 4785 4786 /** 4787 * Set the keyboard appearance config for this input component before attach InputMethod. 4788 * 4789 * @param { number } uniqueId - The unique id of the input component. 4790 * @param { KeyboardAppearanceConfig } config - The config of keyboard. 4791 * @throws { BusinessError } 202 - The caller is not a system application. 4792 * @syscap SystemCapability.ArkUI.ArkUI.Full 4793 * @systemapi 4794 * @since 20 4795 */ 4796 setKeyboardAppearanceConfig(uniqueId: number, config: KeyboardAppearanceConfig): void; 4797 4798 /** 4799 * Create a UI instance singleton without window and get its UIContext object. 4800 * 4801 * @param { common.UIAbilityContext | common.ExtensionContext } context - UIAbilityContext or ExtensionContext. 4802 * @returns { UIContext | undefined } object UIContext, or undefined when failed. 4803 * @throws { BusinessError } 401 - Parameter error. Possible causes: 4804 * <br> 1. The number of parameters is incorrect. 4805 * <br> 2. Invalid parameter type of context. 4806 * @throws { BusinessError } 100001 - Internal error. 4807 * @static 4808 * @syscap SystemCapability.ArkUI.ArkUI.Full 4809 * @atomicservice 4810 * @since arkts { '1.1':'17','1.2':'20' } 4811 * @arkts 1.1&1.2 4812 */ 4813 static createUIContextWithoutWindow(context: common.UIAbilityContext | common.ExtensionContext) : UIContext | undefined; 4814 4815 /** 4816 * Destroy the UI instance singleton without window. 4817 * 4818 * @static 4819 * @syscap SystemCapability.ArkUI.ArkUI.Full 4820 * @atomicservice 4821 * @since arkts { '1.1':'17','1.2':'20' } 4822 * @arkts 1.1&1.2 4823 */ 4824 static destroyUIContextWithoutWindow(): void; 4825} 4826 4827/** 4828 * Enum of KeyBoardAvoidMethodType 4829 * 4830 * @enum { number } KeyBoardAvoidMethodType 4831 * @syscap SystemCapability.ArkUI.ArkUI.Full 4832 * @crossplatform 4833 * @atomicservice 4834 * @since arkts { '1.1':'11','1.2':'20' } 4835 * @arkts 1.1&1.2 4836 */ 4837 4838export const enum KeyboardAvoidMode { 4839 /** 4840 * Offset Type, the layout moves up. 4841 * @syscap SystemCapability.ArkUI.ArkUI.Full 4842 * @crossplatform 4843 * @atomicservice 4844 * @since arkts { '1.1':'11','1.2':'20' } 4845 * @arkts 1.1&1.2 4846 */ 4847 OFFSET = 0, 4848 4849 /** 4850 * Resize Type, the layout is resized. 4851 * @syscap SystemCapability.ArkUI.ArkUI.Full 4852 * @crossplatform 4853 * @atomicservice 4854 * @since arkts { '1.1':'11','1.2':'20' } 4855 * @arkts 1.1&1.2 4856 */ 4857 RESIZE = 1, 4858 4859 /** 4860 * Offset Type, the layout moves up, and this adjustment also occurs if the caret position in the text box changes. 4861 * @syscap SystemCapability.ArkUI.ArkUI.Full 4862 * @crossplatform 4863 * @atomicservice 4864 * @since arkts { '1.1':'14','1.2':'20' } 4865 * @arkts 1.1&1.2 4866 */ 4867 OFFSET_WITH_CARET = 2, 4868 4869 /** 4870 * Resize Type, the layout moves up, and this adjustment also occurs if the caret position in the text box changes. 4871 * @syscap SystemCapability.ArkUI.ArkUI.Full 4872 * @crossplatform 4873 * @atomicservice 4874 * @since arkts { '1.1':'14','1.2':'20' } 4875 * @arkts 1.1&1.2 4876 */ 4877 RESIZE_WITH_CARET = 3, 4878 4879 /** 4880 * None Type, the layout is not adjusted to avoid the keyboard. 4881 * @syscap SystemCapability.ArkUI.ArkUI.Full 4882 * @crossplatform 4883 * @atomicservice 4884 * @since arkts { '1.1':'14','1.2':'20' } 4885 * @arkts 1.1&1.2 4886 */ 4887 NONE = 4, 4888} 4889 4890/** 4891 * Enum of SwiperDynamicSyncSceneType 4892 * 4893 * @enum { number } SwiperDynamicSyncSceneType 4894 * @syscap SystemCapability.ArkUI.ArkUI.Full 4895 * @atomicservice 4896 * @since arkts { '1.1':'12','1.2':'20' } 4897 * @arkts 1.1&1.2 4898 */ 4899export const enum SwiperDynamicSyncSceneType { 4900 /** 4901 * Scene type is GESTURE. 4902 * 4903 * @syscap SystemCapability.ArkUI.ArkUI.Full 4904 * @atomicservice 4905 * @since arkts { '1.1':'12','1.2':'20' } 4906 * @arkts 1.1&1.2 4907 */ 4908 GESTURE = 0, 4909 4910 /** 4911 * Scene type is ANIMATION. 4912 * 4913 * @syscap SystemCapability.ArkUI.ArkUI.Full 4914 * @atomicservice 4915 * @since arkts { '1.1':'12','1.2':'20' } 4916 * @arkts 1.1&1.2 4917 */ 4918 ANIMATION = 1 4919} 4920 4921/** 4922 * Enum of scene type for Marquee 4923 * 4924 * @enum { number } MarqueeDynamicSyncSceneType 4925 * @syscap SystemCapability.ArkUI.ArkUI.Full 4926 * @atomicservice 4927 * @since arkts { '1.1':'14','1.2':'20' } 4928 * @arkts 1.1&1.2 4929 */ 4930export const enum MarqueeDynamicSyncSceneType { 4931 /** 4932 * Scene type is ANIMATION. 4933 * 4934 * @syscap SystemCapability.ArkUI.ArkUI.Full 4935 * @atomicservice 4936 * @since arkts { '1.1':'14','1.2':'20' } 4937 * @arkts 1.1&1.2 4938 */ 4939 ANIMATION = 1 4940} 4941 4942/** 4943 * class TextMenuController 4944 * 4945 * @syscap SystemCapability.ArkUI.ArkUI.Full 4946 * @crossplatform 4947 * @atomicservice 4948 * @since arkts { '1.1':'16','1.2':'20' } 4949 * @arkts 1.1&1.2 4950 */ 4951export declare class TextMenuController { 4952 /** 4953 * Set text menu options. 4954 * 4955 * @param { TextMenuOptions } options - the options of the text menu. 4956 * @syscap SystemCapability.ArkUI.ArkUI.Full 4957 * @crossplatform 4958 * @atomicservice 4959 * @since arkts { '1.1':'16','1.2':'20' } 4960 * @arkts 1.1&1.2 4961 */ 4962 setMenuOptions(options: TextMenuOptions): void; 4963 4964 /** 4965 * Disable all system service menus, such as translation and ai writer. 4966 * True means disable, false means enable. 4967 * 4968 * @syscap SystemCapability.ArkUI.ArkUI.Full 4969 * @atomicservice 4970 * @since 20 4971 */ 4972 static disableSystemServiceMenuItems(disable: boolean): void; 4973 4974 /** 4975 * Disable menu action by action id. 4976 * 4977 * @syscap SystemCapability.ArkUI.ArkUI.Full 4978 * @atomicservice 4979 * @since 20 4980 */ 4981 static disableMenuItems(items: Array<TextMenuItemId>): void; 4982} 4983 4984/** 4985 * An enumeration type that identifies the current node's rendering state. The UI components used in 4986 * the application are automatically managed by the system and controlled for participation in graphical 4987 * rendering by either mounting them onto the render tree or removing them from it. Only nodes that 4988 * participate in graphical rendering have the potential to be displayed. However, participating in 4989 * rendering does not equal to the node's visibility, as there may be many occlusion scenarios in the 4990 * actual implementation of the application. Nevertheless, if a node does not participate in rendering, 4991 * it will definitely not be visible. 4992 * 4993 * @enum { number } NodeRenderState 4994 * @syscap SystemCapability.ArkUI.ArkUI.Full 4995 * @crossplatform 4996 * @atomicservice 4997 * @since 20 4998 */ 4999export const enum NodeRenderState { 5000 /** 5001 * The node has been mount on to the render tree and will soon be rendered. Generally, after the next frame, 5002 * the user will be able to see this node. However, this is not always the case, as in reality, the node may be 5003 * occluded by other nodes, meaning it is rendered but not be visible. 5004 * When registering a listener for the render state using the UIObserver interface, the system will immediately 5005 * trigger the callback once, and the state notified at this time typically represents the current state. 5006 * 5007 * @syscap SystemCapability.ArkUI.ArkUI.Full 5008 * @crossplatform 5009 * @atomicservice 5010 * @since 20 5011 */ 5012 ABOUT_TO_RENDER_IN = 0, 5013 5014 /** 5015 * The node has been removed from the render tree and will no longer be rendered shortly. Generally speaking, 5016 * after the next frame, the user will no longer be able to see this node. 5017 * When registering a listener for the render state using the UIObserver interface, the system will immediately 5018 * trigger the callback once, and the state notified at this time typically represents the current state. 5019 * 5020 * @syscap SystemCapability.ArkUI.ArkUI.Full 5021 * @crossplatform 5022 * @atomicservice 5023 * @since 20 5024 */ 5025 ABOUT_TO_RENDER_OUT = 1 5026} 5027 5028/** 5029 * This is an enumeration type representing the gesture callback phases to be triggered, corresponding to 5030 * the action callbacks defined in gesture.d.ts. Therefore, not all gesture types have all the following 5031 * phase definitions. For example, SwipeGesture only has one callback named onAction, so it also only has 5032 * one enumeration type, which is WILL_START. 5033 * 5034 * @enum { number } GestureActionPhase 5035 * @syscap SystemCapability.ArkUI.ArkUI.Full 5036 * @crossplatform 5037 * @atomicservice 5038 * @since 20 5039 */ 5040export const enum GestureActionPhase { 5041 /** 5042 * The gesture has been successfully recognized by the system, and the action-start/action callback will be 5043 * executed immediately. 5044 * 5045 * @syscap SystemCapability.ArkUI.ArkUI.Full 5046 * @crossplatform 5047 * @atomicservice 5048 * @since 20 5049 */ 5050 WILL_START = 0, 5051 /** 5052 * This indicates the gesture has been determined to be an end, which usually happens when the user lifts their 5053 * fingers, ending the entire interaction, and the action-end callback will be executed immediately. 5054 * 5055 * @syscap SystemCapability.ArkUI.ArkUI.Full 5056 * @crossplatform 5057 * @atomicservice 5058 * @since 20 5059 */ 5060 WILL_END = 1 5061} 5062 5063/** 5064 * This is an enumeration type indicating what kind of gesture you want to monitor for. 5065 * 5066 * @enum { number } GestureListenerType 5067 * @syscap SystemCapability.ArkUI.ArkUI.Full 5068 * @crossplatform 5069 * @atomicservice 5070 * @since 20 5071 */ 5072 export const enum GestureListenerType { 5073 /** 5074 * The tap gesture. 5075 * 5076 * @syscap SystemCapability.ArkUI.ArkUI.Full 5077 * @crossplatform 5078 * @atomicservice 5079 * @since 20 5080 */ 5081 TAP = 0, 5082 /** 5083 * The long press gesture. 5084 * 5085 * @syscap SystemCapability.ArkUI.ArkUI.Full 5086 * @crossplatform 5087 * @atomicservice 5088 * @since 20 5089 */ 5090 LONG_PRESS = 1, 5091 /** 5092 * The pan gesture. 5093 * 5094 * @syscap SystemCapability.ArkUI.ArkUI.Full 5095 * @crossplatform 5096 * @atomicservice 5097 * @since 20 5098 */ 5099 PAN = 2, 5100 /** 5101 * The pinch gesture. 5102 * 5103 * @syscap SystemCapability.ArkUI.ArkUI.Full 5104 * @crossplatform 5105 * @atomicservice 5106 * @since 20 5107 */ 5108 PINCH = 3, 5109 /** 5110 * The swipe gesture. 5111 * 5112 * @syscap SystemCapability.ArkUI.ArkUI.Full 5113 * @crossplatform 5114 * @atomicservice 5115 * @since 20 5116 */ 5117 SWIPE = 4, 5118 /** 5119 * The rotation gesture. 5120 * 5121 * @syscap SystemCapability.ArkUI.ArkUI.Full 5122 * @crossplatform 5123 * @atomicservice 5124 * @since 20 5125 */ 5126 ROTATION = 5 5127} 5128