/* Copyright (c) Citrix Systems Inc. * All rights reserved. * * Redistribution and use in source and binary forms, * with or without modification, are permitted provided * that the following conditions are met: * * * Redistributions of source code must retain the above * copyright notice, this list of conditions and the * following disclaimer. * * Redistributions in binary form must reproduce the above * copyright notice, this list of conditions and the * following disclaimer in the documentation and/or other * materials provided with the distribution. * * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND * CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, * INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF * MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, * WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF * SUCH DAMAGE. */ using System; using System.ComponentModel; using System.Drawing; using System.Windows.Forms; using XenAdmin.Actions; namespace XenAdmin.Dialogs { /// /// Monitors an AsyncAction, showing a progress bar and the action's Description. Shows the exception /// to the user if the Action fails, and waits for the user to click OK. Has a cancel button: make /// sure if enabled that the Action has sensible cancel behaviour. The cancel button is not shown by /// default. /// internal partial class ActionProgressDialog : XenDialogBase { public readonly AsyncAction action; private bool showTryAgain = true; private bool showCancel; /// /// Default value is false. /// public bool ShowCancel { get { return showCancel; } set { showCancel = value; buttonCancel.Visible = showCancel; } } private void HideTitleBarIcons() { ControlBox = false; MinimizeBox = false; MaximizeBox = false; } public ActionProgressDialog(String text) { InitializeComponent(); labelStatus.Text = text; labelSubActionStatus.Visible = false; progressBar1.Style = ProgressBarStyle.Marquee; ShowIcon = false; HideTitleBarIcons(); } public ActionProgressDialog(AsyncAction action, ProgressBarStyle progressBarStyle) { InitializeComponent(); this.action = action; action.Completed += action_Completed; action.Changed += action_Changed; progressBar1.Style = progressBarStyle; updateStatusLabel(); buttonCancel.Enabled = action.CanCancel; ShowIcon = false; HideTitleBarIcons(); } public ActionProgressDialog(AsyncAction action, ProgressBarStyle progressBarStyle, bool showTryAgain) : this(action, progressBarStyle) { this.showTryAgain = showTryAgain; } private void action_Changed(ActionBase sender) { Program.AssertOffEventThread(); if (Disposing || IsDisposed || Program.Exiting) return; action.RecomputeCanCancel(); Program.Invoke(this, action_Changed_); } private void action_Changed_() { Program.AssertOnEventThread(); progressBar1.Value = action.PercentComplete; updateStatusLabel(); buttonCancel.Enabled = action.CanCancel; } private void UpdateLabel(Label label, string description, string title) { label.Text = !string.IsNullOrEmpty(description) ? description : !string.IsNullOrEmpty(title) ? title : string.Empty; } private void updateStatusLabel() { UpdateLabel(labelStatus, action.Description, action.Title); UpdateSubActionStatusLabel(); } private void UpdateSubActionStatusLabel() { var multipleAction = action as MultipleAction; labelSubActionStatus.Visible = multipleAction != null && multipleAction.ShowSubActionsDetails; if (labelSubActionStatus.Visible) UpdateLabel(labelSubActionStatus, multipleAction.SubActionDescription, multipleAction.SubActionTitle); } private void action_Completed(ActionBase sender) { if (Disposing || IsDisposed || Program.Exiting) return; Program.Invoke(this, action_Completed_); } private void action_Completed_() { Program.AssertOnEventThread(); if (action.Succeeded || action.Cancelled) { this.Close(); return; } SwitchDialogToShowErrorState(); } private void SwitchDialogToShowErrorState() { this.SuspendLayout(); progressBar1.Visible = false; buttonCancel.Visible = false; buttonClose.Visible = true; CancelButton = buttonClose; ControlBox = true; ShowIcon = true; labelException.Visible = true; icon.Visible = true; icon.Image = SystemIcons.Error.ToBitmap(); labelBottom.Visible = showTryAgain; if (action.Exception == null) { labelException.Text = Messages.WIZARD_INTERNAL_ERROR; } else if (action.Exception is CancelledException) { labelException.Text = Messages.CANCELLED_BY_USER; } else { labelException.Text = action.Exception.Message; } this.ResumeLayout(); this.CenterToParent(); } protected override void OnShown(EventArgs e) { if (action != null) action.RunAsync(); base.OnShown(e); } private void buttonClose_Click(object sender, EventArgs e) { this.Close(); } public event EventHandler CancelClicked; private void buttonCancel_Click(object sender, EventArgs e) { buttonCancel.Enabled = false; if (CancelClicked != null) CancelClicked(sender, e); if (action != null) action.Cancel(); } private void buttonClose_VisibleChanged(object sender, EventArgs e) { if (buttonClose.Visible) buttonClose.Focus(); } } }