CMFCRibbonStatusBarPane 클래스

클래스는 CMFCRibbonStatusBarPane 리본 상태 표시줄에 추가할 수 있는 리본 요소를 구현합니다.

구문

class CMFCRibbonStatusBarPane : public CMFCRibbonButton

멤버

공용 생성자

속성	설명
CMFCRibbonStatusBarPane::CMFCRibbonStatusBarPane	CMFCRibbonStatusBarPane 개체를 생성하고 초기화합니다.

공용 메서드

이름	설명
CMFCRibbonStatusBarPane::GetAlmostLargeText	잘림 없이 창에 표시할 수 있는 가장 긴 텍스트 문자열을 정의하는 문자열을 반환합니다.
CMFCRibbonStatusBarPane::GetTextAlign	텍스트 맞춤의 현재 설정을 반환합니다.
CMFCRibbonStatusBarPane::IsAnimation	애니메이션이 진행 중인지 여부를 확인합니다.
CMFCRibbonStatusBarPane::IsExtended	창이 리본 상태 표시줄의 확장 영역에 있는지 여부를 확인합니다.
CMFCRibbonStatusBarPane::OnDrawBorder	(재정의 CMFCRibbonButton::OnDrawBorder.)
CMFCRibbonStatusBarPane::OnFillBackground	(재정의 CMFCRibbonButton::OnFillBackground.)
CMFCRibbonStatusBarPane::SetAlmostLargeText	잘림 없이 창에 표시할 수 있는 가장 긴 텍스트 문자열을 정의합니다.
CMFCRibbonStatusBarPane::SetAnimationList	애니메이션에 사용할 수 있는 이미지 목록을 창에 할당합니다.
CMFCRibbonStatusBarPane::SetTextAlign	텍스트 맞춤을 설정합니다.
CMFCRibbonStatusBarPane::StartAnimation	창에 할당된 애니메이션을 시작합니다.
CMFCRibbonStatusBarPane::StopAnimation	창에 할당된 애니메이션을 중지합니다. .

보호된 메서드

속성	설명
CMFCRibbonStatusBarPane::OnFinishAnimation	창에 할당된 애니메이션이 중지되면 프레임워크에서 호출됩니다.

예시

다음 예제에서는 CMFCRibbonStatusBarPane 클래스에서 다양한 메서드를 사용하는 방법을 보여 줍니다. 이 예제에서는 개체를 CMFCRibbonStatusBarPane 생성하고, 상태 표시줄 창 레이블의 텍스트 맞춤을 설정하고, 잘림 없이 상태 표시줄 창에 표시할 수 있는 가장 긴 텍스트를 정의하고, 상태 표시줄 창에 애니메이션에 사용할 수 있는 이미지 목록에 연결하고, 애니메이션을 시작하는 방법을 보여 줍니다.

CString strTitlePane1;
CString strTitlePane2;
strTitlePane1.LoadString(IDS_STATUS_PANE1);
strTitlePane2.LoadString(IDS_STATUS_PANE2);

CMFCRibbonStatusBarPane* rsbp = new CMFCRibbonStatusBarPane( ID_STATUSBAR_PANE1, strTitlePane1, TRUE );
rsbp->SetTextAlign( TA_CENTER );
rsbp->SetAlmostLargeText( _T( "Status bar" ) );
CBitmap bitmap;
bitmap.LoadBitmapW( IDB_FILESMALL );
rsbp->SetAnimationList( (HBITMAP)bitmap );
rsbp->StartAnimation();

상속 계층 구조

CObject

CMFCRibbonBaseElement

CMFCRibbonButton

CMFCRibbonStatusBarPane

요구 사항

헤더: afxribbonstatusbarpane.h

CMFCRibbonStatusBarPane::CMFCRibbonStatusBarPane

상태 표시줄에서 창 개체를 생성합니다.

CMFCRibbonStatusBarPane(
    UINT nCmdID,
    LPCTSTR lpszText,
    BOOL bIsStatic=FALSE,
    HICON hIcon=NULL,
    LPCTSTR lpszAlmostLargeText=NULL);

CMFCRibbonStatusBarPane(
    UINT nCmdID,
    LPCTSTR lpszText,
    HBITMAP hBmpAnimationList,
    int cxAnimation=16,
    COLORREF clrTrnsp=RGB(192,192 1,192) 1,
    HICON hIcon=NULL,
    BOOL bIsStatic=FALSE);

CMFCRibbonStatusBarPane(
    UINT nCmdID,
    LPCTSTR lpszText,
    UINT uiAnimationListResID,
    int cxAnimation=16,
    COLORREF clrTrnsp=RGB(192, 192 1, 192) 1,
    HICON hIcon=NULL,
    BOOL bIsStatic=FALSE);

매개 변수

nCmdID
[in] 창의 명령 ID를 지정합니다.

lpszText
[in] 창에 표시할 텍스트 문자열을 지정합니다.

bIsStatic
[in] TRUE이면 상태 창을 클릭하여 강조 표시하거나 선택할 수 없습니다.

hIcon
[in] 창에 표시할 아이콘에 대한 핸들을 지정합니다.

lpszAlmostLargeText
[in] 창에서 표시할 수 있는 가장 긴 텍스트 문자열을 지정합니다.

hBmpAnimationList
[in] 애니메이션에 사용되는 이미지 목록에 대한 핸들을 지정합니다.

cxAnimation
[in] 애니메이션에 사용되는 이미지 목록의 아이콘 너비를 픽셀 단위로 지정합니다.

