AFX_GLOBAL_DATA 구조체

AFX_GLOBAL_DATA 구조는 프레임워크를 관리하거나 애플리케이션의 모양과 동작을 사용자 지정하는 데 사용되는 필드 및 메서드를 포함합니다.

구문

struct AFX_GLOBAL_DATA

멤버

공용 생성자

속성	설명
AFX_GLOBAL_DATA::AFX_GLOBAL_DATA	AFX_GLOBAL_DATA 구조를 생성합니다.
AFX_GLOBAL_DATA::~AFX_GLOBAL_DATA	소멸자

공용 메서드

이름	설명
AFX_GLOBAL_DATA::CleanUp	브러시, 글꼴 및 DLL 등 프레임워크에 의해 할당되는 리소스를 해제합니다.
AFX_GLOBAL_DATA::D 2D1MakeRotateMatrix	지정된 점을 기준으로 지정된 각도만큼 회전하는 회전 변환을 만듭니다.
AFX_GLOBAL_DATA::D rawParentBackground	지정된 영역에 컨트롤 부모의 배경을 그립니다.
AFX_GLOBAL_DATA::D rawTextOnGlass	지정된 테마의 비주얼 스타일로 지정된 텍스트를 그립니다.
AFX_GLOBAL_DATA::ExcludeTag	지정된 버퍼에서 지정된 XML 태그 쌍을 제거합니다.
AFX_GLOBAL_DATA::GetColor	지정된 사용자 인터페이스 요소의 현재 색을 검색합니다.
AFX_GLOBAL_DATA::GetDirect2dFactory	글로벌 데이터에 저장된 ID2D1Factory 인터페이스로 포인터를 반환합니다. 인터페이스가 초기화되지 않은 경우 기본 매개 변수와 함께 인터페이스가 생성됩니다.
AFX_GLOBAL_DATA::GetHandCursor	식별자가 IDC_HAND인 손 모양의 미리 정의된 커서를 검색합니다.
AFX_GLOBAL_DATA::GetITaskbarList	ITaskBarList 인터페이스에 대한 포인터를 만들고 글로벌 데이터에 저장합니다.
AFX_GLOBAL_DATA::GetITaskbarList3	ITaskBarList3 인터페이스에 대한 포인터를 만들고 글로벌 데이터에 저장합니다.
AFX_GLOBAL_DATA::GetNonClientMetrics	최소화되지 않은 창의 비클라이언트 영역과 관련된 메트릭을 검색합니다.
AFX_GLOBAL_DATA::GetShellAutohideBars	셸 자동 숨기기 막대의 위치를 결정합니다.
AFX_GLOBAL_DATA::GetTextHeight	현재 글꼴에서 텍스트 문자의 높이를 검색합니다.
AFX_GLOBAL_DATA::GetWICFactory	글로벌 데이터에 저장된 IWICImagingFactory 인터페이스로 포인터를 반환합니다. 인터페이스가 초기화되지 않은 경우 기본 매개 변수와 함께 인터페이스가 생성됩니다.
AFX_GLOBAL_DATA::GetWriteFactory	글로벌 데이터에 저장된 IDWriteFactory 인터페이스로 포인터를 반환합니다. 인터페이스가 초기화되지 않은 경우 기본 매개 변수와 함께 인터페이스가 생성됩니다.
AFX_GLOBAL_DATA::InitD2D	D2D, DirectWrite및 WIC 팩터리를 초기화합니다. 주 창이 초기화되기 전에 이 메서드를 호출합니다.
AFX_GLOBAL_DATA::Is32BitIcons	미리 정의된 32비트 아이콘이 지원되는지 여부를 나타냅니다.
AFX_GLOBAL_DATA::IsD2DInitialized	D2D 의 초기화 여부를 확인합니다.
AFX_GLOBAL_DATA::IsDwmCompositionEnabled	Windows DwmIsCompositionEnabled 메서드를 호출하는 간단한 방법을 제공합니다.
AFX_GLOBAL_DATA::IsHighContrastMode	이미지가 현재 고대비로 표시되는지 여부를 나타냅니다.
AFX_GLOBAL_DATA::OnSettingChange	데스크톱 메뉴 애니메이션의 현재 상태 및 작업 표시줄 자동 숨기기 기능을 탐지합니다.
AFX_GLOBAL_DATA::RegisterWindowClass	지정된 MFC 창 클래스를 등록합니다.
AFX_GLOBAL_DATA::ReleaseTaskBarRefs	GetITaskbarList 및 GetITaskbarList3 메서드를 통해 얻은 인터페이스를 해제합니다.
AFX_GLOBAL_DATA::Resume	Windows 테마 및 비주얼 스타일을 지원하는 메서드에 액세스하는 내부 함수 포인터를 다시 초기화합니다.
AFX_GLOBAL_DATA::SetLayeredAttrib	Windows SetLayeredWindowAttributes 메서드를 호출하는 간단한 방법을 제공합니다.
AFX_GLOBAL_DATA::SetMenuFont	지정된 논리 글꼴을 만듭니다.
AFX_GLOBAL_DATA::ShellCreateItemFromParsingName	구문 분석 이름에서 셸 항목 개체를 만들고 초기화합니다.
AFX_GLOBAL_DATA::UpdateFonts	프레임워크에서 사용하는 논리 글꼴을 다시 초기화합니다.
AFX_GLOBAL_DATA::UpdateSysColors	프레임워크에서 사용하는 색, 색 농도, 브러시, 펜 및 이미지를 초기화합니다.

