AFX_GLOBAL_DATA (estructura)

Artículo
06/16/2023

La estructura AFX_GLOBAL_DATA contiene los campos y métodos que se utilizan para administrar el marco o personalizar el aspecto y el comportamiento de la aplicación.

Sintaxis

struct AFX_GLOBAL_DATA

Miembros

Constructores públicos

Nombre	Descripción
`AFX_GLOBAL_DATA::AFX_GLOBAL_DATA`	Crea una estructura `AFX_GLOBAL_DATA` .
`AFX_GLOBAL_DATA::~AFX_GLOBAL_DATA`	Destructor.

Métodos públicos

Nombre	Descripción
AFX_GLOBAL_DATA::CleanUp	Libera los recursos asignados por el marco, como pinceles, fuentes y archivos DLL.
AFX_GLOBAL_DATA::D 2D1MakeRotateMatrix	Crea una transformación de giro que gire según el ángulo especificado alrededor de un punto especificado.
AFX_GLOBAL_DATA::D rawParentBackground	Dibuja el fondo del elemento primario de un control en el área especificada.
AFX_GLOBAL_DATA::D rawTextOnGlass	Dibuja el texto especificado en el estilo visual del tema especificado.
AFX_GLOBAL_DATA::ExcludeTag	Quita el par especificado de etiquetas XML de un búfer especificado.
AFX_GLOBAL_DATA::GetColor	Recupera el color actual del elemento de la interfaz de usuario especificado.
AFX_GLOBAL_DATA::GetDirect2dFactory	Devuelve un puntero a la interfaz `ID2D1Factory` que está almacenada en los datos globales. Si no se inicializa la interfaz, se crea y tiene los parámetros predeterminados.
AFX_GLOBAL_DATA::GetHandCursor	Recupera el cursor predefinido que se parece a una mano y cuyo identificador es `IDC_HAND`.
AFX_GLOBAL_DATA::GetITaskbarList	Crea y almacena en los datos globales un puntero a la interfaz ITaskBarList.
AFX_GLOBAL_DATA::GetITaskbarList3	Crea y almacena en los datos globales un puntero a la interfaz ITaskBarList3.
AFX_GLOBAL_DATA::GetNonClientMetrics	Recupera las métricas asociadas al área no cliente de las ventanas no minimizadas.
AFX_GLOBAL_DATA::GetShellAutohideBars	Determina las posiciones de las barras Ocultar automáticamente del Shell.
AFX_GLOBAL_DATA::GetTextHeight	Recupera el alto de caracteres de texto en la fuente actual.
AFX_GLOBAL_DATA::GetWICFactory	Devuelve un puntero a la interfaz `IWICImagingFactory` que está almacenada en los datos globales. Si no se inicializa la interfaz, se crea y tiene los parámetros predeterminados.
AFX_GLOBAL_DATA::GetWriteFactory	Devuelve un puntero a la interfaz `IDWriteFactory` que está almacenada en los datos globales. Si no se inicializa la interfaz, se crea y tiene los parámetros predeterminados.
AFX_GLOBAL_DATA::InitD2D	Inicializa los generadores `D2D`, `DirectWrite`y `WIC` . Llame a este método antes de que se inicialice la ventana principal.
AFX_GLOBAL_DATA::Is32BitIcons	Indica si se admiten los iconos de 32 bits predefinidos.
AFX_GLOBAL_DATA::IsD2DInitialized	Determina si se inicializó `D2D` .
AFX_GLOBAL_DATA::IsDwmCompositionEnabled	Proporciona una manera sencilla de llamar al método de Windows DwmIsCompositionEnabled .
AFX_GLOBAL_DATA::IsHighContrastMode	Indica si las imágenes se muestran actualmente en contraste alto.
AFX_GLOBAL_DATA::OnSettingChange	Detecta el estado actual de las características del escritorio para la animación de menús y para ocultar automáticamente la barra de tareas.
AFX_GLOBAL_DATA::RegisterWindowClass	Registra la clase de ventana MFC especificada.
AFX_GLOBAL_DATA::ReleaseTaskBarRefs	Libera las interfaces obtenidas a través de los métodos GetITaskbarList y GetITaskbarList3.
AFX_GLOBAL_DATA::Resume	Reinicializa los punteros a función internos que tienen acceso a métodos compatibles con los temas y estilos visualesde Windows.
AFX_GLOBAL_DATA::SetLayeredAttrib	Proporciona una manera sencilla de llamar al método de Windows SetLayeredWindowAttributes .
AFX_GLOBAL_DATA::SetMenuFont	Crea la fuente lógica especificada.
AFX_GLOBAL_DATA::ShellCreateItemFromParsingName	Crea e inicializa un objeto de elemento del Shell a partir de un nombre de análisis.
AFX_GLOBAL_DATA::UpdateFonts	Reinicializa las fuentes lógicas utilizadas por el marco.
AFX_GLOBAL_DATA::UpdateSysColors	Inicializa los colores, la profundidad de color, los pinceles, los lápices y las imágenes utilizadas por el marco.

