ColorDialog Sınıf

Tanım

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

Ö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()
Geçersiz.

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()
Geçersiz.

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)

Şunlara uygulanır

Ayrıca bkz.