보호된 메서드

속성	설명
AFX_GLOBAL_DATA::EnableAccessibilitySupport	Microsoft Active Accessibility 지원을 사용하거나 사용하지 않도록 설정합니다. Active Accessibility는 사용자 인터페이스 요소에 대한 정보를 노출하기 위한 신뢰할 수 있는 방법을 제공합니다.
AFX_GLOBAL_DATA::IsAccessibilitySupport	Microsoft Active Accessibility 지원이 활성화되어 있는지 여부를 나타냅니다.
AFX_GLOBAL_DATA::IsWindowsLayerSupportAvailable	운영 체제가 계층화된 창을 지원하는지 여부를 나타냅니다.

데이터 멤버

속성	설명
AFX_GLOBAL_DATA::bIsOSAlphaBlendingSupport	현재 운영 체제가 알파 혼합을 지원하는지 여부를 나타냅니다.
AFX_GLOBAL_DATA::bIsWindows7	애플리케이션이 Windows 7 운영 체제 이상에서 실행되고 있는지 여부를 나타냅니다.
AFX_GLOBAL_DATA::clrActiveCaptionGradient	활성 캡션의 그라데이션 색을 지정합니다. 도킹 창에 일반적으로 사용됩니다.
AFX_GLOBAL_DATA::clrInactiveCaptionGradient	비활성 캡션의 그라데이션 색을 지정합니다. 도킹 창에 일반적으로 사용됩니다.
AFX_GLOBAL_DATA::m_bUseBuiltIn32BitIcons	프레임워크가 미리 정의된 32비트 컬러 아이콘을 사용하는지, 아니면 더 낮은 해상도의 아이콘을 사용하는지를 나타냅니다.
AFX_GLOBAL_DATA::m_bUseSystemFont	시스템 글꼴이 메뉴, 도구 모음 및 리본에 사용되는지 여부를 나타냅니다.
AFX_GLOBAL_DATA::m_hcurHand	손 모양 커서에 대한 핸들을 저장합니다.
AFX_GLOBAL_DATA::m_hcurStretch	가로 늘이기 커서에 대한 핸들을 저장합니다.
AFX_GLOBAL_DATA::m_hcurStretchVert	세로 늘이기 커서에 대한 핸들을 저장합니다.
AFX_GLOBAL_DATA::m_hiconTool	도구 아이콘에 대한 핸들을 저장합니다.
AFX_GLOBAL_DATA::m_nAutoHideToolBarMargin	맨 왼쪽 자동 숨기기 도구 모음에서 도킹 모음의 왼쪽까지의 오프셋을 지정합니다.
AFX_GLOBAL_DATA::m_nAutoHideToolBarSpacing	자동 숨기기 도구 모음 사이의 간격을 지정합니다.
AFX_GLOBAL_DATA::m_nDragFrameThicknessDock	도킹된 상태를 전달하는 데 사용되는 끌기 프레임의 두께를 지정합니다.
AFX_GLOBAL_DATA::m_nDragFrameThicknessFloat	부동 상태를 전달하는 데 사용되는 끌기 프레임의 두께를 지정합니다.

설명

AFX_GLOBAL_DATA 구조에서 대부분의 데이터는 애플리케이션 시작 시 초기화됩니다.

상속 계층 구조

AFX_GLOBAL_DATA

요구 사항

헤더: afxglobals.h

AFX_GLOBAL_DATA::bIsOSAlphaBlendingSupport

운영 체제에서 알파 혼합을 지원하는지 여부를 나타냅니다.

BOOL  bIsOSAlphaBlendingSupport;

설명

