ColorBuilder.BuildColor(IComponent, Control, String) Method

Definition

Namespace:

System.Web.UI.Design

Assembly:

System.Design.dll

Starts a color editor to build an HTML color property value.

public:
 static System::String ^ BuildColor(System::ComponentModel::IComponent ^ component, System::Windows::Forms::Control ^ owner, System::String ^ initialColor);

public static string BuildColor (System.ComponentModel.IComponent component, System.Windows.Forms.Control owner, string initialColor);

static member BuildColor : System.ComponentModel.IComponent * System.Windows.Forms.Control * string -> string

Public Shared Function BuildColor (component As IComponent, owner As Control, initialColor As String) As String

Parameters

component

IComponent

The IComponent whose site is to be used to access design-time services.

owner

Control

The Control used to parent the picker window.

initialColor

String

The initial color to be shown in the picker window, in a valid HTML color format.

Returns

String

The color value, represented as a string in an HTML color format, or null if the builder service could not be retrieved.

Examples

// Create a parent control.
System::Windows::Forms::Control^ c = gcnew System::Windows::Forms::Control;
c->CreateControl();

// Launch the Color Builder using the specified control
// parent and an initial HTML format (S"RRGGBB") color String*.
System::Web::UI::Design::ColorBuilder::BuildColor( this->Component, c, "405599" );

// Create a parent control.
System.Windows.Forms.Control c = new System.Windows.Forms.Control();            
c.CreateControl();            

// Launch the Color Builder using the specified control 
// parent and an initial HTML format ("RRGGBB") color string.
System.Web.UI.Design.ColorBuilder.BuildColor(this.Component, c, "405599");

' Create a parent control.
Dim c As New System.Windows.Forms.Control()
c.CreateControl()

' Launch the Color Builder using the specified control 
' parent and an initial HTML format ("RRGGBB") color string.
System.Web.UI.Design.ColorBuilder.BuildColor(Me.Component, c, "405599")

Remarks

The returned string, if other than null, indicates a color in a valid HTML color format. Valid formats include named colors and color codes in RGB format (#RRGGBB).