system.setPreferences()

类型 函数
库 system.*
返回值 布尔值
修订 版本 2024.3703
关键词 系统偏好设置, setPreferences
另请参阅 system.getPreference()
system.deletePreferences()

概述

将一个偏好设置值的表写入存储。如果给定的任何偏好设置在存储中不存在，则将插入它们。如果给定的任何偏好设置已存在于存储中，则将覆盖它们。

如果**所有**给定的偏好设置都已成功写入存储，则返回 `true`。如果至少一个给定的偏好设置未能写入存储，则返回 `false`。

注意事项

语法

system.setPreferences( category, preferences )
category (必填)

字符串。 指示应在系统上访问哪一组偏好设置。目前，仅支持 `“app”` 类别 — 这是 Corona 应用程序开发者定义的应用程序自定义偏好设置。

preferences (必填)

表。 要写入存储的偏好设置表。此表应包含键值对，其中键是偏好设置的唯一名称，其值可以是布尔值、数字或字符串。

示例

-- Write this app's custom preferences to storage
local appPreferences =
{
    myBoolean = true,
    myNumber = 123.45,
    myString = "Hello World"
}
system.setPreferences( "app", appPreferences )

-- Read the preferences that were written to storage above
local myBoolean = system.getPreference( "app", "myBoolean", "boolean" )
local myNumber = system.getPreference( "app", "myNumber", "number" )
local myString = system.getPreference( "app", "myString", "string" )