ColorDialog Klass

Definition

Namnområde:

System.Windows.Forms

Sammansättning:

System.Windows.Forms.dll

Källa:

ColorDialog.cs

Representerar en gemensam dialogruta som visar tillgängliga färger tillsammans med kontroller som gör att användaren kan definiera anpassade färger.

public ref class ColorDialog : System::Windows::Forms::CommonDialog

public class ColorDialog : System.Windows.Forms.CommonDialog

type ColorDialog = class
    inherit CommonDialog

Public Class ColorDialog
Inherits CommonDialog

Arv

Object

MarshalByRefObject

Component

CommonDialog

ColorDialog

Exempel

I följande exempel visas skapandet av nya ColorDialog. Det här exemplet kräver att metoden anropas inifrån ett befintligt formulär som har en TextBox och Button placeras på den.

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

Kommentarer

Den ärvda medlemmen ShowDialog måste anropas för att skapa den här specifika gemensamma dialogrutan. HookProc kan åsidosättas för att implementera specifika dialogrutekrokfunktioner. Använd Color för att hämta den färg som användaren har valt.

När du skapar en instans av ColorDialoganges några av läs-/skrivegenskaperna till initiala värden. En lista över dessa värden finns i ColorDialog konstruktorn.

Konstruktorer

Name	Description
ColorDialog()	Initierar en ny instans av ColorDialog klassen.

Egenskaper

Name	Description
AllowFullOpen	Hämtar eller anger ett värde som anger om användaren kan använda dialogrutan för att definiera anpassade färger.
AnyColor	Hämtar eller anger ett värde som anger om dialogrutan visar alla tillgängliga färger i uppsättningen med grundläggande färger.
Color	Hämtar eller anger den färg som användaren har valt.
CustomColors	Hämtar eller anger den uppsättning anpassade färger som visas i dialogrutan.
FullOpen	Hämtar eller anger ett värde som anger om de kontroller som används för att skapa anpassade färger visas när dialogrutan öppnas.
Instance	Hämtar det underliggande fönsterinstanshandtaget (HINSTANCE).
Options	Hämtar värden för att initiera ColorDialog.
ShowHelp	Hämtar eller anger ett värde som anger om en hjälpknapp visas i färgdialogrutan.
SolidColorOnly	Hämtar eller anger ett värde som anger om dialogrutan begränsar användare till att endast välja solida färger.
Tag	Hämtar eller anger ett objekt som innehåller data om kontrollen. (Ärvd från CommonDialog)

Metoder

Name	Description
HookProc(IntPtr, Int32, IntPtr, IntPtr)	Definierar den vanliga dialogrutekrokproceduren som åsidosätts för att lägga till specifika funktioner i en gemensam dialogruta. (Ärvd från CommonDialog)
OnHelpRequest(EventArgs)	Genererar händelsen HelpRequest . (Ärvd från CommonDialog)
OwnerWndProc(IntPtr, Int32, IntPtr, IntPtr)	Definierar den procedur för ägarfönster som åsidosätts för att lägga till specifika funktioner i en gemensam dialogruta. (Ärvd från CommonDialog)
Reset()	Återställer alla alternativ till standardvärdena, den senast markerade färgen till svart och de anpassade färgerna till standardvärdena.
RunDialog(IntPtr)	När åsidosättas i en härledd klass anger en gemensam dialogruta.
ShowDialog()	Kör en gemensam dialogruta med en standardägare. (Ärvd från CommonDialog)
ShowDialog(IWin32Window)	Kör en gemensam dialogruta med den angivna ägaren. (Ärvd från CommonDialog)
ToString()	Returnerar en sträng som representerar ColorDialog.

Händelser

Name	Description
HelpRequest	Inträffar när användaren klickar på hjälpknappen i en gemensam dialogruta. (Ärvd från CommonDialog)

Se även

• CommonDialog