LocalNotifications 外部オブジェクトを使用すると、アプリケーションは、スケジュール設定したイベントやアラームについて、バックグラウンドでユーザーに通知できます。サーバーを介する必要はありません。
なし
トリガーされるタイミングと表示されるテキストを指定して、ローカル通知 (または警告) のセットを作成します。操作が正常に終了すると 0 を返します。
戻り値 |
Numeric(5.0) |
パラメーター |
alerts:LocalNotificationsInfo |
ListAlerts メソッド
事前に作成したローカル通知 (または警告) を一覧表示します。
戻り値 |
LocalNotificationsInfo |
パラメーター |
なし |
RemoveAlerts メソッド
ローカル通知 (または警告) のセットを削除します。各通知は、トリガーされたタイムスタンプとテキストで特定されます。操作が正常に終了すると 0 を返します。
戻り値 |
Numeric(5.0) |
パラメーター |
alerts:LocalNotificationsInfo |
RemoveAllAlerts メソッド
すべてのローカル通知 (または警告) をデバイスから削除します。操作が正常に終了すると 0 を返します。
戻り値 |
Numeric(5.0) |
パラメーター |
なし |
イベント
なし
LocalNotifications 外部オブジェクトに加えて、LocalNotificationsInfo
構造化データタイプ (SDT) を使用してローカル通知の設定を定義します。
これはアイテムのコレクションであり、それぞれが以下を含みます:
- DateTime:DateTime データタイプ
ローカル通知がトリガーされる時間を示します。このフィールドを設定しない (空のままにする) 場合、通知はすぐにトリガーされます。
- Text:VarChar(128)
ローカル通知としてユーザーに表示されるテキストが格納されます。
- Event:
ユーザーがローカル通知を操作するときに実行されるイベントを定義することができます。
- Name: VarChar(40)
実行するイベントの名前です。
- Parameters:
イベントがパラメーターを必要とする場合に、パラメーターを定義できます。
ローカル通知は必要な数だけいくつでも定義できます。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 外部オブジェクトを使用する方法
ネイティブ モバイル アプリケーションのプッシュ通知 (サーバーが必要)