harmony 鸿蒙Interface (WindowStage)

2025-06-12
浏览 (4)

Interface (WindowStage)

NOTE

The initial APIs of this module are supported since API version 6. Newly added APIs will be marked with a superscript to indicate their earliest API version.

WindowStage⁹⁺

Implements a window manager, which manages each basic window unit, that is, Window instance.

Before calling any of the following APIs, you must use onWindowStageCreate() to create a WindowStage instance.

getMainWindow⁹⁺

getMainWindow(callback: AsyncCallback<Window>): void

Obtains the main window of this window stage. This API uses an asynchronous callback to return the result.

Model restriction: This API can be used only in the stage model.

System capability: SystemCapability.WindowManager.WindowManager.Core

Atomic service API: This API can be used in atomic services since API version 11.

Parameters

Name	Type	Mandatory	Description
callback	AsyncCallback<Window>	Yes	Callback used to return the main window.

Error codes

For details about the error codes, see Window Error Codes.

ID	Error Message
1300002	This window state is abnormal.
1300005	This window stage is abnormal.

Example

// EntryAbility.ets
import { UIAbility } from '@kit.AbilityKit';
import { BusinessError } from '@kit.BasicServicesKit';

export default class EntryAbility extends UIAbility {
  // ...

  onWindowStageCreate(windowStage: window.WindowStage) {
    console.info('onWindowStageCreate');
    let windowClass: window.Window|undefined = undefined;
    windowStage.getMainWindow((err: BusinessError, data) => {
      const errCode: number = err.code;
      if (errCode) {
        console.error(`Failed to obtain the main window. Cause code: ${err.code}, message: ${err.message}`);
        return;
      }
      windowClass = data;
      console.info('Succeeded in obtaining the main window. Data: ' + JSON.stringify(data));
    });
  }
};

getMainWindow⁹⁺

getMainWindow(): Promise<Window>

Obtains the main window of this window stage. This API uses a promise to return the result.

Model restriction: This API can be used only in the stage model.

System capability: SystemCapability.WindowManager.WindowManager.Core

Atomic service API: This API can be used in atomic services since API version 11.

Return value

Type	Description
Promise<Window>	Promise used to return the main window.

Error codes

For details about the error codes, see Window Error Codes.

ID	Error Message
1300002	This window state is abnormal.
1300005	This window stage is abnormal.

Example

// EntryAbility.ets
import { UIAbility } from '@kit.AbilityKit';
import { BusinessError } from '@kit.BasicServicesKit';

export default class EntryAbility extends UIAbility {
  // ...

  onWindowStageCreate(windowStage: window.WindowStage) {
    console.info('onWindowStageCreate');
    let windowClass: window.Window|undefined = undefined;
    let promise = windowStage.getMainWindow();
    promise.then((data) => {
      windowClass = data;
      console.info('Succeeded in obtaining the main window. Data: ' + JSON.stringify(data));
    }).catch((err: BusinessError) => {
      console.error(`Failed to obtain the main window. Cause code: ${err.code}, message: ${err.message}`);
    });
  }
};

getMainWindowSync⁹⁺

getMainWindowSync(): Window

Obtains the main window of this window stage.

Model restriction: This API can be used only in the stage model.

System capability: SystemCapability.WindowManager.WindowManager.Core

Atomic service API: This API can be used in atomic services since API version 11.

Return value

Type	Description
Window	Main window.

Error codes

For details about the error codes, see Window Error Codes.

ID	Error Message
1300002	This window state is abnormal.
1300005	This window stage is abnormal.

Example

// EntryAbility.ets
import { UIAbility } from '@kit.AbilityKit';

export default class EntryAbility extends UIAbility {
  // ...

  onWindowStageCreate(windowStage: window.WindowStage) {
    console.info('onWindowStageCreate');
    try {
      let windowClass = windowStage.getMainWindowSync();
    } catch (exception) {
      console.error(`Failed to obtain the main window. Cause code: ${exception.code}, message: ${exception.message}`);
    }
  }
};

createSubWindow⁹⁺

createSubWindow(name: string, callback: AsyncCallback<Window>): void

Creates a child window for this window stage. This API uses an asynchronous callback to return the result.

Model restriction: This API can be used only in the stage model.

System capability: SystemCapability.WindowManager.WindowManager.Core

Atomic service API: This API can be used in atomic services since API version 11.

Parameters

Name	Type	Mandatory	Description
name	string	Yes	Name of the child window.
callback	AsyncCallback<Window>	Yes	Callback used to return the child window.

Error codes

For details about the error codes, see Universal Error Codes and Window Error Codes.

ID	Error Message
401	Parameter error. Possible cause: Incorrect parameter types.
1300002	This window state is abnormal.

Example

// EntryAbility.ets
import { UIAbility } from '@kit.AbilityKit';
import { BusinessError } from '@kit.BasicServicesKit';

export default class EntryAbility extends UIAbility {
  // ...

  onWindowStageCreate(windowStage: window.WindowStage) {
    console.info('onWindowStageCreate');
    let windowClass: window.Window|undefined = undefined;
    try {
      windowStage.createSubWindow('mySubWindow', (err: BusinessError, data) => {
        const errCode: number = err.code;
        if (errCode) {
          console.error(`Failed to create the subwindow. Cause code: ${err.code}, message: ${err.message}`);
          return;
        }
        windowClass = data;
        console.info('Succeeded in creating the subwindow. Data: ' + JSON.stringify(data));
        if (!windowClass) {
          console.info('Failed to load the content. Cause: windowClass is null');
        }
        else {
          (windowClass as window.Window).resize(500, 1000);
        }
      });
    } catch (exception) {
      console.error(`Failed to create the subwindow. Cause code: ${exception.code}, message: ${exception.message}`);
    }
  }
};

createSubWindow⁹⁺

createSubWindow(name: string): Promise<Window>

Creates a child window for this window stage. This API uses a promise to return the result.

Model restriction: This API can be used only in the stage model.

System capability: SystemCapability.WindowManager.WindowManager.Core

Atomic service API: This API can be used in atomic services since API version 11.

Parameters

Name	Type	Mandatory	Description
name	string	Yes	Name of the child window.

Return value

Type	Description
Promise<Window>	Promise used to return the child window.

Error codes

For details about the error codes, see Universal Error Codes and Window Error Codes.

ID	Error Message
401	Parameter error. Possible cause: Incorrect parameter types.
1300002	This window state is abnormal.

Example

// EntryAbility.ets
import { UIAbility } from '@kit.AbilityKit';
import { BusinessError } from '@kit.BasicServicesKit';

export default class EntryAbility extends UIAbility {
  // ...

