CMFCRibbonComboBox 클래스
클래스는 CMFCRibbonComboBox 리본 표시줄, 리본 패널 또는 리본 팝업 메뉴에 추가할 수 있는 콤보 상자 컨트롤을 구현합니다.
구문
class CMFCRibbonComboBox : public CMFCRibbonEdit
멤버
생성자
| 속성 | 설명 |
|---|---|
| CMFCRibbonComboBox::CMFCRibbonComboBox | CMFCRibbonComboBox 개체를 생성합니다. |
공용 메서드
설명
리본 메뉴 콤보 상자는 사용자가 편집할 수 있는 정적 레이블 또는 레이블과 결합된 목록 상자로 구성됩니다. 리본 콤보 상자를 만들 때 원하는 형식을 지정해야 합니다.
예시
다음 예제에서는 클래스의 CMFCRibbonComboBox 개체를 생성하고, 콤보 상자에 항목을 추가하고, 콤보 상자에서 항목을 선택하고, 패널에 콤보 상자를 추가하는 방법을 보여 줍니다.
// 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);
상속 계층 구조
요구 사항
헤더: afxribboncombobox.h
CMFCRibbonComboBox::AddItem
목록 상자에 고유한 항목을 추가합니다.
virtual INT_PTR AddItem(
LPCTSTR lpszItem,
DWORD_PTR dwData=0);
매개 변수
lpszItem
[in] 추가할 항목의 문자열입니다.
dwData
[in] 추가할 항목과 연결된 데이터입니다.
Return Value
추가된 항목의 인덱스(0부터 시작하는 인덱스)입니다.
CMFCRibbonComboBox::CMFCRibbonComboBox
CMFCRibbonComboBox 개체를 생성합니다.
public:
CMFCRibbonComboBox(
UINT nID,
BOOL bHasEditBox=TRUE,
Int nWidth=-1,
LPCTSTR lpszLabel=NULL,
Int nImage=-1);
protected:
CMFCRibbonComboBox();
매개 변수
nID
[in] 콤보 상자의 ID입니다.
bHasEditBox
[in] 컨트롤 내에서 편집 상자를 원하는 경우 TRUE입니다. 그렇지 않으면 FALSE입니다.
nWidth
[in] 콤보 상자의 너비(픽셀)입니다. 또는 기본 너비의 경우 -1입니다.
lpszLabel
[in] 콤보 상자의 표시 레이블입니다.
nImage
[in] 콤보 상자의 작은 이미지 인덱스입니다.
설명
기본 너비는 108픽셀입니다.
CMFCRibbonComboBox::D eleteItem
목록 상자에서 지정된 항목을 삭제합니다.
BOOL DeleteItem(int iIndex);
BOOL DeleteItem(DWORD_PTR dwData);
BOOL DeleteItem(LPCTSTR lpszText);
매개 변수
iIndex
[in] 삭제할 항목의 인덱스(0부터 시작)입니다.
dwData
[in] 삭제할 항목과 연결된 데이터입니다.
lpszText
[in] 삭제할 항목의 문자열입니다. 동일한 문자열을 가진 여러 항목이 있는 경우 첫 번째 항목이 삭제됩니다.
Return Value
지정된 항목이 삭제된 경우 TRUE입니다. 그렇지 않으면 FALSE입니다.
설명
CMFCRibbonComboBox::EnableDropDownListResize
목록 상자가 드롭다운할 때 크기를 변경할 수 있는지 여부를 지정합니다.
void EnableDropDownListResize(BOOL bEnable=FALSE);
매개 변수
bEnable
[in] 크기 조정을 사용하도록 설정하려면 TRUE입니다. 크기 조정을 사용하지 않도록 설정하려면 FALSE입니다.
설명
크기 조정을 사용하도록 설정하면 목록 상자가 표시되는 항목에 맞게 크기가 변경됩니다.
CMFCRibbonComboBox::FindItem
목록 상자에서 지정된 문자열과 일치하는 첫 번째 항목의 인덱스 값을 반환합니다.
int FindItem(LPCTSTR lpszText) const;
매개 변수
lpszText
[in] 목록 상자에 있는 항목의 문자열입니다.
Return Value
항목의 인덱스(0부터 시작하는 인덱스)입니다. 항목을 찾을 수 없으면 -1입니다.
설명
CMFCRibbonComboBox::GetCount
목록 상자의 항목 수를 반환합니다.
INT_PTR GetCount() const;
Return Value
목록 상자의 항목 수이거나, 목록 상자에 항목이 없는 경우 0입니다.
설명
CMFCRibbonComboBox::GetCurSel
목록 상자에서 현재 선택한 항목의 인덱스입니다.
int GetCurSel() const;
Return Value
목록 상자에서 현재 선택한 항목의 인덱스(0부터 시작하는 인덱스)입니다. 또는 -1(항목이 선택되지 않은 경우)입니다.
CMFCRibbonComboBox::GetDropDownHeight
목록 상자가 드롭다운될 때 목록 상자의 높이를 가져옵니다.
int GetDropDownHeight();
Return Value
목록 상자의 높이(픽셀)입니다.
설명
CMFCRibbonComboBox::GetIntermediateSize
중간 모드에 표시된 대로 콤보 상자의 크기를 반환합니다.
virtual CSize GetIntermediateSize(CDC* pDC);
매개 변수
pDC
[in] 콤보 상자의 디바이스 컨텍스트에 대한 포인터입니다.
Return Value
콤보 상자의 크기입니다.
설명
반환되는 크기는 작은 이미지를 표시할 때 콤보 상자의 크기를 기반으로 합니다.
CMFCRibbonComboBox::GetItem
목록 상자의 지정된 인덱스에서 항목과 연결된 문자열을 반환합니다.
LPCTSTR GetItem(int iIndex) const;
매개 변수
iIndex
[in] 목록 상자에 있는 항목의 인덱스(0부터 시작하는 인덱스)입니다.
Return Value
항목과 연결된 문자열에 대한 포인터입니다. 그렇지 않으면 인덱스 매개 변수가 잘못되었거나 인덱스 매개 변수가 -1이고 콤보 상자에서 선택된 항목이 없는 경우 NULL입니다.
설명
CMFCRibbonComboBox::GetItemData
목록 상자의 지정된 인덱스에서 항목과 연결된 데이터를 반환합니다.
DWORD_PTR GetItemData(int iIndex) const;
매개 변수
iIndex
[in] 목록 상자에 있는 항목의 인덱스(0부터 시작하는 인덱스)입니다.
Return Value
항목과 연결된 데이터입니다. 또는 항목이 없거나 인덱스 매개 변수가 -1이고 목록 상자에 선택된 항목이 없는 경우 0입니다.
CMFCRibbonComboBox::HasEditBox
컨트롤에 편집 상자가 포함되어 있는지 여부를 나타냅니다.
BOOL HasEditBox() const;
Return Value
컨트롤에 편집 상자가 포함되어 있으면 TRUE입니다. 그렇지 않으면 FALSE입니다.
설명
CMFCRibbonComboBox::IsResizeDropDownList
목록 상자의 크기를 조정할 수 있는지 여부를 나타냅니다.
BOOL IsResizeDropDownList() const;
Return Value
목록 상자의 크기를 조정할 수 있으면 TRUE입니다. 그렇지 않으면 FALSE입니다. CMFCRibbonComboBox::EnableDropDownListResize
설명
CMFCRibbonComboBox::EnableDropDownListResize 메서드를 사용하여 목록 상자 크기 조정을 사용하도록 설정할 수 있습니다.
CMFCRibbonComboBox::OnSelectItem
사용자가 목록 상자에서 항목을 선택할 때 프레임워크에서 호출됩니다.
virtual void OnSelectItem(int nItem);
매개 변수
nItem
[in] 선택한 항목의 인덱스입니다.
설명
사용자 입력 선택을 처리하려는 경우 이 메서드를 재정의합니다.
CMFCRibbonComboBox::RemoveAllItems
목록 상자에서 모든 항목을 삭제하고 편집 상자를 지웁니다.
void RemoveAllItems();
설명
CMFCRibbonComboBox::SelectItem
목록 상자에서 항목을 선택합니다.
BOOL SelectItem(int iIndex);
BOOL SelectItem(DWORD_PTR dwData);
BOOL SelectItem(LPCTSTR lpszText);
매개 변수
iIndex
[in] 목록 상자에 있는 항목의 인덱스(0부터 시작하는 인덱스)입니다.
dwData
[in] 목록 상자의 항목과 연결된 데이터입니다.
lpszText
[in] 목록 상자에 있는 항목의 문자열입니다.
Return Value
메서드가 성공하면 TRUE입니다. 그렇지 않으면 FALSE입니다.
설명
CMFCRibbonComboBox::SetDropDownHeight
드롭다운할 때 목록 상자의 높이를 설정합니다.
void SetDropDownHeight(int nHeight);
매개 변수
nHeight
[in] 목록 상자의 높이(픽셀)입니다.
설명
기본 높이는 150픽셀입니다.