ColorDialog.AnyColor Właściwość
Definicja
Ważne
Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.
Pobiera lub ustawia wartość wskazującą, czy okno dialogowe wyświetla wszystkie dostępne kolory w zestawie kolorów podstawowych.
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
Wartość właściwości
true
jeśli okno dialogowe wyświetla wszystkie dostępne kolory w zestawie kolorów podstawowych; w przeciwnym razie , false
. Wartość domyślna to false
.
Przykłady
W poniższym przykładzie kodu pokazano inicjowanie ColorDialog ustawienia AnyColorwłaściwości , AllowFullOpen . Użytkownik ColorDialog nie może ustawić koloru niestandardowego, ale umożliwia wyświetlenie pełnego zestawu kolorów podstawowych. Po ustawieniu SolidColorOnly właściwości na false
wartość , umożliwia wyświetlanie kolorów, które są kombinacjami innych kolorów w systemach z 256 lub mniejszymi kolorami. W przykładzie pokazano również ustawienie ShowHelp właściwości i obsługę HelpRequest zdarzenia dla okna dialogowego. Aby uruchomić przykład, wklej następujący kod w formularzu i wywołaj InitializeColorDialog
metodę w konstruktorze lub Load
metodzie formularza. Ten przykład wymaga, aby Click
zdarzenie przycisku było połączone z metodą obsługi zdarzeń zdefiniowaną w przykładzie.
// 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