다음을 통해 공유


CMFCToolBarComboBoxButton 클래스

콤보 상자 컨트롤( CComboBox 클래스)이 포함된 도구 모음 단추입니다.

구문

class CMFCToolBarComboBoxButton : public CMFCToolBarButton

멤버

공용 생성자

속성 설명
CMFCToolBarComboBoxButton::CMFCToolBarComboBoxButton CMFCToolBarComboBoxButton를 생성합니다.

공용 메서드

이름 설명
CMFCToolBarComboBoxButton::AddItem 콤보 상자 목록의 끝에 항목을 추가합니다.
CMFCToolBarComboBoxButton::AddSortedItem 콤보 상자 목록에 항목을 추가합니다. 목록의 항목 순서는 .에 의해 Compare지정됩니다.
CMFCToolBarComboBoxButton::Compare 두 항목을 비교합니다. 콤보 상자 목록에 추가되는 AddSortedItems 항목을 정렬하기 위해 호출됩니다.
CMFCToolBarComboBoxButton::CreateEdit 콤보 상자 단추에 대한 새 편집 컨트롤을 만듭니다.
CMFCToolBarComboBoxButton::D eleteItem 콤보 상자 목록에서 항목을 삭제합니다.
CMFCToolBarComboBoxButton::FindItem 지정된 문자열을 포함하는 항목의 인덱스를 반환합니다.
CMFCToolBarComboBoxButton::GetByCmd 지정된 명령 ID를 사용하여 콤보 상자 단추에 대한 포인터를 반환합니다.
CMFCToolBarComboBoxButton::GetComboBox 콤보 상자 단추에 포함된 콤보 상자 컨트롤에 대한 포인터를 반환합니다.
CMFCToolBarComboBoxButton::GetCount 콤보 상자 목록의 항목 수를 반환합니다.
CMFCToolBarComboBoxButton::GetCountAll 지정된 명령 ID가 있는 콤보 상자 단추를 찾습니다. 해당 단추의 콤보 상자 목록에 있는 항목 수를 반환합니다.
CMFCToolBarComboBoxButton::GetCurSel 콤보 상자 목록에서 선택한 항목의 인덱스 값을 반환합니다.
CMFCToolBarComboBoxButton::GetCurSelAll 지정된 명령 ID가 있는 콤보 상자 단추를 찾고 해당 단추의 콤보 상자 목록에서 선택한 항목의 인덱스 값을 반환합니다.
CMFCToolBarComboBoxButton::GetEditCtrl 콤보 상자 단추에 포함된 편집 컨트롤에 대한 포인터를 반환합니다.
CMFCToolBarComboBoxButton::GetItem 콤보 상자 목록에서 지정된 인덱스와 연결된 문자열을 반환합니다.
CMFCToolBarComboBoxButton::GetItemAll 지정된 명령 ID가 있는 콤보 상자 단추를 찾고 해당 단추의 콤보 상자 목록에서 인덱스와 연결된 문자열을 반환합니다.
CMFCToolBarComboBoxButton::GetItemData 콤보 상자 목록에서 지정된 인덱스와 연결된 32비트 값을 반환합니다.
CMFCToolBarComboBoxButton::GetItemDataAll 지정된 명령 ID가 있는 콤보 상자 단추를 찾고 해당 단추의 콤보 상자 목록에서 인덱스와 연결된 32비트 값을 반환합니다.
CMFCToolBarComboBoxButton::GetItemDataPtrAll 지정된 명령 ID가 있는 콤보 상자 단추를 찾습니다. 해당 단추의 콤보 상자 목록에서 인덱스와 연결된 32비트 값을 검색하고 32비트 값을 포인터로 반환합니다.
CMFCToolBarComboBoxButton::GetText 콤보 상자의 편집 컨트롤에서 텍스트를 반환합니다.
CMFCToolBarComboBoxButton::GetTextAll 지정된 명령 ID가 있는 콤보 상자 단추를 찾고 해당 단추의 편집 컨트롤에서 텍스트를 반환합니다.
CMFCToolBarComboBoxButton::IsCenterVert 애플리케이션의 콤보 상자 단추가 도구 모음의 위쪽에 맞춰지는지 여부를 결정합니다.
CMFCToolBarComboBoxButton::IsFlatMode 애플리케이션의 콤보 상자 단추가 평평한 모양인지 여부를 결정합니다.
CMFCToolBarComboBoxButton::RemoveAllItems 목록 상자에서 모든 항목을 제거하고 콤보 상자의 편집 컨트롤을 제거합니다.
CMFCToolBarComboBoxButton::SelectItem 인덱스, 32비트 값 또는 문자열에 따라 콤보 상자에서 항목을 선택하고 선택 항목에 대해 콤보 상자 컨트롤에 알립니다.
CMFCToolBarComboBoxButton::SelectItemAll 지정된 명령 ID가 있는 콤보 상자 단추를 찾습니다. 문자열, 인덱스 또는 32비트 값에 따라 해당 단추의 콤보 상자에서 항목을 선택하기 위해 호출 SelectItem 합니다.
CMFCToolBarComboBoxButton::SetCenterVert 애플리케이션의 콤보 상자 단추가 세로로 가운데에 맞춰지거나 도구 모음의 위쪽에 맞춰지는지 여부를 지정합니다.
CMFCToolBarComboBoxButton::SetDropDownHeight 드롭다운 목록 상자의 높이를 설정합니다.
CMFCToolBarComboBoxButton::SetFlatMode 애플리케이션의 콤보 상자 단추가 평평한 모양인지 여부를 지정합니다.

