ColorDialog.AnyColor Propriété
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Obtient ou définit une valeur indiquant si la boîte de dialogue affiche toutes les couleurs disponibles dans le jeu de couleurs de base.
public:
virtual property bool AnyColor { bool get(); void set(bool value); };
public virtual bool AnyColor { get; set; }
member this.AnyColor : bool with get, set
Public Overridable Property AnyColor As Boolean
Valeur de propriété
true
si la boîte de dialogue affiche toutes les couleurs disponibles dans le jeu de couleurs de base ; sinon, false
. La valeur par défaut est false
.
Exemples
L’exemple de code suivant illustre l’initialisation d’un ColorDialog paramètre les AnyColorpropriétés , AllowFullOpen . ne ColorDialog permet pas à l’utilisateur de définir une couleur personnalisée, mais il permet d’afficher l’ensemble complet des couleurs de base. Lorsque vous définissez la SolidColorOnly propriété sur false
, elle permet l’affichage des couleurs qui sont des combinaisons d’autres couleurs sur les systèmes avec 256 couleurs ou moins. L’exemple montre également la définition de la propriété et la ShowHelp gestion d’un HelpRequest événement pour une boîte de dialogue. Pour exécuter l’exemple, collez le code suivant dans un formulaire et appelez la InitializeColorDialog
méthode dans le constructeur ou Load
la méthode du formulaire. Cet exemple nécessite que l’événement Click
du bouton soit connecté à la méthode de gestionnaire d’événements définie dans l’exemple.
// This method initializes ColorDialog1 to allow any colors,
// and combination colors on systems with 256 colors or less,
// but will not allow the user to set custom colors. The
// dialog will contain the help button.
void InitializeColorDialog()
{
this->ColorDialog1 = gcnew System::Windows::Forms::ColorDialog;
this->ColorDialog1->AllowFullOpen = false;
this->ColorDialog1->AnyColor = true;
this->ColorDialog1->SolidColorOnly = false;
this->ColorDialog1->ShowHelp = true;
// Associate the event-handling method with
// the HelpRequest event.
this->ColorDialog1->HelpRequest +=
gcnew System::EventHandler( this, &Form1::ColorDialog1_HelpRequest );
}
// This method opens the dialog and checks the DialogResult value.
// If the result is OK, the text box's background color will be changed
// to the user-selected color.
void Button1_Click( System::Object^ sender, System::EventArgs^ e )
{
::DialogResult result = ColorDialog1->ShowDialog();
if ( result == ::DialogResult::OK )
{
TextBox1->BackColor = ColorDialog1->Color;
}
}
// This method is called when the HelpRequest event is raised,
//which occurs when the user clicks the Help button on the ColorDialog object.
void ColorDialog1_HelpRequest( Object^ sender, System::EventArgs^ e )
{
MessageBox::Show( "Please select a color by clicking it. " +
"This will change the BackColor property of the TextBox." );
}
// This method initializes ColorDialog1 to allow any colors,
// and combination colors on systems with 256 colors or less,
// but will not allow the user to set custom colors. The
// dialog will contain the help button.
private void InitializeColorDialog()
{
this.ColorDialog1 = new System.Windows.Forms.ColorDialog();
this.ColorDialog1.AllowFullOpen = false;
this.ColorDialog1.AnyColor = true;
this.ColorDialog1.SolidColorOnly = false;
this.ColorDialog1.ShowHelp = true;
// Associate the event-handling method with
// the HelpRequest event.
this.ColorDialog1.HelpRequest
+= new System.EventHandler(ColorDialog1_HelpRequest);
}
// This method opens the dialog and checks the DialogResult value.
// If the result is OK, the text box's background color will be changed
// to the user-selected color.
private void Button1_Click(System.Object sender, System.EventArgs e)
{
DialogResult result = ColorDialog1.ShowDialog();
if (result.Equals(DialogResult.OK))
{
TextBox1.BackColor = ColorDialog1.Color;
}
}
// This method is called when the HelpRequest event is raised,
//which occurs when the user clicks the Help button on the ColorDialog object.
private void ColorDialog1_HelpRequest(object sender, System.EventArgs e)
{
MessageBox.Show("Please select a color by clicking it. "
+ "This will change the BackColor property of the TextBox.");
}
' This method initializes ColorDialog1 to allow any colors,
' and combination colors on systems with 256 colors or less,
' but will not allow the user to set custom colors. The
' dialog will contain the help button.
Private Sub InitializeColorDialog()
Me.ColorDialog1 = New System.Windows.Forms.ColorDialog
Me.ColorDialog1.AllowFullOpen = False
Me.ColorDialog1.AnyColor = True
Me.ColorDialog1.SolidColorOnly = False
Me.ColorDialog1.ShowHelp = True
End Sub
' This method opens the dialog and checks the DialogResult value.
' If the result is OK, the text box's background color will be changed
' to the user-selected color.
Private Sub Button1_Click(ByVal sender As System.Object, _
ByVal e As System.EventArgs) Handles Button1.Click
Dim result As DialogResult = ColorDialog1.ShowDialog()
If (result.Equals(DialogResult.OK)) Then
TextBox1.BackColor = ColorDialog1.Color
End If
End Sub
' This method is called when the HelpRequest event is raised,
'which occurs when the user clicks the Help button on the ColorDialog object.
Private Sub ColorDialog1_HelpRequest(ByVal sender As Object, _
ByVal e As System.EventArgs) Handles ColorDialog1.HelpRequest
MessageBox.Show("Please select a color by clicking it." _
& "This will change the BackColor property of the TextBox.")
End Sub