Структура AFX_GLOBAL_DATA

Статья
10/12/2023

Структура 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	Предоставляет простой способ для вызова метода DwmIsCompositionEnabled Windows.
AFX_GLOBAL_DATA::IsHighContrastMode	Указывает, отображаются ли сейчас изображения с высокой контрастностью.
AFX_GLOBAL_DATA::OnSettingChange	Определяет текущее состояние для анимации меню рабочего стола и функций автоматического скрытия панели задач.
AFX_GLOBAL_DATA::RegisterWindowClass	Регистрирует указанный класс окна MFC.
AFX_GLOBAL_DATA::ReleaseTaskBarRefs	Освобождает интерфейсы, полученные через методы GetITaskbarList и GetITaskbarList3.
AFX_GLOBAL_DATA::Резюме	Повторно инициализирует внутренние указатели функции, которые обращаются к методам, поддерживающим темы и стили оформленияWindows.
AFX_GLOBAL_DATA::SetLayeredAttrib	Предоставляет простой способ для вызова метода SetLayeredWindowAttributes Windows.
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);

Параметры

угол
Угол поворота по часовой стрелке в градусах.

центр
Точка, о которой поворачиваться.

матрица
При возврате этого метода содержит новое преобразование поворота. Необходимо выделить хранилище для этого параметра.

Возвращаемое значение

Возвращает S_OK в случае успешного выполнения или значения ошибки в противном случае.

AFX_GLOBAL_DATA::D rawParentBackground

Рисует фон родительского объекта элемента управления в заданной области.

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

Параметры

pWnd
[in] Указатель на окно элемента управления.

pDC
[in] Указатель на контекст устройства.

lpRect
[in] Указатель на прямоугольник, ограничивающий область для рисования. Значение по умолчанию — NULL.

Возвращаемое значение

ЗНАЧЕНИЕ 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 поддерживается и включен, параметр nFormat метода CDC::D rawText описывает допустимые флаги. Если темы поддерживаются, параметр dwFlags метода DrawThemeTextEx описывает допустимые флаги.

nGlowSize
[in] Размер эффекта свечения, рисуемого на фоне перед рисованием указанного текста. Значение по умолчанию равно 0.

clrText
[in] Цвет, в котором рисуется указанный текст. Значением по умолчанию является цвет по умолчанию.

Возвращаемое значение

ЗНАЧЕНИЕ TRUE, если тема используется для рисования указанного текста; в противном случае — ЗНАЧЕНИЕ FALSE.

Замечания

Тема определяет визуальный стиль приложения. Тема не используется для рисования текста, если параметр hTheme имеет значение NULL, или если метод DrawThemeTextEx не поддерживается, или если композиция диспетчера окон рабочего стола (DWM) отключена.

AFX_GLOBAL_DATA::EnableAccessibilitySupport

Включает или отключает поддержку Microsoft Active Accessibility.

void EnableAccessibilitySupport(BOOL bEnable=TRUE);

Параметры

bEnable
[in] TRUE для включения поддержки специальных возможностей; FALSE, чтобы отключить поддержку специальных возможностей. Значение по умолчанию — TRUE.

Замечания

Активные специальные возможности — это технология на основе COM, которая улучшает способ работы программ и операционной системы Windows вместе с продуктами вспомогательных технологий. Он предоставляет надежные методы для предоставления сведений о элементах пользовательского интерфейса. Однако теперь доступна более новая модель специальных возможностей, называемая Microsoft модель автоматизации пользовательского интерфейса. Сравнение двух технологий см. в разделе модель автоматизации пользовательского интерфейса и Microsoft Active Accessibility.

Используйте метод AFX_GLOBAL_DATA::IsAccessibilitySupport, чтобы определить, включена ли поддержка специальных возможностей Microsoft Active.

AFX_GLOBAL_DATA::ExcludeTag

Удаляет заданную пару тегов XML из указанного буфера.

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

Параметры

strBuffer
[in] Буфер текста.

lpszTag
[in] Имя пары открывающих и закрывающих XML-тегов.

strTag
[out] При возврате этого метода параметр strTag содержит текст, который находится между открывающим и закрывающим XML-тегами, именуемыми параметром lpszTag . Все начальные или конечные пробелы обрезаются из результата.

bIsCharsList
[in] ЗНАЧЕНИЕ TRUE для преобразования символов escape-символов в параметр strTag в фактические escape-символы; ЗНАЧЕНИЕ FALSE для выполнения преобразования. Значение по умолчанию — FALSE. Дополнительные сведения см. в подразделе "Примечания".

Возвращаемое значение

ЗНАЧЕНИЕ TRUE, если этот метод выполнен успешно; в противном случае — ЗНАЧЕНИЕ FALSE.

Замечания