설명

도구 모음에 콤보 상자 단추를 추가하려면 다음 단계를 수행합니다.

  1. 부모 도구 모음 리소스의 단추에 대한 더미 리소스 ID를 예약합니다.

  2. 개체를 CMFCToolBarComboBoxButton 생성합니다.

  3. AFX_WM_RESETTOOLBAR 메시지를 처리하는 메시지 처리기에서 CMFCToolBar::ReplaceButton을 사용하여 더미 단추를 새 콤보 상자 단추로 바꿉니다.

자세한 내용은 연습: 도구 모음에 컨트롤 배치를 참조 하세요. 콤보 상자 도구 모음 단추의 예제는 예제 프로젝트 VisualStudioDemo를 참조하세요.

예시

다음 예제에서는 CMFCToolBarComboBoxButton 클래스에서 다양한 메서드를 사용하는 방법을 보여 줍니다. 이 예제에서는 편집 및 콤보 상자를 사용하도록 설정하고, 애플리케이션에서 콤보 상자 단추의 세로 위치를 설정하고, 드롭다운할 때 목록 상자의 높이를 설정하고, 애플리케이션에서 콤보 상자 단추의 플랫 스타일 모양을 설정하고, 콤보 상자 단추의 편집 상자에 텍스트를 설정하는 방법을 보여 줍니다. 이 코드 조각은 Visual Studio 데모 샘플일부입니다.

// CObList listButtons
// POSITION posCombo
CMFCToolBarComboBoxButton* pCombo = DYNAMIC_DOWNCAST(CMFCToolBarComboBoxButton, listButtons.GetNext(posCombo));
pCombo->EnableWindow(true);
pCombo->SetCenterVert();
pCombo->SetDropDownHeight(25);
pCombo->SetFlatMode();
pCombo->SetText(_T("this is a combo box"));

상속 계층 구조

CObject

CMFCToolBarButton

CMFCToolBarComboBoxButton

요구 사항

헤더: afxtoolbarcomboboxbutton.h

CMFCToolBarComboBoxButton::AddItem

목록 상자에 고유한 항목을 추가합니다.

virtual INT_PTR AddItem(
    LPCTSTR lpszItem,
    DWORD_PTR dwData=0);

매개 변수

lpszItem
[in] 목록 상자에 추가할 항목의 텍스트입니다.

dwData
[in] 목록 상자에 추가할 항목과 연결된 데이터입니다.

Return Value

목록 상자의 마지막 항목 인덱스입니다.

설명

목록 상자 스타일이 정렬될 때는 이 메서드를 사용하지 마세요.

항목 텍스트가 이미 목록 상자에 있는 경우 새 데이터는 기존 항목과 함께 저장됩니다. 항목에 대한 검색은 대/소문자를 구분합니다.

CMFCToolBarComboBoxButton::AddSortedItem

Compare 메서드에 정의된 순서대로 목록 상자에 항목을 추가합니다.

virtual INT_PTR AddSortedItem(
    LPCTSTR lpszItem,
    DWORD_PTR dwData=0);

매개 변수

lpszItem
[in] 목록 상자에 추가할 항목의 텍스트입니다.

dwData
[in] 목록 상자에 추가할 항목과 연결된 데이터입니다.

Return Value

목록 상자에 추가된 항목의 인덱스입니다.

설명

이 함수를 사용하여 특정 순서로 목록 상자에 항목을 추가합니다.

CMFCToolBarComboBoxButton::CanBeStretched

콤보 상자 단추 크기를 변경할 수 있는지 여부를 나타냅니다.

virtual BOOL CanBeStretched() const;

Return Value

TRUE를 반환합니다.

CMFCToolBarComboBoxButton::CMFCToolBarComboBoxButton

CMFCToolBarComboBoxButton 개체를 생성합니다.

CMFCToolBarComboBoxButton(
    UINT uiID,
    int iImage,
    DWORD dwStyle=CBS_DROPDOWNLIST,
    int iWidth=0);

매개 변수

uiID
[in] 새 단추의 명령 ID입니다.

