다음을 통해 공유


CMFCRibbonEdit 클래스

리본 표시줄에 있는 편집 컨트롤을 구현합니다.

구문

class CMFCRibbonEdit : public CMFCRibbonButton

멤버

공용 생성자

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

공용 메서드

이름 설명
CMFCRibbonEdit::CanBeStretched 컨트롤의 높이가 리본 행의 CMFCRibbonEdit 높이까지 세로로 증가할 수 있는지 여부를 나타냅니다.
CMFCRibbonEdit::CMFCRibbonEdit CMFCRibbonEdit 개체를 생성합니다.
CMFCRibbonEdit::CopyFrom 지정된 CMFCRibbonEdit 개체의 상태를 현재 CMFCRibbonEdit 개체에 복사합니다.
CMFCRibbonEdit::CreateEdit 개체에 대한 CMFCRibbonEdit 새 텍스트 상자를 만듭니다.
CMFCRibbonEdit::DestroyCtrl 개체를 CMFCRibbonEdit 삭제합니다.
CMFCRibbonEdit::DropDownList 목록 상자를 드롭다운합니다.
CMFCRibbonEdit::EnableSpinButtons 텍스트 상자의 스핀 단추 범위를 사용하도록 설정하고 설정합니다.
CMFCRibbonEdit::GetCompactSize 개체의 압축 크기를 검색합니다 CFMCRibbonEdit .
CMFCRibbonEdit::GetEditText 텍스트 상자에서 텍스트를 검색합니다.
CMFCRibbonEdit::GetIntermediateSize 개체의 중간 크기를 검색합니다 CMFCRibbonEdit .
CMFCRibbonEdit::GetTextAlign 텍스트 상자에서 텍스트의 맞춤을 검색합니다.
CMFCRibbonEdit::GetWidth 컨트롤의 너비를 픽셀 단위로 검색 CMFCRibbonEdit 합니다.
CMFCRibbonEdit::HasCompactMode 컨트롤의 표시 크기를 CMFCRibbonEdit 압축할 수 있는지 여부를 나타냅니다.
CMFCRibbonEdit::HasFocus 컨트롤에 포커스가 CMFCRIbbonEdit 있는지 여부를 나타냅니다.
CMFCRibbonEdit::HasLargeMode 컨트롤의 표시 크기가 CMFCRibbonEdit 클 수 있는지 여부를 나타냅니다.
CMFCRibbonEdit::HasSpinButtons 텍스트 상자에 스핀 단추가 있는지 여부를 나타냅니다.
CMFCRibbonEdit::IsHighlighted 컨트롤이 CMFCRibbonEdit 강조 표시되어 있는지 여부를 나타냅니다.
CMFCRibbonEdit::OnAfterChangeRect 컨트롤에 대한 디스플레이 사각형의 크기가 변경되면 프레임워크에서 CMFCRibbonEdit 호출됩니다.
CMFCRibbonEdit::OnDraw 컨트롤을 그리기 위해 프레임워크에서 호출됩니다 CMFCRibbonEdit .
CMFCRibbonEdit::OnDrawLabelAndImage 컨트롤의 레이블과 이미지를 그리기 위해 프레임워크에서 호출됩니다 CMFCRibbonEdit .
CMFCRibbonEdit::OnDrawOnList 명령 목록 상자에 컨트롤을 CMFCRibbonEdit 그리기 위해 프레임워크에서 호출됩니다.
CMFCRibbonEdit::OnEnable 컨트롤을 사용하거나 사용하지 않도록 설정하기 위해 프레임워크에서 호출됩니다 CMFCRibbonEdit .
CMFCRibbonEdit::OnHighlight 포인터가 컨트롤의 경계를 입력하거나 떠날 때 프레임워크에서 CMFCRibbonEdit 호출됩니다.
CMFCRibbonEdit::OnKey 사용자가 키 설명을 누르고 컨트롤에 포커스가 있을 때 프레임워크에서 CMFCRibbonEdit 호출됩니다.
CMFCRibbonEdit::OnLButtonDown 사용자가 컨트롤의 왼쪽 마우스 단추를 누를 때 컨트롤을 업데이트 CMFCRibbonEdit 하기 위해 프레임워크에서 호출됩니다.
CMFCRibbonEdit::OnLButtonUp 사용자가 마우스 왼쪽 단추를 놓을 때 프레임워크에서 호출됩니다.
CMFCRibbonEdit::OnRTLChanged 레이아웃이 방향을 변경할 때 컨트롤을 CMFCRibbonEdit 업데이트하기 위해 프레임워크에서 호출됩니다.
CMFCRibbonEdit::OnShow 컨트롤을 표시하거나 숨기기 위해 프레임워크에서 호출됩니다 CMFCRibbonEdit .
CMFCRibbonEdit::Redraw 컨트롤의 표시를 업데이트합니다 CMFCRibbonEdit .
CMFCRibbonEdit::SetACCData 개체의 접근성 데이터를 CMFCRibbonEdit 설정합니다.
CMFCRibbonEdit::SetEditText 텍스트 상자의 텍스트를 설정합니다.
CMFCRibbonEdit::SetTextAlign 텍스트 상자의 텍스트 맞춤을 설정합니다.
CMFCRibbonEdit::SetWidth 컨트롤의 텍스트 상자 너비를 CMFCRibbonEdit 설정합니다.