Пара тегов XML состоит из именованных тегов открытия и закрытия, указывающих начало и конец выполнения текста в указанном буфере. Параметр strBuffer указывает буфер, а параметр lpszTag указывает имя XML-тегов.

Используйте символы в следующей таблице, чтобы закодировать набор escape-символов в указанном буфере. Укажите ЗНАЧЕНИЕ TRUE для параметра bIsCharsList, чтобы преобразовать символы в параметр strTag в фактические escape-символы. В следующей таблице используется макрос _T() для указания строк символов и escape-символов.

Символ	Escape-символ
_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] Значение, указывающее элемент пользовательского интерфейса, цвет которого извлекается. Список допустимых значений см. в параметре nIndex метода GetSysColor.

Возвращаемое значение

Значение цвета RGB указанного элемента пользовательского интерфейса. Дополнительные сведения см. в подразделе "Примечания".

Замечания

Если параметр nColor выходит за пределы диапазона, возвращаемое значение равно нулю. Так как ноль также является допустимым значением RGB, этот метод нельзя использовать для определения того, поддерживается ли системный цвет текущей операционной системой. Вместо этого используйте метод GetSysColorBrush , который возвращает значение NULL, если цвет не поддерживается.

AFX_GLOBAL_DATA::GetDirect2dFactory

Возвращает указатель на интерфейс ID2D1Factory, который хранится в глобальных данных. Если интерфейс не инициализирован, он создается с параметрами по умолчанию.

ID2D1Factory* GetDirect2dFactory();

Возвращаемое значение

Указатель на интерфейс ID2D1Factory, если создание фабрики выполнено успешно, или ЗНАЧЕНИЕ NULL, если создание завершается ошибкой или текущая операционная система не поддерживает D2D.

AFX_GLOBAL_DATA::GetHandCursor

Извлекает предопределенный курсор, похожий на руку и идентификатор которого IDC_HAND.

HCURSOR GetHandCursor();

Возвращаемое значение

Дескриптор курсора руки.

AFX_GLOBAL_DATA::GetNonClientMetrics

Получает метрики, связанные с неклиентской областью несвернутого окна.

BOOL GetNonClientMetrics(NONCLIENTMETRICS& info);

Параметры

info
[in, out] Структура NONCLIENTMETRICS , содержащая масштабируемые метрики, связанные с неклиентной областью неминимированного окна.

Возвращаемое значение

ЗНАЧЕНИЕ TRUE, если этот метод выполнен успешно; в противном случае — ЗНАЧЕНИЕ FALSE.

AFX_GLOBAL_DATA::GetTextHeight

Получает высоту символов текста в текущем шрифте.

int GetTextHeight(BOOL bHorz = TRUE);

Параметры

bHorz
[in] ЗНАЧЕНИЕ TRUE для получения высоты символов при горизонтальном выполнении текста; ЗНАЧЕНИЕ FALSE для получения высоты символов при вертикальном выполнении текста. Значение по умолчанию — TRUE.

Возвращаемое значение

Высота текущего шрифта, измеряемого от возрастания до спуска.

AFX_GLOBAL_DATA::GetWICFactory

Возвращает указатель на интерфейс IWICImagingFactory, хранящийся в глобальных данных. Если интерфейс не инициализирован, он создается с параметрами по умолчанию.

IWICImagingFactory* GetWICFactory();

Возвращаемое значение

Указатель на интерфейс IWICImagingFactory, если создание фабрики выполнено успешно, или значение NULL, если создание завершается сбоем или текущая операционная система не поддерживает WIC.

AFX_GLOBAL_DATA::GetWriteFactory

Возвращает указатель на интерфейс IDWriteFactory, который хранится в глобальных данных. Если интерфейс не инициализирован, он создается с параметрами по умолчанию.

IDWriteFactory* GetWriteFactory();

Возвращаемое значение

Указатель на интерфейс IDWriteFactory, если создание фабрики выполнено успешно, или значение NULL, если создание завершается ошибкой или текущая операционная система не поддерживает DirectWrite.

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
Значение, указывающее, будет ли объект фабрики записи общим или изолированным.

Возвращаемое значение

Возвращает значение TRUE, если фабрики были интилализурд, FALSE - в противном случае

AFX_GLOBAL_DATA::Is32BitIcons

Указывает, поддерживаются ли стандартные 32-разрядные значки.

BOOL Is32BitIcons() const;

Возвращаемое значение

ЗНАЧЕНИЕ TRUE, если поддерживаются предопределенные 32-разрядные значки; в противном случае — ЗНАЧЕНИЕ FALSE.

Замечания

Этот метод возвращает значение TRUE, если платформа поддерживает 32-разрядные встроенные значки, и если операционная система поддерживает 16 битов на пиксель или больше, а если изображения не отображаются в высокой контрастности.

