다음을 통해 공유

CMFCColorBar 클래스

  • 아티클

이 클래스는 CMFCColorBar 문서 또는 응용 프로그램에서 색을 선택할 수 있는 도킹 컨트롤 막대를 나타냅니다.

구문

class CMFCColorBar : public CMFCPopupMenuBar

멤버

보호된 생성자

속성 설명
CMFCColorBar::CMFCColorBar CMFCColorBar 개체를 생성합니다.

공용 메서드

이름 설명
CMFCColorBar::ContextToSize 색 막대 컨트롤의 단추를 포함하는 데 필요한 세로 및 가로 여백을 계산한 다음 해당 단추의 위치를 조정합니다.
CMFCColorBar::CreateControl 색 막대 컨트롤 창을 만들고 개체에 CMFCColorBar 연결한 다음 지정된 색상표를 포함하도록 컨트롤의 크기를 조정합니다.
CMFCColorBar::Create 색 막대 컨트롤 창을 만들어 개체에 CMFCColorBar 연결합니다.
CMFCColorBar::EnableAutomaticButton 자동 단추를 표시하거나 숨깁니다.
CMFCColorBar::EnableOtherButton 사용자가 더 많은 색을 선택할 수 있는 대화 상자의 표시를 사용하거나 사용하지 않도록 설정합니다.
CMFCColorBar::GetColor 현재 선택한 색을 검색합니다.
CMFCColorBar::GetCommandID 현재 색 막대 컨트롤의 명령 ID를 검색합니다.
CMFCColorBar::GetHighlightedColor 색 단추에 포커스가 있음을 나타내는 색을 검색합니다. 즉, 단추가 뜨거워집니다.
CMFCColorBar::GetHorzMargin 왼쪽 또는 오른쪽 색 셀과 클라이언트 영역 경계 사이의 공간인 가로 여백을 검색합니다.
CMFCColorBar::GetVertMargin 위쪽 또는 아래쪽 색 셀과 클라이언트 영역 경계 사이의 공간인 세로 여백을 검색합니다.
CMFCColorBar::IsTearOff 현재 색 막대를 도킹할 수 있는지 여부를 나타냅니다.
CMFCColorBar::SetColor 현재 선택된 색을 설정합니다.
CMFCColorBar::SetColorName 지정된 색의 새 이름을 설정합니다.
CMFCColorBar::SetCommandID 색 막대 컨트롤에 대한 새 명령 ID를 설정합니다.
CMFCColorBar::SetDocumentColors 현재 문서에서 사용되는 색 목록을 설정합니다.
CMFCColorBar::SetHorzMargin 왼쪽 또는 오른쪽 색 셀과 클라이언트 영역 경계 사이의 공간인 가로 여백을 설정합니다.
CMFCColorBar::SetVertMargin 위쪽 또는 아래쪽 색 셀과 클라이언트 영역 경계 사이의 공간인 세로 여백을 설정합니다.

보호된 메서드