설명

예시

다음 예제에서는 개체를 CMFCRibbonEdit 생성하고 편집 컨트롤 옆에 스핀 단추를 표시하며 편집 컨트롤의 텍스트를 설정하는 방법을 보여 줍니다. 이 코드 조각은 MS Office 2007 데모 샘플일부입니다.

CMFCRibbonEdit *pEditIndentLeft = new CMFCRibbonEdit(ID_PAGELAYOUT_INDENT_LEFT, 72, _T("Left:\nil"), 13);
// specify the min and max value of the spin button control
pEditIndentLeft->EnableSpinButtons(0, 1000);
// set the text of the edit control
pEditIndentLeft->SetEditText(_T("0"));

요구 사항

헤더: afxRibbonEdit.h

CMFCRibbonEdit::CanBeStretched

CMFCRibbonEdit 컨트롤의 높이가 리본 행의 높이까지 세로로 증가할 수 있는지 여부를 나타냅니다.

virtual BOOL CanBeStretched();

Return Value

항상 FALSE를 반환합니다.

설명

CMFCRibbonEdit::CMFCRibbonEdit

CMFCRibbonEdit 개체를 생성합니다.

CMFCRibbonEdit(
    UINT nID,
    int nWidth,
    LPCTSTR lpszLabel = NULL,
    int nImage = -1);

CMFCRibbonEdit();

매개 변수

nID
[in] 컨트롤의 명령 ID입니다 CMFCRibbonEdit .

nWidth
[in] 컨트롤의 텍스트 상자 너비(픽셀)입니다 CMFCRibbonEdit .

lpszLabel
[in] 컨트롤의 레이블입니다 CMFCRibbonEdit .

nImage
[in] 컨트롤에 사용할 작은 이미지의 인덱스입니다 CMFCRibbonEdit . 작은 이미지의 컬렉션은 부모 리본 범주에 의해 유지 관리됩니다.

설명

컨트롤은 CMFCRibbonEdit 큰 이미지를 사용하지 않습니다.

CMFCRibbonEdit::CopyFrom

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

virtual void CopyFrom(const CMFCRibbonBaseElement& src);

매개 변수

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

설명

src 매개 변수는 형식CMFCRibbonEdit이어야 합니다.

CMFCRibbonEdit::CreateEdit

CMFCRibbonEdit 개체에 대한 새 텍스트 상자를 만듭니다.

virtual CMFCRibbonRichEditCtrl* CreateEdit(
    CWnd* pWndParent,
    DWORD dwEditStyle);

매개 변수

pWndParent
[in] 개체의 부모 창에 대한 포인터입니다 CMFCRibbonEdit .

dwEditStyle
[in] 텍스트 상자의 스타일을 지정합니다. 주의 섹션에 나열된 창 스타일을 Windows SDK에 설명된 편집 컨트롤 스타일결합할 수 있습니다.

Return Value

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

설명

파생 클래스에서 이 메서드를 재정의하여 사용자 지정 텍스트 상자를 만듭니다.

텍스트 상자에 다음 창 스타일을 적용할 수 있습니다.

  • WS_CHILD

  • WS_VISIBLE

  • WS_DISABLED

  • WS_GROUP

  • WS_TABSTOP