  onWindowStageCreate(windowStage: window.WindowStage) {
    console.info('onWindowStageCreate');
    let windowClass: window.Window|undefined = undefined;
    try {
      let promise = windowStage.createSubWindow('mySubWindow');
      promise.then((data) => {
        windowClass = data;
        console.info('Succeeded in creating the subwindow. Data: ' + JSON.stringify(data));
      }).catch((err: BusinessError) => {
        console.error(`Failed to create the subwindow. Cause code: ${err.code}, message: ${err.message}`);
      });
    } catch (exception) {
      console.error(`Failed to create the subwindow. Cause code: ${exception.code}, message: ${exception.message}`);
    }
  }
};

createSubWindowWithOptions¹¹⁺

createSubWindowWithOptions(name: string, options: SubWindowOptions): Promise<Window>

Creates a child window for this window stage. This API uses a promise to return the result.

Model restriction: This API can be used only in the stage model.

Atomic service API: This API can be used in atomic services since API version 12.

System capability: SystemCapability.Window.SessionManager

Parameters

Name	Type	Mandatory	Description
name	string	Yes	Name of the child window.
options	SubWindowOptions	Yes	Parameters used for creating the child window.

Return value

Type	Description
Promise<Window>	Promise used to return the child window created.

Error codes

For details about the error codes, see Universal Error Codes and Window Error Codes.

ID	Error Message
401	Parameter error. Possible cause: Incorrect parameter types.
801	Capability not supported. Failed to call the API due to limited device capabilities.
1300002	This window state is abnormal.
1300005	This window stage is abnormal.

Example

// EntryAbility.ets
import { UIAbility } from '@kit.AbilityKit';
import { BusinessError } from '@kit.BasicServicesKit';

export default class EntryAbility extends UIAbility {
  // ...

  onWindowStageCreate(windowStage: window.WindowStage) {
    console.info('onWindowStageCreate');
    let windowClass: window.Window|undefined = undefined;
    try {
      let options : window.SubWindowOptions = {
        title: 'title',
        decorEnabled: true
      };
      let promise = windowStage.createSubWindowWithOptions('mySubWindow', options);
      promise.then((data) => {
        windowClass = data;
        console.info('Succeeded in creating the subwindow. Data: ' + JSON.stringify(data));
      }).catch((err: BusinessError) => {
        console.error(`Failed to create the subwindow. Cause code: ${err.code}, message: ${err.message}`);
      });
    } catch (exception) {
      console.error(`Failed to create the subwindow. Cause code: ${exception.code}, message: ${exception.message}`);
    }
  }
};

getSubWindow⁹⁺

getSubWindow(callback: AsyncCallback<Array<Window>>): void

Obtains all the child windows of this window stage. This API uses an asynchronous callback to return the result.

Model restriction: This API can be used only in the stage model.

System capability: SystemCapability.WindowManager.WindowManager.Core

Atomic service API: This API can be used in atomic services since API version 11.

Parameters

Name	Type	Mandatory	Description
callback	AsyncCallback<Array<Window>>	Yes	Callback used to return all the child windows.

Error codes

For details about the error codes, see Window Error Codes.

ID	Error Message
1300002	This window state is abnormal.

Example

// EntryAbility.ets
import { UIAbility } from '@kit.AbilityKit';
import { BusinessError } from '@kit.BasicServicesKit';

export default class EntryAbility extends UIAbility {
  // ...

  onWindowStageCreate(windowStage: window.WindowStage) {
    console.info('onWindowStageCreate');
    let windowClass: window.Window[] = [];
    windowStage.getSubWindow((err: BusinessError, data) => {
      const errCode: number = err.code;
      if (errCode) {
        console.error(`Failed to obtain the subwindow. Cause code: ${err.code}, message: ${err.message}`);
        return;
      }
      windowClass = data;
      console.info('Succeeded in obtaining the subwindow. Data: ' + JSON.stringify(data));
    });
  }
};

getSubWindow⁹⁺

getSubWindow(): Promise<Array<Window>>

Obtains all the child windows of this window stage. This API uses a promise to return the result.

Model restriction: This API can be used only in the stage model.

System capability: SystemCapability.WindowManager.WindowManager.Core

Atomic service API: This API can be used in atomic services since API version 11.

Return value

Type	Description
Promise<Array<Window>>	Promise used to return all the child windows.

Error codes

For details about the error codes, see Window Error Codes.

ID	Error Message
1300002	This window state is abnormal.

Example

// EntryAbility.ets
import { UIAbility } from '@kit.AbilityKit';
import { BusinessError } from '@kit.BasicServicesKit';

export default class EntryAbility extends UIAbility {
  // ...

  onWindowStageCreate(windowStage: window.WindowStage) {
    console.info('onWindowStageCreate');
    let windowClass: window.Window[] = [];
    let promise = windowStage.getSubWindow();
    promise.then((data) => {
      windowClass = data;
      console.info('Succeeded in obtaining the subwindow. Data: ' + JSON.stringify(data));
    }).catch((err: BusinessError) => {
      console.error(`Failed to obtain the subwindow. Cause code: ${err.code}, message: ${err.message}`);
    });
  }
};

loadContent⁹⁺

loadContent(path: string, storage: LocalStorage, callback: AsyncCallback<void>): void

Loads the content of a page, with its path in the current project specified, to the main window of this window stage, and transfers the state attribute to the page through a local storage. This API uses an asynchronous callback to return the result. You are advised to call this API during UIAbility startup. If called repeatedly, this API will destroy the existing page content (UIContent) before loading the new content. Exercise caution when using it.

Model restriction: This API can be used only in the stage model.

System capability: SystemCapability.WindowManager.WindowManager.Core

Atomic service API: This API can be used in atomic services since API version 11.

Parameters

Name	Type	Mandatory	Description
path	string	Yes	Path of the page from which the content will be loaded. The path is configured in the main_pages.json file of the project.
storage	LocalStorage	Yes	Page-level UI state storage unit, which is used to transfer the state attribute for the page.
callback	AsyncCallback<void>	Yes	Callback used to return the result.

Error codes

For details about the error codes, see Universal Error Codes and Window Error Codes.

ID	Error Message
401	Parameter error. Possible cause: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types; 3. Invalid path parameter.
1300002	This window state is abnormal.

Example

// EntryAbility.ets
import { UIAbility } from '@kit.AbilityKit';
import { BusinessError } from '@kit.BasicServicesKit';

export default class EntryAbility extends UIAbility {
  // ...

  storage: LocalStorage = new LocalStorage();

  onWindowStageCreate(windowStage: window.WindowStage) {
    this.storage.setOrCreate('storageSimpleProp', 121);
    console.info('onWindowStageCreate');
    try {
      windowStage.loadContent('pages/page2', this.storage, (err: BusinessError) => {
        const errCode: number = err.code;
        if (errCode) {
          console.error(`Failed to load the content. Cause code: ${err.code}, message: ${err.message}`);
          return;
        }
        console.info('Succeeded in loading the content.');
      });
    } catch (exception) {
      console.error(`Failed to load the content. Cause code: ${exception.code}, message: ${exception.message}`);
    }
  }
};

