CComboBoxEx Sınıfı

Resim listeleri için destek sağlayarak birleşik giriş kutusu denetimini genişletir.

Sözdizimi

class CComboBoxEx : public CComboBox

Üyeler

Ortak Oluşturucular

Veri Akışı Adı	Açıklama
CComboBoxEx::CComboBoxEx	Bir CComboBoxEx nesne oluşturur.

Genel Yöntemler

Veri Akışı Adı	Açıklama
CComboBoxEx::Create	Birleşik giriş kutusunu oluşturur ve nesneye CComboBoxEx ekler.
CComboBoxEx::CreateEx	Belirtilen Windows genişletilmiş stilleriyle bir birleşik giriş kutusu oluşturur ve bunu bir ComboBoxEx nesneye ekler.
CComboBoxEx::D eleteItem	Bir öğeyi denetimden ComboBoxEx kaldırır.
CComboBoxEx::GetComboBoxCtrl	Alt birleşik giriş kutusu denetiminin işaretçisini alır.
CComboBoxEx::GetEditCtrl	Tutamacı denetimin ComboBoxEx düzenleme denetimi bölümüne alır.
CComboBoxEx::GetExtendedStyle	Denetim için ComboBoxEx kullanılan genişletilmiş stilleri alır.
CComboBoxEx::GetImageList	Denetime atanan görüntü listesinin işaretçisini ComboBoxEx alır.
CComboBoxEx::GetItem	Belirli ComboBoxEx bir öğenin öğe bilgilerini alır.
CComboBoxEx::HasEditChanged	Kullanıcının yazarak düzenleme denetiminin ComboBoxEx içeriğini değiştirip değiştirmediğini belirler.
CComboBoxEx::InsertItem	Denetime yeni bir ComboBoxEx öğe ekler.
CComboBoxEx::SetExtendedStyle	Denetim ComboBoxEx içindeki genişletilmiş stilleri ayarlar.
CComboBoxEx::SetImageList	Denetim için ComboBoxEx bir görüntü listesi ayarlar.
CComboBoxEx::SetItem	Denetimdeki bir öğenin ComboBoxEx özniteliklerini ayarlar.
CComboBoxEx::SetWindowTheme	Genişletilmiş birleşik giriş kutusu denetiminin görsel stilini ayarlar.

Açıklamalar

birleşik giriş kutusu denetimleri oluşturmak için kullanarak CComboBoxEx artık kendi görüntü çizim kodunuzu uygulamanız gerekmez. Bunun yerine, bir görüntü listesinden görüntülere erişmek için kullanın CComboBoxEx .

Görüntü Listesi Desteği

Standart birleşik giriş kutusunda birleşik giriş kutusunun sahibi, birleşik giriş kutusunu sahip-çizim denetimi olarak oluşturarak resim çizmekle sorumludur. kullanırken CComboBoxEx, çizim stillerini CBS_OWNERDRAWFIXED ve CBS_HASSTRINGS ayarlamanız gerekmez çünkü bunlar örtülür. Aksi takdirde, çizim işlemlerini gerçekleştirmek için kod yazmanız gerekir. Denetim CComboBoxEx , öğe başına en fazla üç görüntüyü destekler: biri seçili bir durum, biri seçilmemiş bir durum ve biri katman görüntüsü için.

Stiller

CComboBoxEx stilleri CBS_SIMPLE, CBS_DROPDOWN, CBS_DROPDOWNLIST ve WS_CHILD destekler. Pencereyi oluştururken geçirilen diğer tüm stiller denetim tarafından yoksayılır. Pencere oluşturulduktan sonra, SetExtendedStyle üye işlevini çağırarak CComboBoxEx diğer birleşik giriş kutusu stillerini sağlayabilirsiniz. Bu stiller ile şunları yapabilirsiniz:

• Listedeki dize aramalarını büyük/küçük harfe duyarlı olacak şekilde ayarlayın.