CMFCRibbonEdit::DestroyCtrl

CMFCRibbonEdit 개체를 삭제합니다.

virtual void DestroyCtrl();

설명

목록 상자를 드롭다운합니다.

virtual void DropDownList();

설명

기본적으로 이 메서드는 아무 작업도 수행하지 않습니다. 목록 상자를 드롭다운하려면 이 메서드를 재정의합니다.

CMFCRibbonEdit::EnableSpinButtons

텍스트 상자의 스핀 단추 범위를 사용하도록 설정하고 설정합니다.

void EnableSpinButtons(
    int nMin,
    int nMax);

매개 변수

nMin
[in] 스핀 단추의 최소값입니다.

nMax
[in] 스핀 단추의 최대값입니다.

설명

스핀 단추는 위쪽 및 아래쪽 화살표를 표시하고 사용자가 고정된 값 집합을 통해 이동할 수 있도록 합니다.

CMFCRibbonEdit::GetCompactSize

CMFCRibbonEdit 개체의 압축 크기를 검색합니다.

virtual CSize GetCompactSize(CDC* pDC);

매개 변수

pDC
[in] 개체의 디바이스 컨텍스트에 대한 포인터입니다 CMFCRibbonEdit .

Return Value

개체의 CMFCRibbonEdit 압축 크기입니다.

설명

CMFCRibbonEdit::GetEditText

텍스트 상자에서 텍스트를 검색합니다.

CString GetEditText() const;

Return Value

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

설명

CMFCRibbonEdit::GetIntermediateSize

CMFCRibbonEdit 개체의 중간 크기를 검색합니다.

virtual CSize GetIntermediateSize(CDC* pDC);

매개 변수

pDC
[in] 개체의 디바이스 컨텍스트에 대한 포인터입니다 CMFCRibbonEdit .

Return Value

개체의 중간 크기입니다 CMFCRibbonEdit .

설명

CMFCRibbonEdit::GetTextAlign

텍스트 상자에서 텍스트의 맞춤을 검색합니다.

int GetTextAlign() const;

Return Value

텍스트 맞춤 열거형 값입니다. 가능한 값은 설명 섹션을 참조하세요.

설명

반환된 값은 다음 편집 컨트롤 스타일 중 하나입니다.

  • 왼쪽 맞춤에 대한 ES_LEFT

  • 가운데 맞춤에 대한 ES_CENTER

  • 오른쪽 맞춤에 대한 ES_RIGHT

이러한 스타일에 대한 자세한 내용은 컨트롤 스타일 편집을 참조 하세요.

CMFCRibbonEdit::GetWidth

CMFCRibbonEdit 컨트롤의 너비를 픽셀 단위로 검색합니다.

int GetWidth(BOOL bInFloatyMode = FALSE) const;

매개 변수

bInFloatyMode
[in] 컨트롤이 부동 모드이 CMFCRibbonEdit 면 TRUE이고, 그렇지 않으면 FALSE입니다.

Return Value

컨트롤의 너비(픽셀)입니다 CMFCRibbonEdit .

설명

CMFCRibbonEdit::HasCompactMode

CMFCRibbonEdit 컨트롤의 표시 크기를 압축할 수 있는지 여부를 나타냅니다.

virtual BOOL HasCompactMode() const;

Return Value

항상 TRUE를 반환합니다.

설명

기본적으로 이 메서드는 항상 TRUE를 반환합니다. 표시 크기를 압축할 수 있는지 여부를 나타내려면 이 메서드를 재정의합니다.

CMFCRibbonEdit::HasFocus

CMFCRibbonEdit 컨트롤에 포커스가 있는지 여부를 나타냅니다.

virtual BOOL HasFocus() const;

Return Value

컨트롤에 포커스가 CMFCRibbonEdit 있으면 TRUE이고, 그렇지 않으면 FALSE입니다.

설명

CMFCRibbonEdit::HasLargeMode

CMFCRibbonEdit 컨트롤의 표시 크기가 클 수 있는지 여부를 나타냅니다.

virtual BOOL HasLargeMode() const;

Return Value

항상 FALSE를 반환합니다.

설명