Métodos protegidos

Nombre	Descripción
AFX_GLOBAL_DATA::EnableAccessibilitySupport	Habilita o deshabilita la compatibilidad con Microsoft Active Accessibility. Active Accessibility proporciona métodos de confianza para exponer información sobre los elementos de la interfaz de usuario.
AFX_GLOBAL_DATA::IsAccessibilitySupport	Indica si la compatibilidad con Microsoft Active Accessibility está habilitada.
AFX_GLOBAL_DATA::IsWindowsLayerSupportAvailable	Indica si el sistema operativo admite ventanas superpuestas.

Miembros de datos

Nombre	Descripción
AFX_GLOBAL_DATA::bIsOSAlphaBlendingSupport	Indica si el sistema operativo actual admite la combinación alfa.
AFX_GLOBAL_DATA::bIsWindows7	Indica si la aplicación se está ejecutando en el sistema operativo Windows 7 o posterior.
AFX_GLOBAL_DATA::clrActiveCaptionGradient	Especifica el degradado de color de la leyenda activa. Se suele utilizar para acoplar paneles.
AFX_GLOBAL_DATA::clrInactiveCaptionGradient	Especifica el degradado de color de la leyenda inactiva. Se suele utilizar para acoplar paneles.
AFX_GLOBAL_DATA::m_bUseBuiltIn32BitIcons	Indica si el marco usa iconos de colores de 32 bits predefinidos o iconos de una resolución inferior.
AFX_GLOBAL_DATA::m_bUseSystemFont	Indica si se usa una fuente del sistema para los menús, las barras de herramientas y las cintas.
AFX_GLOBAL_DATA::m_hcurHand	Almacena el identificador del cursor de mano.
AFX_GLOBAL_DATA::m_hcurStretch	Almacena el identificador del cursor de ajuste horizontal.
AFX_GLOBAL_DATA::m_hcurStretchVert	Almacena el identificador del cursor de ajuste vertical.
AFX_GLOBAL_DATA::m_hiconTool	Almacena el identificador para el icono de la herramienta.
AFX_GLOBAL_DATA::m_nAutoHideToolBarMargin	Especifica el desplazamiento de la barra de herramientas Ocultar automáticamente situada más a la izquierda en el lado izquierdo de la barra de acoplamiento.
AFX_GLOBAL_DATA::m_nAutoHideToolBarSpacing	Especifica la separación entre las barras de herramientas Ocultar automáticamente.
AFX_GLOBAL_DATA::m_nDragFrameThicknessDock	Especifica el grosor del marco de arrastrar que se usa para comunicar el estado acoplado.
AFX_GLOBAL_DATA::m_nDragFrameThicknessFloat	Especifica el grosor del marco de arrastrar que se usa para comunicar el estado flotante.

Comentarios

La mayoría de los datos de la estructura AFX_GLOBAL_DATA se inicializan cuando se inicia la aplicación.