iImage
[in] 새 단추와 연결된 이미지의 이미지 인덱스입니다.

dwStyle
[in] 새 단추의 스타일입니다.

iWidth
[in] 새 단추의 너비(픽셀)입니다.

설명

기본 너비는 150픽셀입니다.

도구 모음 단추 스타일 목록은 도구 모음 컨트롤 스타일을 참조 하세요.

CMFCToolBarComboBoxButton::ClearData

사용자 정의 데이터를 삭제합니다.

virtual void ClearData();

설명

기본적으로 이 메서드는 아무 작업도 수행하지 않습니다. 사용자 정의 데이터를 삭제하려는 경우 파생 클래스에서 이 메서드를 재정의합니다.

CMFCToolBarComboBoxButton::Compare

두 문자열을 비교합니다.

virtual int Compare(
    LPCTSTR lpszItem1,
    LPCTSTR lpszItem2);

매개 변수

lpszItem1
[in] 비교할 첫 번째 문자열입니다.

lpszItem2
[in] 비교할 두 번째 문자열입니다.

Return Value

문자열 간의 대/소문자 구분 어휘 관계를 나타내는 값입니다. 다음 표에서는 가능한 값을 나열합니다.

설명
<0 첫 번째 문자열은 두 번째 문자열보다 작습니다.
0 첫 번째 문자열은 두 번째 문자열과 같습니다.
>0 첫 번째 문자열이 두 번째 문자열보다 큽다.

설명

목록 상자에서 항목을 정렬하는 방법을 변경하려면 이 메서드를 재정의합니다.

비교 시 대/소문자를 구분합니다.

이 메서드는 AddSortedItem 메서드에서만 호출됩니다.

CMFCToolBarComboBoxButton::CopyFrom

지정된 CMFCToolBarComboBoxButton 상태를 현재 개체에 복사합니다.

virtual void CopyFrom(const CMFCToolBarButton& src);

매개 변수

src
[in] 원본 CMFCToolBarComboBoxButton 개체입니다.

CMFCToolBarComboBoxButton::CreateCombo

콤보 상자 단추에 대한 새 콤보 상자를 만듭니다.

virtual CComboBox* CreateCombo(
    CWnd* pWndParent,
    const CRect& rect);

매개 변수

pWndParent
[in] 단추의 부모 창에 대한 포인터입니다.

rect
[in] 콤보 상자의 경계 사각형입니다.

Return Value

메서드가 성공한 경우 새 콤보 상자에 대한 포인터입니다. 그렇지 않으면 NULL입니다.

CMFCToolBarComboBoxButton::CreateEdit

콤보 상자 단추에 대한 새 편집 상자를 만듭니다.

virtual CMFCToolBarComboBoxEdit* CreateEdit(
    CWnd* pWndParent,
    const CRect& rect,
    DWORD dwEditStyle);

매개 변수

pWndParent
[in] 단추의 부모 창에 대한 포인터입니다.

rect
[in] 새 편집 상자의 경계 사각형입니다.

dwEditStyle
[in] 새 편집 상자의 컨트롤 스타일입니다.

Return Value

메서드가 성공한 경우 새 편집 상자에 대한 포인터입니다. 그렇지 않으면 NULL입니다.

설명

프레임워크는 콤보 상자 단추에 대한 새 편집 상자를 만들 때 이 메서드를 호출합니다. CMFCToolBarComboBoxEdit를 만드는 방법을 변경하려면 이 메서드를 재정의 합니다.

CMFCToolBarComboBoxButton::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입니다.

설명

CMFCToolBarComboBoxButton::D uplicateData

사용자 정의 데이터를 복제합니다.

virtual void DuplicateData();

설명

기본적으로 이 메서드는 아무 작업도 수행하지 않습니다. 사용자 정의 데이터를 복사하려는 경우 파생 클래스에서 이 메서드를 재정의합니다.

CMFCToolBarComboBoxButton::EnableWindow

편집 및 콤보 상자를 사용하거나 사용하지 않도록 설정합니다.

virtual void EnableWindow(BOOL bEnable = TRUE);

매개 변수

bEnable
[in] TRUE이면 편집 및 콤보 상자를 사용할 수 있습니다. 편집 및 콤보 상자를 사용하지 않도록 설정하려면 FALSE입니다.

설명

사용하지 않도록 설정하면 컨트롤이 활성화될 수 없으며 사용자 입력을 허용할 수 없습니다.

CMFCToolBarComboBoxButton::ExportToMenuButton

콤보 상자 단추 명령 ID를 사용하여 애플리케이션 문자열 테이블에서 지정된 메뉴로 문자열을 복사합니다.

virtual BOOL ExportToMenuButton(CMFCToolBarMenuButton& menuButton) const;

매개 변수

menuButton
[out] 메뉴 단추에 대한 참조입니다.

