CMFCRibbonComboBox Sınıfı
sınıfı, CMFCRibbonComboBox şerit çubuğuna, şerit paneline veya şerit açılır menüsüne ekleyebileceğiniz bir birleşik giriş kutusu denetimi uygular.
Sözdizimi
class CMFCRibbonComboBox : public CMFCRibbonEdit
Üyeler
Oluşturucular
| Veri Akışı Adı | Açıklama |
|---|---|
| CMFCRibbonComboBox::CMFCRibbonComboBox | CMFCRibbonComboBox nesnesi oluşturur. |
Genel Yöntemler
| Veri Akışı Adı | Açıklama |
|---|---|
| CMFCRibbonComboBox::AddItem | Liste kutusuna benzersiz bir öğe ekler. |
| CMFCRibbonComboBox::D eleteItem | Belirtilen öğeyi liste kutusundan siler. |
| CMFCRibbonComboBox::EnableDropDownListResize | Liste kutusunun aşağı düştüğünde boyutu değiştirip değiştiremeyeceğini belirtir. |
| CMFCRibbonComboBox::FindItem | Liste kutusundaki belirtilen dizeyle eşleşen ilk öğenin dizinini döndürür. |
| CMFCRibbonComboBox::GetCount | Liste kutusundaki öğe sayısını döndürür. |
| CMFCRibbonComboBox::GetCurSel | Liste kutusunda seçili durumdaki öğenin dizinini alır. |
| CMFCRibbonComboBox::GetDropDownHeight | Liste kutusu aşağı bırakıldığında liste kutusunun yüksekliğini alır. |
| CMFCRibbonComboBox::GetIntermediateSize | Ara modda gösterildiği gibi birleşik giriş kutusunun boyutunu döndürür. |
| CMFCRibbonComboBox::GetItem | Liste kutusunda belirtilen dizindeki bir öğeyle ilişkilendirilmiş dizeyi döndürür. |
| CMFCRibbonComboBox::GetItemData | Liste kutusunda belirtilen dizindeki bir öğeyle ilişkili verileri döndürür. |
| CMFCRibbonComboBox::HasEditBox | Denetimin düzenleme kutusu içerip içermediğini gösterir. |
| CMFCRibbonComboBox::IsResizeDropDownList | Liste kutusunun yeniden boyutlandırılıp boyutlandırılamayacağını gösterir. |
| CMFCRibbonComboBox::OnSelectItem | Kullanıcı liste kutusunda bir öğe seçtiğinde çerçeve tarafından çağrılır. |
| CMFCRibbonComboBox::RemoveAllItems | Liste kutusundan tüm öğeleri siler ve düzenleme kutusunu temizler. |
| CMFCRibbonComboBox::SelectItem | Liste kutusunda bir öğe seçer. |
| CMFCRibbonComboBox::SetDropDownHeight | Liste kutusunun aşağı bırakıldığında yüksekliğini ayarlar. |
Açıklamalar
Şerit birleşik giriş kutusu, kullanıcı tarafından düzenlenebilen statik bir etiket veya etiketle birleştirilmiş bir liste kutusundan oluşur. Şerit birleşik giriş kutunuzu oluştururken istediğiniz türü belirtmeniz gerekir.
Örnek
Aşağıdaki örnekte sınıfın bir nesnesinin CMFCRibbonComboBox nasıl oluşturulur, birleşik giriş kutusuna öğe eklenir, birleşik giriş kutusundan bir öğe seçilir ve panele birleşik giriş kutusu eklenir.
// Create a simple combo box with two entries:
// The first parameter is the id of the combo box.
// The third parameter is the width of the combo box in pixels.
// The fourth parameter is the display label of the combo box.
// The fifth parameter is the index of the small image of the combo box.
CMFCRibbonComboBox *pComboSimple = new CMFCRibbonComboBox(-1, FALSE, -1, 0, -1);
// Add two items to the combo box and select the first item in the list:
pComboSimple->AddItem(_T("Hi!"));
pComboSimple->AddItem(_T("Hello!"));
pComboSimple->SelectItem(0);
// Add combo button to "Favorites" panel:
// CMFCRibbonPanel* pPanelFavorites
pPanelFavorites->Add(pComboSimple);
Devralma Hiyerarşisi
Gereksinimler
Üst bilgi: afxribboncombobox.h
CMFCRibbonComboBox::AddItem
Liste kutusuna benzersiz bir öğe ekler.
virtual INT_PTR AddItem(
LPCTSTR lpszItem,
DWORD_PTR dwData=0);
Parametreler
lpszItem
[in] Eklenecek öğenin dizesi.
dwData
[in] Eklenecek öğeyle ilişkili veriler.
Dönüş Değeri
Eklenen öğenin sıfır tabanlı dizini.
CMFCRibbonComboBox::CMFCRibbonComboBox
Bir CMFCRibbonComboBox nesne oluşturur.
public:
CMFCRibbonComboBox(
UINT nID,
BOOL bHasEditBox=TRUE,
Int nWidth=-1,
LPCTSTR lpszLabel=NULL,
Int nImage=-1);
protected:
CMFCRibbonComboBox();
Parametreler
Nıd
[in] Birleşik giriş kutusunun kimliği.
bHasEditBox
[in] Denetim içinde bir düzenleme kutusu istiyorsanız TRUE; FALSE aksi takdirde.
nWidth
[in] Birleşik giriş kutusunun piksel cinsinden genişliği; veya varsayılan genişlik için -1.
lpszLabel
[in] Birleşik giriş kutusunun görünen etiketi.
nImage
[in] Birleşik giriş kutusunun küçük görüntü dizini.
Açıklamalar
Varsayılan genişlik 108 pikseldir.
CMFCRibbonComboBox::D eleteItem
Belirtilen öğeyi liste kutusundan siler.
BOOL DeleteItem(int iIndex);
BOOL DeleteItem(DWORD_PTR dwData);
BOOL DeleteItem(LPCTSTR lpszText);
Parametreler
iIndex
[in] Silinecek öğenin sıfır tabanlı dizini.
dwData
[in] Silinecek öğeyle ilişkili veriler.
lpszText
[in] Silinecek öğenin dizesi. Aynı dizeye sahip birden çok öğe varsa, ilk öğe silinir.
Dönüş Değeri
Belirtilen öğe silinmişse DOĞRU; aksi takdirde YANLIŞ.
Açıklamalar
CMFCRibbonComboBox::EnableDropDownListResize
Liste kutusunun aşağı düştüğünde boyutu değiştirip değiştiremeyeceğini belirtir.
void EnableDropDownListResize(BOOL bEnable=FALSE);
Parametreler
bEnable
[in] Yeniden boyutlandırmayı etkinleştirmek için TRUE; Yeniden boyutlandırmayı devre dışı bırakmak için FALSE.
Açıklamalar
Yeniden boyutlandırma etkinleştirildiğinde, liste kutusu görüntülenen öğelere uyacak şekilde boyut değiştirir.
CMFCRibbonComboBox::FindItem
Liste kutusundaki belirtilen dizeyle eşleşen ilk öğenin dizinini döndürür.
int FindItem(LPCTSTR lpszText) const;
Parametreler
lpszText
[in] Liste kutusundaki bir öğenin dizesi.
Dönüş Değeri
Öğenin sıfır tabanlı dizini; veya öğe bulunamazsa -1.
Açıklamalar
CMFCRibbonComboBox::GetCount
Liste kutusundaki öğe sayısını döndürür.
INT_PTR GetCount() const;
Dönüş Değeri
Liste kutusundaki öğe sayısı veya liste kutusunda öğe yoksa 0.
Açıklamalar
CMFCRibbonComboBox::GetCurSel
Liste kutusunda seçili durumdaki öğenin dizinini alır.
int GetCurSel() const;
Dönüş Değeri
Liste kutusunda seçili durumdaki öğenin sıfır tabanlı dizini; veya hiçbir öğe seçilmediyse -1.
CMFCRibbonComboBox::GetDropDownHeight
Liste kutusu aşağı bırakıldığında liste kutusunun yüksekliğini alır.
int GetDropDownHeight();
Dönüş Değeri
Liste kutusunun piksel cinsinden yüksekliği.
Açıklamalar
CMFCRibbonComboBox::GetIntermediateSize
Ara modda gösterildiği gibi birleşik giriş kutusunun boyutunu döndürür.
virtual CSize GetIntermediateSize(CDC* pDC);
Parametreler
pDC
[in] Birleşik giriş kutusu için bir cihaz bağlamı işaretçisi.
Dönüş Değeri
Birleşik giriş kutusunun boyutu.
Açıklamalar
Döndürülen boyut, küçük görüntüler görüntülendiğinde birleşik giriş kutusunun boyutuna bağlıdır.
CMFCRibbonComboBox::GetItem
Liste kutusunda belirtilen dizindeki bir öğeyle ilişkilendirilmiş dizeyi döndürür.
LPCTSTR GetItem(int iIndex) const;
Parametreler
iIndex
[in] Liste kutusundaki bir öğenin sıfır tabanlı dizini.
Dönüş Değeri
Öğeyle ilişkilendirilmiş dize işaretçisi; aksi takdirde, dizin parametresi geçersizse veya dizin parametresi -1 ise ve birleşik giriş kutusunda seçili öğe yoksa NULL olur.
Açıklamalar
CMFCRibbonComboBox::GetItemData
Liste kutusunda belirtilen dizindeki bir öğeyle ilişkili verileri döndürür.
DWORD_PTR GetItemData(int iIndex) const;
Parametreler
iIndex
[in] Liste kutusundaki bir öğenin sıfır tabanlı dizini.
Dönüş Değeri
Öğeyle ilişkili veriler; veya öğe yoksa veya dizin parametresi -1 ise ve liste kutusunda seçili öğe yoksa 0.
CMFCRibbonComboBox::HasEditBox
Denetimin düzenleme kutusu içerip içermediğini gösterir.
BOOL HasEditBox() const;
Dönüş Değeri
Denetim bir düzenleme kutusu içeriyorsa TRUE; aksi takdirde YANLIŞ.
Açıklamalar
CMFCRibbonComboBox::IsResizeDropDownList
Liste kutusunun yeniden boyutlandırılıp boyutlandırılamayacağını gösterir.
BOOL IsResizeDropDownList() const;
Dönüş Değeri
Liste kutusu yeniden boyutlandırılabilirse DOĞRU; aksi takdirde YANLIŞ. CMFCRibbonComboBox::EnableDropDownListResize
Açıklamalar
CMFCRibbonComboBox::EnableDropDownListResize yöntemini kullanarak liste kutusunu yeniden boyutlandırmayı etkinleştirebilirsiniz.
CMFCRibbonComboBox::OnSelectItem
Kullanıcı liste kutusundan bir öğe seçtiğinde çerçeve tarafından çağrılır.
virtual void OnSelectItem(int nItem);
Parametreler
nItem
[in] Seçili öğenin dizini.
Açıklamalar
Kullanıcı girişi seçimini işlemek istiyorsanız bu yöntemi geçersiz kılın.
CMFCRibbonComboBox::RemoveAllItems
Liste kutusundan tüm öğeleri siler ve düzenleme kutusunu temizler.
void RemoveAllItems();
Açıklamalar
CMFCRibbonComboBox::SelectItem
Liste kutusunda bir öğe seçer.
BOOL SelectItem(int iIndex);
BOOL SelectItem(DWORD_PTR dwData);
BOOL SelectItem(LPCTSTR lpszText);
Parametreler
iIndex
[in] Liste kutusundaki bir öğenin sıfır tabanlı dizini.
dwData
[in] Liste kutusundaki bir öğeyle ilişkili veriler.
lpszText
[in] Liste kutusundaki bir öğenin dizesi.
Dönüş Değeri
Yöntem başarılı olursa TRUE; aksi takdirde YANLIŞ.
Açıklamalar
CMFCRibbonComboBox::SetDropDownHeight
Liste kutusunun aşağı bırakıldığında yüksekliğini ayarlar.
void SetDropDownHeight(int nHeight);
Parametreler
nHeight
[in] Liste kutusunun piksel cinsinden yüksekliği.
Açıklamalar
Varsayılan yükseklik 150 pikseldir.