TRUE는 알파 혼합이 지원됨을 나타냅니다. 그렇지 않으면 FALSE입니다.

AFX_GLOBAL_DATA::CleanUp

브러시, 글꼴 및 DLL 등 프레임워크에 의해 할당되는 리소스를 해제합니다.

void CleanUp();

AFX_GLOBAL_DATA::D 2D1MakeRotateMatrix

지정된 점을 기준으로 지정된 각도만큼 회전하는 회전 변환을 만듭니다.

HRESULT D2D1MakeRotateMatrix(
    FLOAT angle,
    D2D1_POINT_2F center,
    D2D1_MATRIX_3X2_F *matrix);

매개 변수

각
시계 방향 회전 각도(도)입니다.

center
회전할 지점입니다.

matrix
이 메서드가 반환되면 새 회전 변환이 포함됩니다. 이 매개 변수에 대한 스토리지를 할당해야 합니다.

Return Value

성공하면 S_OK 반환하고, 그렇지 않으면 오류 값을 반환합니다.

AFX_GLOBAL_DATA::D rawParentBackground

지정된 영역에 컨트롤 부모의 배경을 그립니다.

BOOL DrawParentBackground(
    CWnd* pWnd,
    CDC* pDC,
    LPRECT lpRect = NULL);

매개 변수

pWnd
[in] 컨트롤의 창에 대한 포인터입니다.

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

lpRect
[in] 그릴 영역을 경계로 하는 사각형에 대한 포인터입니다. 기본값은 NULL입니다.

Return Value

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

AFX_GLOBAL_DATA::D rawTextOnGlass

지정된 테마의 비주얼 스타일로 지정된 텍스트를 그립니다.

BOOL DrawTextOnGlass(
    HTHEME hTheme,
    CDC* pDC,
    int iPartId,
    int iStateId,
    CString strText,
    CRect rect,
    DWORD dwFlags,
    int nGlowSize = 0,
    COLORREF clrText = (COLORREF)-1);

매개 변수

hTheme
[in] 창의 테마 데이터 또는 NULL을 처리합니다. 이 매개 변수가 NULL이 아니고 테마가 지원되는 경우 프레임워크는 지정된 테마를 사용하여 텍스트를 그립니다. 그렇지 않으면 테마를 사용하여 텍스트를 그리지 않습니다.

OpenThemeData 메서드를 사용하여 HTHEME를 만듭니다.

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

iPartId
[in] 원하는 텍스트 모양이 있는 컨트롤 파트입니다. 자세한 내용은 파트 및 상태에 설명된 표의 파트 열을 참조하세요. 이 값이 0이면 텍스트가 기본 글꼴로 그려지거나 디바이스 컨텍스트로 선택된 글꼴로 그려집니다.

iStateId
[in] 원하는 텍스트 모양이 있는 컨트롤 상태입니다. 자세한 내용은 파트 및 상태에 설명된 표의 상태 열을 참조하세요.

strText
[in] 그릴 텍스트입니다.

rect
[in] 지정된 텍스트가 그려지는 영역의 경계입니다.

dwFlags
[in] 지정된 텍스트를 그리는 방법을 지정하는 플래그의 비트 조합(OR)입니다.

hTheme 매개 변수가 NULL 있거나 테마가 지원되지 않고 사용하도록 설정되지 않은 경우 CDC::D rawText 메서드의 nFormat 매개 변수는 유효한 플래그를 설명합니다. 테마가 지원되는 경우 DrawThemeTextEx 메서드의 dwFlags 매개 변수는 유효한 플래그를 설명합니다.

nGlowSize
[in] 지정된 텍스트를 그리기 전에 배경에 그려지는 네온 효과의 크기입니다. 기본값은 0입니다.

clrText
[in] 지정한 텍스트가 그려지는 색입니다. 기본값은 기본 색입니다.

Return Value

지정된 텍스트를 그리는 데 테마를 사용하는 경우 TRUE입니다. 그렇지 않으면 FALSE입니다.

설명

테마는 애플리케이션의 비주얼 스타일을 정의합니다. hTheme 매개 변수가 NULL이거나 DrawThemeTextEx 메서드가 지원되지 않거나 DWM(Desktop Window Manager) 컴퍼지션이 비활성화된 경우 테마를 사용하여 텍스트를 그리는 데 사용되지 않습니다.

AFX_GLOBAL_DATA::EnableAccessibilitySupport

Microsoft Active Accessibility 지원을 사용하거나 사용하지 않도록 설정합니다.

void EnableAccessibilitySupport(BOOL bEnable=TRUE);

매개 변수

