DestroyOnClose Property

If True the toolbar will be destroyed when the tearaway floating window is closed.

Syntax

Visual Basic

'Declaration
 
Public Property DestroyOnClose As Boolean

C#

public bool DestroyOnClose {get; set;}

Example

The following code demonstrates how to access the information passed in the event arguments of the TearawayToolbarCreated event and conditionally set a value that will destroy the toolbar when it is closed by the user.

For an overview of how to handle events in Visual Basic or Visual C#, see Event Handlers in Visual Basic and Visual C#. For specific information and code examples illustrating how to consume events in your application, see Consuming Events in the .NET Framework Developer's Guide.

Visual Basic

Imports System.Diagnostics
Imports Infragistics.Win
Imports Infragistics.Win.UltraWinToolbars

	Private Sub UltraToolbarsManager1_TearawayToolbarCreated(ByVal sender As Object, ByVal e As Infragistics.Win.UltraWinToolbars.TearawayToolbarCreatedEventArgs) Handles UltraToolbarsManager1.TearawayToolbarCreated

		Dim dr As DialogResult = MessageBox.Show(Me, "The toolbar with key '" + e.Toolbar.Key + "' has been torn away. Do you want to destory the toolbar when it is closed?", "Cancelable Toolbar Event", MessageBoxButtons.YesNo)

		e.DestroyOnClose = (dr = DialogResult.Yes)

	End Sub

C#

using System.Diagnostics;
using Infragistics.Win;
using Infragistics.Win.UltraWinToolbars;

		private void ultraToolbarsManager1_TearawayToolbarCreated(object sender, Infragistics.Win.UltraWinToolbars.TearawayToolbarCreatedEventArgs e)
		{

			DialogResult dr =  MessageBox.Show(this, "The toolbar with key '" + e.Toolbar.Key + "' has been torn away. Do you want to destory the toolbar when it is closed?", "Cancelable Toolbar Event", MessageBoxButtons.YesNo);

			e.DestroyOnClose =  (dr == DialogResult.Yes);

		}

Requirements

Target Platforms: Windows 10, Windows 8.1, Windows 8, Windows 7, Windows Server 2012, Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2