clrTrnsp
[in] 이미지 목록에서 애니메이션에 사용되는 이미지의 투명한 색을 지정합니다.

uiAnimationListResID
[in] 애니메이션에 사용되는 이미지 목록의 리소스 ID를 지정합니다.

CMFCRibbonStatusBarPane::GetAlmostLargeText

상태 표시줄 창에 표시할 수 있는 가장 긴 텍스트 문자열을 가져옵니다.

LPCTSTR GetAlmostLargeText() const;

Return Value

상태 표시줄 창에 표시할 수 있는 가장 긴 텍스트 문자열입니다.

CMFCRibbonStatusBarPane::GetTextAlign

상태 표시줄 창의 레이블에 대한 텍스트 맞춤의 현재 설정을 가져옵니다.

int GetTextAlign() const;

Return Value

다음 중 하나일 수 있는 현재 텍스트 맞춤입니다.

• TA_LEFT

• TA_CENTER

• TA_RIGHT.

CMFCRibbonStatusBarPane::IsAnimation

애니메이션이 진행 중인지 여부를 확인합니다.

BOOL IsAnimation() const;

Return Value

애니메이션이 진행 중인 경우 TRUE입니다. 그렇지 않으면 FALSE입니다.

CMFCRibbonStatusBarPane::IsExtended

창이 리본 상태 표시줄의 확장 영역에 있는지 여부를 확인합니다.

BOOL IsExtended() const;

Return Value

TRUE이면 창이 상태 표시줄 확장 영역에 있습니다. 그렇지 않으면 FALSE입니다.

CMFCRibbonStatusBarPane::OnDrawBorder

더 자세한 내용은 Visual Studio 설치의 VC\atlmfc\src\mfc 폴더에 있는 소스 코드를 참조하세요.

virtual void OnDrawBorder(CDC*);

매개 변수

[in] CDC*

설명

CMFCRibbonStatusBarPane::OnFillBackground

더 자세한 내용은 Visual Studio 설치의 VC\atlmfc\src\mfc 폴더에 있는 소스 코드를 참조하세요.

virtual COLORREF OnFillBackground(CDC* pDC);

매개 변수

[in] pDC

Return Value

설명

CMFCRibbonStatusBarPane::OnFinishAnimation

프레임워크는 창에 할당된 애니메이션이 종료되면 이 메서드를 호출합니다.

virtual void OnFinishAnimation();

설명

StopAnimation 메서드는 애니메이션이 OnFinishAnimation 끝날 때 데이터를 정리하는 데 사용할 수 있는 메서드를 호출합니다.

CMFCRibbonStatusBarPane::SetAlmostLargeText

잘림 없이 상태 표시줄 창에 표시할 수 있는 가장 긴 텍스트를 정의합니다.

void SetAlmostLargeText(LPCTSTR lpszAlmostLargeText);

매개 변수

lpszAlmostLargeText
[in] 잘림 없이 상태 표시줄 창에 표시할 수 있는 가장 긴 문자열을 지정합니다.

설명

라이브러리는 lpszAlmostLargeText가 지정하는 텍스트의 크기를 계산하고 그에 따라 창의 크기를 조정합니다. 여전히 창에 맞지 않으면 텍스트가 잘립니다.

CMFCRibbonStatusBarPane::SetAnimationList

애니메이션에 사용할 수 있는 이미지 목록을 상태 표시줄 창에 연결합니다.

void SetAnimationList(
    HBITMAP hBmpAnimationList,
    int cxAnimation=16,
    COLORREF clrTransp=RGB(192, 192 1, 192) 1);

BOOL SetAnimationList(
    UINT uiAnimationListResID,
    int cxAnimation=16,
    COLORREF clrTransp=RGB(192, 192 1, 192) 1);

매개 변수

hBmpAnimationList
[in] 이미지 목록에 대한 핸들을 지정합니다.

cxAnimation
[in] 이미지 목록의 프레임 너비를 픽셀 단위로 지정합니다.

clrTransp
[in] 이미지 목록의 투명한 색을 지정합니다.

uiAnimationListResID
[in] 이미지 목록의 리소스 ID를 지정합니다.

Return Value

TRUE이면 이미지 목록이 상태 표시줄 창에 성공적으로 연결됩니다. 그렇지 않으면 FALSE입니다.

CMFCRibbonStatusBarPane::SetTextAlign

상태 표시줄 창 레이블의 텍스트 맞춤을 설정합니다.

void SetTextAlign(int nAlign);

매개 변수

nAlign
[in] 텍스트 맞춤을 지정합니다.

설명

nAlign 은 다음 값 중 하나를 가질 수 있습니다.

• TA_LEFT: 왼쪽 맞춤

• TA_CENTER: 가운데 맞춤

• TA_RIGHT: 오른쪽 맞춤

CMFCRibbonStatusBarPane::StartAnimation

창에 할당하는 애니메이션을 시작합니다.

void StartAnimation(
    UINT nFrameDelay=500,
    UINT nDuration=-1);

매개 변수

nFrameDelay
[in] 애니메이션 프레임 속도를 밀리초 단위로 지정합니다.

nDuration
[in] 애니메이션 재생 기간을 밀리초 단위로 지정합니다. 무한 루프에 -1을 사용합니다.

설명

를 사용하여 SetAnimationList호출 StartAnimation 하기 전에 이미지 목록에 대한 핸들을 지정해야 합니다.

CMFCRibbonStatusBarPane::StopAnimation

상태 표시줄 창에 할당한 애니메이션을 중지합니다.

void StopAnimation();

참고 항목

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