bEnable
[in] 접근성 지원을 사용하도록 설정하려면 TRUE입니다. 접근성 지원을 사용하지 않도록 설정하는 FALSE입니다. 기본값은 TRUE입니다.

설명

Active Accessibility는 프로그램의 방식을 향상시키는 COM 기반의 기술이고 Windows 운영 체제는 보조 기술 제품과 함께 작동합니다. 이는 사용자 인터페이스 요소에 대한 정보를 노출하기 위한 신뢰할 수 있는 메서드를 제공합니다. 그러나 이제부터 Microsoft UI 자동화라고 하는 새로운 내게 필요한 옵션 모델을 사용할 수 있습니다. 두 기술을 비교하려면 UI 자동화 및 Microsoft Active Accessibility를 참조하세요.

AFX_GLOBAL_DATA::IsAccessibilitySupport 메서드를 사용하여 Microsoft Active Accessibility 지원을 사용할 수 있는지 여부를 확인합니다.

AFX_GLOBAL_DATA::ExcludeTag

지정된 버퍼에서 지정된 XML 태그 쌍을 제거합니다.

BOOL ExcludeTag(
    CString& strBuffer,
    LPCTSTR lpszTag,
    CString& strTag,
    BOOL bIsCharsList = FALSE);

매개 변수

strBuffer
[in] 텍스트 버퍼입니다.

lpszTag
[in] 열기 및 닫는 XML 태그 쌍의 이름입니다.

strTag
[out] 이 메서드가 반환되면 strTag 매개 변수에는 lpszTag 매개 변수로 명명된 여는 XML 태그와 닫는 XML 태그 사이에 있는 텍스트가 포함됩니다. 선행 또는 후행 공백은 결과에서 잘립니다.

bIsCharsList
[in] strTag 매개 변수의 이스케이프 문자에 대한 기호를 실제 이스케이프 문자로 변환하려면 TRUE입니다. 변환을 수행하지 않는 FALSE입니다. 기본값은 FALSE입니다. 자세한 내용은 설명 부분을 참조하세요.

Return Value

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

설명

XML 태그 쌍은 지정된 버퍼에서 텍스트 실행의 시작과 끝을 나타내는 명명된 여는 태그와 닫는 태그로 구성됩니다. strBuffer 매개 변수는 버퍼를 지정하고 lpszTag 매개 변수는 XML 태그의 이름을 지정합니다.

다음 표의 기호를 사용하여 지정된 버퍼의 이스케이프 문자 집합을 인코딩합니다. bIsCharsList 매개 변수에 TRUE를 지정하여 strTag 매개 변수의 기호를 실제 이스케이프 문자로 변환합니다. 다음 표에서는 _T() 매크로를 사용하여 기호 및 이스케이프 문자 문자열을 지정합니다.

기호	이스케이프 문자
_T("\\t")	_T("\t")
_T("\\n")	_T("\n")
_T("\\r")	_T("\r")
_T("\\b")	_T("\b")
_T("LT")	_T(""<)
_T("GT")	_T("">)
_T("AMP")	_T("&")

AFX_GLOBAL_DATA::GetColor

지정된 사용자 인터페이스 요소의 현재 색을 검색합니다.

COLORREF GetColor(int nColor);

매개 변수

nColor
[in] 색이 검색되는 사용자 인터페이스 요소를 지정하는 값입니다. 유효한 값 목록은 GetSysColor 메서드의 nIndex 매개 변수를 참조하세요.

Return Value

지정된 사용자 인터페이스 요소의 RGB 색 값입니다. 자세한 내용은 설명 부분을 참조하세요.

설명

nColor 매개 변수가 범위를 벗어나면 반환 값은 0입니다. 0은 유효한 RGB 값이기도 하므로 이 메서드를 사용하여 시스템 색이 현재 운영 체제에서 지원되는지 여부를 확인할 수 없습니다. 대신 색이 지원되지 않는 경우 NULL을 반환하는 GetSysColorBrush 메서드를 사용합니다.

AFX_GLOBAL_DATA::GetDirect2dFactory

전역 데이터에 저장된 ID2D1Factory 인터페이스에 대한 포인터를 반환합니다. 인터페이스가 초기화되지 않은 경우 기본 매개 변수와 함께 인터페이스가 생성됩니다.

ID2D1Factory* GetDirect2dFactory();

Return Value

팩터리 만들기에 성공하면 ID2D1Factory 인터페이스에 대한 포인터이거나, 만들기가 실패하거나 현재 운영 시스템에 D2D가 지원되지 않는 경우 NULL입니다.

AFX_GLOBAL_DATA::GetHandCursor