loadContent⁹⁺

loadContent(path: string, storage?: LocalStorage): Promise<void>

Loads the content of a page, with its path in the current project specified, to the main window of this window stage, and transfers the state attribute to the page through a local storage. This API uses a promise to return the result. You are advised to call this API during UIAbility startup. If called repeatedly, this API will destroy the existing page content (UIContent) before loading the new content. Exercise caution when using it.

Model restriction: This API can be used only in the stage model.

System capability: SystemCapability.WindowManager.WindowManager.Core

Atomic service API: This API can be used in atomic services since API version 11.

Parameters

Name	Type	Mandatory	Description
path	string	Yes	Path of the page from which the content will be loaded. The path is configured in the main_pages.json file of the project.
storage	LocalStorage	No	Page-level UI state storage unit, which is used to transfer the state attribute for the page.

Return value

Type	Description
Promise<void>	Promise that returns no value.

Error codes

For details about the error codes, see Universal Error Codes and Window Error Codes.

ID	Error Message
401	Parameter error. Possible cause: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types; 3. Invalid path parameter.
1300002	This window state is abnormal.

Example

// EntryAbility.ets
import { UIAbility } from '@kit.AbilityKit';
import { BusinessError } from '@kit.BasicServicesKit';

export default class EntryAbility extends UIAbility {
  // ...

  storage: LocalStorage = new LocalStorage();

  onWindowStageCreate(windowStage: window.WindowStage) {
    this.storage.setOrCreate('storageSimpleProp', 121);
    console.info('onWindowStageCreate');
    try {
      let promise = windowStage.loadContent('pages/page2', this.storage);
      promise.then(() => {
        console.info('Succeeded in loading the content.');
      }).catch((err: BusinessError) => {
        console.error(`Failed to load the content. Cause code: ${err.code}, message: ${err.message}`);
      });
    } catch (exception) {
      console.error(`Failed to load the content. Cause code: ${exception.code}, message: ${exception.message}`);
    }
    ;
  }
};

loadContent⁹⁺

loadContent(path: string, callback: AsyncCallback<void>): void

Loads the content of a page, with its path in the current project specified, to the main window of this window stage. This API uses an asynchronous callback to return the result. You are advised to call this API during UIAbility startup. If called repeatedly, this API will destroy the existing page content (UIContent) before loading the new content. Exercise caution when using it.

Model restriction: This API can be used only in the stage model.

System capability: SystemCapability.WindowManager.WindowManager.Core

Atomic service API: This API can be used in atomic services since API version 11.

Parameters

Name	Type	Mandatory	Description
path	string	Yes	Path of the page from which the content will be loaded. The path is configured in the main_pages.json file of the project.
callback	AsyncCallback<void>	Yes	Callback used to return the result.

Error codes

For details about the error codes, see Universal Error Codes and Window Error Codes.

ID	Error Message
401	Parameter error. Possible cause: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types; 3. Invalid path parameter.
1300002	This window state is abnormal.

Example

// EntryAbility.ets
import { UIAbility } from '@kit.AbilityKit';
import { BusinessError } from '@kit.BasicServicesKit';

export default class EntryAbility extends UIAbility {
  // ...

  onWindowStageCreate(windowStage: window.WindowStage) {
    console.info('onWindowStageCreate');
    try {
      windowStage.loadContent('pages/page2', (err: BusinessError) => {
        const errCode: number = err.code;
        if (errCode) {
          console.error(`Failed to load the content. Cause code: ${err.code}, message: ${err.message}`);
          return;
        }
        console.info('Succeeded in loading the content.');
      });
    } catch (exception) {
      console.error(`Failed to load the content. Cause code: ${exception.code}, message: ${exception.message}`);
    }
  }
};

loadContentByName¹¹⁺

loadContentByName(name: string, storage: LocalStorage, callback: AsyncCallback<void>): void

Loads the content of a named route page to this window stage, and transfers the state attribute to the page through a local storage. This API uses an asynchronous callback to return the result. You are advised to call this API during UIAbility startup. If called repeatedly, this API will destroy the existing page content (UIContent) before loading the new content. Exercise caution when using it.

Model restriction: This API can be used only in the stage model.

System capability: SystemCapability.WindowManager.WindowManager.Core

Atomic service API: This API can be used in atomic services since API version 11.

Parameters

Name	Type	Mandatory	Description
name	string	Yes	Name of the named route page.
storage	LocalStorage	Yes	Page-level UI state storage unit, which is used to transfer the state attribute for the page.
callback	AsyncCallback<void>	Yes	Callback used to return the result.

Error codes

For details about the error codes, see Universal Error Codes and Window Error Codes.

ID	Error Message
401	Parameter error. Possible cause: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types.
1300002	This window state is abnormal.

Example

// EntryAbility.ets
import { UIAbility } from '@kit.AbilityKit';
import { BusinessError } from '@kit.BasicServicesKit';
import * as Index from '../pages/Index'; // Import the named route page.

export default class EntryAbility extends UIAbility {
  // ...

  storage: LocalStorage = new LocalStorage();

  onWindowStageCreate(windowStage: window.WindowStage) {
    console.info('onWindowStageCreate');
    this.storage.setOrCreate('storageSimpleProp', 121);
    try {
      windowStage.loadContentByName(Index.entryName, this.storage, (err: BusinessError) => {
        const errCode: number = err.code;
        if (errCode) {
          console.error(`Failed to load the content. Cause code: ${err.code}, message: ${err.message}`);
          return;
        }
        console.info('Succeeded in loading the content.');
      });
    } catch (exception) {
      console.error(`Failed to load the content. Cause code: ${exception.code}, message: ${exception.message}`);
    }
  }
};

// ets/pages/Index.ets
export const entryName : string = 'Index';
@Entry({routeName: entryName, useSharedStorage: true})
@Component
export struct Index {
  @State message: string = 'Hello World'
  @LocalStorageLink('storageSimpleProp') storageSimpleProp: number = 1;
  build() {
    Row() {
      Column() {
        Text(this.message)
          .fontSize(50)
          .fontWeight(FontWeight.Bold)
      }
      .width('100%')
    }
    .height('100%')
  }
}

loadContentByName¹¹⁺

loadContentByName(name: string, callback: AsyncCallback<void>): void

Loads the content of a named route page to this window stage. This API uses an asynchronous callback to return the result. You are advised to call this API during UIAbility startup. If called repeatedly, this API will destroy the existing page content (UIContent) before loading the new content. Exercise caution when using it.

Model restriction: This API can be used only in the stage model.

System capability: SystemCapability.WindowManager.WindowManager.Core

Atomic service API: This API can be used in atomic services since API version 11.

Parameters

