ColorDialog Třída

Definice

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

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()
Zastaralé.

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()
Zastaralé.

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)

Platí pro

Viz také