손과 비슷하고 식별자가 IDC_HAND 미리 정의된 커서를 검색합니다.

HCURSOR GetHandCursor();

Return Value

손 커서의 핸들입니다.

AFX_GLOBAL_DATA::GetNonClientMetrics

최소화되지 않은 창의 비클라이언트 영역과 관련된 메트릭을 검색합니다.

BOOL GetNonClientMetrics(NONCLIENTMETRICS& info);

매개 변수

정보
[in, out] 축소되지 않은 창의 비클라이언트 영역과 연결된 확장 가능한 메트릭을 포함하는 NONCLIENTMETRICS 구조체입니다.

Return Value

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

AFX_GLOBAL_DATA::GetTextHeight

현재 글꼴에서 텍스트 문자의 높이를 검색합니다.

int GetTextHeight(BOOL bHorz = TRUE);

매개 변수

bHorz
[in] 텍스트가 가로로 실행될 때 문자 높이를 검색하려면 TRUE입니다. 텍스트가 세로로 실행되면 문자 높이를 검색하는 FALSE입니다. 기본값은 TRUE입니다.

Return Value

현재 글꼴의 높이로, 오름차순에서 내림차순으로 측정됩니다.

AFX_GLOBAL_DATA::GetWICFactory

전역 데이터에 저장된 IWICImagingFactory 인터페이스에 대한 포인터를 반환합니다. 인터페이스가 초기화되지 않은 경우 기본 매개 변수와 함께 인터페이스가 생성됩니다.

IWICImagingFactory* GetWICFactory();

Return Value

팩터리 만들기에 성공하면 IWICImagingFactory 인터페이스에 대한 포인터이거나, 생성에 실패하거나 현재 운영 시스템에 WIC 지원이 없는 경우 NULL입니다.

AFX_GLOBAL_DATA::GetWriteFactory

전역 데이터에 저장된 IDWriteFactory 인터페이스에 대한 포인터를 반환합니다. 인터페이스가 초기화되지 않은 경우 기본 매개 변수와 함께 인터페이스가 생성됩니다.

IDWriteFactory* GetWriteFactory();

Return Value

팩터리 만들기에 성공하면 IDWriteFactory 인터페이스에 대한 포인터이거나, 만들기가 실패하거나 현재 운영 시스템에 DirectWrite가 지원되지 않는 경우 NULL입니다.

AFX_GLOBAL_DATA::InitD2D

D2D, DirectWrite 및 WIC 팩터리를 초기화합니다. 주 창이 초기화되기 전에 이 메서드를 호출합니다.

BOOL InitD2D(
    D2D1_FACTORY_TYPE d2dFactoryType = D2D1_FACTORY_TYPE_SINGLE_THREADED,
    DWRITE_FACTORY_TYPE writeFactoryType = DWRITE_FACTORY_TYPE_SHARED);

매개 변수

d2dFactoryType
D2D 팩터리의 스레딩 모델 및 만드는 리소스입니다.

writeFactoryType
쓰기 팩터리 개체를 공유할지 격리할지 여부를 지정하는 값입니다.

Return Value

공장이 intilalizrd이면 TRUE를 반환하고, 그렇지 않으면 FALSE를 반환합니다.

AFX_GLOBAL_DATA::Is32BitIcons

미리 정의된 32비트 아이콘이 지원되는지 여부를 나타냅니다.

BOOL Is32BitIcons() const;

Return Value

미리 정의된 32비트 아이콘이 지원되는 경우 TRUE입니다. 그렇지 않으면 FALSE입니다.

설명

이 메서드는 프레임워크에서 32비트 기본 제공 아이콘을 지원하고 운영 체제가 픽셀당 16비트 이상을 지원하는 경우와 이미지가 고대비로 표시되지 않는 경우 TRUE를 반환합니다.

AFX_GLOBAL_DATA::IsAccessibilitySupport

Microsoft Active Accessibility 지원이 활성화되어 있는지 여부를 나타냅니다.

BOOL IsAccessibilitySupport() const;

Return Value

접근성 지원을 사용하는 경우 TRUE입니다. 그렇지 않으면 FALSE입니다.

설명

Microsoft Active Accessibility는 애플리케이션을 액세스할 수 있도록 했던 이전 솔루션입니다. Microsoft UI 자동화는 Microsoft Windows의 새로운 접근성 모델로서 보조 기술 제품 및 자동 테스트 도구의 요구를 충족시키기 위한 것입니다.

AFX_GLOBAL_DATA::EnableAccessibilitySupport 메서드를 사용하여 활성 접근성 지원을 사용하거나 사용하지 않도록 설정합니다.