속성 설명
CMFCColorBar::AdjustLocations 색 막대 컨트롤에서 색 단추의 위치를 조정합니다.
CMFCColorBar::AllowChangeTextLabels 색 단추의 텍스트 레이블을 변경할 수 있는지 여부를 나타냅니다.
CMFCColorBar::AllowShowOnList 사용자 지정 프로세스 중에 도구 모음 목록에 색 막대 컨트롤 개체를 표시할 수 있는지 여부를 나타냅니다.
CMFCColorBar::CalcSize 레이아웃 계산 프로세스의 일부로 프레임워크에서 호출됩니다.
CMFCColorBar::CreatePalette 지정된 색 배열의 색을 사용하여 색상표를 초기화합니다.
CMFCColorBar::GetColorGridSize 색 막대 컨트롤의 눈금에 있는 행과 열 수를 계산합니다.
CMFCColorBar::GetExtraHeight 기타 단추, 문서 색 등과 같은 기타 사용자 인터페이스 요소를 표시하기 위해 현재 색 표시줄에 필요한 추가 높이를 계산합니다.
CMFCColorBar::InitColors 지정된 색상표 또는 시스템 기본 색상표의 색을 사용하여 색 배열을 초기화합니다.
CMFCColorBar::OnKey 사용자가 키보드 단추를 누를 때 프레임워크에서 호출됩니다.
CMFCColorBar::OnSendCommand 팝업 컨트롤의 계층 구조를 닫기 위해 프레임워크에서 호출됩니다.
CMFCColorBar::OnUpdateCmdUI 항목이 표시되기 전에 색 막대 컨트롤의 사용자 인터페이스 항목을 사용하거나 사용하지 않도록 설정하기 위해 프레임워크에서 호출됩니다.
CMFCColorBar::OpenColorDialog 색 대화 상자를 엽니다.
CMFCColorBar::Rebuild 색 막대 컨트롤을 완전히 다시 그어 줍니다.
CMFCColorBar::SelectPalette 지정된 디바이스 컨텍스트의 논리적 색상표를 현재 색 막대 컨트롤의 부모 단추 색상표로 설정합니다.
CMFCColorBar::SetPropList m_pWndPropList 보호된 데이터 멤버를 속성 그리드 컨트롤에 대한 지정된 포인터로 설정합니다.
CMFCColorBar::ShowCommandMessageString 색 막대 컨트롤을 소유한 프레임 창에 상태 표시줄의 메시지 줄을 업데이트하도록 요청합니다.

보호된 데이터 멤버

속성 설명
m_bInternal 마우스 이벤트가 처리되는지 여부를 결정하는 부울 필드입니다. 일반적으로 마우스 이벤트는 이 필드가 TRUE이고 사용자 지정 모드가 FALSE일 때 처리됩니다.
m_bIsEnabled 컨트롤을 사용할 수 있는지 여부를 나타내는 부울입니다.
m_bIsTearOff 색 막대 컨트롤이 도킹을 지원하는지 여부를 나타내는 부울입니다.
m_BoxSize 색 막대 눈금에 있는 셀의 크기를 지정하는 CSize 개체입니다.
m_bShowDocColorsWhenDocked 색 막대가 도킹될 때 문서 색을 표시할지 여부를 나타내는 부울입니다. 자세한 내용은 CMFCColorBar::SetDocumentColors를 참조 하세요.
m_bStdColorDlg 표준 시스템 색 대화 상자 또는 CMFCColorDialog 대화 상자를 표시할지 여부를 나타내는 부울입니다. 자세한 내용은 CMFCColorBar::EnableOtherButton을 참조 하세요.
m_ColorAutomatic 현재 자동 색을 저장하는 COLORREF입니다. 자세한 내용은 CMFCColorBar::EnableOtherButton을 참조 하세요.
m_ColorNames RGB 색 집합을 해당 이름과 연결하는 CMap 개체입니다.
m_colors 색 막대 컨트롤에 표시되는 색을 포함하는 COLORREF 값의 CArray입니다.
m_ColorSelected 사용자가 현재 색 표시줄 컨트롤에서 선택한 색인 COLORREF 값입니다.
m_lstDocColors 현재 문서에서 사용되는 색을 포함하는 COLORREF 값의 CList입니다.
m_nCommandID 색 단추의 명령 ID인 부호 없는 정수입니다.
m_nHorzMargin 색 눈금의 색 단추 사이의 가로 여백인 정수입니다.
m_nHorzOffset 색 단추의 가운데에 대한 가로 오프셋인 정수입니다. 이 값은 단추에 색 외에 텍스트 또는 이미지가 표시되는 경우에 중요합니다.
m_nNumColumns 색 막대 컨트롤 그리드의 열 수인 정수입니다.
m_nNumColumnsVert 세로 방향 색 눈금의 열 수인 정수입니다.
m_nNumRowsHorz 가로 방향 색 눈금의 열 수인 정수입니다.
m_nRowHeight 색 눈금에 있는 색 단추 행의 높이인 정수입니다.
m_nVertMargin 색 눈금의 색 단추 사이의 세로 여백인 정수입니다.
m_nVertOffset 색 단추의 가운데에 대한 세로 오프셋인 정수입니다. 이 값은 단추에 색 외에 텍스트 또는 이미지가 표시되는 경우에 중요합니다.
m_Palette 색 막대 컨트롤에 사용되는 색의 CPalette입니다.
m_pParentBtn 현재 단추의 부모인 CMFCColorButton 개체에 대한 포인터입니다. 이 값은 색 단추가 도구 모음 컨트롤의 계층 구조에 있거나 색 속성 눈금 컨트롤에 있는 경우에 중요합니다.
m_pParentRibbonBtn 리본에 있고 현재 단추의 부모 단추인 CMFCRibbonColorButton 개체에 대한 포인터입니다. 이 값은 색 단추가 도구 모음 컨트롤의 계층 구조에 있거나 색 속성 눈금 컨트롤에 있는 경우에 중요합니다.
m_pWndPropList CMFCPropertyGridCtrl 개체에 대한 포인터입니다.
m_strAutoColor 자동 단추에 표시되는 텍스트인 CString입니다. 자세한 내용은 CMFCColorBar::EnableAutomaticButton을 참조하세요.
m_strDocColors 문서 색 단추에 표시되는 텍스트인 CString입니다. 자세한 내용은 CMFCColorBar::SetDocumentColors를 참조 하세요.
m_strOtherColor 다른 단추에 표시되는 텍스트인 CString입니다. 자세한 내용은 CMFCColorBar::EnableOtherButton을 참조 하세요.