Jerarquía de herencia

AFX_GLOBAL_DATA

Requisitos

Encabezado: afxglobals.h

AFX_GLOBAL_DATA::bIsOSAlphaBlendingSupport

Indica si el sistema operativo admite la combinación alfa.

BOOL  bIsOSAlphaBlendingSupport;

Comentarios

TRUE indica que se admite la combinación alfa; en caso contrario, FALSE.

AFX_GLOBAL_DATA::CleanUp

Libera los recursos asignados por el marco, como pinceles, fuentes y archivos DLL.

void CleanUp();

AFX_GLOBAL_DATA::D 2D1MakeRotateMatrix

Crea una transformación de giro que gire según el ángulo especificado alrededor de un punto especificado.

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

Parámetros

ángulo
Ángulo de rotación en sentido de las agujas del reloj, en grados.

centro
Punto sobre el que se va a girar.

matriz
Cuando este método devuelve un resultado, contiene la nueva transformación de rotación. Debe asignar almacenamiento para este parámetro.

Valor devuelto

Devuelve S_OK si se realiza correctamente; de lo contrario, un valor de error.

AFX_GLOBAL_DATA::D rawParentBackground

Dibuja el fondo del elemento primario de un control en el área especificada.

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

Parámetros

pWnd
[in] Puntero a la ventana de un control.

pDC
[in] Puntero a un contexto de dispositivo.

lpRect
[in] Puntero a un rectángulo que enlaza el área que se va a dibujar. El valor predeterminado es NULL.

Valor devuelto

TRUE si este método se ejecuta correctamente; de lo contrario, FALSE.

AFX_GLOBAL_DATA::D rawTextOnGlass

Dibuja el texto especificado en el estilo visual del tema especificado.

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

Parámetros

hTheme
[in] Identificador de los datos del tema de una ventana, o NULL. El marco usa el tema especificado para dibujar el texto si este parámetro no es NULL y se admiten temas. En caso contrario, el marco no usa un tema para dibujar el texto.

Use el método OpenThemeData para crear un objeto HTHEME.

pDC
[in] Puntero a un contexto de dispositivo.

iPartId
[in] Elemento del control que tiene la apariencia del texto deseado. Para obtener más información, vea la columna Parts (Elementos) de la tabla de Parts and States(Estados y elementos). Si este valor es 0, el texto se dibuja en la fuente predeterminada o en una fuente seleccionada en el contexto del dispositivo.

iStateId
[in] Estado del control que tiene la apariencia del texto deseado. Para obtener más información, vea la columna States (Estados) de la tabla de Parts and States(Estados y elementos).

strText
[in] El texto que se va a dibujar.

rect
[in] Límite del área en la que se dibuja el texto especificado.

dwFlags
[in] Combinación bit a bit (OR) de marcas que especifican cómo se dibuja el texto especificado.

Si el parámetro hTheme es NULL o si los temas no se admiten ni están habilitados, el parámetro nFormat del método CDC::DrawText describe las marcas válidas. Si se admiten temas, el parámetro dwFlags del método DrawThemeTextEx describe las marcas válidas.

nGlowSize
[in] Tamaño de un efecto de iluminado que se dibuja en el fondo antes de dibujar el texto especificado. El valor predeterminado es 0.

clrText
[in] Color en el que se dibuja el texto especificado. El valor predeterminado es el color predeterminado.

Valor devuelto

TRUE si se usa un tema para dibujar el texto especificado; en caso contrario, FALSE.

Comentarios

Un tema define el estilo visual de una aplicación. Un tema no se usa para dibujar el texto si el parámetro hTheme es NULL, si no se admite el método DrawThemeTextEx o si la composición del Administrador de ventanas de escritorio (DWM) está deshabilitada.

AFX_GLOBAL_DATA::EnableAccessibilitySupport

Habilita o deshabilita la compatibilidad con Microsoft Active Accessibility.