AFX_GLOBAL_DATA::IsD2DInitialized

D2D가 초기화되었는지 여부를 확인합니다.

BOOL IsD2DInitialized() const;

Return Value

D2D가 초기화된 경우 TRUE입니다. 그렇지 않으면 FALSE입니다.

AFX_GLOBAL_DATA::IsDwmCompositionEnabled

Windows DwmIsCompositionEnabled 메서드를 호출하는 간단한 방법을 제공합니다.

BOOL IsDwmCompositionEnabled();

Return Value

DWM(데스크톱 창 관리자) 컴퍼지션을 사용하도록 설정하면 TRUE이고, 그렇지 않으면 FALSE입니다.

AFX_GLOBAL_DATA::IsHighContrastMode

이미지가 현재 고대비로 표시되는지 여부를 나타냅니다.

BOOL IsHighContrastMode() const;

Return Value

이미지가 현재 흑백 고대비 모드로 표시되는 경우 TRUE입니다. 그렇지 않으면 FALSE입니다.

설명

검은색 고대비 모드에서는 빛을 향한 가장자리가 흰색이고 배경은 검은색입니다. 흰색 고대비 모드에서는 빛을 향한 가장자리가 검은색이고 배경은 흰색입니다.

AFX_GLOBAL_DATA::IsWindowsLayerSupportAvailable

운영 체제가 계층화된 창을 지원하는지 여부를 나타냅니다.

BOOL IsWindowsLayerSupportAvailable() const;

Return Value

계층화된 창이 지원되는 경우 TRUE입니다. 그렇지 않으면 FALSE입니다.

설명

계층화된 창이 지원 되는 경우 스마트 도킹 표식 은 계층화된 창을 사용합니다.

AFX_GLOBAL_DATA::m_bUseBuiltIn32BitIcons

프레임워크가 미리 정의된 32비트 컬러 아이콘을 사용하는지, 아니면 더 낮은 해상도의 아이콘을 사용하는지를 나타냅니다.

BOOL  m_bUseBuiltIn32BitIcons;

설명

TRUE는 프레임워크에서 32비트 색 아이콘을 사용하도록 지정합니다. FALSE는 낮은 해상도 아이콘을 지정합니다. AFX_GLOBAL_DATA::AFX_GLOBAL_DATA 생성자는 이 멤버를 TRUE로 초기화합니다.

이 멤버는 애플리케이션 시작 시 설정해야 합니다.

AFX_GLOBAL_DATA::m_bUseSystemFont

시스템 글꼴이 메뉴, 도구 모음 및 리본에 사용되는지 여부를 나타냅니다.

BOOL m_bUseSystemFont;

설명

TRUE는 시스템 글꼴을 사용하도록 지정합니다. 그렇지 않으면 FALSE입니다. AFX_GLOBAL_DATA::AFX_GLOBAL_DATA 생성자는 이 멤버를 FALSE로 초기화합니다.

프레임워크에서 사용할 글꼴을 결정하는 유일한 방법은 이 멤버를 테스트하는 것만이 아닙니다. 또한 이 메서드는 AFX_GLOBAL_DATA::UpdateFonts 기본 및 대체 글꼴을 테스트하여 메뉴, 도구 모음 및 리본 메뉴에 적용할 수 있는 비주얼 스타일을 결정합니다.

AFX_GLOBAL_DATA::m_hcurHand

손 모양 커서에 대한 핸들을 저장합니다.

HCURSOR m_hcurHand;

AFX_GLOBAL_DATA::m_hcurStretch

가로 늘이기 커서에 대한 핸들을 저장합니다.

HCURSOR m_hcurStretch;

AFX_GLOBAL_DATA::m_hcurStretchVert

세로 늘이기 커서에 대한 핸들을 저장합니다.

HCURSOR m_hcurStretchVert;

AFX_GLOBAL_DATA::m_hiconTool

도구 아이콘에 대한 핸들을 저장합니다.

HICON m_hiconTool;

AFX_GLOBAL_DATA::m_nAutoHideToolBarMargin

맨 왼쪽 자동 숨기기 도구 모음에서 도크 막대 왼쪽까지의 오프셋을 지정합니다.

int  m_nAutoHideToolBarMargin;

설명

AFX_GLOBAL_DATA::AFX_GLOBAL_DATA 생성자는 이 멤버를 4픽셀로 초기화합니다.

AFX_GLOBAL_DATA::m_nAutoHideToolBarSpacing

자동 숨기기 도구 모음 사이의 간격을 지정합니다.

