ISupportInitialize Interface

 
System_CAPS_noteNote

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

Specifies that this object supports a simple, transacted notification for batch initialization.

Namespace:   System.ComponentModel
Assembly:  System (in System.dll)

public interface class ISupportInitialize

NameDescription
System_CAPS_pubmethodBeginInit()

Signals the object that initialization is starting.

System_CAPS_pubmethodEndInit()

Signals the object that initialization is complete.

ISupportInitialize allows controls to optimize multiple property assignments. As a result, you can initialize co-dependent properties or batch set multiple properties at design time.

Call the BeginInit method to signal the object that initialization is starting. Call the EndInit method to signal that initialization is complete.

The following code example demonstrates how to use the ISupportInitialize interface to initialize three TrackBar controls.

(dynamic_cast<System::ComponentModel::ISupportInitialize^>(this->trackBar1))->BeginInit();
(dynamic_cast<System::ComponentModel::ISupportInitialize^>(this->trackBar2))->BeginInit();
(dynamic_cast<System::ComponentModel::ISupportInitialize^>(this->trackBar3))->BeginInit();
this->SuspendLayout();

// 
// trackBar1
// 
this->trackBar1->Location = System::Drawing::Point( 160, 400 );
this->trackBar1->Name = "trackBar1";
this->trackBar1->TabIndex = 1;
this->trackBar1->Scroll += gcnew System::EventHandler( this, &Form1::trackBar_Scroll );

// 
// trackBar2
// 
this->trackBar2->Location = System::Drawing::Point( 608, 40 );
this->trackBar2->Name = "trackBar2";
this->trackBar2->TabIndex = 2;
this->trackBar2->Scroll += gcnew System::EventHandler( this, &Form1::trackBar_Scroll );

// 
// trackBar3
// 
this->trackBar3->Location = System::Drawing::Point( 56, 40 );
this->trackBar3->Name = "trackBar3";
this->trackBar3->TabIndex = 3;
this->trackBar3->Scroll += gcnew System::EventHandler( this, &Form1::trackBar_Scroll );
(dynamic_cast<System::ComponentModel::ISupportInitialize^>(this->trackBar1))->EndInit();
(dynamic_cast<System::ComponentModel::ISupportInitialize^>(this->trackBar2))->EndInit();
(dynamic_cast<System::ComponentModel::ISupportInitialize^>(this->trackBar3))->EndInit();

.NET Framework
Available since 1.1
Silverlight
Available since 4.0
Windows Phone Silverlight
Available since 7.1
Return to top
Show: