ColorDialog Třída

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

Zdroj:

ColorDialog.cs

Představuje společné dialogové okno, které zobrazuje dostupné barvy spolu s ovládacími prvky, které uživateli umožňují definovat vlastní barvy.

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

Dědičnost

Object

MarshalByRefObject

Component

CommonDialog

ColorDialog

Příklady

Následující příklad znázorňuje vytvoření nového ColorDialog. Tento příklad vyžaduje, aby metoda byla volána z existujícího formuláře, který má TextBox a Button je na něm umístěn.

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

Poznámky

Zděděný člen ShowDialog musí být vyvolán, aby se vytvořilo toto konkrétní společné dialogové okno. HookProc lze přepsat, aby implementovaly konkrétní funkce háku dialogového okna. Slouží Color k načtení barvy vybrané uživatelem.

Při vytváření instance ColorDialogjsou některé vlastnosti pro čtení a zápis nastaveny na počáteční hodnoty. Seznam těchto hodnot naleznete v konstruktoru ColorDialog .

Konstruktory

Name	Description
ColorDialog()	Inicializuje novou instanci ColorDialog třídy.

Vlastnosti

Name	Description
AllowFullOpen	Získá nebo nastaví hodnotu určující, zda uživatel může použít dialogové okno definovat vlastní barvy.
AnyColor	Získá nebo nastaví hodnotu určující, zda dialogové okno zobrazí všechny dostupné barvy v sadě základních barev.
Color	Získá nebo nastaví barvu vybranou uživatelem.
CustomColors	Získá nebo nastaví sadu vlastních barev zobrazených v dialogovém okně.
FullOpen	Získá nebo nastaví hodnotu určující, zda ovládací prvky použité k vytvoření vlastních barev jsou viditelné při otevření dialogového okna.
Instance	Získá podkladový popisovač instance okna (HINSTANCE).
Options	Získá hodnoty pro inicializaci ColorDialog.
ShowHelp	Získá nebo nastaví hodnotu označující, zda se tlačítko nápověda zobrazí v dialogovém okně barvy.
SolidColorOnly	Získá nebo nastaví hodnotu označující, zda dialogové okno omezí uživatele na výběr pouze plné barvy.
Tag	Získá nebo nastaví objekt, který obsahuje data o ovládacím prvku. (Zděděno od CommonDialog)

Metody

Name	Description
HookProc(IntPtr, Int32, IntPtr, IntPtr)	Definuje běžnou proceduru háku dialogového okna, která se přepíše a přidá do společného dialogového okna konkrétní funkce. (Zděděno od CommonDialog)
OnHelpRequest(EventArgs)	HelpRequest Vyvolá událost. (Zděděno od CommonDialog)
OwnerWndProc(IntPtr, Int32, IntPtr, IntPtr)	Definuje proceduru okna vlastníka, která je přepsána pro přidání konkrétní funkce do společného dialogového okna. (Zděděno od CommonDialog)
Reset()	Obnoví všechny možnosti na výchozí hodnoty, poslední vybranou barvu na černou a vlastní barvy na výchozí hodnoty.
RunDialog(IntPtr)	Při přepsání v odvozené třídě určuje společné dialogové okno.
ShowDialog()	Spustí společné dialogové okno s výchozím vlastníkem. (Zděděno od CommonDialog)
ShowDialog(IWin32Window)	Spustí společné dialogové okno se zadaným vlastníkem. (Zděděno od CommonDialog)
ToString()	Vrátí řetězec, který představuje ColorDialoghodnotu .

Událost

Name	Description
HelpRequest	Nastane, když uživatel klikne na tlačítko Nápověda v běžném dialogovém okně. (Zděděno od CommonDialog)

Viz také

• CommonDialog