void EnableAccessibilitySupport(BOOL bEnable=TRUE);

Parámetros

bEnable
[in] TRUE para habilitar la compatibilidad con accesibilidad; FALSE para deshabilitar la compatibilidad con accesibilidad. El valor predeterminado es TRUE.

Comentarios

La accesibilidad activa es una tecnología basada en COM que mejora la forma en que los programas y el sistema operativo Windows funcionan junto con productos de tecnología de asistencia. Proporciona métodos de confianza para exponer información sobre los elementos de la interfaz de usuario. Sin embargo, ahora existe un nuevo modelo de accesibilidad llamado Microsoft UI Automation. Para obtener una comparación de las dos tecnologías, consulte UI Automation y Microsoft Active Accessibility.

Use el método AFX_GLOBAL_DATA::IsAccessibilitySupport para determinar si la compatibilidad con Microsoft Active Accessibility está habilitada.

AFX_GLOBAL_DATA::ExcludeTag

Quita el par especificado de etiquetas XML de un búfer especificado.

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

Parámetros

strBuffer
[in] Búfer de texto.

lpszTag
[in] Nombre de un par de etiquetas XML de apertura y cierre.

strTag
[out] Cuando se devuelve este método, el parámetro strTag contiene el texto que se encuentra entre las etiquetas XML de apertura y cierre denominadas por el parámetro lpszTag. Cualquier espacio en blanco inicial o final se recorta del resultado.

bIsCharsList
[in] TRUE para convertir los símbolos de los caracteres de escape en el parámetro strTag en caracteres de escape reales; FALSE para no realizar la conversión. El valor predeterminado es FALSE. Para obtener más información, vea la sección Comentarios.

Valor devuelto

TRUE si este método se ejecuta correctamente; de lo contrario, FALSE.

Comentarios

Un par de etiquetas XML consta de etiquetas de apertura y cierre con nombre que indican el inicio y el final de una ejecución de texto en el búfer especificado. El parámetro strBuffer especifica el búfer y el parámetro lpszTag especifica el nombre de las etiquetas XML.

Use los símbolos de la tabla siguiente para codificar un conjunto de caracteres de escape en el búfer especificado. Especifique TRUE para el parámetro bIsCharsList para convertir los símbolos del parámetro strTag en caracteres de escape reales. En la tabla siguiente se usa la macro _T() para especificar las cadenas de caracteres de escape y símbolos.

Símbolo	Carácter de 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

Recupera el color actual del elemento de la interfaz de usuario especificado.

COLORREF GetColor(int nColor);

Parámetros

nColor
[in] Valor que especifica un elemento de interfaz de usuario cuyo color se recupera. Para obtener una lista de valores válidos, vea el parámetro nIndex del método GetSysColor.

Valor devuelto

Valor de color RGB del elemento de interfaz de usuario especificado. Para obtener más información, vea la sección Comentarios.

Comentarios

Si el parámetro nColor está fuera del intervalo, el valor devuelto es cero. Dado que cero también es un valor RGB válido, no puede usar este método para determinar si el sistema operativo actual admite un color del sistema. En su lugar, use el método GetSysColorBrush, que devuelve NULL si no se admite el color.

AFX_GLOBAL_DATA::GetDirect2dFactory

Devuelve un puntero a la interfaz ID2D1Factory que está almacenada en los datos globales. Si no se inicializa la interfaz, se crea y tiene los parámetros predeterminados.

ID2D1Factory* GetDirect2dFactory();

Valor devuelto

Puntero a la interfaz ID2D1Factory si la creación de una fábrica se realiza correctamente, o NULL si se produce un error en la creación o el sistema operativo actual no tienen compatibilidad con D2D.

AFX_GLOBAL_DATA::GetHandCursor

Recupera el cursor predefinido que se parece a una mano y cuyo identificador es IDC_HAND.

HCURSOR GetHandCursor();

Valor devuelto

Manipulador del cursor de mano.

AFX_GLOBAL_DATA::GetNonClientMetrics