기본적으로 이 메서드는 항상 FALSE를 반환합니다. 표시 크기가 클 수 있는지 여부를 나타내려면 이 메서드를 재정의합니다.

CMFCRibbonEdit::HasSpinButtons

텍스트 상자에 스핀 단추가 있는지 여부를 나타냅니다.

virtual BOOL HasSpinButtons() const;

Return Value

텍스트 상자에 스핀 단추가 있으면 TRUE입니다. 그렇지 않으면 FALSE입니다.

설명

CMFCRibbonEdit::IsHighlighted

CMFCRibbonEdit 컨트롤이 강조 표시되어 있는지 여부를 나타냅니다.

virtual BOOL IsHighlighted() const;

Return Value

컨트롤이 강조 표시 CMFCRibbonEdit 되면 TRUE이고, 그렇지 않으면 FALSE입니다.

설명

CMFCRibbonEdit::OnAfterChangeRect

CMFCRibbonEdit 컨트롤에 대한 디스플레이 사각형의 크기가 변경될 때 프레임워크에서 호출됩니다.

virtual void OnAfterChangeRect(CDC* pDC);

매개 변수

pDC
[in] 컨트롤의 디바이스 컨텍스트에 대한 포인터입니다 CMFCRibbonEdit .

설명

CMFCRibbonEdit::OnDraw

CMFCRibbonEdit 컨트롤을 그리기 위해 프레임워크에서 호출됩니다.

virtual void OnDraw(CDC* pDC);

매개 변수

pDC
[in] 컨트롤의 디바이스 컨텍스트에 대한 포인터입니다 CMFCRibbonEdit .

설명

CMFCRibbonEdit::OnDrawLabelAndImage

CMFCRibbonEdit 컨트롤에 대한 레이블 및 이미지를 그리기 위해 프레임워크에서 호출됩니다.

virtual void OnDrawLabelAndImage(CDC* pDC);

매개 변수

pDC
[in] 컨트롤의 디바이스 컨텍스트에 대한 포인터입니다 CMFCRibbonEdit .

설명

CMFCRibbonEdit::OnDrawOnList

명령 목록 상자에 CMFCRibbonEdit 컨트롤을 그리기 위해 프레임워크에서 호출됩니다.

virtual void OnDrawOnList(
    CDC* pDC,
    CString strText,
    int nTextOffset,
    CRect rect,
    BOOL bIsSelected,
    BOOL bHighlighted);

매개 변수

pDC
[in] 컨트롤의 디바이스 컨텍스트에 대한 포인터입니다 CMFCRibbonEdit .

strText
[in] 표시 텍스트입니다.

nTextOffset
[in] 목록 상자의 왼쪽에서 표시 텍스트까지의 거리(픽셀)입니다.

rect
[in] 컨트롤의 표시 사각형입니다 CMFCRibbonEdit .

bIsSelected
[in] 이 매개 변수는 사용되지 않습니다.

bHighlighted
[in] 이 매개 변수는 사용되지 않습니다.

설명

명령 목록 상자에는 사용자가 빠른 실행 도구 모음을 사용자 지정할 수 있는 리본 컨트롤이 표시됩니다.

CMFCRibbonEdit::OnEnable

CMFCRibbonEdit 컨트롤을 사용하거나 사용하지 않도록 설정하기 위해 프레임워크에서 호출됩니다.

virtual void OnEnable(BOOL bEnable);

매개 변수

bEnable
[in] TRUE를 사용하여 컨트롤을 사용하도록 설정합니다. 컨트롤을 사용하지 않도록 설정하려면 FALSE입니다.

설명

CMFCRibbonEdit::OnHighlight

포인터가 CMFCRibbonEdit 컨트롤의 범위를 입력하거나 떠날 때 프레임워크에서 호출됩니다.

virtual void OnHighlight(BOOL bHighlight);

매개 변수

bHighlight
[in] 포인터가 컨트롤의 CMFCRibbonEdit 범위에 있으면 TRUE이고, 그렇지 않으면 FALSE입니다.

설명

CMFCRibbonEdit::OnKey

사용자가 키 설명을 누르고 CMFCRibbonEdit 컨트롤에 포커스가 있을 때 프레임워크에서 호출됩니다.

virtual BOOL OnKey(BOOL bIsMenuKey);

매개 변수

