cascades文档翻译——HomeScreen

头文件：

#include <bb/platform/HomeScreen>

依赖库：

LIBS += -lbbplatform

提供功能：

更改壁纸，添加快捷方式，检查是否是床边模式。

属性：

bool	bedsideModeActive [read-only]是否是床边模式
bb::platform::DeviceLockState::Type	lockState [read-only]锁屏状态0未知；1未所屏；2屏幕被锁；3密码锁定；4PIN锁定
bb::platform::WallpaperLockState::Type	wallpaperLockState [read-only]壁纸锁定状态：0未知；1被锁定；2未被锁定。

方法：

HomeScreen (QObject *parent=0)
virtual	~HomeScreen ()
Q_INVOKABLE bool	addShortcut (const QUrl &iconPath, const QString &iconLabel, const QUrl &url) 添加快捷方式： 参数1：icon图标位置 参数2：快捷方式label 参数3：该快捷方式所指向目标的地址
bool	isBedsideModeActive () const检查是否床边模式
Q_INVOKABLEbb::platform::DeviceLockState::Type	lockState () const 获取锁屏状态
Q_INVOKABLE bool	setWallpaper (const QUrl &wallpaperFile) 设置壁纸， 参数：壁纸文件位置
bb::platform::WallpaperLockState::Type	wallpaperLockState () const 获取壁纸锁定状态

信号：

void	bedsideModeActiveChanged (bool newState)
void	lockStateChanged (bb::platform::DeviceLockState::Type newState)
void	wallpaperFinished (const QUrl &path, bb::platform::WallpaperResult::Type result)
void	wallpaperLockStateChanged(bb::platform::WallpaperLockState::Type wallpaperLockState)

qml例子：

// QML Plugin for libbbplatform

import bb.platform 1.0

 

import bb.cascades 1.0

 

Page {

    Container {

 

        // HomeScreen isn't a visible object so it must be wrapped as an

        // attached object.

        attachedObjects: [

            HomeScreen {

                id: myHomeScreen

            }

        ]

         

        Button {

            text: "Print Lock State"

             

            onClicked: {

                // Of course, you can't press the button on a locked screen so you'll

                // never see either of the locked states.

                if (myHomeScreen.lockState == DeviceLockState.Unknown) {

                    console.log("No idea");

                } else if (myHomeScreen.lockState == DeviceLockState.Unlocked) {

                    console.log("Unlocked");

                } else if (myHomeScreen.lockState == DeviceLockState.ScreenLocked) {

                    console.log("Screen locked");

                } else if (myHomeScreen.lockState == DeviceLockState.PasswordLocked) {

                    console.log("Password locked");

                } else if (myHomeScreen.lockState == DeviceLockState.PinBlocked) {

                    console.log("PIN blocked");

                }

            }

        }

         

        // Additional QML

    }

}

参考网页：https://developer.blackberry.com/native/reference/cascades/bb__platform__homescreen.html#property-wallpaperlockstate