Recupera las métricas asociadas al área no cliente de las ventanas no minimizadas.

BOOL GetNonClientMetrics(NONCLIENTMETRICS& info);

Parámetros

info
[in, out] Estructura NONCLIENTMETRICS que contiene las métricas escalables asociadas al área no cliente de una ventana no minimizada.

Valor devuelto

TRUE si este método se realiza correctamente; de lo contrario, FALSE.

AFX_GLOBAL_DATA::GetTextHeight

Recupera el alto de caracteres de texto en la fuente actual.

int GetTextHeight(BOOL bHorz = TRUE);

Parámetros

bHorz
[in] TRUE para recuperar la altura de los caracteres cuando el texto se ejecuta horizontalmente; FALSE para recuperar la altura de los caracteres cuando el texto se ejecuta verticalmente. El valor predeterminado es TRUE.

Valor devuelto

Altura de la fuente actual, que se mide de su ascendente a su descendiente.

AFX_GLOBAL_DATA::GetWICFactory

Devuelve un puntero a la interfaz IWICImagingFactory que está almacenada en los datos globales. Si no se inicializa la interfaz, se crea y tiene los parámetros predeterminados.

IWICImagingFactory* GetWICFactory();

Valor devuelto

Puntero a la interfaz IWICImagingFactory si la creación de una fábrica se realiza correctamente, o NULL si se produce un error en la creación o el sistema operativo actual no tienen compatibilidad con WIC.

AFX_GLOBAL_DATA::GetWriteFactory

Devuelve un puntero a la interfaz IDWriteFactory que está almacenada en los datos globales. Si no se inicializa la interfaz, se crea y tiene los parámetros predeterminados.

IDWriteFactory* GetWriteFactory();

Valor devuelto

Puntero a la interfaz IDWriteFactory si la creación de una fábrica se realiza correctamente, o NULL si se produce un error en la creación o el sistema operativo actual no tienen compatibilidad con DirectWrite.

AFX_GLOBAL_DATA::InitD2D

Inicializa las fábricas D2D, DirectWrite y WIC. Llame a este método antes de que se inicialice la ventana principal.

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

Parámetros

d2dFactoryType
Modelo de subprocesos de la factoría D2D y los recursos que crea.

writeFactoryType
Valor que especifica si el objeto de fábrica de escritura se compartirá o aislará

Valor devuelto

Devuelve TRUE si las fábricas estaban inicializadas; de lo contrario, FALSE

AFX_GLOBAL_DATA::Is32BitIcons

Indica si se admiten los iconos de 32 bits predefinidos.

BOOL Is32BitIcons() const;

Valor devuelto

TRUE si se admiten iconos predefinidos de 32 bits; de lo contrario, FALSE.

Comentarios

Este método devuelve TRUE si el marco admite iconos integrados de 32 bits y si el sistema operativo admite 16 bits por píxel o más, y si las imágenes no se muestran en contraste alto.

AFX_GLOBAL_DATA::IsAccessibilitySupport

Indica si la compatibilidad con Microsoft Active Accessibility está habilitada.

BOOL IsAccessibilitySupport() const;

Valor devuelto

TRUE si la compatibilidad con accesibilidad está habilitada; de lo contrario, FALSE.

Comentarios

Microsoft Active Accessibility era la solución anterior para hacer que las aplicaciones fuesen accesibles. La Automatización de la interfaz de usuario de Microsoft es el modelo nuevo de accesibilidad para Microsoft Windows y está pensado para abordar las necesidades de los productos de tecnología de asistencia y las herramientas de prueba automatizadas.

Use el método AFX_GLOBAL_DATA::EnableAccessibilitySupport para habilitar o deshabilitar la compatibilidad con Active Accessibility.

AFX_GLOBAL_DATA::IsD2DInitialized

Determina si se inicializó el D2D

BOOL IsD2DInitialized() const;

Valor devuelto

TRUE si se ha inicializado D2D; de lo contrario, FALSE.