Name	Type	Mandatory	Description
name	string	Yes	Name of the named route page.
callback	AsyncCallback<void>	Yes	Callback used to return the result.

Error codes

For details about the error codes, see Universal Error Codes and Window Error Codes.

ID	Error Message
401	Parameter error. Possible cause: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types.
1300002	This window state is abnormal.

Example

// EntryAbility.ets
import { UIAbility } from '@kit.AbilityKit';
import { BusinessError } from '@kit.BasicServicesKit';
import * as Index from '../pages/Index'; // Import the named route page.

export default class EntryAbility extends UIAbility {
  // ...

  onWindowStageCreate(windowStage: window.WindowStage) {
    console.info('onWindowStageCreate');
    try {
      windowStage.loadContentByName(Index.entryName, (err: BusinessError) => {
        const errCode: number = err.code;
        if (errCode) {
          console.error(`Failed to load the content. Cause code: ${err.code}, message: ${err.message}`);
          return;
        }
        console.info('Succeeded in loading the content.');
      });
    } catch (exception) {
      console.error(`Failed to load the content. Cause code: ${exception.code}, message: ${exception.message}`);
    }
  }
};

// ets/pages/Index.ets
export const entryName : string = 'Index';
@Entry({routeName: entryName})
@Component
export struct Index {
  @State message: string = 'Hello World'
  build() {
    Row() {
      Column() {
        Text(this.message)
          .fontSize(50)
          .fontWeight(FontWeight.Bold)
      }
      .width('100%')
    }
    .height('100%')
  }
}

loadContentByName¹¹⁺

loadContentByName(name: string, storage?: LocalStorage): Promise<void>;

Loads the content of a named route page to this window stage, and transfers the state attribute to the page through a local storage. This API uses a promise to return the result. You are advised to call this API during UIAbility startup. If called repeatedly, this API will destroy the existing page content (UIContent) before loading the new content. Exercise caution when using it.

Model restriction: This API can be used only in the stage model.

System capability: SystemCapability.WindowManager.WindowManager.Core

Atomic service API: This API can be used in atomic services since API version 11.

Parameters

Name	Type	Mandatory	Description
name	string	Yes	Name of the named route page.
storage	LocalStorage	No	Page-level UI state storage unit, which is used to transfer the state attribute for the page.

Error codes

For details about the error codes, see Universal Error Codes and Window Error Codes.

ID	Error Message
401	Parameter error. Possible cause: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types.
1300002	This window state is abnormal.

Example

// EntryAbility.ets
import { UIAbility } from '@kit.AbilityKit';
import { BusinessError } from '@kit.BasicServicesKit';
import * as Index from '../pages/Index'; // Import the named route page.

export default class EntryAbility extends UIAbility {
  // ...

  storage: LocalStorage = new LocalStorage();

  onWindowStageCreate(windowStage: window.WindowStage) {
    console.info('onWindowStageCreate');
    this.storage.setOrCreate('storageSimpleProp', 121);
    try {
      let promise = windowStage.loadContentByName(Index.entryName, this.storage);
      promise.then(() => {
        console.info('Succeeded in loading the content.');
      }).catch((err: BusinessError) => {
        console.error(`Failed to load the content. Cause code: ${err.code}, message: ${err.message}`);
      });
    } catch (exception) {
      console.error(`Failed to load the content. Cause code: ${exception.code}, message: ${exception.message}`);
    }
  }
};

// ets/pages/Index.ets
export const entryName : string = 'Index';
@Entry({routeName: entryName, useSharedStorage: true})
@Component
export struct Index {
  @State message: string = 'Hello World'
  @LocalStorageLink('storageSimpleProp') storageSimpleProp: number = 1;
  build() {
    Row() {
      Column() {
        Text(this.message)
          .fontSize(50)
          .fontWeight(FontWeight.Bold)
      }
      .width('100%')
    }
    .height('100%')
  }
}

on(‘windowStageEvent’)⁹⁺

on(eventType: ‘windowStageEvent’, callback: Callback<WindowStageEventType>): void

Subscribes to the window stage lifecycle change event.

Model restriction: This API can be used only in the stage model.

System capability: SystemCapability.WindowManager.WindowManager.Core

Atomic service API: This API can be used in atomic services since API version 11.

Parameters

Name	Type	Mandatory	Description
eventType	string	Yes	Event type. The value is fixed at ‘windowStageEvent’, indicating the window stage lifecycle change event.
callback	Callback<WindowStageEventType>	Yes	Callback used to return the window stage lifecycle state.

Error codes

For details about the error codes, see Universal Error Codes and Window Error Codes.

ID	Error Message
401	Parameter error. Possible cause: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types; 3. Parameter verification failed.
1300002	This window state is abnormal.
1300005	This window stage is abnormal.

Example

// EntryAbility.ets
import { UIAbility } from '@kit.AbilityKit';

export default class EntryAbility extends UIAbility {
  // ...

  onWindowStageCreate(windowStage: window.WindowStage) {
    console.info('onWindowStageCreate');
    try {
      windowStage.on('windowStageEvent', (data) => {
        console.info('Succeeded in enabling the listener for window stage event changes. Data: ' +
        JSON.stringify(data));
      });
    } catch (exception) {
      console.error(`Failed to enable the listener for window stage event changes. Cause code: ${exception.code}, message: ${exception.message}`);
    }
  }
};

off(‘windowStageEvent’)⁹⁺

off(eventType: ‘windowStageEvent’, callback?: Callback<WindowStageEventType>): void

Unsubscribes from the window stage lifecycle change event.

Model restriction: This API can be used only in the stage model.

System capability: SystemCapability.WindowManager.WindowManager.Core

Atomic service API: This API can be used in atomic services since API version 11.

Parameters

Name	Type	Mandatory	Description
eventType	string	Yes	Event type. The value is fixed at ‘windowStageEvent’, indicating the window stage lifecycle change event.
callback	Callback<WindowStageEventType>	No	Callback used to return the window stage lifecycle state. If a value is passed in, the corresponding subscription is canceled. If no value is passed in, all subscriptions to the specified event are canceled.

Error codes

For details about the error codes, see Universal Error Codes and Window Error Codes.

ID	Error Message
401	Parameter error. Possible cause: 1. Incorrect parameter types; 2. Parameter verification failed.
1300002	This window state is abnormal.
1300005	This window stage is abnormal.

Example

// EntryAbility.ets
import { UIAbility } from '@kit.AbilityKit';

export default class EntryAbility extends UIAbility {
  // ...

  onWindowStageCreate(windowStage: window.WindowStage) {
    console.info('onWindowStageCreate');
    const callback = (windowStageEventType: window.WindowStageEventType) => {
      // ...
    }
    try {
      windowStage.on('windowStageEvent', callback);
    } catch (exception) {
      console.error(`Failed to enable the listener for window stage event changes. Cause code: ${exception.code}, message: ${exception.message}`);
    }
    try {
      windowStage.off('windowStageEvent', callback);
      // Unregister all the callbacks that have been registered through on().
      windowStage.off('windowStageEvent');
    } catch (exception) {
      console.error(`Failed to disable the listener for window stage event changes. Cause code: ${exception.code}, message: ${exception.message}`);
    }
  }
};

