cascades文档翻译——HomeScreen

翻译于 2013-08-15 17:12:20 发布 · 1.6k 阅读

文章标签：

#cascades #BlackBerry 10

移动开发专栏收录该内容

26 篇文章

订阅专栏

本文详细介绍了黑莓平台HomeScreen组件的功能和使用方法，包括更改壁纸、添加桌面快捷方式及检查床边模式等特性。同时提供了组件的属性介绍、方法调用示例以及QML示例代码。

头文件：

#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
     
      }
     
      }