Return Value

항상 TRUE입니다.

CMFCToolBarComboBoxButton::FindItem

지정된 문자열을 포함하는 목록 상자에서 첫 번째 항목의 인덱스를 반환합니다.

int FindItem(LPCTSTR lpszText) const;

매개 변수

lpszText
[in] 목록 상자에서 검색할 텍스트입니다.

Return Value

항목의 인덱스입니다. 또는 항목을 찾을 수 없으면 CB_ERR.

설명

CMFCToolBarComboBoxButton::GetByCmd

지정된 명령 ID가 있는 콤보 상자 단추에 대한 포인터를 가져옵니다.

static CMFCToolBarComboBoxButton* GetByCmd(
    UINT uiCmd,
    BOOL bIsFocus=FALSE);

매개 변수

uiCmd
[in] 콤보 상자 단추의 명령 ID입니다.

bIsFocus
[in] TRUE이면 포커스가 있는 단추만 검색합니다. 모든 단추를 검색하려면 FALSE입니다.

Return Value

콤보 상자 단추에 대한 포인터입니다. 또는 단추를 찾을 수 없는 경우 NULL입니다.

설명

CMFCToolBarComboBoxButton::GetComboBox

콤보 상자 단추의 콤보 상자에 대한 포인터를 반환합니다.

CComboBox* GetComboBox() const;

Return Value

메서드가 성공한 경우 CComboBox 클래스 개체에 대한 포인터입니다. 그렇지 않으면 NULL입니다.

설명

CMFCToolBarComboBoxButton::GetContextMenuID

콤보 상자 단추의 바로 가기 메뉴 리소스 ID를 가져옵니다.

UINT GetContextMenuID();

Return Value

바로 가기 메뉴 리소스 ID입니다.

CMFCToolBarComboBoxButton::GetCount

목록 상자의 항목 수를 반환합니다.

INT_PTR GetCount() const;

Return Value

목록 상자의 항목 수입니다.

설명

CMFCToolBarComboBoxButton::GetCountAll

지정된 명령 ID가 있는 콤보 상자 단추의 목록 상자에 있는 항목 수를 가져옵니다.

static int GetCountAll(UINT uiCmd);

매개 변수

uiCmd
[in] 콤보 상자 단추의 명령 ID입니다.

Return Value

목록 상자의 항목 수입니다. 그렇지 않으면 콤보 상자 단추를 찾을 수 없으면 CB_ERR.

설명

CMFCToolBarComboBoxButton::GetCurSel

목록 상자에서 현재 선택한 항목의 인덱스입니다.

int GetCurSel() const;

Return Value

목록 상자에서 현재 선택한 항목의 인덱스입니다. 또는 항목이 선택되지 않은 경우 CB_ERR.

설명

목록 상자 인덱스가 0부터 시작하는 경우

CMFCToolBarComboBoxButton::GetCurSelAll

지정된 명령 ID가 있는 콤보 상자 단추의 목록 상자에서 현재 선택한 항목의 인덱스 값을 반환합니다.

static int GetCurSelAll(UINT uiCmd);

매개 변수

uiCmd
[in] 콤보 상자 단추의 명령 ID입니다.

Return Value

목록 상자에서 현재 선택한 항목의 인덱스입니다. 그렇지 않으면 항목이 선택되지 않았거나 콤보 상자 단추를 찾을 수 없는 경우 CB_ERR.

설명

목록 상자 인덱스가 0부터 시작하는 경우

CMFCToolBarComboBoxButton::GetEditCtrl

콤보 상자 단추의 편집 상자에 대한 포인터를 반환합니다.

virtual CEdit* GetEditCtrl();

Return Value

메서드가 성공한 경우 편집 상자에 대한 포인터입니다. 그렇지 않으면 NULL입니다.

설명

CMFCToolBarComboBoxButton::GetHwnd

콤보 상자의 창 핸들을 반환합니다.

virtual HWND GetHwnd();

Return Value

창 핸들이거나, 콤보 상자가 창 개체와 연결되지 않은 경우 NULL입니다.

CMFCToolBarComboBoxButton::GetItem

목록 상자의 지정된 인덱스에서 항목과 연결된 문자열을 반환합니다.

LPCTSTR GetItem(int iIndex=-1) const;

매개 변수

iIndex
[in] 목록 상자에 있는 항목의 인덱스(0부터 시작하는 인덱스)입니다.

Return Value

항목과 연결된 문자열에 대한 포인터입니다. 그렇지 않으면 인덱스 매개 변수가 잘못되었거나 인덱스 매개 변수가 -1이고 콤보 상자에 선택된 항목이 없는 경우 NULL입니다.

설명

-1의 인덱스 매개 변수는 현재 선택된 항목의 문자열을 반환합니다.

CMFCToolBarComboBoxButton::GetItemAll