on(‘windowStageClose’)¹⁴⁺

on(eventType: ‘windowStageClose’, callback: Callback<void>): void

Subscribes to the click event on the close button in the three-button navigation bar of the main window. This event is triggered when the close button in the three-button navigation bar of the main window is clicked. The registered lifecycle callback function UIAbility.onPrepareToTerminate is not executed.

If the event is subscribed to multiple times, only the most recently subscribed-to event takes effect.

The callback function in this API is executed synchronously. For asynchronous close events of the main window, refer to on(‘windowWillClose’).

If there is an existing event subscribed to by calling on(‘windowWillClose’), only the on(‘windowWillClose’) API will be responded to.

This API can be used only on 2-in-1 devices.

Model restriction: This API can be used only in the stage model.

System capability: SystemCapability.Window.SessionManager

Atomic service API: This API can be used in atomic services since API version 14.

Parameters

Name	Type	Mandatory	Description
eventType	string	Yes	Event type. The value is fixed at ‘windowStageClose’, indicating that the close button in the three-button navigation bar of the main window is clicked
callback	Callback<void>	Yes	Callback invoked when the close button in the upper right corner of the main window is clicked. It does not return any parameter. The internal logic of the callback function requires a return value of the Boolean type. The return value determines whether to continue to close the main window. The value true means not to close the main window, and false means to continue to close the main window.

Error codes

For details about the error codes, see Universal Error Codes and Window Error Codes.

ID	Error Message
401	Parameter error. Possible cause: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types; 3. Parameter verification failed.
801	Capability not supported. Failed to call the API due to limited device capabilities.
1300002	This window state is abnormal.

Example

// EntryAbility.ets
import { UIAbility } from '@kit.AbilityKit';
import { window } from '@kit.ArkUI';

export default class EntryAbility extends UIAbility {
  // ...

  onWindowStageCreate(windowStage: window.WindowStage) {
    console.info('onWindowStageCreate');
    try {
      windowStage.on('windowStageClose', () => {
        console.info('Succeeded in enabling the listener for window stage close event.');
        return false;
      });
    } catch (exception) {
      console.error(`Failed to enable the listener for window stage close event. Cause code: ${exception.code}, message: ${exception.message}`);
    }
  }
};

off(‘windowStageClose’)¹⁴⁺

off(eventType: ‘windowStageClose’, callback?: Callback<void>): void

Unsubscribes from the event indicating that the main window is closed.

This API can be used only on 2-in-1 devices.

Model restriction: This API can be used only in the stage model.

System capability: SystemCapability.Window.SessionManager

Atomic service API: This API can be used in atomic services since API version 14.

Parameters

Name	Type	Mandatory	Description
eventType	string	Yes	Event type. The value is fixed at ‘windowStageClose’, indicating that the close button in the three-button navigation bar of the main window is clicked.
callback	Callback<void>	No	Callback invoked when the close button in the upper right corner of the main window is clicked. It does not return any parameter. The internal logic of the callback function requires a return value of the Boolean type. The return value determines whether to continue to close the main window. The value true means not to close the main window, and false means to continue to close the main window. If a value is passed in, the corresponding subscription is canceled. If no value is passed in, all subscriptions to the specified event are canceled.

Error codes

For details about the error codes, see Universal Error Codes and Window Error Codes.

ID	Error Message
401	Parameter error. Possible cause: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types; 3. Parameter verification failed.
801	Capability not supported. Failed to call the API due to limited device capabilities.
1300002	This window state is abnormal.

Example

// EntryAbility.ets
import { UIAbility } from '@kit.AbilityKit';
import { window } from '@kit.ArkUI';

export default class EntryAbility extends UIAbility {
  // ...

  onWindowStageCreate(windowStage: window.WindowStage) {
    console.info('onWindowStageCreate');
    const callback = () => {
      // ...
      return false;
    }
    try {
      windowStage.on('windowStageClose', callback);
      windowStage.off('windowStageClose', callback);
      windowStage.off('windowStageClose');
    } catch (exception) {
      console.error(`Failed to disable the listener for window stage close changes. Cause code: ${exception.code}, message: ${exception.message}`);
    }
  }
};

setDefaultDensityEnabled¹²⁺

setDefaultDensityEnabled(enabled: boolean): void

Sets whether the main window of the application uses the system’s default density. Child windows and system windows will follow the main window’s setting. Before calling this API, call WindowStage.loadContent() to initialize the layout to ensure the correct call sequence.

If this API is not called, the default density is not used.

When the default density is not used, if setCustomDensity() has been called, the window will be re-laid out according to the custom display size changes. Otherwise, it will be re-laid out according to the system display size changes.

Model restriction: This API can be used only in the stage model.

Atomic service API: This API can be used in atomic services since API version 12.

System capability: SystemCapability.Window.SessionManager

Parameters

Name	Type	Mandatory	Description
enabled	boolean	Yes	Whether to enable the system’s default density. The value true means to enable the system’s default density, and false means the opposite. When the system’s default density is enabled, the window layout does not change with the system display size.

Error codes

For details about the error codes, see Universal Error Codes and Window Error Codes.

ID	Error Message
401	Parameter error. Possible cause: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types.
801	Capability not supported. Failed to call the API due to limited device capabilities.
1300002	This window state is abnormal.
1300005	This window stage is abnormal.

Example

// EntryAbility.ets
import { UIAbility } from '@kit.AbilityKit';
import { window } from '@kit.ArkUI';
import { BusinessError } from '@kit.BasicServicesKit'

export default class EntryAbility extends UIAbility {
  // ...

  onWindowStageCreate(windowStage: window.WindowStage) {
      windowStage.loadContent("pages/page2", (err: BusinessError) => {
        let errCode: number = err.code;
        if (errCode) {
          console.error(`Failed to load the content. Cause code: ${err.code}, message: ${err.message}`);
          return;
        }
        console.info('onWindowStageCreate');
      try {
        windowStage.setDefaultDensityEnabled(true);
        console.info('Succeeded in loading the content.');
      } catch (exception) {
        console.error(`Failed to set default density enabled. Cause code: ${exception.code}, message: ${exception.message}`);
      }
    });
  }
};

setCustomDensity¹⁵⁺

setCustomDensity(density: number): void

Allows the main window of the application to customize its display size scale factor. Child windows and system windows will follow the main window’s setting. If both this API and setDefaultDensityEnabled(true) are called to set a display size scale factor, the setting from the last called API will be applied.

Model restriction: This API can be used only in the stage model.

