WizardPage クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
オブジェクトに表示されるウィザード ページの基本クラスを WizardForm 提供します。
public ref class WizardPage abstract : System::Windows::Forms::UserControl
public abstract class WizardPage : System.Windows.Forms.UserControl
type WizardPage = class
inherit UserControl
Public MustInherit Class WizardPage
Inherits UserControl
- 継承
-
WizardPage
例
次の例では、 クラスのいくつかのメソッドとプロパティを WizardPage 実装しています。 次の使用例は、 オブジェクトに WizardForm 含まれる 3 つのウィザード ページのいずれかを作成します。 最初のウィザード ページには、[ 送信] ボタンがあるユーザー名とパスワードのテキスト ボックスが表示され、ユーザーは次のウィザード ページに移動する前に検証のために資格情報を送信できます。
using System;
using System.Collections.Generic;
using System.ComponentModel;
using System.Drawing;
using System.Data;
using System.Text;
using System.Windows.Forms;
using Microsoft.Web.Management.Client;
using Microsoft.Web.Management.Client.Win32;
namespace ExtensibilityDemo
{
public partial class DemoModuleWizardLoginPage : WizardPage
{
bool _canNavigateNext = false;
public DemoModuleWizardLoginPage()
{
InitializeComponent();
}
// Activate is called upon initial load.
protected override void Activate()
{
Description = this.Name;
}
// This is the login page. You can navigate to the next page,
// after the user is validted. Set initially to false.
protected override bool CanNavigateNext
{
get
{
return _canNavigateNext;
}
}
// Customize the CanNavigateNext property. This property
// is set to false until the user is validated.
private void button1_Click(object sender, EventArgs e)
{
// Perform user validation checks. If this is a valid
// user move to the next page. If the user is not a valid
// user, exit the application.
// User validation.
string text = "Did the user pass validation?";
MessageBoxButtons buttons = MessageBoxButtons.YesNo;
MessageBoxIcon icon = MessageBoxIcon.Information;
MessageBoxDefaultButton defaultButton = MessageBoxDefaultButton.Button2;
DialogResult result = ShowMessage(text, buttons, icon, defaultButton);
if (result == DialogResult.No)
{
Application.Exit();
}
else
{
_canNavigateNext = true;
this.UpdateWizard();
ShowHelp();
}
}
// Customize the CanShowHelp method.
public new bool CanShowHelp
{
get
{
return true;
}
}
// Customize the ShowHelp method.
public new void ShowHelp()
{
// Check to determine if the CanShowHelp will
// allow help to be shown.
if (CanShowHelp)
{
// Show the help file.
Help.ShowHelp(this, "D:/minint/Microsoft.NET/framework/1033/admin.chm");
// Alternatively, use the folllowing to navigate to Tech Net.
//Help.ShowHelp(null, "http://www.technet.com");
}
}
protected new DialogResult ShowMessage(string text,
MessageBoxButtons buttons,
MessageBoxIcon icon,
MessageBoxDefaultButton defaultButton)
{
return base.ShowMessage(text + " Yes or No.", buttons, icon, defaultButton);
}
}
}
using System;
using System.Collections.Generic;
using System.ComponentModel;
using System.Drawing;
using System.Data;
using System.Text;
using System.Windows.Forms;
using Microsoft.Web.Management.Client;
using Microsoft.Web.Management.Client.Win32;
namespace ExtensibilityDemo
{
public partial class DemoModuleWizardModificationPage : WizardPage
{
private string _caption;
private bool _rightToLeftLayout=false;
private string _description;
public DemoModuleWizardModificationPage()
{
InitializeComponent();
}
protected override void Activate()
{
_description = this.Name;
_caption = "Original Caption";
this.button4.Text = "Change R to L Layout : currently " + RightToLeft.ToString();
}
// This is the modificationpage page. You can navigate to the previous page.
protected override bool CanNavigatePrevious
{
get
{
return true;
}
}
// Customize the Caption Property.
public new string Caption
{
get
{
return _caption;
}
set
{
_caption = value;
}
}
// Customize the Description Property.
public new string Description
{
get
{
return _description;
}
set
{
_description = value;
}
}
// The Caption button is clicked.
private void button2_Click(object sender, EventArgs e)
{
Caption = "Caption Modified";
}
// The Description button is clicked.
private void button3_Click(object sender, EventArgs e)
{
Description = Caption.ToString();
this.Wizard.TaskCaption = Description;
}
// Customize the RightToLeftLayout property.
public new bool RightToLeftLayout
{
get
{
return _rightToLeftLayout;
}
set
{
_rightToLeftLayout = value;
}
}
// The Right to Left button is clicked.
private void button4_Click(object sender, EventArgs e)
{
if(RightToLeftLayout)
{
RightToLeft = RightToLeft.No;
}
else
{
RightToLeft = RightToLeft.Yes;
}
RightToLeftLayout = !RightToLeftLayout;
}
// The RightToLeft method was called.
protected override void OnRightToLeftChanged(EventArgs e)
{
this.button4.Text = "Change R to L Layout : currently " + RightToLeft.ToString();
base.OnRightToLeftChanged(e);
}
}
}
注釈
このクラスは抽象であるため、そのインスタンスを直接作成することはできません。
クラスからページを WizardPage 派生させ、特定の機能を提供するコントロールを追加できます (たとえば、ログオン ウィザード ページでユーザー資格情報のテキスト ボックスを追加できます)。 派生ウィザード ページがオブジェクトに WizardForm 表示されます。 、、および ManagementTabPage オブジェクトなどのManagementGroupBoxManagementPanelコントロールをウィザード ページに配置できます。
コンストラクター
WizardPage() |
WizardPage クラスの新しいインスタンスを初期化します。 |
プロパティ
CanNavigateNext |
ユーザーが次のウィザード ページに移動できるかどうかを示す値を取得します。 |
CanNavigatePrevious |
派生クラスでオーバーライドされると、ユーザーが前のウィザード ページに移動できるかどうかを示す値を取得します。 |
CanShowHelp |
派生クラスでオーバーライドされると、メソッドがサポートされているかどうかを示す値を ShowHelp() 取得します。 |
Caption |
フォーム、ウィザード ページ、またはその他のオブジェクトのキャプションを取得または設定します。 |
CreateParams |
ウィザード ページの作成時に必要な作成パラメーターを取得します。 |
Description |
フォーム、ウィザード ページ、またはその他のオブジェクトの説明を取得または設定します。 |
NextPage |
派生クラスでオーバーライドされると、ウィザードの次のページを取得します。 |
Pages |
ウィザード内の IList ページのコレクションを含むインターフェイスを取得します。 |
PreviousPage |
派生クラスでオーバーライドされると、ウィザードの前のページを取得します。 |
RightToLeftLayout |
右から左へのミラー配置が有効かどうかを示す値を取得または設定します。 |
ServiceProvider |
このページを含むウィザード フォームのサービス プロバイダーを取得します。 |
Wizard |
このウィザード ページを含むウィザード フォームを取得します。 |
WizardData |
ウィザードの情報を取得します。 |
メソッド
Activate() |
派生クラスでオーバーライドされた場合、フォームが初めて読み込まれたことを示します |
GetService(Type) |
指定した型に関連付けられているサービス オブジェクトを取得します。 |
OnNext() |
派生クラスでオーバーライドされると、ウィザードの次のページに移動するメカニズムが提供されます。 |
OnPrevious() |
派生クラスでオーバーライドされると、ウィザードの前のページに移動するメカニズムが提供されます。 |
OnRightToLeftChanged(EventArgs) |
プロパティが変更されたときにアクションを実行するメカニズムを RightToLeftLayout 提供します。 |
ShowError(Exception, String, Boolean) |
指定した例外と例外に関する情報を表示します。 |
ShowHelp() |
派生クラスでオーバーライドされると、ウィザードのヘルプ ファイルを表示するメカニズムが提供されます。 |
ShowMessage(String) |
指定したテキストを使用するメッセージ ボックスを表示します。 |
ShowMessage(String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton) |
指定したテキスト、ボタン セット、シンボル、および既定のボタンを使用するメッセージ ボックスを表示します。 |
UpdateWizard() |
ウィザードの表示を更新するメカニズムを提供します。 |