ColorDialog Třída

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

Představuje společné dialogové okno, které zobrazuje dostupné barvy spolu s ovládacími prvky, které umožňují uživateli 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ěna.

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

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 se implementovaly konkrétní funkce háku dialogového okna. Slouží Color k načtení barvy vybrané uživatelem.

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

Konstruktory

ColorDialog()

Inicializuje novou instanci ColorDialog třídy .

Vlastnosti

AllowFullOpen	Získá nebo nastaví hodnotu označující, zda uživatel může použít dialogové okno definovat vlastní barvy.
AnyColor	Získá nebo nastaví hodnotu označující, zda dialogové okno zobrazí všechny dostupné barvy v sadě základních barev.
CanRaiseEvents	Získá hodnotu označující, zda komponenta může vyvolat událost. (Zděděno od Component)
Color	Získá nebo nastaví barvu vybranou uživatelem.
Container	Získá objekt IContainer , který obsahuje Component. (Zděděno od Component)
CustomColors	Získá nebo nastaví sadu vlastních barev zobrazených v dialogovém okně.
DesignMode	Získá hodnotu, která označuje, zda je aktuálně v režimu návrhu Component . (Zděděno od Component)
Events	Získá seznam obslužných rutin událostí, které jsou připojeny k tomuto Component. (Zděděno od Component)
FullOpen	Získá nebo nastaví hodnotu označ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 v dialogovém okně barvy zobrazí tlačítko Nápověda.
Site	Získá nebo nastaví ISite z Component. (Zděděno od Component)
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

CreateObjRef(Type)	Vytvoří objekt, který obsahuje všechny relevantní informace potřebné k vygenerování proxy sloužící ke komunikaci se vzdáleným objektem. (Zděděno od MarshalByRefObject)
Dispose()	Uvolní všechny prostředky používané nástrojem Component. (Zděděno od Component)
Dispose(Boolean)	Uvolní nespravované prostředky používané nástrojem Component a volitelně uvolní spravované prostředky. (Zděděno od Component)
Equals(Object)	Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object)
GetHashCode()	Slouží jako výchozí hashovací funkce. (Zděděno od Object)
GetLifetimeService()	Načte aktuální životnost objektu služby, který řídí zásady životnosti pro tuto instanci. (Zděděno od MarshalByRefObject)
GetService(Type)	Vrátí objekt, který představuje službu poskytovanou objektem Component nebo .Container (Zděděno od Component)
GetType()	Type Získá z aktuální instance. (Zděděno od Object)
HookProc(IntPtr, Int32, IntPtr, IntPtr)	Definuje společnou proceduru hooku dialogového okna, která je přepsána pro přidání konkrétních funkcí do běžného dialogového okna. (Zděděno od CommonDialog)
InitializeLifetimeService()	Získá životnost objektu služby, který řídí zásady životnosti pro tuto instanci. (Zděděno od MarshalByRefObject)
MemberwiseClone()	Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object)
MemberwiseClone(Boolean)	Vytvoří mělkou kopii aktuálního MarshalByRefObject objektu. (Zděděno od MarshalByRefObject)
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ích funkcí do společného dialogového okna. (Zděděno od CommonDialog)
Reset()	Obnoví výchozí hodnoty všech možností, naposledy 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 ColorDialog.

Událost

Disposed	Vyvolá se, když je komponenta uvolněna voláním Dispose() metody . (Zděděno od Component)
HelpRequest	Vyvolá se, když uživatel klikne na tlačítko Nápověda ve společném dialogovém okně. (Zděděno od CommonDialog)

Viz také

• CommonDialog