지정된 명령 ID가 있는 콤보 상자 단추의 목록 상자에 있는 지정된 인덱스의 항목과 연결된 문자열을 반환합니다.

static LPCTSTR GetItemAll(
    UINT uiCmd,
    int iIndex=-1);

매개 변수

uiCmd
[in] 콤보 상자 단추의 명령 ID입니다.

iIndex
[in] 목록 상자에 있는 항목의 인덱스(0부터 시작하는 인덱스)입니다.

Return Value

메서드가 성공한 경우 항목의 문자열에 대한 포인터입니다. 그렇지 않으면 인덱스가 유효하지 않거나 콤보 상자 단추를 찾을 수 없거나 인덱스가 -1이고 콤보 상자에 선택된 항목이 없는 경우 NULL입니다.

설명

인덱스 값 -1은 현재 선택된 항목의 문자열을 반환합니다.

CMFCToolBarComboBoxButton::GetItemData

목록 상자의 특정 인덱스에서 항목과 연결된 데이터를 반환합니다.

DWORD_PTR GetItemData(int iIndex=-1) const;

매개 변수

iIndex
[in] 목록 상자에 있는 항목의 인덱스(0부터 시작하는 인덱스)입니다.

Return Value

항목과 연결된 데이터입니다. 항목이 없으면 0입니다.

설명

-1의 인덱스 매개 변수는 현재 선택한 항목과 연결된 데이터를 반환합니다.

CMFCToolBarComboBoxButton::GetItemDataAll

특정 명령 ID가 있는 콤보 상자 단추의 목록 상자에서 특정 인덱스의 항목과 연결된 데이터를 반환합니다.

static DWORD_PTR GetItemDataAll(
    UINT uiCmd,
    int iIndex=-1);

매개 변수

uiCmd
[in] 콤보 상자 단추의 명령 ID입니다.

iIndex
[in] 목록 상자에 있는 항목의 인덱스(0부터 시작하는 인덱스)입니다.

Return Value

메서드가 성공한 경우 항목과 연결된 데이터입니다. 그렇지 않으면 지정된 인덱스가 유효하지 않으면 0이고, 콤보 상자 단추를 찾을 수 없으면 CB_ERR.

설명

-1의 인덱스 매개 변수는 현재 선택한 항목과 연결된 데이터를 반환합니다.

CMFCToolBarComboBoxButton::GetItemDataPtrAll

특정 명령 ID가 있는 콤보 상자 단추의 목록 상자에서 특정 인덱스의 항목과 연결된 데이터를 반환합니다. 이 데이터는 포인터로 반환됩니다.

static void* GetItemDataPtrAll(
    UINT uiCmd,
    int iIndex=-1);

매개 변수

uiCmd
[in] 콤보 상자 단추의 명령 ID입니다.

iIndex
[in] 목록 상자에 있는 항목의 인덱스(0부터 시작하는 인덱스)입니다.

Return Value

메서드가 성공한 경우 항목과 연결된 포인터입니다. 그렇지 않으면 오류가 발생하면 -1이고, 콤보 상자 단추를 찾을 수 없으면 NULL입니다.

설명

CMFCToolBarComboBoxButton::GetPrompt

콤보 상자 단추의 프롬프트 문자열을 반환합니다.

virtual CString GetPrompt() const;

Return Value

프롬프트 문자열입니다.

설명

이 메서드는 현재 구현되지 않습니다.

CMFCToolBarComboBoxButton::GetText

편집 상자의 텍스트를 가져옵니다.

LPCTSTR GetText() const;

Return Value

편집 상자의 텍스트입니다.

설명

CMFCToolBarComboBoxButton::GetTextAll

지정된 명령 ID가 있는 콤보 상자 단추의 편집 상자에 있는 텍스트를 가져옵니다.

static LPCTSTR GetTextAll(UINT uiCmd);

매개 변수

uiCmd
[in] 특정 콤보 상자 단추의 명령 ID입니다.

Return Value

메서드가 성공한 경우 편집 상자의 텍스트입니다. 그렇지 않으면 NULL입니다.

설명

CMFCToolBarComboBoxButton::HasFocus

콤보 상자에 현재 포커스가 있는지 여부를 나타냅니다.

virtual BOOL HasFocus() const;

Return Value

TRUE이면 현재 콤보 상자에 포커스가 있습니다. 그렇지 않으면 FALSE입니다.

설명

이 메서드는 콤보 상자의 자식 창에 현재 포커스가 있는 경우에도 TRUE를 반환합니다.

CMFCToolBarComboBoxButton::IsCenterVert

애플리케이션에서 콤보 상자 단추의 세로 위치를 반환합니다.

static BOOL IsCenterVert();

Return Value

단추가 가운데에 있으면 TRUE이고, 단추가 위쪽에 정렬되면 FALSE입니다.

설명