Atomic service API: This API can be used in atomic services since API version 15.

System capability: SystemCapability.Window.SessionManager

Parameters

Name	Type	Mandatory	Description
density	number	Yes	Custom display size scale factor. The value is a floating point number in the range [0.5, 4.0] or is set to -1.0. The value 4.0 indicates the largest permissible display size scale factor for the window, and -1.0 means that the window uses the system’s default display size scale factor.

Error codes

For details about the error codes, see Universal Error Codes and Window Error Codes.

ID	Error Message
401	Parameter error. Possible cause: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types.
801	Capability not supported. Failed to call the API due to limited device capabilities.
1300002	This window state is abnormal.
1300005	This window stage is abnormal.

Example

// EntryAbility.ets
import { UIAbility } from '@kit.AbilityKit';

export default class EntryAbility extends UIAbility {
  // ...

  onWindowStageCreate(windowStage: window.WindowStage) {
    console.info('onWindowStageCreate');
    try {
      windowStage.setCustomDensity(-1.0);
    } catch (exception) {
      console.error(`Failed to set custom density. Cause code: ${exception.code}, message: ${exception.message}`);
    }
  }
};

setWindowModal¹⁴⁺

setWindowModal(isModal: boolean): Promise<void>

Enables the modal property of the main window. This API uses a promise to return the result.

This API must be called by the main window and the setting takes effect for the main window. After the modal property of the main window is enabled, other main windows in the same application process and their child windows do not respond to user interactions until the main window is closed or the main window’s modal property is disabled.

This API can be used only on 2-in-1 devices.

Model restriction: This API can be used only in the stage model.

Atomic service API: This API can be used in atomic services since API version 14.

System capability: SystemCapability.Window.SessionManager

Parameters

Name	Type	Mandatory	Description
isModal	boolean	Yes	Whether to enable the modal property of the main window. The value true means to enable the modal property, and false means the opposite.

Return value

Type	Description
Promise<void>	Promise that returns no value.

Error codes

For details about the error codes, see Universal Error Codes and Window Error Codes.

ID	Error Message
401	Parameter error. Possible cause: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types.
801	Capability not supported. Failed to call the API due to limited device capabilities.
1300002	This window state is abnormal.
1300003	This window manager service works abnormally.
1300005	This window stage is abnormal.

Example

// EntryAbility.ets
import { UIAbility } from '@kit.AbilityKit';
import { BusinessError } from '@kit.BasicServicesKit';

export default class EntryAbility extends UIAbility {
  // ...
  onWindowStageCreate(windowStage: window.WindowStage): void {
    console.info('onWindowStageCreate');
    try {
      let promise = windowStage.setWindowModal(true);
      promise.then(() => {
        console.info('Succeeded in setting window modal');
      }).catch((err: BusinessError) => {
        console.error(`Failed to set window modal. Cause code: ${err.code}, message: ${err.message}`);
      });
    } catch (exception) {
      console.error(`Failed to set window modal. Cause code: ${exception.code}, message: ${exception.message}`);
    }
  }
}

removeStartingWindow¹⁴⁺

removeStartingWindow(): Promise<void>

Allows the application to control the time when the launch page disappears.

This API takes effect only for the application main window when enable.remove.starting.window under metadata in abilities in the module.json5 file is set to true.

If the tag is set to true, the system provides timeout protection for the launch page. If this API is not called within 5 seconds, the system automatically removes the launch page.

If the tag is set to false or is not configured, this API does not take effect. The launch page will be automatically removed after the first frame of the application is rendered.

Model restriction: This API can be used only in the stage model.

Atomic service API: This API can be used in atomic services since API version 14.

System capability: SystemCapability.Window.SessionManager

Return value

Type	Description
Promise<void>	Promise that returns no value.

Error codes

For details about the error codes, see Universal Error Codes and Window Error Codes.

ID	Error Message
801	Capability not supported. Failed to call the API due to limited device capabilities.
1300002	This window state is abnormal.
1300003	This window manager service works abnormally.

Example

// EntryAbility.ets
import { UIAbility } from '@kit.AbilityKit';
import { BusinessError } from '@kit.BasicServicesKit';

export default class EntryAbility extends UIAbility {
  // ...

  onWindowStageCreate(windowStage: window.WindowStage) {
    console.info('onWindowStageCreate');
    windowStage.removeStartingWindow().then(() => {
      console.info('Succeeded in removing starting window.');
    }).catch((err: BusinessError) => {
        console.error(`Failed to remove starting window. Cause code: ${err.code}, message: ${err.message}`);
    });
  }
};

setWindowRectAutoSave¹⁴⁺

setWindowRectAutoSave(enabled: boolean): Promise<void>

Enables or disables the auto-save feature for the size of the last closed main window. This API uses a promise to return the result. It takes effect only on 2-in-1 devices.

When the auto-save feature is enabled, within the same UIAbility, the size of the last closed main window is remembered. When this main window is restarted, it will open at the remembered size according to the rules.

The following rules apply in stacking scenarios:

If the current instance is a free-form window, the next opened window will adopt the same size when stacked.
If the current instance is maximized or in full-screen mode, the next opened window will maintain the maximized state when stacked.

The following table describes the memory rules:

Last Window State	Memorizing Rule
Free-form window	Retains the size/position of the free-form window, rebound if exceeding the workspace.
Split-screen window	Retains the size and position of the free-form window before screen splitting.
Maximized window	Retains the maximized state.
Immersive window	Retains the size and position of the free-form window before immersive mode.
Minimized window	Retains the size and position of the free-form window before minimization.

Model restriction: This API can be used only in the stage model.

Atomic service API: This API can be used in atomic services since API version 14.

System capability: SystemCapability.Window.SessionManager

Parameters

Name	Type	Mandatory	Description
enabled	boolean	Yes	Whether to enable the auto-save feature. The value true means to enable it, and false means to disable it.

Return value

Type	Description
Promise<void>	Promise that returns no value.

Error codes

For details about the error codes, see Universal Error Codes and Window Error Codes.

ID	Error Message
401	Parameter error. Possible cause: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types.
801	Capability not supported. Failed to call the API due to limited device capabilities.
1300002	This window state is abnormal.
1300003	This window manager service works abnormally.

Example

// EntryAbility.ets
import { UIAbility } from '@kit.AbilityKit';
import { BusinessError } from '@kit.BasicServicesKit';

export default class EntryAbility extends UIAbility {
  // ...
  onWindowStageCreate(windowStage: window.WindowStage): void {
    console.info('onWindowStageCreate');
    try {
      let promise = windowStage.setWindowRectAutoSave(true);
      promise.then(() => {
        console.info('Succeeded in setting window rect auto-save');
      }).catch((err: BusinessError) => {
        console.error(`Failed to set window rect auto-save. Cause code: ${err.code}, message: ${err.message}`);
      });
    } catch (exception) {
      console.error(`Failed to set window rect auto-save. Cause code: ${exception.code}, message: ${exception.message}`);
    }
  }
}

