ColorDialog.AllowFullOpen 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 l'utilisateur peut utiliser la boîte de dialogue pour définir des couleurs personnalisées.
public:
virtual property bool AllowFullOpen { bool get(); void set(bool value); };
public virtual bool AllowFullOpen { get; set; }
member this.AllowFullOpen : bool with get, set
Public Overridable Property AllowFullOpen As Boolean
Valeur de propriété
true
en cas de possibilité de définition de couleurs personnalisées par l'utilisateur ; sinon, false
. La valeur par défaut est true
.
Exemples
L’exemple suivant illustre la création de nouveau ColorDialog. Cet exemple nécessite que la méthode soit appelée à partir d’un formulaire existant qui a un TextBox et Button l’a placé sur celui-ci.
private:
void button1_Click( Object^ /*sender*/, System::EventArgs^ /*e*/ )
{
ColorDialog^ MyDialog = gcnew ColorDialog;
// Keeps the user from selecting a custom color.
MyDialog->AllowFullOpen = false;
// Allows the user to get help. (The default is false.)
MyDialog->ShowHelp = true;
// Sets the initial color select to the current text color.
MyDialog->Color = textBox1->ForeColor;
// Update the text box color if the user clicks OK
if ( MyDialog->ShowDialog() == ::System::Windows::Forms::DialogResult::OK )
{
textBox1->ForeColor = MyDialog->Color;
}
}
private void button1_Click(object sender, System.EventArgs e)
{
ColorDialog MyDialog = new ColorDialog();
// Keeps the user from selecting a custom color.
MyDialog.AllowFullOpen = false ;
// Allows the user to get help. (The default is false.)
MyDialog.ShowHelp = true ;
// Sets the initial color select to the current text color.
MyDialog.Color = textBox1.ForeColor ;
// Update the text box color if the user clicks OK
if (MyDialog.ShowDialog() == DialogResult.OK)
textBox1.ForeColor = MyDialog.Color;
}
Private Sub Button1_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) Handles Button1.Click
Dim MyDialog As New ColorDialog()
' Keeps the user from selecting a custom color.
MyDialog.AllowFullOpen = False
' Allows the user to get help. (The default is false.)
MyDialog.ShowHelp = True
' Sets the initial color select to the current text color,
MyDialog.Color = TextBox1.ForeColor
' Update the text box color if the user clicks OK
If (MyDialog.ShowDialog() = Windows.Forms.DialogResult.OK) Then
TextBox1.ForeColor = MyDialog.Color
End If
End Sub
Remarques
Lorsqu’il est défini false
sur , le bouton associé dans la boîte de dialogue est désactivé et l’utilisateur ne peut pas accéder au contrôle de couleurs personnalisées dans la boîte de dialogue.