설명

일반적으로 개체를 CMFCColorBar 직접 만들지 않습니다. 대신 CMFCColorMenuButton 클래스 (메뉴 및 도구 모음에 사용됨) 또는 CMFCColorButton 클래스 가 개체를 CMFCColorBar 만듭니다.

클래스는 CMFCColorBar 다음과 같은 기능을 제공합니다.

  • 문서 색 목록을 자동으로 조정합니다.

  • 문서 상태와 함께 상태를 저장하고 복원합니다.

  • "자동" 단추를 관리합니다.

  • CMFCColorPickerCtrl 클래스 컨트롤을 사용하여 사용자 지정 색을 선택합니다.

  • CMFCColorMenuButton 클래스를 사용하여 만든 경우 "분리" 상태를 지원합니다.

애플리케이션에 CMFCColorBar 기능을 통합하려면 다음을 수행합니다.

  1. 일반 메뉴 단추를 만들고 ID(예: ID_CHAR_COLOR)를 할당합니다.

  2. 프레임 창 클래스에서 CFrameWndEx::OnShowPopupMenu 메서드를 재정의하고 CMFCToolBar::ReplaceButton을 호출하여 일반 메뉴 단추를 CMFCColorMenuButton 클래스 개체로 바꿉니다.

  3. CMFCColorMenuButton 클래스를 만드는 동안 모든 스타일을 설정하고 개체의 CMFCColorBar 기능을 사용하거나 사용하지 않도록 설정합니다. 개체는 CMFCColorMenuButton 프레임워크에서 메서드를 호출한 CMFCColorBar 후 개체를 CreatePopupMenu 동적으로 만듭니다.

사용자가 색 막대 컨트롤 단추를 클릭하면 프레임워크는 매크로를 ON_COMMAND 사용하여 부모에 색 막대 컨트롤을 알립니다. 매크로에서 명령 ID 매개 변수는 1단계의 색 막대 컨트롤 단추에 할당한 값입니다(이 예제에서는 ID_CHAR_COLOR). 자세한 내용은 CMFCColorMenuButton 클래스, CMFCColorButton 클래스, CMFCColorPickerCtrl 클래스, CFrameWndEx 클래스 및 CMFCToolBar 클래스 클래스 를 참조하세요.

예시

다음 예제에서는 클래스의 다양한 메서드를 사용하여 색 막대를 구성하는 방법을 보여 줍니다 CMFCColorBar . 메서드는 가로 및 세로 여백을 설정하고, 다른 단추를 사용하도록 설정하고, 색 막대 컨트롤 창을 만들고, 현재 선택한 색을 설정합니다. 이 예제는 새 컨트롤 샘플의 일부입니다.

CMFCColorBar m_wndColorBar;

// set the margins
m_wndColorBar.SetHorzMargin(0);
m_wndColorBar.SetVertMargin(0);
// enable the display of a dialog box that
// lets the user select more colors
m_wndColorBar.EnableOtherButton(_T("Other..."));
// create a color bar control window
m_wndColorBar.CreateControl(this, rectColorBar, IDC_COLORBAR, 5 /* columns */);
// set the currently selected color
m_wndColorBar.SetColor(RGB(255, 0, 0));