bIsMenuKey
[in] 키 설명에 팝업 메뉴가 표시되면 TRUE입니다. 그렇지 않으면 FALSE입니다.

Return Value

이벤트가 처리되었으면 TRUE입니다. 그렇지 않으면 FALSE입니다.

설명

CMFCRibbonEdit::OnLButtonDown

사용자가 컨트롤의 왼쪽 마우스 단추를 누를 때 CMFCRibbonEdit 컨트롤을 업데이트하기 위해 프레임워크에서 호출됩니다.

virtual void OnLButtonDown(CPoint point);

매개 변수

point
[in] 이 매개 변수는 사용되지 않습니다.

설명

CMFCRibbonEdit::OnLButtonUp

사용자가 마우스 왼쪽 단추를 놓을 때 프레임워크에서 호출됩니다.

virtual void OnLButtonUp(CPoint point);

매개 변수

point
[in] 이 매개 변수는 사용되지 않습니다.

설명

CMFCRibbonEdit::OnRTLChanged

레이아웃이 방향을 변경할 때 CMFCRibbonEdit 컨트롤을 업데이트하기 위해 프레임워크에서 호출됩니다.

virtual void OnRTLChanged(BOOL bIsRTL);

매개 변수

bIsRTL
[in] 레이아웃이 오른쪽에서 왼쪽인 경우 TRUE입니다. 레이아웃이 왼쪽에서 오른쪽인 경우 FALSE입니다.

설명

CMFCRibbonEdit::OnShow

CMFCRibbonEdit 컨트롤을 표시하거나 숨기기 위해 프레임워크에서 호출됩니다.

virtual void OnShow(BOOL bShow);

매개 변수

bShow
[in] TRUE이면 컨트롤을 표시합니다. 컨트롤을 숨기려면 FALSE입니다.

설명

CMFCRibbonEdit::Redraw

CMFCRibbonEdit 컨트롤의 표시를 업데이트합니다.

virtual void Redraw();

설명

이 메서드는 RDW_INVALIDATE, RDW_ERASE 및 RDW_UPDATENOW 플래그 집합을 사용하여 CWnd::RedrawWindow를 간접적으로 호출하여 개체의 표시 사각형 CMFCRibbonEdit 을 다시 그립니다.

CMFCRibbonEdit::SetACCData

CMFCRibbonEdit 개체의 접근성 데이터를 설정합니다.

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

매개 변수

pParent
개체의 부모 창에 대한 포인터입니다 CMFCRibbonEdit .

data
개체의 CMFCRibbonEdit 접근성 데이터입니다.

Return Value

항상 TRUE를 반환합니다.

설명

CMFCRibbonEdit::SetEditText

텍스트 상자의 텍스트를 설정합니다.

void SetEditText(CString strText);

매개 변수

strText
[in] 텍스트 상자의 텍스트입니다.

CMFCRibbonEdit::SetTextAlign

텍스트 상자의 텍스트 맞춤을 설정합니다.

void SetTextAlign(int nAlign);

매개 변수

nAlign
[in] 텍스트 맞춤 열거형 값입니다. 가능한 값은 설명 섹션을 참조하세요.

설명

nAlign 매개 변수는 다음 편집 컨트롤 스타일 중 하나입니다.

  • 왼쪽 맞춤에 대한 ES_LEFT

  • 가운데 맞춤에 대한 ES_CENTER

  • 오른쪽 맞춤에 대한 ES_RIGHT

이러한 스타일에 대한 자세한 내용은 컨트롤 스타일 편집을 참조 하세요.

CMFCRibbonEdit::SetWidth

CMFCRibbonEdit 컨트롤의 텍스트 상자 너비를 설정합니다.

void SetWidth(
    int nWidth,
    BOOL bInFloatyMode = FALSE);

매개 변수

nWidth
[in] 텍스트 상자의 너비(픽셀)입니다.

bInFloatyMode
TRUE이면 부동 모드의 너비를 설정합니다. 일반 모드의 너비를 설정하려면 FALSE입니다.

설명

컨트롤의 CMFCRibbonEdit 표시 모드에 따라 두 가지 너비가 있습니다. 부동 모드와 일반 모드입니다.

참고 항목

계층 구조 차트
클래스
CMFCRibbonButton 클래스
CMFCRibbonBar 클래스