• Sözcük sınırlayıcıları olarak eğik çizgi ('/'), ters eğik çizgi ('\') ve nokta ('.') karakterlerini kullanan bir birleşik giriş kutusu denetimi oluşturun. Bu, kullanıcıların CTRL+ OK klavye kısayolunu kullanarak sözcükten sözcüke atlayabilmelerini sağlar.

• Birleşik giriş kutusu denetimini görüntüleyecek veya görüntülemeyecek şekilde ayarlayın. Görüntü görüntülenmezse birleşik giriş kutusu, görüntüye uygun metin girintisini kaldırabilir.

• İçeren daha geniş birleşik giriş kutusunu klipslemesi için boyutlandırma da dahil olmak üzere dar bir birleşik giriş kutusu denetimi oluşturun.

Bu stil bayrakları CComboBoxEx kullanma bölümünde daha ayrıntılı olarak açıklanmıştır.

Öğe Saklama ve Geri Çağırma Öğesi Öznitelikleri

Öğeler ve görüntüler için dizinler, girinti değerleri ve metin dizeleri gibi öğe bilgileri, Windows SDK'da açıklandığı gibi Win32 yapısı COMBOBOXEXITEM içinde depolanır. Yapı, geri çağırma bayraklarına karşılık gelen üyeleri de içerir.

Ayrıntılı, kavramsal bir tartışma için bkz . CComboBoxEx kullanma.

Devralma Hiyerarşisi

CObject

CCmdTarget

CWnd

CComboBox

CComboBoxEx

Gereksinimler

Üst bilgi: afxcmn.h

CComboBoxEx::CComboBoxEx

Nesne oluşturmak CComboBoxEx için bu üye işlevini çağır.

CComboBoxEx();

CComboBoxEx::Create

Birleşik giriş kutusunu oluşturur ve nesneye CComboBoxEx ekler.

virtual BOOL Create(
    DWORD dwStyle,
    const RECT& rect,
    CWnd* pParentWnd,
    UINT nID);

Parametreler

dwStyle
Birleşik giriş kutusuna uygulanan birleşik giriş kutusu stillerinin bileşimini belirtir. Stiller hakkında daha fazla bilgi için aşağıdaki Açıklamalar bölümüne bakın.

Rect
Birleşik giriş kutusunun konumu ve boyutu olan CRect nesnesine veya RECT yapısına başvuru.

pParentWnd
Birleşik giriş kutusunun üst penceresi olan bir CWnd nesnesine işaretçi (genellikle bir CDialog). NULL olmamalıdır.

Nıd
Birleşik giriş kutusunun denetim kimliğini belirtir.

Dönüş Değeri

Nesne başarıyla oluşturulduysa sıfır olmayan; aksi takdirde 0.

Açıklamalar

İki adımda nesne CComboBoxEx oluşturma:

1. Nesne CComboBoxEx oluşturmak için CComboBoxEx çağrısı yapın.

2. Genişletilmiş Windows birleşik giriş kutusunu oluşturan ve nesneye ekleyen bu üye işlevini çağırın CComboBoxEx .

çağırdığınızda Create, MFC ortak denetimleri başlatır.

Birleşik giriş kutusunu oluşturduğunuzda, aşağıdaki birleşik giriş kutusu stillerinden herhangi birini veya tümünü belirtebilirsiniz:

• CBS_SIMPLE

• CBS_DROPDOWN

• CBS_DROPDOWNLIST

• CBS_AUTOHSCROLL

• WS_CHILD

Pencereyi oluştururken geçirilen diğer tüm stiller yoksayılır. Denetim, ComboBoxEx ek özellikler sağlayan genişletilmiş stilleri de destekler. Bu stiller, Windows SDK'sında ComboBoxEx denetimi genişletilmiş stilleri bölümünde açıklanmıştır. SetExtendedStyle öğesini çağırarak bu stilleri ayarlayın.

Denetiminizle genişletilmiş windows stilleri kullanmak istiyorsanız, yerine CreateEx'i çağırın.Create

CComboBoxEx::CreateEx

Genişletilmiş birleşik giriş kutusu denetimi (alt pencere) oluşturmak ve nesneyle ilişkilendirmek için bu işlevi çağırın CComboBoxEx .

virtual BOOL CreateEx(
    DWORD dwExStyle,
    DWORD dwStyle,
    const RECT& rect,
    CWnd* pParentWnd,
    UINT nID);

Parametreler

dwExStyle
Oluşturulan denetimin genişletilmiş stilini belirtir. Genişletilmiş Windows stillerinin listesi için Windows SDK'sında CreateWindowEx için dwExStyle parametresine bakın.

dwStyle
Birleşik giriş kutusu denetiminin stili. Stillerin listesi için bkz . Oluşturma .

Rect
pParentWnd istemci koordinatlarında oluşturulacak pencerenin boyutunu ve konumunu açıklayan rect yapısına başvuru.

pParentWnd
Denetimin üst öğesi olan pencere işaretçisi.

Nıd
Denetimin alt pencere kimliği.

Dönüş Değeri

Başarılı olursa sıfır olmayan; aksi takdirde 0.

Açıklamalar

WS_EX_ Windows genişletilmiş stil ön biçimi tarafından belirtilen genişletilmiş Windows stilleri uygulamak için yerine Create kullanınCreateEx.

CreateExdenetimi dwExStyle tarafından belirtilen genişletilmiş Windows stilleriyle oluşturur. SetExtendedStyle kullanarak genişletilmiş birleşik giriş kutusu denetimine özgü genişletilmiş stiller ayarlamanız gerekir. Örneğin, WS_EX_CONTEXTHELP gibi stilleri ayarlamak için kullanın CreateEx , ancak CBES_EX_CASESENSITIVE gibi stilleri ayarlamak için kullanın SetExtendedStyle . Daha fazla bilgi için Windows SDK'sında ComboBoxEx Denetimi Genişletilmiş Stilleri konusunda açıklanan stiller konusuna bakın.

CComboBoxEx::D eleteItem

Bir öğeyi denetimden ComboBoxEx kaldırır.

int DeleteItem(int iIndex);

Parametreler

iIndex
Kaldırılacak öğenin sıfır tabanlı dizini.

Dönüş Değeri

Denetimde kalan öğelerin sayısı. iIndex geçersizse işlev CB_ERR döndürür.

Açıklamalar

Bu üye işlevi, Windows SDK'da açıklandığı gibi ileti CBEM_DELETEITEM işlevselliğini uygular. DeleteItem'ı çağırdığınızda, üst pencereye CBEN_DELETEITEM bildirimi içeren bir WM_NOTIFY iletisi gönderilir.

CComboBoxEx::GetComboBoxCtrl

Nesne içindeki CComboBoxEx birleşik giriş kutusu denetimine işaretçi almak için bu üye işlevini çağır.

CComboBox* GetComboBoxCtrl();

Dönüş Değeri

Nesne işaretçisi CComboBox .

Açıklamalar

Denetim CComboBoxEx , bir öğesini kapsülleyen CComboBoxbir üst pencereden oluşur.

CComboBox Dönüş değeri tarafından işaret edilen nesne geçici bir nesnedir ve bir sonraki boşta işlem zamanında yok edilir.

CComboBoxEx::GetEditCtrl

Birleşik giriş kutusunun düzenleme denetiminin işaretçisini almak için bu üye işlevini çağırın.

CEdit* GetEditCtrl();

Dönüş Değeri

CEdit nesnesinin işaretçisi.

Açıklamalar

Denetim CComboBoxEx , CBS_DROPDOWN stiliyle oluşturulduğunda düzenleme kutusu kullanır.

CEdit Dönüş değeri tarafından işaret edilen nesne geçici bir nesnedir ve bir sonraki boşta işlem zamanında yok edilir.

CComboBoxEx::GetExtendedStyle

Denetim için kullanılan genişletilmiş stilleri almak için CComboBoxEx bu üye işlevini çağırın.

DWORD GetExtendedStyle() const;

Dönüş Değeri

Birleşik giriş kutusu denetimi için kullanılan genişletilmiş stilleri içeren DWORD değeri.

Açıklamalar

Bu stiller hakkında daha fazla bilgi için bkz. Windows SDK'sında ComboBoxEx Denetimi Genişletilmiş Stilleri.

CComboBoxEx::GetImageList

Denetim tarafından CComboBoxEx kullanılan görüntü listesine bir işaretçi almak için bu üye işlevini çağırın.

CImageList* GetImageList() const;

Dönüş Değeri

CImageList nesnesinin işaretçisi. Başarısız olursa, bu üye işlevi NULL döndürür.

Açıklamalar

CImageList Dönüş değeri tarafından işaret edilen nesne geçici bir nesnedir ve bir sonraki boşta işlem zamanında yok edilir.

CComboBoxEx::GetItem

Belirli ComboBoxEx bir öğenin öğe bilgilerini alır.

BOOL GetItem(COMBOBOXEXITEM* pCBItem);

Parametreler

pCBItem
Öğe bilgilerini alacak COMBOBOXEXITEM yapısının işaretçisi.

Dönüş Değeri

İşlem başarılı olursa sıfır olmayan; aksi takdirde 0.

Açıklamalar

Bu üye işlevi, Windows SDK'da açıklandığı gibi CBEM_GETITEM iletinin işlevselliğini uygular.

CComboBoxEx::HasEditChanged

Kullanıcının yazarak düzenleme denetiminin ComboBoxEx içeriğini değiştirip değiştirmediğini belirler.

BOOL HasEditChanged();

Dönüş Değeri

Kullanıcı denetimin düzenleme kutusuna yazdıysa sıfır olmayan; aksi takdirde 0.

Açıklamalar

Bu üye işlevi, Windows SDK'da açıklandığı gibi ileti CBEM_HASEDITCHANGED işlevselliğini uygular.

CComboBoxEx::InsertItem

Denetime yeni bir ComboBoxEx öğe ekler.

int InsertItem(const COMBOBOXEXITEM* pCBItem);

Parametreler

pCBItem
Öğe bilgilerini alacak COMBOBOXEXITEM yapısının işaretçisi. Bu yapı, öğenin geri çağırma bayrağı değerlerini içerir.

Dönüş Değeri

Başarılı olursa yeni öğenin eklendiği dizin; aksi takdirde -1.

Açıklamalar

çağrısı InsertItemyaptığınızda, üst pencereye CBEN_INSERTITEM bildirimi içeren bir WM_NOTIFY iletisi gönderilir.

CComboBoxEx::SetExtendedStyle

Birleşik giriş kutusu genişletilmiş denetimi için kullanılan genişletilmiş stilleri ayarlamak için bu üye işlevini çağırın.

DWORD SetExtendedStyle(
    DWORD dwExMask,
    DWORD dwExStyles);

Parametreler

dwExMask
dwExStyles içindeki hangi stillerin etkileneceğini gösteren DWORD değeri. Yalnızca dwExMask içindeki genişletilmiş stiller değiştirilir. Diğer tüm stiller olduğu gibi korunur. Bu parametre sıfırsa, dwExStyles içindeki tüm stiller etkilenir.

dwExStyles
Denetim için ayarlanacağı genişletilmiş stilleri içeren birleşik giriş kutusu denetimi DWORD değeri.

Dönüş Değeri

Daha önce denetim için kullanılan genişletilmiş stilleri içeren bir DWORD değeri.

Açıklamalar

Bu stiller hakkında daha fazla bilgi için bkz. Windows SDK'sında ComboBoxEx Denetimi Genişletilmiş Stilleri.

Genişletilmiş windows stilleriyle birleşik giriş kutusu genişletilmiş denetimi oluşturmak için CreateEx kullanın.

CComboBoxEx::SetImageList

Denetim için ComboBoxEx bir görüntü listesi ayarlar.

CImageList* SetImageList(CImageList* pImageList);

Parametreler

pImageList
Denetimle kullanılacak görüntüleri içeren bir CImageList nesne işaretçisi CComboBoxEx .

Dönüş Değeri

Daha önce denetim tarafından kullanılan görüntüleri içeren bir CImageList nesnesine yönelik CComboBoxEx bir işaretçi. Daha önce ayarlanmış bir resim listesi yoksa NULL.

Açıklamalar

Bu üye işlevi, Windows SDK'da açıklandığı gibi ileti CBEM_SETIMAGELIST işlevselliğini uygular. Varsayılan düzenleme denetiminin yüksekliğini değiştirirseniz, çağrısı yaptıktan sonra denetiminizi yeniden boyutlandırmak için SetWindowPos Win32 işlevini çağırınSetImageList, aksi takdirde düzgün görüntülenmez.

CImageList Dönüş değeri tarafından işaret edilen nesne geçici bir nesnedir ve bir sonraki boşta işlem zamanında yok edilir.

CComboBoxEx::SetItem

Denetimdeki bir öğenin ComboBoxEx özniteliklerini ayarlar.

BOOL SetItem(const COMBOBOXEXITEM* pCBItem);

Parametreler

pCBItem
Öğe bilgilerini alacak COMBOBOXEXITEM yapısının işaretçisi.

Dönüş Değeri

İşlem başarılı olursa sıfır olmayan; aksi takdirde 0.

Açıklamalar

Bu üye işlevi, windows SDK'sında açıklandığı gibi ileti CBEM_SETITEM işlevselliğini uygular.

CComboBoxEx::SetWindowTheme

Genişletilmiş birleşik giriş kutusu denetiminin görsel stilini ayarlar.

HRESULT SetWindowTheme(LPCWSTR pszSubAppName);

Parametreler

pszSubAppName
Ayarlanacağı genişletilmiş birleşik giriş kutusu görsel stilini içeren unicode dize işaretçisi.

Dönüş Değeri

Dönüş değeri kullanılmaz.

Açıklamalar

Bu üye işlevi, Windows SDK'da açıklandığı gibi CBEM_SETWINDOWTHEME iletisinin işlevselliğine öykünmektedir.

Ayrıca bkz.

MFC Örnek MFCIE
CComboBox Sınıfı
Hiyerarşi Grafiği
CComboBox Sınıfı