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