@ohos.multimodalInput.pointer (Mouse Pointer)

The pointer module provides APIs related to pointer attribute management.

NOTE

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

Modules to Import

import pointer from '@ohos.multimodalInput.pointer';

pointer.setPointerVisible9+

setPointerVisible(visible: boolean, callback: AsyncCallback<void>): void

Sets the visible status of the mouse pointer. This API uses an asynchronous callback to return the result.

System capability: SystemCapability.MultimodalInput.Input.Pointer

Parameters

Name Type Mandatory Description
visible boolean Yes Whether the mouse pointer is visible.
callback AsyncCallback<void> Yes Callback used to return the result.

Example

try {
  pointer.setPointerVisible(true, (error) => {
    if (error) {
      console.log(`Set pointer visible failed, error: ${JSON.stringify(error, [`code`, `message`])}`);
      return;
    }
    console.log(`Set pointer visible success`);
  });
} catch (error) {
  console.log(`Set pointer visible failed, error: ${JSON.stringify(error, [`code`, `message`])}`);
}

pointer.setPointerVisible9+

setPointerVisible(visible: boolean): Promise<void>

Sets the visible status of the mouse pointer. This API uses a promise to return the result.

System capability: SystemCapability.MultimodalInput.Input.Pointer

Parameters

Name Type Mandatory Description
visible boolean Yes Whether the mouse pointer is visible.

Return value

Name Description
Promise<void> Promise used to return the result.

Example

try {
  pointer.setPointerVisible(false).then(() => {
    console.log(`Set pointer visible success`);
  });
} catch (error) {
  console.log(`Set pointer visible failed, error: ${JSON.stringify(error, [`code`, `message`])}`);
}

pointer.isPointerVisible9+

isPointerVisible(callback: AsyncCallback<boolean>): void

Checks the visible status of the mouse pointer. This API uses an asynchronous callback to return the result.

System capability: SystemCapability.MultimodalInput.Input.Pointer

Parameters

Name Type Mandatory Description
callback AsyncCallback<boolean> Yes Callback used to return the result.

Example

try {
  pointer.isPointerVisible((error, visible) => {
    if (error) {
      console.log(`Get pointer visible failed, error: ${JSON.stringify(error, [`code`, `message`])}`);
      return;
    }
    console.log(`Get pointer visible success, visible: ${JSON.stringify(visible)}`);
  });
} catch (error) {
  console.log(`Get pointer visible failed, error: ${JSON.stringify(error, [`code`, `message`])}`);
}

pointer.isPointerVisible9+

isPointerVisible(): Promise<boolean>

Checks the visible status of the mouse pointer. This API uses a promise to return the result.

System capability: SystemCapability.MultimodalInput.Input.Pointer

Return value

Name Description
Promise<boolean> Promise used to return the result.

Example

try {
  pointer.isPointerVisible().then((visible) => {
    console.log(`Get pointer visible success, visible: ${JSON.stringify(visible)}`);
  });
} catch (error) {
  console.log(`Get pointer visible failed, error: ${JSON.stringify(error, [`code`, `message`])}`);
}

pointer.setPointerSpeed9+

setPointerSpeed(speed: number, callback: AsyncCallback<void>): void

Sets the mouse movement speed. This API uses an asynchronous callback to return the result.

System capability: SystemCapability.MultimodalInput.Input.Pointer

System API: This is a system API.

Parameters

Name Type Mandatory Description
speed number Yes Mouse movement speed. The value ranges from 1 to 11. The default value is 5.
callback AsyncCallback<void> Yes Callback used to return the result.

Example

try {
  pointer.setPointerSpeed(5, (error) => {
    if (error) {
      console.log(`Set pointer speed failed, error: ${JSON.stringify(error, [`code`, `message`])}`);
      return;
    }
    console.log(`Set pointer speed success`);
  });
} catch (error) {
  console.log(`Set pointer speed failed, error: ${JSON.stringify(error, [`code`, `message`])}`);
}

pointer.setPointerSpeed9+

setPointerSpeed(speed: number): Promise<void>

Sets the mouse movement speed. This API uses a promise to return the result.

System capability: SystemCapability.MultimodalInput.Input.Pointer

System API: This is a system API.

Parameters

Name Type Mandatory Description
speed number Yes Mouse movement speed. The value ranges from 1 to 11. The default value is 5.

Return value

Name Description
Promise<void> Promise used to return the result.

Example