상속 계층 구조

CObject

CCmdTarget

CWnd

CBasePane

CPane

CMFCBaseToolBar

CMFCToolBar

CMFCPopupMenuBar

CMFCColorBar

요구 사항

헤더: afxcolorbar.h

CMFCColorBar::AdjustLocations

색 막대 컨트롤에서 색 단추의 위치를 조정합니다.

virtual void AdjustLocations();

설명

이 메서드는 WM_SIZE 메시지 처리 중 프레임워크에서 호출됩니다.

CMFCColorBar::AllowChangeTextLabels

색 단추의 텍스트 레이블을 변경할 수 있는지 여부를 나타냅니다.

virtual BOOL AllowChangeTextLabels() const;

Return Value

항상 FALSE입니다.

설명

기본적으로 이 메서드는 항상 FALSE를 반환하므로 텍스트 레이블을 수정할 수 없습니다. 텍스트 레이블 수정을 사용하도록 설정하려면 이 메서드를 재정의합니다.

CMFCColorBar::AllowShowOnList

사용자 지정 프로세스 중에 도구 모음 목록에 색 막대 컨트롤 개체를 표시할 수 있는지 여부를 나타냅니다.

virtual BOOL AllowShowOnList() const;

Return Value

항상 TRUE입니다.

설명

기본적으로 이 메서드는 항상 TRUE를 반환합니다. 즉, 프레임워크는 사용자 지정 프로세스 중에 색 막대 컨트롤을 표시할 수 있습니다. 이 메서드를 재정의하여 다른 동작을 구현합니다.

CMFCColorBar::CalcSize

레이아웃 계산 프로세스의 일부로 프레임워크에서 호출됩니다.

virtual CSize CalcSize(BOOL bVertDock);

매개 변수

bVertDock
[in] TRUE이면 색 막대 컨트롤이 세로로 도킹되도록 지정합니다. FALSE를 사용하여 색 막대 컨트롤이 가로로 도킹되도록 지정합니다.

Return Value

색 막대 컨트롤의 색 단추 배열 크기입니다.

CMFCColorBar::CMFCColorBar

CMFCColorBar 개체를 생성합니다.

CMFCColorBar(
    const CArray<COLORREF,COLORREF>& colors,
    COLORREF color,
    LPCTSTR lpszAutoColor,
    LPCTSTR lpszOtherColor,
    LPCTSTR lpszDocColors,
    CList<COLORREF,COLORREF>& lstDocColors,
    int nColumns,
    int nRowsDockHorz,
    int nColDockVert,
    COLORREF colorAutomatic,
    UINT nCommandID,
    CMFCColorButton* pParentBtn);

CMFCColorBar(
    const CArray<COLORREF,COLORREF>& colors,
    COLORREF color,
    LPCTSTR lpszAutoColor,
    LPCTSTR lpszOtherColor,
    LPCTSTR lpszDocColors,
    CList<COLORREF,COLORREF>& lstDocColors,
    int nColumns,
    COLORREF colorAutomatic,
    UINT nCommandID,
    CMFCRibbonColorButton* pParentRibbonBtn);

CMFCColorBar(
    CMFCColorBar& src,
    UINT uiCommandID);

매개 변수

색상
[in] 프레임워크가 색 표시줄 컨트롤에 표시하는 색 배열입니다.

color
[in] 처음에 선택한 색입니다.

lpszAutoColor
[in] 자동(기본) 색 단추 또는 NULL의 텍스트 레이블입니다.

자동 단추의 표준 레이블은 자동입니다.

lpszOtherColor
[in] 다른 단추의 텍스트 레이블로, 더 많은 색 선택 항목 또는 NULL을 표시합니다.

다른 단추의 표준 레이블은 다른 색...입니다.

lpszDocColors
[in] 문서 색 단추의 텍스트 레이블입니다. 문서 색 색상표에는 현재 문서에서 사용하는 모든 색이 나열됩니다.

