ColorDialog Sınıf

Tanım

Ad Alanı:

System.Windows.Forms

Bütünleştirilmiş Kod:

System.Windows.Forms.dll

Kullanıcının özel renkler tanımlamasını sağlayan denetimlerin yanı sıra kullanılabilir renkleri görüntüleyen ortak bir iletişim kutusunu temsil eder.

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

Devralma

Object

MarshalByRefObject

Component

CommonDialog

ColorDialog

Örnekler

Aşağıdaki örnekte yeni ColorDialogöğesinin oluşturulması gösterilmektedir. Bu örnek, yönteminin üzerinde ve Button bulunan mevcut bir formun TextBox içinden çağrılmış olmasını gerektirir.

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

Açıklamalar

Bu özel ortak iletişim kutusunu oluşturmak için devralınan üye ShowDialog çağrılmalıdır. HookProc belirli iletişim kutusu kanca işlevselliğini uygulamak için geçersiz kılınabilir. Kullanıcı tarafından seçilen rengi almak için kullanın Color .

örneğini ColorDialogoluşturduğunuzda, bazı okuma/yazma özellikleri ilk değerlere ayarlanır. Bu değerlerin listesi için oluşturucuya ColorDialog bakın.

Oluşturucular

ColorDialog()

ColorDialog sınıfının yeni bir örneğini başlatır.

Özellikler

AllowFullOpen	Kullanıcının özel renkler tanımlamak için iletişim kutusunu kullanıp kullanamayacağını belirten bir değer alır veya ayarlar.
AnyColor	İletişim kutusunun tüm kullanılabilir renkleri temel renkler kümesinde görüntüleyip görüntülemeyeceğini belirten bir değer alır veya ayarlar.
CanRaiseEvents	Bileşenin olay oluşturup oluşturamayacağını belirten bir değer alır. (Devralındığı yer: Component)
Color	Kullanıcı tarafından seçilen rengi alır veya ayarlar.
Container	öğesini IContainer içeren öğesini Componentalır. (Devralındığı yer: Component)
CustomColors	İletişim kutusunda gösterilen özel renk kümesini alır veya ayarlar.
DesignMode	öğesinin şu anda tasarım modunda olup olmadığını Component gösteren bir değer alır. (Devralındığı yer: Component)
Events	Bu Componentöğesine eklenen olay işleyicilerinin listesini alır. (Devralındığı yer: Component)
FullOpen	İletişim kutusu açıldığında özel renkler oluşturmak için kullanılan denetimlerin görünür olup olmadığını belirten bir değer alır veya ayarlar.
Instance	Temel pencere örneği tanıtıcısını (HINSTANCE) alır.
Options	başlatma ColorDialogdeğerlerini alır.
ShowHelp	Renk iletişim kutusunda Yardım düğmesinin görünüp görünmediğini belirten bir değer alır veya ayarlar.
Site	öğesini alır veya ayarlar ISiteComponent. (Devralındığı yer: Component)
SolidColorOnly	İletişim kutusunun kullanıcıları yalnızca düz renkler seçmeye kısıtlayıp kısıtlamayacağını belirten bir değer alır veya ayarlar.
Tag	Denetim hakkındaki verileri içeren bir nesneyi alır veya ayarlar. (Devralındığı yer: CommonDialog)

Yöntemler

CreateObjRef(Type)	Uzak bir nesneyle iletişim kurmak için kullanılan bir ara sunucu oluşturmak için gereken tüm ilgili bilgileri içeren bir nesne oluşturur. (Devralındığı yer: MarshalByRefObject)
Dispose()	Component tarafından kullanılan tüm kaynakları serbest bırakır. (Devralındığı yer: Component)
Dispose(Boolean)	Component tarafından kullanılan yönetilmeyen kaynakları serbest bırakır ve yönetilen kaynakları isteğe bağlı olarak serbest bırakır. (Devralındığı yer: Component)
Equals(Object)	Belirtilen nesnenin geçerli nesneye eşit olup olmadığını belirler. (Devralındığı yer: Object)
GetHashCode()	Varsayılan karma işlevi işlevi görür. (Devralındığı yer: Object)
GetLifetimeService()	Bu örnek için yaşam süresi ilkesini denetleen geçerli yaşam süresi hizmet nesnesini alır. (Devralındığı yer: MarshalByRefObject)
GetService(Type)	veya tarafından ComponentContainersağlanan bir hizmeti temsil eden bir nesnesi döndürür. (Devralındığı yer: Component)
GetType()	Type Geçerli örneğini alır. (Devralındığı yer: Object)
HookProc(IntPtr, Int32, IntPtr, IntPtr)	Ortak bir iletişim kutusuna belirli işlevler eklemek için geçersiz kılınan ortak iletişim kutusu kanca yordamını tanımlar. (Devralındığı yer: CommonDialog)
InitializeLifetimeService()	Bu örneğin yaşam süresi ilkesini denetlemek için bir yaşam süresi hizmet nesnesi alır. (Devralındığı yer: MarshalByRefObject)
MemberwiseClone()	Geçerli Objectöğesinin sığ bir kopyasını oluşturur. (Devralındığı yer: Object)
MemberwiseClone(Boolean)	Geçerli MarshalByRefObject nesnenin sığ bir kopyasını oluşturur. (Devralındığı yer: MarshalByRefObject)
OnHelpRequest(EventArgs)	Olayı tetikler HelpRequest . (Devralındığı yer: CommonDialog)
OwnerWndProc(IntPtr, Int32, IntPtr, IntPtr)	Ortak bir iletişim kutusuna belirli işlevler eklemek için geçersiz kılınan sahip penceresi yordamını tanımlar. (Devralındığı yer: CommonDialog)
Reset()	Tüm seçenekleri varsayılan değerlerine, seçilen son rengi siyaha ve özel renkleri varsayılan değerlerine sıfırlar.
RunDialog(IntPtr)	Türetilmiş bir sınıfta geçersiz kılındığında, ortak bir iletişim kutusu belirtir.
ShowDialog()	Varsayılan sahibi olan ortak bir iletişim kutusu çalıştırır. (Devralındığı yer: CommonDialog)
ShowDialog(IWin32Window)	Belirtilen sahiple ortak bir iletişim kutusu çalıştırır. (Devralındığı yer: CommonDialog)
ToString()	öğesini temsil ColorDialogeden bir dize döndürür.

Ekinlikler

Disposed	Bileşen yöntemine Dispose() yapılan bir çağrı tarafından atıldığında gerçekleşir. (Devralındığı yer: Component)
HelpRequest	Kullanıcı ortak bir iletişim kutusundaki Yardım düğmesine tıkladığında gerçekleşir. (Devralındığı yer: CommonDialog)

Ayrıca bkz.

• CommonDialog