int   m_nAutoHideToolBarSpacing;

설명

생성자는 이 AFX_GLOBAL_DATA::AFX_GLOBAL_DATA 멤버를 14픽셀로 초기화합니다.

AFX_GLOBAL_DATA::m_nDragFrameThicknessDock

도킹된 상태를 나타내는 데 사용되는 끌기 프레임의 두께를 지정합니다.

int  m_nDragFrameThicknessDock;

설명

AFX_GLOBAL_DATA::AFX_GLOBAL_DATA 생성자는 이 멤버를 3픽셀로 초기화합니다.

AFX_GLOBAL_DATA::m_nDragFrameThicknessFloat

부동 상태를 나타내는 데 사용되는 끌기 프레임의 두께를 지정합니다.

int  m_nDragFrameThicknessFloat;

설명

AFX_GLOBAL_DATA::AFX_GLOBAL_DATA 생성자는 이 멤버를 4픽셀로 초기화합니다.

AFX_GLOBAL_DATA::OnSettingChange

데스크톱 메뉴 애니메이션의 현재 상태 및 작업 표시줄 자동 숨기기 기능을 탐지합니다.

void OnSettingChange();

설명

이 메서드는 프레임워크 변수를 사용자 데스크톱의 특정 특성 상태로 설정합니다. 이 메서드는 메뉴 애니메이션, 메뉴 페이드 및 작업 표시줄 자동 숨기기 기능의 현재 상태를 검색합니다.

AFX_GLOBAL_DATA::RegisterWindowClass

지정된 MFC 창 클래스를 등록합니다.

CString RegisterWindowClass(LPCTSTR lpszClassNamePrefix);

매개 변수

lpszClassNamePrefix
[in] 등록할 창 클래스의 이름입니다.

Return Value

이 메서드가 성공하면 등록된 클래스의 정규화된 이름입니다. 그렇지 않으면 리소스 예외입니다.

설명

반환 값은 lpszClassNamePrefix 매개 변수 문자열의 콜론으로 구분된 목록이며, 현재 애플리케이션 인스턴스의 핸들에 대한 16진수 텍스트 표현, 식별자가 IDC_ARROW 화살표 커서인 애플리케이션 커서 및 배경 브러시입니다. MFC 창 클래스 등록에 대한 자세한 내용은 AfxRegisterClass를 참조 하세요.

AFX_GLOBAL_DATA::Resume

Windows 테마 및 비주얼 스타일을 지원하는 메서드에 액세스하는 내부 함수 포인터를 다시 초기화합니다.

BOOL Resume();

Return Value

이 메서드가 성공하면 TRUE입니다. 그렇지 않으면 FALSE입니다. 디버그 모드에서 이 메서드가 실패하면 이 메서드를 어설션합니다.

설명

이 메서드는 프레임워크가 WM_POWERBROADCAST 메시지를 받을 때 호출됩니다.

AFX_GLOBAL_DATA::SetLayeredAttrib

Windows SetLayeredWindowAttributes 메서드를 호출하는 간단한 방법을 제공합니다.

BOOL SetLayeredAttrib(
    HWND hwnd,
    COLORREF crKey,
    BYTE bAlpha,
    DWORD dwFlags);

매개 변수

hwnd
[in] 계층화된 창에 대한 핸들입니다.

crKey
[in] 바탕 화면 창 관리자가 계층화된 창을 작성하는 데 사용하는 투명도 색 키입니다.

bAlpha
[in] 계층화된 창의 불투명도를 설명하는 데 사용되는 알파 값입니다.

dwFlags
[in] 사용할 메서드 매개 변수를 지정하는 플래그의 비트 조합(OR)입니다. crKey 매개 변수를 투명도 색으로 사용할 LWA_COLORKEY 지정합니다. bAlpha 매개 변수를 사용하여 계층화된 창의 불투명도를 결정하는 LWA_ALPHA 지정합니다.

Return Value

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

AFX_GLOBAL_DATA::SetMenuFont

지정된 논리 글꼴을 만듭니다.

BOOL SetMenuFont(
    LPLOGFONT lpLogFont,
    BOOL bHorz);

매개 변수

lpLogFont
[in] 글꼴의 특성을 포함하는 구조체에 대한 포인터입니다.

bHorz
[in] TRUE이면 텍스트가 가로로 실행되도록 지정합니다. FALSE를 사용하여 텍스트가 세로로 실행되도록 지정합니다.

Return Value

이 메서드가 성공하면 TRUE입니다. 그렇지 않으면 FALSE입니다. 디버그 모드에서 이 메서드가 실패하면 이 메서드를 어설션합니다.