CMFCToolBarComboBoxButton::IsFlatMode

애플리케이션에서 콤보 상자 단추의 플랫 스타일 모양을 반환합니다.

static BOOL IsFlatMode();

Return Value

단추에 플랫 스타일이 있으면 TRUE입니다. 그렇지 않으면 FALSE입니다.

설명

콤보 상자 단추의 기본 플랫 스타일은 FALSE입니다.

CMFCToolBarComboBoxButton::IsOwnerOf

지정된 핸들이 콤보 상자 단추와 연결되어 있는지 또는 해당 자식 중 하나에 연결되어 있는지 여부를 나타냅니다.

virtual BOOL IsOwnerOf(HWND hwnd);

매개 변수

hwnd
[in] 창 핸들입니다.

Return Value

핸들이 콤보 상자 단추 또는 자식 중 하나로 할당된 경우 TRUE입니다. 그렇지 않으면 FALSE입니다.

CMFCToolBarComboBoxButton::IsRibbonButton

콤보 상자 단추가 리본 패널에 있는지 여부를 나타냅니다.

BOOL IsRibbonButton() const;

Return Value

항상 FALSE입니다.

설명

기본적으로 이 메서드는 항상 FALSE를 반환합니다. 즉, 리본 패널에 콤보 상자 단추가 표시되지 않습니다.

CMFCToolBarComboBoxButton::IsWindowVisible

콤보 상자 단추의 표시 상태를 반환합니다.

virtual BOOL IsWindowVisible();

Return Value

콤보 상자 단추의 표시 유형 상태입니다.

CMFCToolBarComboBoxButton::NotifyCommand

콤보 상자 단추가 메시지를 처리하는지 여부를 나타냅니다.

virtual BOOL NotifyCommand(int iNotifyCode);

매개 변수

iNotifyCode
[in] 명령과 연결된 알림 메시지입니다.

Return Value

콤보 상자 단추가 메시지를 처리하는지 여부입니다.

CMFCToolBarComboBoxButton::OnAddToCustomizePage

사용자 지정 대화 상자에 단추를 추가할 때 프레임워크에서 호출됩니다.

virtual void OnAddToCustomizePage();

CMFCToolBarComboBoxButton::OnCalculateSize

단추의 크기를 계산하기 위해 프레임워크에서 호출됩니다.

virtual SIZE OnCalculateSize(
    CDC* pDC,
    const CSize& sizeDefault,
    BOOL bHorz);

매개 변수

pDC
[in] 콤보 상자 단추를 표시하는 디바이스 컨텍스트입니다.

sizeDefault
[in] 콤보 상자 단추의 기본 크기입니다.

bHorz
[in] 부모 도구 모음의 도킹 상태입니다. 도구 모음이 가로로 도킹된 경우 TRUE이고 도구 모음이 세로로 도킹되면 FALSE입니다.

Return Value

SIZE 콤보 상자 단추의 크기를 픽셀 단위로 포함하는 구조체입니다.

CMFCToolBarComboBoxButton::OnChangeParentWnd

콤보 상자 단추가 새 도구 모음에 삽입될 때 프레임워크에서 호출됩니다.

virtual void OnChangeParentWnd(CWnd* pWndParent);

매개 변수

pWndParent
[in] 새 부모 도구 모음에 대한 포인터입니다.

CMFCToolBarComboBoxButton::OnClick

사용자가 콤보 상자 단추를 클릭할 때 프레임워크에서 호출됩니다.

virtual BOOL OnClick(
    CWnd* pWnd,
    BOOL bDelay = TRUE);

매개 변수

pWnd
[in] 콤보 상자 단추의 부모 창에 대한 포인터입니다.

bDelay
[in] 파생 클래스에서 사용하도록 예약됩니다.

Return Value

메서드가 이벤트를 처리하는 경우 TRUE입니다. 그렇지 않으면 FALSE입니다.

CMFCToolBarComboBoxButton::OnCtlColor

사용자가 부모 도구 모음 색을 변경하여 콤보 상자 단추 색을 설정할 때 프레임워크에서 호출됩니다.

virtual HBRUSH OnCtlColor(
    CDC* pDC,
    UINT nCtlColor);

매개 변수

pDC
[in] 콤보 상자 단추를 표시하는 디바이스 컨텍스트입니다.

nCtlColor
[in] 사용되지 않습니다.

Return Value

프레임워크가 콤보 상자 단추의 배경을 그리는 데 사용하는 브러시에 대한 핸들입니다.

설명

이 메서드는 콤보 상자 단추 텍스트 색도 설정합니다.

CMFCToolBarComboBoxButton::OnDraw

지정된 스타일 및 옵션을 사용하여 콤보 상자 단추를 그리기 위해 프레임워크에서 호출됩니다.