AFX_GLOBAL_DATA::IsAccessibilitySupport

Указывает, включена ли поддержка Microsoft Active Accessibility.

BOOL IsAccessibilitySupport() const;

Возвращаемое значение

ЗНАЧЕНИЕ TRUE, если включена поддержка специальных возможностей; в противном случае — ЗНАЧЕНИЕ FALSE.

Замечания

Microsoft Active Accessibility — это более раннее решение для обеспечения доступности приложений. Microsoft модель автоматизации пользовательского интерфейса — это новая модель специальных возможностей для Microsoft Windows, предназначенная для решения потребностей вспомогательных технологий и автоматизированных средств тестирования.

Используйте метод AFX_GLOBAL_DATA::EnableAccessibilitySupport, чтобы включить или отключить поддержку активных специальных возможностей.

AFX_GLOBAL_DATA::IsD2DInitialized

Определяет, был ли инициализирован D2D

BOOL IsD2DInitialized() const;

Возвращаемое значение

ЗНАЧЕНИЕ TRUE, если D2D был инициализирован; в противном случае ЗНАЧЕНИЕ FALSE.

AFX_GLOBAL_DATA::IsDwmCompositionEnabled

Предоставляет простой способ для вызова метода DwmIsCompositionEnabled Windows.

BOOL IsDwmCompositionEnabled();

Возвращаемое значение

ЗНАЧЕНИЕ TRUE, если композиция диспетчера окон рабочего стола (DWM) включена; в противном случае — ЗНАЧЕНИЕ FALSE.

AFX_GLOBAL_DATA::IsHighContrastMode

Указывает, отображаются ли сейчас изображения с высокой контрастностью.

BOOL IsHighContrastMode() const;

Возвращаемое значение

TRUE, если изображения в настоящее время отображаются в черно-белом режиме высокой контрастности; в противном случае — ЗНАЧЕНИЕ FALSE.

Замечания

В черном режиме высокой контрастности края, обращенные к свету, белые, и фон черный. В белом режиме высокой контрастности края, обращенные к свету, черные, и фон белый.

AFX_GLOBAL_DATA::IsWindowsLayerSupportAvailable

Указывает, поддерживает ли операционная система многослойные окна.

BOOL IsWindowsLayerSupportAvailable() const;

Возвращаемое значение

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] Имя класса окна для регистрации.

Возвращаемое значение

Полное имя зарегистрированного класса, если этот метод выполнен успешно; в противном случае — исключение ресурса.

Замечания

Возвращаемое значение — это список строк параметров lpszClassNamePrefix, а шестнадцатеричное текстовое представление дескрипторов текущего экземпляра приложения; курсор приложения, который является курсором со стрелкой, идентификатор которого IDC_ARROW; и фоновой кисти. Дополнительные сведения о регистрации классов окон MFC см. в статье AfxRegisterClass.

AFX_GLOBAL_DATA::Резюме

Повторно инициализирует внутренние указатели функции, которые обращаются к методам, поддерживающим темы и стили оформленияWindows.

BOOL Resume();

Возвращаемое значение

ЗНАЧЕНИЕ TRUE, если этот метод выполнен успешно; в противном случае — ЗНАЧЕНИЕ FALSE. В режиме отладки этот метод утверждает, если этот метод не удается.

Замечания

Этот метод вызывается, когда платформа получает сообщение WM_POWERBROADCAST .

AFX_GLOBAL_DATA::SetLayeredAttrib

Предоставляет простой способ для вызова метода SetLayeredWindowAttributes Windows.

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

Параметры

hwnd
[in] Дескриптор многоуровневого окна.

crKey
[in] Цветной ключ прозрачности, который используется диспетчером окон рабочего стола для создания многоуровневого окна.

bAlpha
[in] Альфа-значение, используемое для описания непрозрачности многоуровневого окна.

dwFlags
[in] Побитовая комбинация флагов, указывающая используемые параметры метода. Укажите LWA_COLORKEY использовать параметр crKey в качестве цвета прозрачности. Укажите LWA_ALPHA, чтобы использовать параметр bAlpha для определения непрозрачности многоуровневого окна.

Возвращаемое значение

ЗНАЧЕНИЕ TRUE, если этот метод выполнен успешно; в противном случае — ЗНАЧЕНИЕ FALSE.

AFX_GLOBAL_DATA::SetMenuFont

Создает указанный логический шрифт.

BOOL SetMenuFont(
    LPLOGFONT lpLogFont,
    BOOL bHorz);

Параметры

lpLogFont
[in] Указатель на структуру, содержащую атрибуты шрифта.

bHorz
[in] ЗНАЧЕНИЕ 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();

Возвращаемое значение

