native.setProperty()

类型 函数
native.*
返回值
修订 版本 2024.3703
关键词 native 属性
另请参阅 native.getProperty()

概述

设置平台特定的属性。

语法

native.setProperty( key, value )
(必需)

字符串. 将更改其值的属性。支持的键包括

  • "androidSystemUiVisibility" — 仅限 Android;有关允许的 value 选项,请参阅下面的 androidSystemUiVisibility
  • "applicationIconBadgeNumber" — 仅限 iOS;指定一个 整数
  • "applicationSupportsShakeToEdit" — 仅限 iOS;为 value 指定一个 布尔值
  • "networkActivityIndicatorVisible" — 仅限 iOS;为 value 指定一个 布尔值
  • "prefersHomeIndicatorAutoHidden" — 仅限 iOS;为 value 指定一个 布尔值。如果设置,iPhone X 软件主页指示器将在屏幕未交互时自动隐藏。
  • "windowMode" — 仅适用于 macOS 桌面和 Win32 桌面应用程序;设置窗口模式。支持的值包括 "normal"(正常)、"minimized"(最小化)、"maximized"(最大化)或 "fullscreen"(全屏)。默认为 "normal"
  • "windowSize" — 仅适用于 macOS 桌面和 Win32 桌面应用程序;设置窗口宽度和/或高度。指定一个包含 width 和/或 height 值的
  • "windowTitleText" — 仅适用于 macOS 桌面和 Win32 桌面应用程序;将窗口的标题栏文本设置为指定的 字符串
  • "mouseCursor" — 仅适用于 macOS 桌面和 Win32 桌面应用程序。为应用程序窗口设置平台提供的鼠标光标之一。为 value 指定一个 字符串
  • "mouseCursorVisible" — 仅适用于 macOS 桌面和 Win32 桌面应用程序。显示或隐藏鼠标光标悬停在应用程序窗口上时。为 value 指定一个 布尔值
  • "preferredScreenEdgesDeferringSystemGestures" — 仅限 iOS;为 value 指定一个 布尔值。如果设置,系统手势(控制中心、通知栏等)不会立即生效,而是需要额外滑动才能激活。尽可能将此设置保留为默认值 false,但这对于防止在滑动频繁的游戏中意外激活系统手势很有用。
(必需)

数字字符串布尔值. 要将指定属性设置到的值,由 key 表示。

androidSystemUiVisibility

仅适用于 Android 和 Fire OS 设备。如果 Android 版本不支持该值,则不会发生任何事情。

  • "immersiveSticky" — 仅限 Android KitKat (Api 19) 及更高版本 **或** Fire OS 2(API 15 的分支)及更高版本。在 Android KitKat 及更高版本或 Fire OS 4 及更高版本上,它将导致状态栏和导航栏消失,然后,如果用户从顶部或底部滑动,它们将重新出现然后再次消失。在 Fire OS 2 或 3 上,状态栏和 软按键栏 将被隐藏,并且不会根据任何滑动操作而改变。
  • "immersive" — 仅限 Android KitKat (Api 19) 及更高版本 **或** Fire OS 2(API 15 的分支)及更高版本。在 Android KitKat 及更高版本或 Fire OS 4 及更高版本上,它将导致状态栏和导航栏消失,然后,如果用户从顶部或底部滑动,它们将重新出现并保持显示 — 在这种情况下,将触发 resize 事件,并且需要手动重新渲染屏幕上的对象(这是因为设备的内容缩放比例发生了变化,除非移除并恢复对象,否则对象将没有正确的纵横比)。在 Fire OS 2 或 3 上,它与 "immersiveSticky" 的效果相同。
  • "lowProfile" — 仅限 Android Ice Cream Sandwich (Api 14) 或更高版本。使导航栏图标变暗。
  • "default" — 重置值。

示例

图标徽章数字
-- Sets application icon badge number to 10 (iOS only)
native.setProperty( "applicationIconBadgeNumber", 10 )
Android 系统 UI 可见性
-- Sets system UI visibility (Android KitKat or above)
native.setProperty( "androidSystemUiVisibility", "immersiveSticky" )
窗口模式
-- Sets the window mode (Win32 desktop and macOS desktop apps only)
native.setProperty( "windowMode", "maximized" )
窗口标题
-- Sets the window title text (Win32 desktop and macOS desktop apps only)
native.setProperty( "windowTitleText", "Window Title Test" )
鼠标光标
-- Sets a platform-provided mouse cursor for the window
native.setProperty( "mouseCursor", "arrow" )

-- Win32 cursors: appStarting, arrow, crosshair, pointingHand, beam, notAllowed, resizeAll, resizeNorthEastSouthWest, resizeUpDown, resizeNorthWestSouthEast, resizeLeftRight, upArrow, hourglass

-- macOS cursors: arrow, closedHand, openHand, pointingHand, crosshair, notAllowed, beam, resizeRight, resizeLeft, resizeLeftRight, resizeUp, resizeDown, resizeUpDown, disappearingItem, beamHorizontal, dragLink, dragCopy, contextMenu