try {
  pointer.setPointerSpeed(5).then(() => {
    console.log(`Set pointer speed success`);
  });
} catch (error) {
  console.log(`Set pointer speed failed, error: ${JSON.stringify(error, [`code`, `message`])}`);
}

pointer.getPointerSpeed9+

getPointerSpeed(callback: AsyncCallback<number>): void

Obtains the mouse movement speed. This API uses an asynchronous callback to return the result.

System capability: SystemCapability.MultimodalInput.Input.Pointer

System API: This is a system API.

Parameters

Name Type Mandatory Description
callback AsyncCallback<number> Yes Callback used to return the result.

Example

try {
  pointer.getPointerSpeed((error, speed) => {
    if (error) {
      console.log(`Get pointer speed failed, error: ${JSON.stringify(error, [`code`, `message`])}`);
      return;
    }
    console.log(`Get pointer speed success, speed: ${JSON.stringify(speed)}`);
  });
} catch (error) {
  console.log(`Get pointer speed failed, error: ${JSON.stringify(error, [`code`, `message`])}`);
}

pointer.getPointerSpeed9+

getPointerSpeed(): Promise<number>

Obtains the mouse movement speed. This API uses a promise to return the result.

System capability: SystemCapability.MultimodalInput.Input.Pointer

System API: This is a system API.

Return value

Name Description
Promise<number> Promise used to return the result.

Example

try {
  pointer.getPointerSpeed().then(speed => {
    console.log(`Get pointer speed success, speed: ${JSON.stringify(speed)}`);
  });
} catch (error) {
  console.log(`Get pointer speed failed, error: ${JSON.stringify(error, [`code`, `message`])}`);
}

pointer.getPointerStyle9+

getPointerStyle(windowId: number, callback: AsyncCallback<PointerStyle>): void

Obtains the mouse pointer style. This API uses an asynchronous callback to return the result.

System capability: SystemCapability.MultimodalInput.Input.Pointer

Parameters

Name Type Mandatory Description
windowId number Yes Window ID.
callback AsyncCallback<PointerStyle> Yes Callback used to return the result.

Example

import window from '@ohos.window';

window.getLastWindow(this.context, (error, win) => {
  if (error.code) {
    console.error('Failed to obtain the top window. Cause: ' + JSON.stringify(error));
    return;
  }
  let windowId = win.getWindowProperties().id;
  if (windowId < 0) {
    console.log(`Invalid windowId`);
    return;
  }
  try {
    pointer.getPointerStyle(windowId, (error, style) => {
      console.log(`Get pointer style success, style: ${JSON.stringify(style)}`);
    });
  } catch (error) {
    console.log(`Get pointer style failed, error: ${JSON.stringify(error, [`code`, `message`])}`);
  }
});

pointer.getPointerStyle9+

getPointerStyle(windowId: number): Promise<PointerStyle>

Obtains the mouse pointer style. This API uses a promise to return the result.

System capability: SystemCapability.MultimodalInput.Input.Pointer

Parameters

Name Type Mandatory Description
windowId number Yes Window ID.

Return value

Name Description
Promise<PointerStyle> Promise used to return the result.

Example

import window from '@ohos.window';

window.getLastWindow(this.context, (error, win) => {
  if (error.code) {
    console.error('Failed to obtain the top window. Cause: ' + JSON.stringify(error));
    return;
  }
  let windowId = win.getWindowProperties().id;
  if (windowId < 0) {
    console.log(`Invalid windowId`);
    return;
  }
  try {
    pointer.getPointerStyle(windowId).then((style) => {
      console.log(`Get pointer style success, style: ${JSON.stringify(style)}`);
    });
  } catch (error) {
    console.log(`Get pointer style failed, error: ${JSON.stringify(error, [`code`, `message`])}`);
  }
});

pointer.setPointerStyle9+

setPointerStyle(windowId: number, pointerStyle: PointerStyle, callback: AsyncCallback<void>): void

Sets the mouse pointer style. This API uses an asynchronous callback to return the result.

System capability: SystemCapability.MultimodalInput.Input.Pointer

Parameters

Name Type Mandatory Description
windowId number Yes Window ID.
pointerStyle PointerStyle Yes Mouse pointer style ID.
callback AsyncCallback<void> Yes Callback used to return the result.

Example

import window from '@ohos.window';