설명

이 메서드는 가로 일반 글꼴, 밑줄이 그은 글꼴 및 기본 메뉴 항목에 사용되는 굵은 글꼴을 만듭니다. 이 메서드는 필요에 따라 일반 세로 글꼴을 만듭니다. 논리 글꼴 에 대한 자세한 내용은 CFont::CreateFontIndirect를 참조하세요.

AFX_GLOBAL_DATA::UpdateFonts

프레임워크에서 사용하는 논리 글꼴을 다시 초기화합니다.

void UpdateFonts();

설명

논리 글꼴에 대한 자세한 내용은 다음을 참조하세요 CFont::CreateFontIndirect.

AFX_GLOBAL_DATA::UpdateSysColors

프레임워크에서 사용하는 색, 색 농도, 브러시, 펜 및 이미지를 초기화합니다.

void UpdateSysColors();

AFX_GLOBAL_DATA::bIsWindows7

애플리케이션이 Windows 7 이상에서 실행되고 있는지 여부를 나타냅니다.

BOOL bIsWindows7;

AFX_GLOBAL_DATA::clrActiveCaptionGradient

현재 캡션의 그라데이션 색을 지정합니다. 도킹 창에 일반적으로 사용됩니다.

COLORREF clrActiveCaptionGradient;

AFX_GLOBAL_DATA::clrInactiveCaptionGradient

비활성 캡션의 그라데이션 색을 지정합니다. 도킹 창에 일반적으로 사용됩니다.

COLORREF clrInactiveCaptionGradient;

AFX_GLOBAL_DATA::GetITaskbarList

인터페이스에 대한 포인터 ITaskBarList 를 전역 데이터에 만들고 저장합니다.

ITaskbarList *GetITaskbarList();

Return Value

작업 표시줄 목록 개체를 만드는 데 성공하면 인터페이스에 대한 포인터 ITaskbarList 입니다. 만들기가 실패하거나 현재 운영 체제가 Windows 7보다 작은 경우 NULL입니다.

AFX_GLOBAL_DATA::GetITaskbarList3

인터페이스에 대한 포인터 ITaskBarList3 를 전역 데이터에 만들고 저장합니다.

ITaskbarList3 *GetITaskbarList3();

Return Value

작업 표시줄 목록 개체를 만드는 데 성공하면 인터페이스에 대한 포인터 ITaskbarList3 입니다. 만들기가 실패하거나 현재 운영 체제가 Windows 7보다 작은 경우 NULL입니다.

AFX_GLOBAL_DATA::GetShellAutohideBars

셸 자동 숨기기 막대의 위치를 결정합니다.

int GetShellAutohideBars();

Return Value

자동 숨기기 막대의 위치를 지정하는 인코딩된 플래그가 있는 정수 값입니다. AFX_AUTOHIDE_BOTTOM, AFX_AUTOHIDE_TOP, AFX_AUTOHIDE_LEFT, AFX_AUTOHIDE_RIGHT 값을 결합할 수 있습니다.

AFX_GLOBAL_DATA::ReleaseTaskBarRefs

및 GetITaskbarList3 메서드를 통해 얻은 인터페이스를 GetITaskbarList 해제합니다.

void ReleaseTaskBarRefs();

AFX_GLOBAL_DATA::ShellCreateItemFromParsingName

구문 분석 이름에서 셸 항목 개체를 만들고 초기화합니다.

HRESULT ShellCreateItemFromParsingName(
    PCWSTR pszPath,
    IBindCtx *pbc,
    REFIID riid,
    void **ppv);

매개 변수

pszPath
[in] 표시 이름에 대한 포인터입니다.

pbc
구문 분석 작업을 제어하는 바인딩 컨텍스트에 대한 포인터입니다.

riid
인터페이스 ID에 대한 참조입니다.

ppv
[out] 이 함수가 반환되면 riid에서 요청된 인터페이스 포인터를 포함합니다. 일반적으로 이 값은 다음과 같습니다IShellItem.IShellItem2

Return Value

성공하면 S_OK 반환합니다. 그렇지 않으면 오류 값입니다.

참고 항목

계층 구조 차트
구조체, 스타일, 콜백 및 메시지 맵
COLORREF
파트 및 상태
CDC::D rawText
메서드의
바탕 화면 창 관리자
DWM 컴퍼지션 사용 및 제어
UI 자동화 및 Microsoft Active Accessibility
GetSysColor 함수
GetSysColorBrush
NONCLIENTMETRICS 구조체
AfxRegisterClass
AfxThrowResourceException
SetLayeredWindowAttributes