virtual void OnDraw(
    CDC* pDC,
    const CRect& rect,
    CMFCToolBarImages* pImages,
    BOOL bHorz = TRUE,
    BOOL bCustomizeMode = FALSE,
    BOOL bHighlight = FALSE,
    BOOL bDrawBorder = TRUE,
    BOOL bGrayDisabledButtons = TRUE);

매개 변수

Pdc
[in] 단추를 표시하는 디바이스 컨텍스트입니다.

rect
[in] 단추의 경계 사각형입니다.

pImages
[in] 단추와 연결된 이미지의 컬렉션입니다.

bHorz
[in] 부모 도구 모음의 도킹 상태입니다. 도구 모음이 가로로 도킹된 경우 TRUE이고 도구 모음이 세로로 도킹되면 FALSE입니다.

bCustomizeMode
[in] 애플리케이션이 사용자 지정 모드인지 여부입니다.

bHighlight
[in] 강조 표시된 콤보 상자 단추를 그릴지 여부입니다.

bDrawBorder
[in] 테두리가 있는 콤보 상자 단추를 그릴지 여부입니다.

bGrayDisabledButtons
[in] 음영 처리된 비활성 단추를 그리려면 TRUE입니다. FALSE를 사용하여 비활성화된 이미지 컬렉션을 사용합니다.

CMFCToolBarComboBoxButton::OnDrawOnCustomizeList

사용자 지정 대화 상자의 명령 창에서 콤보 상자 단추를 그리기 위해 프레임워크에서 호출됩니다.

virtual int OnDrawOnCustomizeList(
    CDC* pDC,
    const CRect& rect,
    BOOL bSelected);

매개 변수

pDC
[in] 콤보 상자 단추를 표시하는 디바이스 컨텍스트입니다.

rect
[in] 콤보 상자 단추의 경계 사각형입니다.

bSelected
[in] TRUE이면 콤보 상자 단추가 선택됩니다. 그렇지 않으면 FALSE입니다.

Return Value

콤보 상자 단추의 너비(픽셀)입니다.

CMFCToolBarComboBoxButton::OnGlobalFontsChanged

애플리케이션 글꼴이 변경되면 프레임워크에서 호출되어 콤보 상자 단추 글꼴을 설정합니다.

virtual void OnGlobalFontsChanged();

CMFCToolBarComboBoxButton::OnMove

부모 도구 모음이 이동할 때 콤보 상자 단추의 위치를 변경하기 위해 프레임워크에서 호출됩니다.

virtual void OnMove();

CMFCToolBarComboBoxButton::OnShow

콤보 상자 단추가 숨겨지거나 표시될 때 프레임워크에서 호출됩니다.

virtual void OnShow(BOOL bShow);

매개 변수

bShow
[in] 콤보 상자 단추를 숨기거나 표시할지 여부입니다.

CMFCToolBarComboBoxButton::OnSize

부모 도구 모음의 크기가 변경되면 프레임워크에서 호출하여 콤보 상자 단추의 크기를 변경합니다.

virtual void OnSize(int iSize);

매개 변수

iSize
[in] 콤보 상자 단추의 새 너비입니다.

CMFCToolBarComboBoxButton::OnUpdateToolTip

사용자가 콤보 상자 단추의 도구 팁을 변경할 때 프레임워크에서 호출됩니다.

virtual BOOL OnUpdateToolTip(
    CWnd* pWndParent,
    int iButtonIndex,
    CToolTipCtrl& wndToolTip,
    CString& str);

매개 변수

pWndParent
[in] 콤보 상자 단추의 부모 창에 대한 포인터입니다.

iButtonIndex
[in] 콤보 상자 단추의 ID입니다.

wndToolTip
[in] 콤보 상자 단추와 연결할 도구 설명입니다.

str
[in] 도구 설명 텍스트입니다.

Return Value

메서드가 이벤트를 처리하는 경우 TRUE입니다. 그렇지 않으면 FALSE입니다.

CMFCToolBarComboBoxButton::RemoveAllItems

목록에서 모든 항목을 삭제하고 상자를 편집합니다.

void RemoveAllItems();

설명

콤보 상자의 목록 상자 및 편집 컨트롤에서 모든 항목을 제거합니다.

CMFCToolBarComboBoxButton::SelectItem

목록 상자에서 항목을 선택합니다.

BOOL SelectItem(
    int iIndex,
    BOOL bNotify=TRUE);

BOOL SelectItem(DWORD_PTR dwData);
BOOL SelectItem(LPCTSTR lpszText);

매개 변수

iIndex
[in] 목록 상자에 있는 항목의 인덱스(0부터 시작하는 인덱스)입니다.

bNotify
[in] TRUE이면 선택 영역의 콤보 상자 단추에 알립니다. 그렇지 않으면 FALSE입니다.

dwData
[in] 목록 상자의 항목과 연결된 데이터입니다.