setWindowRectAutoSave¹⁷⁺

setWindowRectAutoSave(enabled: boolean, isSaveBySpecifiedFlag: boolean): Promise<void>

Enables or disables the auto-save feature for the size of the main window. This API uses a promise to return the result. It takes effect only on 2-in-1 devices.

Within the same UIAbility, you can remember the size of the last closed main window, or you can remember the size of each main window individually. The individual auto-save feature for each main window size is only available when the UIAbility launch mode is set to specified and the isSaveBySpecifiedFlag parameter is set to true.

When the auto-save feature is enabled, the size of the main window when it is closed is remembered. When the main window is restarted, it will open at the remembered size according to the rules.

The following table describes the memory rules:

Last Window State	Memorizing Rule
Free-form window	Retains the size/position of the free-form window, rebound if exceeding the workspace.
Split-screen window	Retains the size and position of the free-form window before screen splitting.
Maximized window	Retains the maximized state.
Immersive window	Retains the size and position of the free-form window before immersive mode.
Minimized window	Retains the size and position of the free-form window before minimization.

Model restriction: This API can be used only in the stage model.

Atomic service API: This API can be used in atomic services since API version 17.

System capability: SystemCapability.Window.SessionManager

Parameters

Name	Type	Mandatory	Description
enabled	boolean	Yes	Whether to enable the auto-save feature. The value true means to enable it, and false means to disable it.
isSaveBySpecifiedFlag	boolean	Yes	Whether to enable the individual auto-save feature when the UIAbility launch mode is set to specified. The value true means to enable it, and false means to disable it.

Return value

Type	Description
Promise<void>	Promise that returns no value.

Error codes

For details about the error codes, see Universal Error Codes and Window Error Codes.

ID	Error Message
401	Parameter error. Possible causes: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types.
801	Capability not supported. Function setWindowRectAutoSave can not work correctly due to limited device capabilities.
1300002	This window state is abnormal.
1300003	This window manager service works abnormally.

Example

// EntryAbility.ets
import { UIAbility } from '@kit.AbilityKit';
import { BusinessError } from '@kit.BasicServicesKit';

export default class EntryAbility extends UIAbility {
  // ...
  onWindowStageCreate(windowStage: window.WindowStage): void {
    console.info('onWindowStageCreate');
    try {
      let promise = windowStage.setWindowRectAutoSave(true, true);
      promise.then(() => {
        console.info('Succeeded in setting window rect auto-save');
      }).catch((err: BusinessError) => {
        console.error(`Failed to set window rect auto-save. Cause code: ${err.code}, message: ${err.message}`);
      });
    } catch (exception) {
      console.error(`Failed to set window rect auto-save. Cause code: ${exception.code}, message: ${exception.message}`);
    }
  }
}

isWindowRectAutoSave¹⁴⁺

isWindowRectAutoSave(): Promise<boolean>

Checks whether the auto-save feature is enabled for the main window’s size. This API uses a promise to return the result. It takes effect only on 2-in-1 devices.

Model restriction: This API can be used only in the stage model.

Atomic service API: This API can be used in atomic services since API version 14.

System capability: SystemCapability.Window.SessionManager

Return value

Type	Description
Promise<boolean>	Promise used to return the result. The value true means that the auto-save feature is enabled, and false means the opposite.

Error codes

For details about the error codes, see Window Error Codes.

ID	Error Message
801	Capability not supported. Failed to call the API due to limited device capabilities.
1300002	This window state is abnormal.
1300003	This window manager services works abnormally.

Example

// EntryAbility.ets
import { UIAbility } from '@kit.AbilityKit';
import { BusinessError } from '@kit.BasicServicesKit';

export default class EntryAbility extends UIAbility {
  // ...
  onWindowStageCreate(windowStage: window.WindowStage): void {
    console.info('onWindowStageCreate');
    try {
      let promise = windowStage.isWindowRectAutoSave();
      promise.then((data) => {
        console.info(`Succeeded in checking whether the window support the rect auto-save. Data: ${data}`);
      }).catch((err: BusinessError) => {
        console.error(`Failed to check whether the window support the rect auto-save. Cause code: ${err.code}, message: ${err.message}`);
      });
    } catch (exception) {
      console.error(`Failed to check whether the window support the rect auto-save. Cause code: ${exception.code}, message: ${exception.message}`);
    }
  }
}

setSupportedWindowModes¹⁵⁺

setSupportedWindowModes(supportedWindowModes: Array): Promise<void>

Sets the supported window modes of the main window. This API uses a promise to return the result.

This API can be used only on 2-in-1 devices.

Model restriction: This API can be used only in the stage model.

Atomic service API: This API can be used in atomic services since API version 15.

System capability: SystemCapability.Window.SessionManager

Parameters

Name	Type	Mandatory	Description
supportedWindowModes	Array<bundleManager.SupportWindowMode>	Yes	Supported window modes. - FULL_SCREEN: full-screen mode. - FLOATING: floating window mode. - SPLIT: split-screen mode. FULL_SCREEN or FLOATING must be used together. Configuring only SPLIT is not supported. Note: The values of the SupportWindowMode field in the array should not conflict with the values of the supportWindowMode field under abilities of the module.json5 file corresponding to this UIAbility, or with the values of the supportWindowModes field in StartOptions. In case of a conflict, the window support mode set by this parameter will take precedence.

Return value

Type	Description
Promise<void>	Promise that returns no value.

Error codes

For details about the error codes, see Universal Error Codes and Window Error Codes.

ID	Error Message
401	Parameter error. Possible cause: 1. Mandatory parameters are left unspecified; 2. Incorrect parameter types.
801	Capability not supported. Failed to call the API due to limited device capabilities.
1300002	This window state is abnormal.
1300003	This window manager service works abnormally.

Example

// EntryAbility.ets
import { UIAbility, bundleManager } from '@kit.AbilityKit';
import { BusinessError } from '@kit.BasicServicesKit';

export default class EntryAbility extends UIAbility {
  // ...
  onWindowStageCreate(windowStage: window.WindowStage): void {
    console.info('onWindowStageCreate');
    try {
      let promise = windowStage.setSupportedWindowModes([
        bundleManager.SupportWindowMode.FULL_SCREEN,
        bundleManager.SupportWindowMode.SPLIT,
        bundleManager.SupportWindowMode.FLOATING
      ]);
      promise.then(() => {
        console.info('Succeeded in setting window support modes');
      }).catch((err: BusinessError) => {
        console.error(`Failed to set window support modes. Cause code: ${err.code}, message: ${err.message}`);
      });
    } catch (exception) {
      console.error(`Failed to set window support modes. Cause code: ${exception.code}, message: ${exception.message}`);
    }
  }
}