AFX_GLOBAL_DATA::IsDwmCompositionEnabled

Proporciona una manera sencilla de llamar al método de Windows DwmIsCompositionEnabled .

BOOL IsDwmCompositionEnabled();

Valor devuelto

TRUE si se habilita la composición de Administrador de ventanas de escritorio (DWM); de lo contrario, FALSE.

AFX_GLOBAL_DATA::IsHighContrastMode

Indica si las imágenes se muestran actualmente en contraste alto.

BOOL IsHighContrastMode() const;

Valor devuelto

TRUE si las imágenes se muestran actualmente en modo de contraste alto negro o blanco; de lo contrario, FALSE.

Comentarios

En el modo de contraste alto negro, los bordes orientados a la luz son blancos y el fondo es negro. En el modo de contraste alto blanco, los bordes orientados a la luz son negros y el fondo es blanco.

AFX_GLOBAL_DATA::IsWindowsLayerSupportAvailable

Indica si el sistema operativo admite ventanas superpuestas.

BOOL IsWindowsLayerSupportAvailable() const;

Valor devuelto

TRUE si se admiten ventanas superpuestas; de lo contrario, FALSE.

Comentarios

Si se admiten ventanas superpuestas, los marcadores de acoplamiento inteligente las usan.

AFX_GLOBAL_DATA::m_bUseBuiltIn32BitIcons

Indica si el marco usa iconos de colores de 32 bits predefinidos o iconos de una resolución inferior.

BOOL  m_bUseBuiltIn32BitIcons;

Comentarios

TRUE especifica que el marco usa iconos de color de 32 bits; FALSE especifica iconos de resolución inferior. El constructor AFX_GLOBAL_DATA::AFX_GLOBAL_DATA inicializa este miembro en TRUE.

Este miembro debe establecerse en el inicio de la aplicación.

AFX_GLOBAL_DATA::m_bUseSystemFont

Indica si se usa una fuente del sistema para los menús, las barras de herramientas y las cintas.

BOOL m_bUseSystemFont;

Comentarios

TRUE especifica el uso de una fuente del sistema; de lo contrario, FALSE. El constructor AFX_GLOBAL_DATA::AFX_GLOBAL_DATA inicializa este miembro en FALSE.

Probar este miembro no es la única manera de que el marco determine la fuente que se va a usar. El método AFX_GLOBAL_DATA::UpdateFonts también prueba las fuentes predeterminadas y alternativas para determinar qué estilos visuales están disponibles para aplicarse a menús, barras de herramientas y cintas de opciones.

AFX_GLOBAL_DATA::m_hcurHand

Almacena el identificador del cursor de mano.

HCURSOR m_hcurHand;

AFX_GLOBAL_DATA::m_hcurStretch

Almacena el identificador del cursor de ajuste horizontal.

HCURSOR m_hcurStretch;

AFX_GLOBAL_DATA::m_hcurStretchVert

Almacena el identificador del cursor de ajuste vertical.

HCURSOR m_hcurStretchVert;

AFX_GLOBAL_DATA::m_hiconTool

Almacena el identificador para el icono de la herramienta.

HICON m_hiconTool;

AFX_GLOBAL_DATA::m_nAutoHideToolBarMargin

Especifica el desplazamiento de la barra de herramientas Ocultar automáticamente situada más a la izquierda en el lado izquierdo de la barra de acoplamiento.

int  m_nAutoHideToolBarMargin;

Comentarios

El constructor AFX_GLOBAL_DATA::AFX_GLOBAL_DATA inicializa este miembro en 4 píxeles.

AFX_GLOBAL_DATA::m_nAutoHideToolBarSpacing

Especifica la separación entre las barras de herramientas Ocultar automáticamente.

int   m_nAutoHideToolBarSpacing;

Comentarios

El constructor AFX_GLOBAL_DATA::AFX_GLOBAL_DATA inicializa este miembro en 14 píxeles.

AFX_GLOBAL_DATA::m_nDragFrameThicknessDock

