CHOOSECOLOR

choosecolor yapısı, renk ortak iletişim kutusu başlatmak için ChooseColor işlevini kullanan bilgi içerir. Kullanıcı iletişim kutusunu kapattıktan sonra sistem içinde bu yapı kullanıcının seçimi hakkında bilgi döndürür.

typedef struct {/ / cc dword lStructSize; 
    hwnd hwndOwner; 
    hwnd HINSTANCE; 
    colorref rgbResult; 
    colorref * lpCustColors; 
    dword Flags; 
    lparam lCustData; 
    lpcchookproc lpfnHook; 
    lpctstr lpTemplateName; 
} CHOOSECOLOR 

 

Üyeler

lStructSize
Yapı bayt cinsinden uzunluğu belirtir.
hwndOwner
İletişim kutusu sahibi pencereyi tanımlar. Herhangi bir geçerli pencere tanıtıcısı bu üye olabilir ya da iletişim kutusunda Hayır sahibi varsa boş olabilir.
hINSTANCE
Bayrakları üye cc_enabletemplatehandle bayrağı ayarlanmışsa, HINSTANCE tanıtıcı iletişim kutusunda şablon içeren bellek nesnesi değil. cc_enabletemplate bayrağı ayarlanmışsa, HINSTANCE lpTemplateName üye tarafından adlı iletişim kutusunda şablon içeren modül tanımlar. Ne cc_enabletemplatehandle ne de cc_enabletemplate ayarlı ise, bu üye yoksayılır.
rgbResult
CC_RGBINIT bayrağı ayarlı ise, rgbResult iletişim kutusu oluşturulduğunda başlangıçta seçilen renk belirtir. Sistem, belirtilen renk değeri kullanılabilir renkleri arasında değil, kullanılabilen en yakın düz renk seçer. RgbResult sıfır veya CC_RGBINIT ayarlı değil, başlangıçta seçilen renk siyahtır. Tamam düğmesini tıkladığında, kullanıcının renk seçimi rgbResult belirtir.
lpCustColors
16 colorref değerleri için özel rengi kırmızı, yeşil ve mavi (rgb) değerleri içeren bir dizi işaretçisine iletişim kutusunda kutuları. Kullanıcı bu renkleri değiştirir sistem dizi ile yeni rgb değerlerini güncelleştirir. ChooseColor işlev çağrıları arasında yeni özel renkleri korumak için statik hafıza dizi için ayırmak.
Bayraklar
Renk ortak iletişim kutusu başlatmak için kullanabileceğiniz bir bit bayrağı kümesidir. İletişim kutusu döndüğünde, kullanıcının giriş göstermek için bu bayrakları ayarlar. Bu üye aşağıdaki bayrakları bir arada olabilir:
Bayrak Anlamı
CC_ANYCOLOR Temel renkler kümesindeki tüm kullanılabilir renkleri görüntülemek için iletişim kutusunu neden.
CC_ENABLEHOOK Bu yapı lpfnHook üyesi belirtilen kanca işlemi sağlar. Bu bayrak, yalnızca iletişim kutusu başlatmak için kullanılır.
CC_ENABLETEMPLATE HINSTANCE ve lpTemplateName üyeleri bir iletişim kutusunda şablon varsayılan şablon yerine belirtin gösterir. Bu bayrak, yalnızca iletişim kutusu başlatmak için kullanılır.
CC_ENABLETEMPLATEHANDLE HINSTANCE üye önceden yüklenmiş iletişim kutusunda şablon içeren veri bloğu tanımlar gösterir. Bu seçenek belirtilmezse sistem lpTemplateName üye yoksayar. Bu bayrak, yalnızca iletişim kutusu başlatmak için kullanılır.
CC_FULLOPEN Ek denetimleri özel renkler oluşturma kullanıcı görüntülemek için iletişim kutusunu neden olur. Bu bayrağı ayarlanmazsa, kullanıcı özel renk denetimlerini görüntülemek için Tanımla özel renk düğmesini tıklatın.
CC_PREVENTFULLOPEN Özelrenkleri Tanımladüğmesini devre dışı bırakır .
CC_RGBINIT RgbResult üye olarak ilk renk seçimi belirtilen rengi kullanmak için iletişim kutusunu neden.
CC_SHOWHELP Yardım düğmesini görüntülemek için iletişim kutusunu neden olur. HwndOwner üye HELPMSGSTRING almak için pencereyi kayıtlı kullanıcı Yardım düğmesini tıklattığında iletişim kutusunu gönderdiği iletileri belirtmeniz gerekir.
CC_SOLIDCOLOR Temel renkler kümesinde yalnızca düz renkleri görüntülemek için iletişim kutusunu neden.

lCustData
LpfnHook üye tarafından tanımlanan kanca işlemi sistem geçirir, uygulama tanımlı veri belirtir. Sistem kancası yordamı WM_INITDIALOG ileti gönderdiğinde, ileti lParam parametresinin choosecolor yapısı için işaretçi iletişim oluşturulduğu belirtilen olduğunu. LCustData değerini almak için bu işaretçi kancası yordamı kullanabilirsiniz.
lpfnHook
İşaretçi bir CCHookProc iletişim kutusu amaçlanan iletileri işleme yordamı kanca. cc_enablehook bayrağı bayrak üyesinin ayarlanmadığı sürece bu üye yoksayılır.
lpTemplateName
HINSTANCE üye tarafından tanımlanan modül iletişim kutusunda şablon kaynak adları boşlukla sonlandırılmış dize işaretçisi. Bu şablon için standart iletişim kutusunda şablon geçmesidir. Numaralı iletişim kutusu kaynakları için lpTemplateName MAKEINTRESOURCE makro tarafından döndürülen değeri olabilir. cc_enabletemplate bayrağı bayrak üyesinin ayarlanmadığı sürece bu üye yoksayılır.

QuickInfo

nbsp; Windows &NT: sürüm 3.1 veya üstü gerektirir.
Windows:Windows 95 veya sonraki sürümleri gerektirir.
Windows ce:Sürüm 1.0 veya daha ilerisini gerektirir.
Header:Commdlg.h ilan etti.
Unicode:Unicode ve ANSI yapılar tanımlanan.

Ayrıca bkz:

Ortak iletişim kutusuna kitaplığın genel bakış, ortak iletişim kutusu yapıları, CCHookProc, ChooseColor, MAKEINTRESOURCE, WM_INITDIALOG