LocalNotifications 外部オブジェクトを使用すると、アプリケーションは、スケジュール設定したイベントやアラームについて、バックグラウンドでユーザーに通知できます。サーバーを介する必要はありません。

適用範囲

プロパティ

なし

メソッド

CreateAlerts メソッド

トリガーされるタイミングと表示されるテキストを指定して、ローカル通知 (または警告) のセットを作成します。操作が正常に終了すると 0 を返します。

ListAlerts メソッド

事前に作成したローカル通知 (または警告) を一覧表示します。

RemoveAlerts メソッド

ローカル通知 (または警告) のセットを削除します。各通知は、トリガーされたタイムスタンプとテキストで特定されます。操作が正常に終了すると 0 を返します。

RemoveAllAlerts メソッド

すべてのローカル通知 (または警告) をデバイスから削除します。操作が正常に終了すると 0 を返します。

イベント

なし
 

LocalNotificationsInfo 構造化データタイプ

LocalNotifications 外部オブジェクトに加えて、LocalNotificationsInfo 構造化データタイプ (SDT) を使用してローカル通知の設定を定義します。

これはアイテムのコレクションであり、それぞれが以下を含みます:

• DateTime:DateTime データタイプ
  ローカル通知がトリガーされる時間を示します。このフィールドを設定しない (空のままにする) 場合、通知はすぐにトリガーされます。
   
• Text:VarChar(128)
  ローカル通知としてユーザーに表示されるテキストが格納されます。
   
• Event: ユーザーがローカル通知を操作するときに実行されるイベントを定義することができます。
  
  • Name: VarChar(40)
    実行するイベントの名前です。
     
  • Parameters: イベントがパラメーターを必要とする場合に、パラメーターを定義できます。
    
    • Item: 
      • Name: VarChar(40)
      • Value: VarChar(128)

ローカル通知は必要な数だけいくつでも定義できます。LocalNotificationsInfo コレクションの 1 つが 1 件のローカル通知に対応します。

例

[ Main program ] プロパティ が True に設定された Panel オブジェクトがあるとします。 
パネルレイアウトには、'NotificationEvent' イベントに関連付けられたボタンが含まれています:

Event 'NotificationEvent'
 Composite
   &AlertDateTime = Now()
   &AlertDateTime = &AlertDateTime.AddSeconds(10)        
   &LocalNotItem = New() //通知を作成
   &LocalNotItem.DateTime = &AlertDateTime
   &LocalNotItem.Text = !'You have a new notification'
   &LocalNotItem.Event.Name = "EventCallType"   //呼び出されるイベントの名前パネルで定義されている必要がある。
   &localNotEventsParameters.Name = "callParam" //パネルで定義され、呼び出されるイベントで使用される変数名
   &localNotEventsParameters.Value = "PopUp"    //前の変数名に割り当てられる値。
   &LocalNotItem.Event.Parameters.Add(&LocalNotEventsParameters)
   &LocalNotInfo.Add(&LocalNotItem)
 EndComposite
Endevent

Event "EventCallType"
 Composite 
    InfoPanel.CallOptions.Type = &callParam //&callParam の値は "Popup"
    InfoPanel.Call(&callParam)              //パネルは、パラメーターとして選択した CallOptions タイプで呼び出される
 EndComposite
EndEvent

パネルボタンをタップすると、'NotificationEvent' イベントが実行されます。このイベントは、LocalNotificationsInfo SDT に基づく変数をロードします。つまり、EventCallType イベントは、指示された (&AlertDateTime が割り当てられた) ときに実行されます。この例では、EventCallType イベントがポップアップモードでパネル (InfoPanel) を呼び出します。

参考情報

ネイティブ モバイル アプリケーションで LocalNotifications 外部オブジェクトを使用する方法
ネイティブ モバイル アプリケーションのプッシュ通知 (サーバーが必要)