lstDocColors
[in] 문서에서 현재 사용하는 색 목록입니다.

nColumns
[in] 색 배열에 있는 열 수입니다.

nRowsDockHorz
[in] 색 막대가 가로로 도킹될 때 사용하는 행 수입니다.

nColDockVert
[in] 색 막대가 세로로 도킹될 때 사용하는 열 수입니다.

colorAutomatic
[in] 자동 단추를 클릭할 때 프레임워크가 적용되는 기본 색입니다.

nCommandID
[in] 색 막대 컨트롤 명령 ID입니다.

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

src
[in] 새 CMFCColorBar 개체에 복사할 기존 CMFCColorBar 개체입니다.

uiCommandID
[in] 명령 ID입니다.

CMFCColorBar::ContextToSize

색 막대 컨트롤의 단추를 포함하는 데 필요한 세로 및 가로 여백을 계산하고 해당 단추의 위치를 조정합니다.

void ContextToSize(
    BOOL bSquareButtons = TRUE,
    BOOL bCenterButtons = TRUE);

매개 변수

bSquareButtons
[in] TRUE이면 색 막대 컨트롤의 단추 모양이 정사각형이 되도록 지정합니다. 그렇지 않으면 FALSE입니다. 기본값은 TRUE입니다.

bCenterButtons
[in] TRUE이면 색 막대 컨트롤 단추의 면에 있는 콘텐츠가 가운데에 배치됩니다. 그렇지 않으면 FALSE입니다. 기본값은 TRUE입니다.

설명

CMFCColorBar::Create

색 막대 컨트롤 창을 만들어 개체에 CMFCColorBar 연결합니다.

virtual BOOL Create(
    CWnd* pParentWnd,
    DWORD dwStyle,
    UINT nID,
    CPalette* pPalette=NULL,
    int nColumns=0,
    int nRowsDockHorz=0,
    int nColDockVert=0);

매개 변수

pParentWnd
[in] 부모 창에 대한 포인터입니다.

dwStyle
[in] 창 스타일의 비트 조합(OR) 입니다.

nID
[in] 명령 ID입니다.

pPalette
[in] 색상표에 대한 포인터입니다. 기본값은 NULL입니다.

nColumns
[in] 색 막대 컨트롤의 열 수입니다. 기본값은 0입니다.

nRowsDockHorz
[in] 가로로 도킹된 경우 색 막대 컨트롤의 행 수입니다. 기본값은 0입니다.

nColDockVert
[in] 색 막대 컨트롤이 세로로 도킹될 때의 열 수입니다. 기본값은 0입니다.

Return Value

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

설명

개체를 CMFCColorBar 생성하려면 클래스 생성자를 호출한 다음 이 메서드를 호출합니다. 이 메서드는 Create Windows 컨트롤을 만들고 색 목록을 초기화합니다.

CMFCColorBar::CreateControl

색 막대 컨트롤 창을 만들고 개체에 CMFCColorBar 연결한 다음 지정된 색상표를 포함하도록 컨트롤 창의 크기를 조정합니다.

virtual BOOL CreateControl(
    CWnd* pParentWnd,
    const CRect& rect,
    UINT nID,
    int nColumns=-1,
    CPalette* pPalette=NULL);

매개 변수

pParentWnd
[in] 부모 창에 대한 포인터입니다. NULL일 수 없습니다.

rect
[in] 색 막대 컨트롤을 그릴 위치를 지정하는 경계 사각형입니다.

nID
[in] 컨트롤 ID입니다.

nColumns
[in] 색 막대 컨트롤의 이상적인 열 수입니다. 이 메서드는 지정된 색상표에 맞게 해당 숫자를 수정합니다. 기본값은 -1입니다. 즉, 이 매개 변수가 지정되지 않았습니다.

pPalette
[in] 색상표 또는 NULL에 대한 포인터입니다. 이 매개 변수가 NULL이면 이 메서드는 색 막대 컨트롤의 크기를 20가지 색이 지정된 것처럼 계산합니다. 기본값은 NULL입니다.

Return Value

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

설명

이 메서드는 rect, nColumns 및 pPalette 매개 변수를 사용하여 색 막대 컨트롤에서 적절한 수 또는 행과 열을 계산한 다음 CMFCColorBar::Create 메서드를 호출합니다.

