ActionHandlerBase クラス

ユーザーが入力コントロールを操作したときに実行される処理を定義するための抽象基本クラス。

シンタックス

Visual Basic
C#

'宣言
 
Public MustInherit Class ActionHandlerBase

public abstract class ActionHandlerBase

解説

１つまたは複数の RenderInputBase 派生オブジェクトを含む C1PrintDocument が C1PrintPreviewControl などのサポートするビューアコントロールによって表示される場合、各 RenderInputBase オブジェクトは、対応するコントロールをドキュメントページ上に生成します。たとえば、RenderInputText は、ユーザーがテキストを入力できる textbox コントロールを生成し、 RenderInputButton は pushbutton を生成します。

ドキュメント内のそれらの入力コントロールの機能は「アクションハンドラ」を介して展開できます。アクションハンドラは、多くの .NET コンポーネントのイベントに割り当てられる C# または VB イベントハンドラに似ています。サポートされるイベントリストには、UserActionEnum 列挙体によって指定され、マウスの click、マウスの enter／leave、キーボードフォーカスの enter／leave、およびマウスの up／down のイベントが含まれます。

RenderInputBase 派生オブジェクト上のユーザーアクションにハンドラを作成してアタッチするには、以下の一般的な手順に従います。

ハイパーリンクジャンプやファイル操作など、実行する必要があるアクションに一致する具象タイプの ActionHandlerBase 派生クラスのインスタンスを作成します（それらのクラスには ActionHandlerLink、 ActionHandlerFileOpen、 ActionHandlerFileSave、 ActionHandlerPageSetup、 ActionHandlerPrint、 ActionHandlerReflow、 ActionHandlerPageView、 ActionHandlerHistoryPrev、および ActionHandlerHistoryNext が含まれます）。
それらのクラスの一部は、アクション固有のプロパティ（ActionHandlerFile.FileName など）を公開します。必要に応じて、それらのプロパティの値を調整します。
InputAction クラスのインスタンスを作成して、その InputAction.UserAction プロパティを希望のユーザーアクション（click またはフォーカスの enter など）を設定して、その InputAction.ActionHandler プロパティを先行の手順で作成された ActionHandlerBase インスタンスに設定します。
InputAction を RenderInputBase オブジェクトの RenderInputBase.InputActions コレクションに追加します。

複数の InputAction オブジェクトを単一の描画入力コントロールに関連付けることができることに注意してください。

使用例

次の例では、クリックされたときに現在のドキュメントの最終ページにジャンプするボタンをドキュメントに追加する方法を示します。

C1PrintDocument doc = new C1PrintDocument();
// 最終ページにジャンプするアクションハンドラを作成します。
ActionHandlerLink ahl = new ActionHandlerLink(new C1LinkTargetPage(PageJumpTypeEnum.Last));
// 入力アクションを作成して、そのプロパティを設定します。
InputAction ia = new InputAction();
ia.ActionHandler = ahl;
ia.UserAction = UserActionEnum.Click;
// ボタンを作成して、入力アクションをそのアクションに追加します。
RenderInputButton rbtn = new RenderInputButton("Jump to last page");
rbtn.InputActions.Add(ia);
// ボタンをドキュメントに追加します。
doc.Body.Children.Add(rbtn);
// その他のコンテンツをドキュメントに追加します。

継承階層

System.Object
   C1.C1Preview.ActionHandlerBase
      C1.C1Preview.ActionHandlerFile
      C1.C1Preview.ActionHandlerHistoryNext
      C1.C1Preview.ActionHandlerHistoryPrev
      C1.C1Preview.ActionHandlerLink
      C1.C1Preview.ActionHandlerPageSetup
      C1.C1Preview.ActionHandlerPageView
      C1.C1Preview.ActionHandlerPrint
      C1.C1Preview.ActionHandlerReflow

参照

ActionHandlerBase メンバ
 C1.C1Preview 名前空間