Указатель на интерфейс при ITaskbarList успешном создании объекта списка панели задач; ЗНАЧЕНИЕ NULL, если создание завершается ошибкой или если текущая операционная система меньше Windows 7.

AFX_GLOBAL_DATA::GetITaskbarList3

Создает и сохраняет в глобальных данных указатель на ITaskBarList3 интерфейс.

ITaskbarList3 *GetITaskbarList3();

Возвращаемое значение

Указатель на интерфейс при ITaskbarList3 успешном создании объекта списка панели задач; ЗНАЧЕНИЕ NULL, если создание завершается ошибкой или если текущая операционная система меньше Windows 7.

AFX_GLOBAL_DATA::GetShellAutohideBars

Определяет положения автоматически скрываемых панелей оболочки.

int GetShellAutohideBars();

Возвращаемое значение

Целочисленное значение с закодированными флагами, определяющими позиции автоматически скрывающихся полос. Он может сочетать следующие значения: AFX_AUTOHIDE_BOTTOM, AFX_AUTOHIDE_TOP, AFX_AUTOHIDE_LEFT, AFX_AUTOHIDE_RIGHT.

AFX_GLOBAL_DATA::ReleaseTaskBarRefs

Освобождает интерфейсы, полученные с помощью GetITaskbarList методов и GetITaskbarList3 методов.

void ReleaseTaskBarRefs();

AFX_GLOBAL_DATA::ShellCreateItemFromParsingName

Создает и инициализирует объект элемента оболочки из имени синтаксического анализа.

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

Параметры

pszPath
[in] Указатель на отображаемое имя.

pbc
Указатель на контекст привязки, который управляет операцией синтаксического анализа.

riid
Ссылка на идентификатор интерфейса.

ppv
[out] Когда эта функция возвращается, содержит указатель интерфейса, запрошенный в riid. Обычно это будет IShellItem или IShellItem2.

Возвращаемое значение

Возвращает S_OK в случае успешного выполнения; Значение ошибки в противном случае.

См. также

Диаграмма иерархии
Структуры, стили, обратные вызовы и схемы сообщений
COLORREF
Части и состояния
CDC::D rawText
DrawThemeTextEx
Диспетчер окон рабочего стола
Включение и управление композицией DWM
Модель автоматизации пользовательского интерфейса и Microsoft Active Accessibility
Функция GetSysColor
GetSysColorBrush
Структура NONCLIENTMETRICS
AfxRegisterClass
AfxThrowResourceException
SetLayeredWindowAttributes

Поделиться через

Структура AFX_GLOBAL_DATA

Синтаксис

Участники

Открытые конструкторы

Открытые методы

Защищенные методы

Элементы данных

Замечания

Иерархия наследования

Требования

AFX_GLOBAL_DATA::bIsOSAlphaBlendingSupport

Замечания

AFX_GLOBAL_DATA::CleanUp

AFX_GLOBAL_DATA::D 2D1MakeRotateMatrix

Параметры

Возвращаемое значение

AFX_GLOBAL_DATA::D rawParentBackground

Параметры

Возвращаемое значение

AFX_GLOBAL_DATA::D rawTextOnGlass

Параметры

Возвращаемое значение

Замечания

AFX_GLOBAL_DATA::EnableAccessibilitySupport

Параметры

Замечания

AFX_GLOBAL_DATA::ExcludeTag

Параметры

Возвращаемое значение

Замечания

AFX_GLOBAL_DATA::GetColor

Параметры

Возвращаемое значение

Замечания

AFX_GLOBAL_DATA::GetDirect2dFactory

Возвращаемое значение

AFX_GLOBAL_DATA::GetHandCursor

Возвращаемое значение

AFX_GLOBAL_DATA::GetNonClientMetrics

Параметры

Возвращаемое значение

AFX_GLOBAL_DATA::GetTextHeight

Параметры

Возвращаемое значение

AFX_GLOBAL_DATA::GetWICFactory

Возвращаемое значение

AFX_GLOBAL_DATA::GetWriteFactory

Возвращаемое значение

AFX_GLOBAL_DATA::InitD2D

Параметры

Возвращаемое значение

AFX_GLOBAL_DATA::Is32BitIcons

Возвращаемое значение

Замечания

AFX_GLOBAL_DATA::IsAccessibilitySupport

Возвращаемое значение

Замечания

AFX_GLOBAL_DATA::IsD2DInitialized

Возвращаемое значение

AFX_GLOBAL_DATA::IsDwmCompositionEnabled

Возвращаемое значение

AFX_GLOBAL_DATA::IsHighContrastMode

Возвращаемое значение

Замечания

AFX_GLOBAL_DATA::IsWindowsLayerSupportAvailable

Возвращаемое значение

Замечания

AFX_GLOBAL_DATA::m_bUseBuiltIn32BitIcons

Замечания

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

Замечания