ColorDialog.AllowFullOpen Eigenschaft

Definition

Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob der Benutzer das Dialogfeld zum Definieren benutzerdefinierter Farben verwenden kann.

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

Eigenschaftswert

truewenn der Benutzer benutzerdefinierte Farben definieren kann; andernfalls . false Der Standardwert lautet true.

Beispiele

Das folgende Beispiel veranschaulicht die Erstellung neuer ColorDialog. Dieses Beispiel erfordert, dass die Methode innerhalb eines vorhandenen Formulars aufgerufen wird, das über ein TextBox und Button platziertes Formular verfügt.

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() = DialogResult.OK) Then
        TextBox1.ForeColor = MyDialog.Color
    End If
End Sub

Hinweise

Bei Festlegung auf false, ist die zugeordnete Schaltfläche im Dialogfeld deaktiviert, und der Benutzer kann nicht auf das Steuerelement für benutzerdefinierte Farben im Dialogfeld zugreifen.

Gilt für:

Weitere Informationen