Especifica el grosor del marco de arrastre que se usa para comunicar el estado acoplado.

int  m_nDragFrameThicknessDock;

Comentarios

El constructor AFX_GLOBAL_DATA::AFX_GLOBAL_DATA inicializa este miembro en 3 píxeles.

AFX_GLOBAL_DATA::m_nDragFrameThicknessFloat

Especifica el grosor del marco de arrastrar que se usa para indicar el estado flotante.

int  m_nDragFrameThicknessFloat;

Comentarios

El constructor AFX_GLOBAL_DATA::AFX_GLOBAL_DATA inicializa este miembro en 4 píxeles.

AFX_GLOBAL_DATA::OnSettingChange

Detecta el estado actual de las características del escritorio para la animación de menús y para ocultar automáticamente la barra de tareas.

void OnSettingChange();

Comentarios

Este método establece variables de marco en el estado de determinados atributos del escritorio del usuario. Este método detecta el estado actual de la animación del menú, la atenuación del menú y las características de ocultación automática de la barra de tareas.

AFX_GLOBAL_DATA::RegisterWindowClass

Registra la clase de ventana MFC especificada.

CString RegisterWindowClass(LPCTSTR lpszClassNamePrefix);

Parámetros

lpszClassNamePrefix
[in] Nombre de la clase de ventana que se va a registrar.

Valor devuelto

Nombre completo de la clase registrada si este método se realiza correctamente; de lo contrario, una excepción de recurso.

Comentarios

El valor devuelto es una lista delimitada por dos puntos de la cadena de parámetro lpszClassNamePrefix y las representaciones de texto hexadecimales de los manipuladores de la instancia de aplicación actual; el cursor de la aplicación, que es el cursor de flecha cuyo identificador es IDC_ARROW; y el pincel de fondo. Para obtener más información sobre cómo registrar clases de ventana de MFC, vea AfxRegisterClass.

AFX_GLOBAL_DATA::Resume

Reinicializa los punteros a función internos que tienen acceso a métodos compatibles con los temas y estilos visualesde Windows.

BOOL Resume();

Valor devuelto

TRUE si este método se realiza correctamente; de lo contrario, FALSE. En el modo de depuración, este método afirma si este método no se realiza correctamente.

Comentarios

Se llama a este método cuando el marco recibe el mensaje WM_POWERBROADCAST.

AFX_GLOBAL_DATA::SetLayeredAttrib

Proporciona una manera sencilla de llamar al método de Windows SetLayeredWindowAttributes .

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

Parámetros

hwnd
[in] Manipulador de la ventana superpuesta.

crKey
[in] Tecla de color de transparencia que usa el Administrador de ventanas de escritorio para componer la ventana superpuesta.

bAlpha
[in] Valor alfa utilizado para describir la opacidad de la ventana superpuesta.

dwFlags
[in] Combinación bit a bit (OR) de marcas que especifican qué parámetros de método se van a usar. Especifique LWA_COLORKEY para usar el parámetro crKey como color de transparencia. Especifique LWA_ALPHA para usar el parámetro bAlpha para determinar la opacidad de la ventana superpuesta.

Valor devuelto

TRUE si este método se realiza correctamente; de lo contrario, FALSE.

AFX_GLOBAL_DATA::SetMenuFont

Crea la fuente lógica especificada.

BOOL SetMenuFont(
    LPLOGFONT lpLogFont,
    BOOL bHorz);

Parámetros

lpLogFont
[in] Puntero a una estructura que contiene los atributos de una fuente.

bHorz
[in] TRUE para especificar que el texto se ejecuta horizontalmente; FALSE para especificar que el texto se ejecuta verticalmente.

Valor devuelto

TRUE si este método se realiza correctamente; de lo contrario, FALSE. En el modo de depuración, este método afirma si este método no se realiza correctamente.

Comentarios