lpszText
[in] 목록 상자에 있는 항목의 텍스트입니다.

Return Value

메서드가 성공하면 TRUE입니다. 그렇지 않으면 FALSE입니다.

설명

CMFCToolBarComboBoxButton::SelectItemAll

지정된 명령 ID가 있는 콤보 상자 단추의 목록 상자에서 항목을 선택합니다.

static BOOL SelectItemAll(
    UINT uiCmd,
    int iIndex);

static BOOL SelectItemAll(
    UINT uiCmd,
    DWORD_PTR dwData);

static BOOL SelectItemAll(
    UINT uiCmd,
    LPCTSTR lpszText);

매개 변수

uiCmd
[in] 목록 상자가 포함된 콤보 상자 단추의 명령 ID입니다.

iIndex
[in] 목록 상자에 있는 항목의 인덱스(0부터 시작하는 인덱스)입니다. -1 값은 목록 상자에서 현재 선택 영역을 제거하고 편집 상자를 지웁니다.

dwData
[in] 목록 상자에 있는 항목의 데이터입니다.

lpszText
[in] 목록 상자에 있는 항목의 텍스트입니다.

Return Value

메서드가 성공하면 TRUE입니다. 그렇지 않으면 FALSE입니다.

설명

CMFCToolBarComboBoxButton::Serialize

보관 파일에서 이 개체를 읽거나 보관 파일에 씁니다.

virtual void Serialize(CArchive& ar);

매개 변수

ar
[in, out] CArchive serialize할 개체입니다.

설명

개체의 설정은 CArchive 이 메서드가 보관 파일을 읽거나 쓸지 여부를 결정합니다.

CMFCToolBarComboBoxButton::SetACCData

콤보 상자 단추의 접근성 데이터를 사용하여 지정된 CAccessibilityData 개체를 채웁니다.

virtual BOOL SetACCData(
    CWnd* pParent,
    CAccessibilityData& data);

매개 변수

pParent
[in] 콤보 상자 단추의 부모 창입니다.

data
[out] CAccessibilityData 콤보 상자 단추에서 접근성 데이터를 받는 개체입니다.

Return Value

메서드가 성공하면 TRUE입니다. 그렇지 않으면 FALSE입니다.

CMFCToolBarComboBoxButton::SetCenterVert

애플리케이션에서 콤보 상자 단추의 세로 위치를 설정합니다.

static void SetCenterVert(BOOL bCenterVert=TRUE);

매개 변수

bCenterVert
[in] TRUE이면 도구 모음에서 콤보 상자 단추를 가운데에 배치합니다. 콤보 상자 단추를 도구 모음의 위쪽에 맞추려면 FALSE입니다.

설명

기본적으로 콤보 상자 단추는 위쪽에 맞춰집니다.

CMFCToolBarComboBoxButton::SetContextMenuID

콤보 상자 단추의 바로 가기 메뉴 리소스 ID를 설정합니다.

void SetContextMenuID(UINT uiResID);

매개 변수

uiResID
[in] 바로 가기 메뉴 리소스 ID입니다.

CMFCToolBarComboBoxButton::SetDropDownHeight

드롭다운할 때 목록 상자의 높이를 설정합니다.

void SetDropDownHeight(int nHeight);

매개 변수

nHeight
[in] 목록 상자의 높이(픽셀)입니다.

설명

기본 높이는 150픽셀입니다.

CMFCToolBarComboBoxButton::SetFlatMode

애플리케이션에서 콤보 상자 단추의 플랫 스타일 모양을 설정합니다.

static void SetFlatMode(BOOL bFlat=TRUE);

매개 변수

bFlat
[in] 플랫 스타일 모양에 대한 TRUE입니다. 그렇지 않으면 FALSE입니다.

설명

콤보 상자 단추의 기본 플랫 스타일은 FALSE입니다.

CMFCToolBarComboBoxButton::SetStyle

콤보 상자 단추에 대해 지정된 스타일을 설정하고 사용하지 않도록 설정되지 않은 경우 컨트롤을 다시 그립니다.

virtual void SetStyle(UINT nStyle);

매개 변수

nStyle
[in] 도구 모음 스타일의 비트 조합(OR)입니다.

설명

도구 모음 단추 스타일 목록은 도구 모음 컨트롤 스타일을 참조 하세요.

CMFCToolBarComboBoxButton::SetText

콤보 상자 단추의 편집 상자에 있는 텍스트를 설정합니다.

void SetText(LPCTSTR lpszText);

매개 변수

lpszText
[in] 편집 상자의 텍스트가 들어 있는 문자열에 대한 포인터입니다.

참고 항목

계층 구조 차트
클래스
CMFCToolBarButton 클래스
CComboBox 클래스
CMFCToolBar::ReplaceButton
연습: 도구 모음에 컨트롤 배치