window.getLastWindow(this.context, (error, win) => {
  if (error.code) {
    console.error('Failed to obtain the top window. Cause: ' + JSON.stringify(error));
    return;
  }
  let windowId = win.getWindowProperties().id;
  if (windowId < 0) {
    console.log(`Invalid windowId`);
    return;
  }
  try {
    pointer.setPointerStyle(windowId, pointer.PointerStyle.CROSS, error => {
      console.log(`Set pointer style success`);
    });
  } catch (error) {
    console.log(`Set pointer style failed, error: ${JSON.stringify(error, [`code`, `message`])}`);
  }
});

pointer.setPointerStyle9+

setPointerStyle(windowId: number, pointerStyle: PointerStyle): Promise<void>

Sets the mouse pointer style. This API uses a promise to return the result.

System capability: SystemCapability.MultimodalInput.Input.Pointer

Parameters

Name Type Mandatory Description
windowId number Yes Window ID.
pointerStyle PointerStyle Yes Mouse pointer style ID.
Promise<void> void Yes Promise used to return the result.

Example

import window from '@ohos.window';

window.getLastWindow(this.context, (error, win) => {
  if (error.code) {
    console.error('Failed to obtain the top window. Cause: ' + JSON.stringify(error));
    return;
  }
  let windowId = win.getWindowProperties().id;
  if (windowId < 0) {
    console.log(`Invalid windowId`);
    return;
  }
  try {
    pointer.setPointerStyle(windowId, pointer.PointerStyle.CROSS).then(() => {
      console.log(`Set pointer style success`);
    });
  } catch (error) {
    console.log(`Set pointer style failed, error: ${JSON.stringify(error, [`code`, `message`])}`);
  }
});

PointerStyle9+

Enumerates mouse pointer styles.

System capability: SystemCapability.MultimodalInput.Input.Pointer

Name Value Description Legend
DEFAULT 0 Default Default.png
EAST 1 East arrow East.png
WEST 2 West arrow West.png
SOUTH 3 South arrow South.png
NORTH 4 North arrow North.png
WEST_EAST 5 West-east arrow West_East.png
NORTH_SOUTH 6 North-south arrow North_South.png
NORTH_EAST 7 North-east arrow North_East.png
NORTH_WEST 8 North-west arrow North_West.png
SOUTH_EAST 9 South-east arrow South_East.png
SOUTH_WEST 10 South-west arrow South_West.png
NORTH_EAST_SOUTH_WEST 11 North-east and south-west adjustment North_East_South_West.png
NORTH_WEST_SOUTH_EAST 12 North-west and south-east adjustment North_West_South_East.png
CROSS 13 Cross (accurate selection) Cross.png
CURSOR_COPY 14 Copy cursor Copy.png
CURSOR_FORBID 15 Forbid cursor Forbid.png
COLOR_SUCKER 16 Sucker Colorsucker.png
HAND_GRABBING 17 Grabbing hand Hand_Grabbing.png
HAND_OPEN 18 Opening hand Hand_Open.png
HAND_POINTING 19 Hand-shaped pointer Hand_Poniting.png
HELP 20 Help Help.png
MOVE 21 Move Move.png
RESIZE_LEFT_RIGHT 22 Left and right resizing Resize_Left_Right.png
RESIZE_UP_DOWN 23 Up and down resizing Resize_Up_Down.png
SCREENSHOT_CHOOSE 24 Screenshot crosshair Screenshot_Cross.png
SCREENSHOT_CURSOR 25 Screenshot cursor Screenshot_Cursor.png
TEXT_CURSOR 26 Text cursor Text_Cursor.png
ZOOM_IN 27 Zoom in Zoom_In.png
ZOOM_OUT 28 Zoom out Zoom_Out.png
MIDDLE_BTN_EAST 29 Scrolling east MID_Btn_East.png
MIDDLE_BTN_WEST 30 Scrolling west MID_Btn_West.png
MIDDLE_BTN_SOUTH 31 Scrolling south MID_Btn_South.png
MIDDLE_BTN_NORTH 32 Scrolling north MID_Btn_North.png
MIDDLE_BTN_NORTH_SOUTH 33 Scrolling north-south MID_Btn_North_South.png
MIDDLE_BTN_NORTH_EAST 34 Scrolling north-east MID_Btn_North_East.png
MIDDLE_BTN_NORTH_WEST 35 Scrolling north-west MID_Btn_North_West.png
MIDDLE_BTN_SOUTH_EAST 36 Scrolling south-east MID_Btn_South_East.png
MIDDLE_BTN_SOUTH_WEST 37 Scrolling south-west MID_Btn_South_West.png
MIDDLE_BTN_NORTH_SOUTH_WEST_EAST 38 Moving as a cone in four directions MID_Btn_North_South_West_East.png