CMFCColorBar::CreatePalette

지정된 색 배열의 색을 사용하여 색상표를 초기화합니다.

static BOOL CreatePalette(
    const CArray<COLORREF, COLORREF>& arColors,
    CPalette& palette);

매개 변수

arColors
[in] 색 배열입니다.

팔레트
[in] 색상표입니다.

Return Value

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

CMFCColorBar::EnableAutomaticButton

자동 단추를 표시하거나 숨깁니다.

void EnableAutomaticButton(
    LPCTSTR lpszLabel,
    COLORREF colorAutomatic,
    BOOL bEnable=TRUE);

매개 변수

lpszLabel
[in] 자동(기본) 색 단추 또는 NULL의 텍스트 레이블입니다.

자동 단추의 표준 레이블은 자동입니다.

colorAutomatic
[in] 자동 단추를 클릭할 때 프레임워크가 적용되는 기본 색입니다.

bEnable
[in] TRUE이면 자동 단추를 사용하도록 설정합니다. 자동 단추를 사용하지 않도록 설정하려면 FALSE입니다. 기본값은 TRUE입니다.

설명

lpszLabel 매개 변수가 NULL이거나 bEnable 매개 변수가 FALSE이면 자동 단추의 텍스트 레이블이 삭제됩니다.

CMFCColorBar::EnableOtherButton

사용자가 더 많은 색을 선택할 수 있는 대화 상자의 표시를 사용하거나 사용하지 않도록 설정합니다.

void EnableOtherButton(
    LPCTSTR lpszLabel,
    BOOL bAltColorDlg=TRUE,
    BOOL bEnable=TRUE);

매개 변수

lpszLabel
[in] 다른 단추의 텍스트 레이블로, 더 많은 색 선택 항목 또는 NULL을 표시합니다.

이 단추의 표준 레이블은 다른 색...입니다.

bAltColorDlg
[in] CMFCColorDialog 대화 상자를 표시하려면 TRUE입니다. FALSE로 표준 CColorDialog 대화 상자를 표시합니다. 기본값은 TRUE입니다.

bEnable
[in] TRUE이면 단추가 활성화됩니다. 단추를 사용하지 않도록 설정하려면 FALSE입니다. 기본값은 TRUE입니다.

CMFCColorBar::GetColor

현재 선택한 색을 검색합니다.

COLORREF GetColor() const;

Return Value

현재 선택한 색입니다.

CMFCColorBar::GetColorGridSize

색 막대 컨트롤의 눈금에 있는 행과 열 수를 계산합니다.

CSize GetColorGridSize(BOOL bVertDock) const;

매개 변수

bVertDock
[in] TRUE이면 세로로 도킹된 색 막대 컨트롤에 대한 계산을 수행합니다. 그렇지 않으면 가로 도킹된 컨트롤에 대한 계산을 수행합니다.

Return Value

구성 요소에 열 수가 포함되고 cy 해당 구성 요소에 행 수가 포함된 CSize 개체 cx 입니다.

CMFCColorBar::GetCommandID

현재 색 막대 컨트롤의 명령 ID를 검색합니다.

UINT GetCommandID() const;

Return Value

명령 ID입니다.

설명

사용자가 새 색을 선택하면 프레임워크는 WM_COMMAND 메시지의 명령 ID를 보내 개체의 CMFCColorBar 부모에 알립니다.

CMFCColorBar::GetExtraHeight

기타 단추 또는 문서 색과 같은 기타 사용자 인터페이스 요소를 표시하기 위해 현재 색 표시줄에 필요한 추가 높이를 계산합니다.

int GetExtraHeight(int nNumColumns) const;

매개 변수

nNumColumns
[in] 색 막대 컨트롤에 문서 색이 포함된 경우 문서 색 표에 표시할 열의 수입니다. 그렇지 않으면 이 값이 사용되지 않습니다.

Return Value

필요한 계산된 추가 높이입니다.

CMFCColorBar::GetHighlightedColor

색 단추에 포커스가 있음을 나타내는 색을 검색합니다. 즉, 단추가 뜨거워집니다.

COLORREF GetHighlightedColor() const;