Este método crea una fuente normal horizontal, una fuente subrayada y una fuente en negrita que se usa en los elementos de menú predeterminados. Este método crea opcionalmente una fuente vertical normal. Para obtener más información sobre las fuentes lógicas, vea CFont::CreateFontIndirect.

AFX_GLOBAL_DATA::UpdateFonts

Reinicializa las fuentes lógicas utilizadas por el marco.

void UpdateFonts();

Comentarios

Para obtener más información acerca de las fuentes lógicas, vea CFont::CreateFontIndirect.

AFX_GLOBAL_DATA::UpdateSysColors

Inicializa los colores, la profundidad de color, los pinceles, los lápices y las imágenes utilizadas por el marco.

void UpdateSysColors();

AFX_GLOBAL_DATA::bIsWindows7

Indica si la aplicación se está ejecutando en el sistema operativo Windows 7 o posterior.

BOOL bIsWindows7;

AFX_GLOBAL_DATA::clrActiveCaptionGradient

Especifica el degradado de color de la leyenda activa. Se suele utilizar para acoplar paneles.

COLORREF clrActiveCaptionGradient;

AFX_GLOBAL_DATA::clrInactiveCaptionGradient

Especifica el degradado de color de la leyenda inactiva. Se suele utilizar para acoplar paneles.

COLORREF clrInactiveCaptionGradient;

AFX_GLOBAL_DATA::GetITaskbarList

Crea y almacena en los datos globales un puntero a la interfaz ITaskBarList.

ITaskbarList *GetITaskbarList();

Valor devuelto

Puntero a la interfaz ITaskbarList si la creación de un objeto de lista de barras de tareas se realiza correctamente; NULL si se produce un error en la creación o si el sistema operativo actual es anterior a Windows 7.

AFX_GLOBAL_DATA::GetITaskbarList3

Crea y almacena en los datos globales un puntero a la interfaz ITaskBarList3.

ITaskbarList3 *GetITaskbarList3();

Valor devuelto

Puntero a la interfaz ITaskbarList3 si la creación de un objeto de lista de barras de tareas se realiza correctamente; NULL si se produce un error en la creación o si el sistema operativo actual es anterior a Windows 7.

AFX_GLOBAL_DATA::GetShellAutohideBars

Determina las posiciones de las barras Ocultar automáticamente del Shell.

int GetShellAutohideBars();

Valor devuelto

Valor entero con marcas codificadas que especifican posiciones de barras de ocultación automática. Puede combinar los siguientes valores: AFX_AUTOHIDE_BOTTOM, AFX_AUTOHIDE_TOP, AFX_AUTOHIDE_LEFT, AFX_AUTOHIDE_RIGHT.

AFX_GLOBAL_DATA::ReleaseTaskBarRefs

Libera interfaces obtenidas a través de los métodos GetITaskbarList y GetITaskbarList3.

void ReleaseTaskBarRefs();

AFX_GLOBAL_DATA::ShellCreateItemFromParsingName

Crea e inicializa un objeto de elemento del Shell a partir de un nombre de análisis.

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

Parámetros

pszPath
[in] Puntero a un nombre para mostrar.

pbc
Puntero a un contexto de enlace que controla la operación de análisis.

riid
Referencia a un identificador de interfaz.

ppv
[out] Cuando se devuelve esta función, contiene el puntero de interfaz solicitado en riid. Normalmente, esto será IShellItem o IShellItem2.

Valor devuelto

Devuelve S_OK si se realiza correctamente; de lo contrario, un valor de error.

Consulte también

Gráfico de jerarquías
Estructuras, estilos, devoluciones de llamada y mapas de mensajes
COLORREF
Partes y estados
CDC::D rawText
DrawThemeTextEx
Administrador de ventanas de escritorio
Habilitar y controlar la composición de DWM
Automatización de la interfaz de usuario y Microsoft Active Accessibility
Función GetSysColor
GetSysColorBrush
Estructura NONCLIENTMETRICS
AfxRegisterClass
AfxThrowResourceException
SetLayeredWindowAttributes