setSupportedWindowModes²⁰⁺

setSupportedWindowModes(supportedWindowModes: Array, grayOutMaximizeButton: boolean): Promise<void>

Sets the supported window modes for the main window and optionally disables the maximize button. This API uses a promise to return the result.

This API can be used only on 2-in-1 devices.

Model restriction: This API can be used only in the stage model.

System capability: SystemCapability.Window.SessionManager

Parameters

Name	Type	Mandatory	Description
supportedWindowModes	Array<bundleManager.SupportWindowMode>	Yes	Supported window modes. - FULL_SCREEN: full-screen mode. - FLOATING: floating window mode. - SPLIT: split-screen mode. FULL_SCREEN or FLOATING must be used together. Configuring only SPLIT is not supported. Note: The values of the SupportWindowMode field in the array should not conflict with the value of the supportWindowMode field under abilities or supportWindowModes field in StartOptions of the module.json5 file corresponding to this UIAbility. In case of a conflict, the window support mode set by this parameter will take precedence.
grayOutMaximizeButton	boolean	Yes	Whether to display the main window and disable its maximize button. The value true means to display the main window and disable its maximize button, and false means the opposite. This parameter takes effect only when supportedWindowModes is not set to FULL_SCREEN.

Return value

Type	Description
Promise<void>	Promise that returns no value.

Error codes

For details about the error codes, see Universal Error Codes and Window Error Codes.

ID	Error Message
801	Capability not supported. Function setSupportedWindowModes can not work correctly due to limited device capabilities.
1300002	This window state is abnormal.
1300003	This window manager service works abnormally.
1300016	Parameter error. Possible cause: 1. Invalid parameter range. 2. Invalid parameter length. 3. Incorrect parameter format.

Example

// EntryAbility.ets
import { UIAbility, bundleManager } from '@kit.AbilityKit';
import { BusinessError } from '@kit.BasicServicesKit';

export default class EntryAbility extends UIAbility {
  // ...
  onWindowStageCreate(windowStage: window.WindowStage): void {
    console.info('onWindowStageCreate');
    try {
      let promise = windowStage.setSupportedWindowModes([
        bundleManager.SupportWindowMode.FULL_SCREEN,
        bundleManager.SupportWindowMode.SPLIT,
        bundleManager.SupportWindowMode.FLOATING
      ], true);
      promise.then(() => {
        console.info('Succeeded in setting window support modes');
      }).catch((err: BusinessError) => {
        console.error(`Failed to set window support modes. Cause code: ${err.code}, message: ${err.message}`);
      });
    } catch (exception) {
      console.error(`Failed to set window support modes. Cause code: ${exception.code}, message: ${exception.message}`);
    }
  }
}

你可能感兴趣的鸿蒙文章

harmony 鸿蒙ArkUI

harmony 鸿蒙ARKUI_TextPickerCascadeRangeContent

harmony 鸿蒙ARKUI_TextPickerRangeContent

harmony 鸿蒙ArkUI_AnimateCompleteCallback

harmony 鸿蒙ArkUI_AttributeItem

harmony 鸿蒙ArkUI_ColorStop

harmony 鸿蒙ArkUI_ContextCallback

harmony 鸿蒙ArkUI_EventModule

harmony 鸿蒙ArkUI_ExpectedFrameRateRange

harmony 鸿蒙ArkUI_IntOffset

0 赞

所属分类： 后端技术
本文标签：
版权声明： 原创文章如转载，请注明本文链接: https://m.seaxiang.com/blog/r9Gt4t

harmony 鸿蒙Interface (WindowStage)

Interface (WindowStage)

WindowStage⁹⁺

getMainWindow⁹⁺

getMainWindow⁹⁺

getMainWindowSync⁹⁺

createSubWindow⁹⁺

createSubWindow⁹⁺

createSubWindowWithOptions¹¹⁺

getSubWindow⁹⁺

getSubWindow⁹⁺

loadContent⁹⁺

loadContent⁹⁺

loadContent⁹⁺

loadContentByName¹¹⁺

loadContentByName¹¹⁺

loadContentByName¹¹⁺

on(‘windowStageEvent’)⁹⁺

off(‘windowStageEvent’)⁹⁺

on(‘windowStageClose’)¹⁴⁺

off(‘windowStageClose’)¹⁴⁺

setDefaultDensityEnabled¹²⁺

setCustomDensity¹⁵⁺

setWindowModal¹⁴⁺

removeStartingWindow¹⁴⁺

setWindowRectAutoSave¹⁴⁺

setWindowRectAutoSave¹⁷⁺

isWindowRectAutoSave¹⁴⁺

setSupportedWindowModes¹⁵⁺

setSupportedWindowModes²⁰⁺

你可能感兴趣的鸿蒙文章

热门推荐

标签云

最新文章

本文目录

harmony 鸿蒙Interface (WindowStage)

Interface (WindowStage)

WindowStage9+

getMainWindow9+

getMainWindow9+

getMainWindowSync9+

createSubWindow9+

createSubWindow9+

createSubWindowWithOptions11+

getSubWindow9+

getSubWindow9+

loadContent9+

loadContent9+

loadContent9+

loadContentByName11+

loadContentByName11+

loadContentByName11+

on(‘windowStageEvent’)9+

off(‘windowStageEvent’)9+

on(‘windowStageClose’)14+

off(‘windowStageClose’)14+

setDefaultDensityEnabled12+

setCustomDensity15+

setWindowModal14+

removeStartingWindow14+

setWindowRectAutoSave14+

setWindowRectAutoSave17+

isWindowRectAutoSave14+

setSupportedWindowModes15+

setSupportedWindowModes20+

你可能感兴趣的鸿蒙文章

热门推荐

标签云

最新文章

本文目录

WindowStage⁹⁺

getMainWindow⁹⁺

getMainWindow⁹⁺

getMainWindowSync⁹⁺

createSubWindow⁹⁺

createSubWindow⁹⁺

createSubWindowWithOptions¹¹⁺

getSubWindow⁹⁺

getSubWindow⁹⁺

loadContent⁹⁺

loadContent⁹⁺

loadContent⁹⁺

loadContentByName¹¹⁺

loadContentByName¹¹⁺

loadContentByName¹¹⁺

on(‘windowStageEvent’)⁹⁺

off(‘windowStageEvent’)⁹⁺

on(‘windowStageClose’)¹⁴⁺

off(‘windowStageClose’)¹⁴⁺

setDefaultDensityEnabled¹²⁺

setCustomDensity¹⁵⁺

setWindowModal¹⁴⁺

removeStartingWindow¹⁴⁺

setWindowRectAutoSave¹⁴⁺

setWindowRectAutoSave¹⁷⁺

isWindowRectAutoSave¹⁴⁺

setSupportedWindowModes¹⁵⁺

setSupportedWindowModes²⁰⁺