WizardPage Classe

Referência

Definição

Namespace:: Microsoft.Web.Management.Client.Win32

Assembly:: Microsoft.Web.Management.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Fornece a classe base para páginas do assistente mostradas em um WizardForm objeto .

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

Herança: UserControl
WizardPage

Exemplos

O exemplo a seguir implementa vários dos métodos e propriedades da WizardPage classe . Este exemplo cria uma das três páginas do assistente contidas no WizardForm objeto . A primeira página do assistente exibe caixas de texto de nome de usuário e senha que têm um botão Enviar para permitir que o usuário envie as credenciais para validação antes de passar para a próxima página do assistente.

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);
        }
    }
}

Comentários

Como essa classe é abstrata, você não pode criar uma instância dela diretamente.

Você pode derivar uma página da WizardPage classe e adicionar controles para fornecer funcionalidades específicas (por exemplo, você pode adicionar caixas de texto para credenciais de usuário em uma página do assistente de logon). As páginas derivadas do assistente são exibidas em um WizardForm objeto . Você pode colocar controles como ManagementGroupBox ManagementPanel, e ManagementTabPage objetos na página do assistente.

Construtores

WizardPage()

Inicializa uma nova instância da classe WizardPage.

Propriedades

CanNavigateNext	Obtém um valor que indica se o usuário pode passar para a próxima página do assistente.
CanNavigatePrevious	Quando substituído em uma classe derivada, obtém um valor que indica se o usuário pode mover para a página anterior do assistente.
CanShowHelp	Quando substituído em uma classe derivada, obtém um valor que indica se o ShowHelp() método tem suporte.
Caption	Obtém ou define a legenda de um formulário, página do assistente ou outro objeto.
CreateParams	Obtém os parâmetros de criação necessários quando a página do assistente é criada.
Description	Obtém ou define a descrição de um formulário, página do assistente ou outro objeto.
NextPage	Quando substituído em uma classe derivada, obtém a próxima página do assistente.
Pages	Obtém a IList interface que contém a coleção de páginas no assistente.
PreviousPage	Quando substituído em uma classe derivada, obtém a página anterior do assistente.
RightToLeftLayout	Obtém ou define um valor que indica se o posicionamento do espelho da direita para a esquerda está habilitado.
ServiceProvider	Obtém o provedor de serviços para o formulário do assistente que contém esta página.
Wizard	Obtém o formulário do assistente que contém esta página do assistente.
WizardData	Obtém as informações do assistente.

Métodos

Activate()	Quando substituído em uma classe derivada, indica que o formulário foi carregado pela primeira vez
GetService(Type)	Obtém o objeto de serviço associado ao tipo especificado.
OnNext()	Quando substituído em uma classe derivada, fornece um mecanismo para passar para a próxima página do assistente.
OnPrevious()	Quando substituído em uma classe derivada, fornece um mecanismo para mover para a página anterior no assistente.
OnRightToLeftChanged(EventArgs)	Fornece um mecanismo para executar uma ação quando a RightToLeftLayout propriedade é alterada.
ShowError(Exception, String, Boolean)	Exibe a exceção especificada e as informações sobre a exceção.
ShowHelp()	Quando substituído em uma classe derivada, fornece um mecanismo para exibir o arquivo de Ajuda do assistente.
ShowMessage(String)	Exibe uma caixa de mensagem que usa o texto especificado.
ShowMessage(String, MessageBoxButtons, MessageBoxIcon, MessageBoxDefaultButton)	Exibe uma caixa de mensagem que usa o texto, o conjunto de botões, o símbolo e o botão padrão especificados.
UpdateWizard()	Fornece um mecanismo para atualizar a exibição do assistente.

Aplica-se a

Compartilhar via