Return Value

RGB 값입니다.

설명

CMFCColorBar::GetHorzMargin

왼쪽 또는 오른쪽 색 셀과 클라이언트 영역 경계 사이의 공간인 가로 여백을 검색합니다.

int GetHorzMargin();

Return Value

가로 여백입니다.

CMFCColorBar::GetVertMargin

위쪽 또는 아래쪽 색 셀과 클라이언트 영역 경계 사이의 공간인 세로 여백을 검색합니다.

int GetVertMargin() const;

Return Value

세로 여백입니다.

CMFCColorBar::InitColors

지정된 색상표 또는 시스템 기본 색상표를 사용하여 색 배열을 초기화합니다.

static int InitColors(
    CPalette* pPalette,
    CArray<COLORREF, COLORREF>& arColors);

매개 변수

pPalette
[in] 색상표 개체 또는 NULL에 대한 포인터입니다. 이 매개 변수가 NULL이면 이 메서드는 운영 체제의 기본 팔레트를 사용합니다.

arColors
[in] 색 배열입니다.

Return Value

색 배열의 요소 수입니다.

CMFCColorBar::IsTearOff

현재 색 막대를 도킹할 수 있는지 여부를 나타냅니다.

BOOL IsTearOff() const;

Return Value

현재 색 막대 컨트롤을 도킹할 수 있으면 TRUE이고, 그렇지 않으면 FALSE입니다.

설명

색 막대 컨트롤을 도킹할 수 있는 경우 컨트롤 막대를 떼어내고 다른 위치에 도킹할 수 있습니다.

CMFCColorBar::OnKey

사용자가 키보드 단추를 누를 때 프레임워크에서 호출됩니다.

virtual BOOL OnKey(UINT nChar);

매개 변수

nChar
[in] 사용자가 누른 키에 대한 가상 키 코드입니다.

Return Value

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

CMFCColorBar::OnSendCommand

팝업 컨트롤의 계층 구조를 닫기 위해 프레임워크에서 호출됩니다.

virtual BOOL OnSendCommand(const CMFCToolBarButton* pButton);

매개 변수

pButton
[in] 도구 모음에 있는 컨트롤에 대한 포인터입니다.

Return Value

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

CMFCColorBar::OnUpdateCmdUI

항목이 표시되기 전에 색 막대 컨트롤의 사용자 인터페이스 항목을 사용하거나 사용하지 않도록 설정하기 위해 프레임워크에서 호출됩니다.

virtual void OnUpdateCmdUI(
    CFrameWnd* pTarget,
    BOOL bDisableIfNoHndler);

매개 변수

pTarget
[in] 업데이트할 사용자 인터페이스 항목이 포함된 창에 대한 포인터입니다.

bDisableIfNoHndler
[in] 메시지 맵에 처리기가 정의되지 않은 경우 사용자 인터페이스 항목을 사용하지 않도록 설정하려면 TRUE입니다. 그렇지 않으면 FALSE입니다.

설명

애플리케이션 사용자가 사용자 인터페이스 항목을 클릭하면 항목이 활성화 또는 비활성화로 표시되어야 하는지 여부를 알고 있어야 합니다. 명령 메시지의 대상은 ON_UPDATE_COMMAND_UI 명령 처리기를 구현하여 이 정보를 제공합니다. 이 메서드를 사용하여 명령을 처리할 수 있습니다. 자세한 내용은 CCmdUI 클래스를 참조 하세요.

CMFCColorBar::OpenColorDialog

색 대화 상자를 엽니다.

virtual BOOL OpenColorDialog(
    const COLORREF colorDefault,
    COLORREF& colorRes);

매개 변수

colorDefault
[in] 색 대화 상자가 열릴 때 기본적으로 선택되는 색입니다.

colorRes
[out] 사용자가 선택한 색입니다.

Return Value

사용자가 색을 선택한 경우 TRUE입니다. 사용자가 색 대화 상자를 취소한 경우 FALSE입니다.

설명

CMFCColorBar::Rebuild

색 막대 컨트롤을 완전히 다시 그어 줍니다.

virtual void Rebuild();

CMFCColorBar::SelectPalette

