Vcl.Forms.TApplication.OnActionUpdate

提供:RAD Studio API Documentation


Delphi

property OnActionUpdate: TActionEvent read FOnActionUpdate write FOnActionUpdate;

C++

__property System::Classes::TActionEvent OnActionUpdate = {read=FOnActionUpdate, write=FOnActionUpdate};

プロパティ

種類 可視性 ソース ユニット 親
event public
Vcl.Forms.pas
Vcl.Forms.hpp
Vcl.Forms TApplication


説明

アクションの Update メソッドが呼び出され、かつ、そのアクション リストがまだ処理されていないときに発生します。

OnActionUpdate イベント ハンドラを使用すると、アクションのアクション リストが OnUpdate イベント ハンドラでアクションを処理しない場合、アプリケーションがアイドルの際に、アクションのプロパティを更新することができます。

アクションを含むアクション リストが、アクションを OnUpdate イベント ハンドラ内で更新しなかった場合、そのアクションはアプリケーション オブジェクトの UpdateAction メソッドに渡され、そのメソッドは OnActionUpdate イベント ハンドラを呼び出します。 (アプリケーションの UpdateAction メソッドは、アプリケーション内のすべてのアクションに適用されます。)

イベント ハンドラの Handled パラメータは、デフォルトでは、false を返します。 ハンドラがイベントを更新した場合は、Handled を true に変え、アクションの処理を終了させる必要があります。Handled が false の状態でイベント ハンドラが終了すると、アクションの OnUpdate イベントが発生します。 アクションがその後も更新されなかった場合、アクティブ コントロールの UpdateAction メソッドが呼び出され、ターゲットでアクションを更新できるようにします。 最後に、他のどのハンドラもアクションを処理しなかった場合、アクティブ フォームの UpdateAction メソッドが呼び出されます。

メモ: OnActionUpdate は、アプリケーションの OnIdle イベントの後に発生します。

メモ: TApplicationEvents コンポーネントを使用してもこのイベントに応答することができ、その場合 IDE を使用してイベント ハンドラを割り当てることができます。

関連項目

コード サンプル