지정된 디바이스 컨텍스트의 논리적 색상표를 현재 색 막대 컨트롤의 부모 단추 색상표로 설정합니다.

CPalette* SelectPalette(CDC* pDC);

매개 변수

pDC
[in] 현재 색 막대 컨트롤의 부모 단추 디바이스 컨텍스트에 대한 포인터입니다.

Return Value

현재 색 막대 컨트롤의 부모 단추 색상표로 대체되는 색상표에 대한 포인터입니다.

CMFCColorBar::SetColor

현재 선택된 색을 설정합니다.

void SetColor(COLORREF color);

매개 변수

color
[in] RGB 색 값입니다.

CMFCColorBar::SetColorName

지정된 색의 새 이름을 설정합니다.

static void SetColorName(
    COLORREF color,
    const CString& strName);

매개 변수

color
[in] 색의 RGB 값입니다.

strName
[in] 지정한 색의 새 이름입니다.

설명

이 메서드는 애플리케이션의 모든 CMFCColorBar 개체에서 지정한 색의 이름을 변경합니다.

CMFCColorBar::SetCommandID

색 막대 컨트롤에 대한 새 명령 ID를 설정합니다.

void SetCommandID(UINT nCommandID);

매개 변수

nCommandID
[in] 명령 ID입니다.

설명

색 막대 컨트롤의 명령 ID를 수정하고 컨트롤의 부모 창에 ID가 변경되었음을 알리려면 이 메서드를 호출합니다.

CMFCColorBar::SetDocumentColors

현재 문서에서 사용되는 색 목록을 설정합니다.

void SetDocumentColors(
    LPCTSTR lpszCaption,
    CList<COLORREF,COLORREF>& lstDocColors,
    BOOL bShowWhenDocked=FALSE);

매개 변수

lpszCaption
[in] 색 막대 컨트롤이 도킹되지 않은 경우 표시되는 캡션입니다.

lstDocColors
[in] 현재 문서 색을 대체하는 색 목록입니다.

bShowWhenDocked
[in] TRUE이면 색 막대 컨트롤이 도킹될 때 문서 색을 표시합니다. 그렇지 않으면 FALSE입니다. 기본값은 FALSE입니다.

설명

문서 색 은 현재 문서에서 사용되는 색입니다. 프레임워크는 문서 색 목록을 자동으로 유지 관리하지만 이 메서드를 사용하여 목록을 수정할 수 있습니다.

CMFCColorBar::SetHorzMargin

왼쪽 또는 오른쪽 색 셀과 클라이언트 영역의 경계 사이의 공간인 가로 여백을 설정합니다.

void SetHorzMargin(int nHorzMargin);

매개 변수

nHorzMargin
[in] 가로 여백(픽셀)입니다.

설명

기본적으로 CMFCColorBar::CMFCColorBar 생성자는 가로 여백을 4픽셀로 설정합니다.

CMFCColorBar::SetPropList

m_pWndPropList 보호된 데이터 멤버를 속성 그리드 컨트롤에 대한 지정된 포인터로 설정합니다.

void SetPropList(CMFCPropertyGridCtrl* pWndList);

매개 변수

pWndList
[in] 속성 그리드 컨트롤 개체에 대한 포인터입니다.

CMFCColorBar::SetVertMargin

위쪽 또는 아래쪽 색 셀과 클라이언트 영역 경계 사이의 공간인 세로 여백을 설정합니다.

void SetVertMargin(int nVertMargin);

매개 변수

nVertMargin
[in] 세로 여백(픽셀)입니다.

설명

기본적으로 CMFCColorBar::CMFCColorBar 생성자는 세로 여백을 4픽셀로 설정합니다.

CMFCColorBar::ShowCommandMessageString

색 막대 컨트롤을 소유한 프레임 창에 상태 표시줄의 메시지 줄을 업데이트하도록 요청합니다.

virtual void ShowCommandMessageString(UINT uiCmdId);

매개 변수

uiCmdId
[in] 명령 ID입니다. (이 매개 변수는 무시됩니다.)

설명

이 메서드는 색 막대 컨트롤의 소유자에 WM_SETMESSAGESTRING 메시지를 보냅니다.

참고 항목

계층 구조 차트
클래스