AFX_GLOBAL_DATA, structure

La structure AFX_GLOBAL_DATA contient des champs et des méthodes qui permettent de gérer l’infrastructure ou de personnaliser l’apparence et le comportement de votre application.

Syntaxe

struct AFX_GLOBAL_DATA

Membres

Constructeurs publics

Nom	Description
AFX_GLOBAL_DATA::AFX_GLOBAL_DATA	Construit une structure AFX_GLOBAL_DATA .
AFX_GLOBAL_DATA::~AFX_GLOBAL_DATA	Destructeur.

Méthodes publiques

Nom	Description
AFX_GLOBAL_DATA ::CleanUp	Libère les ressources allouées par l’infrastructure, telles que les pinceaux, les polices et les DLL.
AFX_GLOBAL_DATA ::D 2D1MakeRotateMatrix	Crée une transformation de rotation qui pivote autour d’un point spécifié selon un angle spécifié.
AFX_GLOBAL_DATA ::D rawParentBackground	Dessine l’arrière-plan du parent d’un contrôle dans la zone spécifiée.
AFX_GLOBAL_DATA ::D rawTextOnGlass	Dessine le texte spécifié dans le style visuel du thème spécifié.
AFX_GLOBAL_DATA ::ExcludeTag	Supprime la paire de balises XML spécifiée dans une mémoire tampon spécifiée.
AFX_GLOBAL_DATA ::GetColor	Récupère la couleur actuelle de l’élément d’interface utilisateur spécifié.
AFX_GLOBAL_DATA ::GetDirect2dFactory	Renvoie un pointeur à l’interface ID2D1Factory qui est stockée dans les données globales. Si l’interface n’est pas initialisée, elle est créée avec les paramètres par défaut.
AFX_GLOBAL_DATA ::GetHandCursor	Récupère le curseur prédéfini qui a la forme d’une main et dont l’identificateur est IDC_HAND.
AFX_GLOBAL_DATA ::GetITaskbarList	Crée et stocke dans les données globales un pointeur vers l’interface ITaskBarList.
AFX_GLOBAL_DATA ::GetITaskbarList3	Crée et stocke dans les données globales un pointeur vers l’interface ITaskBarList3.
AFX_GLOBAL_DATA ::GetNonClientMetrics	Récupère les mesures associées à la zone non cliente des fenêtres non réduites.
AFX_GLOBAL_DATA ::GetShellAutohideBars	Détermine les positions des barres de masquage automatique de l’interpréteur de commandes.
AFX_GLOBAL_DATA ::GetTextHeight	Récupère la hauteur des caractères de texte dans la police actuelle.
AFX_GLOBAL_DATA ::GetWICFactory	Renvoie un pointeur à l’interface IWICImagingFactory qui est stockée dans les données globales. Si l’interface n’est pas initialisée, elle est créée avec les paramètres par défaut.
AFX_GLOBAL_DATA ::GetWriteFactory	Renvoie un pointeur à l’interface IDWriteFactory qui est stockée dans les données globales. Si l’interface n’est pas initialisée, elle est créée avec les paramètres par défaut.
AFX_GLOBAL_DATA ::InitD2D	Initialise les fabriques D2D, DirectWriteet WIC . Appelez cette méthode avant que la fenêtre principale soit initialisée.
AFX_GLOBAL_DATA ::Is32BitIcons	Indique si les icônes 32 bits prédéfinies sont prises en charge.
AFX_GLOBAL_DATA ::IsD2DInitialized	Détermine si D2D a été initialisé.
AFX_GLOBAL_DATA ::IsDwmCompositionEnabled	Fournit un moyen simple d’appeler la méthode Windows DwmIsCompositionEnabled .
AFX_GLOBAL_DATA ::IsHighContrastMode	Indique si les images sont actuellement affichées avec un contraste élevé.
AFX_GLOBAL_DATA ::OnSettingChange	Détecte l’état actuel des fonctionnalités de masquage automatique de la barre des tâches et de l’animation des menus du Bureau.
AFX_GLOBAL_DATA ::RegisterWindowClass	Inscrit la classe de fenêtre MFC spécifiée.
AFX_GLOBAL_DATA ::ReleaseTaskBarRefs	Libère les interfaces obtenues par les méthodes GetITaskbarList et GetITaskbarList3.
AFX_GLOBAL_DATA ::Resume	Réinitialise les pointeurs de fonction internes qui accèdent à des méthodes prenant en charge les thèmes et les styles visuelsWindows.
AFX_GLOBAL_DATA ::SetLayeredAttrib	Fournit un moyen simple d’appeler la méthode Windows SetLayeredWindowAttributes .
AFX_GLOBAL_DATA ::SetMenuFont	Crée la police logique spécifiée.
AFX_GLOBAL_DATA ::ShellCreateItemFromParsingName	Crée et initialise un objet élément d’interpréteur de commandes à partir d’un nom de l’analyse.
AFX_GLOBAL_DATA ::UpdateFonts	Réinitialise les polices logiques qui sont utilisées par l’infrastructure.
AFX_GLOBAL_DATA ::UpdateSysColors	Initialise les couleurs, la profondeur de couleur, les pinceaux, les stylets et les images qui sont utilisés par l’infrastructure.

Méthodes protégées

Nom	Description
AFX_GLOBAL_DATA ::EnableAccessibilitySupport	Active ou désactive la prise en charge de Microsoft Active Accessibility. Active Accessibility fournit des méthodes fiables pour exposer des informations sur les éléments d’interface utilisateur.
AFX_GLOBAL_DATA ::IsAccessibilitySupport	Indique si la prise en charge de Microsoft Active Accessibility est activée.
AFX_GLOBAL_DATA ::IsWindowsLayerSupportAvailable	Indique si le système d’exploitation prend en charge les fenêtres superposées.

Données membres

Nom	Description
AFX_GLOBAL_DATA ::bIsOSAlphaBlendingSupport	Indique si le système d’exploitation actuel prend en charge la simulation de transparence.
AFX_GLOBAL_DATA ::bIsWindows7	Indique si l’application est exécutée sur le système d’exploitation Windows 7 ou ultérieur
AFX_GLOBAL_DATA ::clrActiveCaptionGradient	Spécifie la couleur de dégradé de la légende active. Généralement utilisé pour les volets d’ancrage.
AFX_GLOBAL_DATA ::clrInactiveCaptionGradient	Spécifie la couleur de dégradé de la légende inactive. Généralement utilisé pour les volets d’ancrage.
AFX_GLOBAL_DATA ::m_bUseBuiltIn32BitIcons	Indique si l’infrastructure utilise des icônes de couleur 32 bits prédéfinies ou des icônes d’une résolution inférieure.
AFX_GLOBAL_DATA ::m_bUseSystemFont	Indique si une police système est utilisée pour les menus, les barres d’outils et les rubans.
AFX_GLOBAL_DATA ::m_hcurHand	Stocke le handle du curseur en forme de main.
AFX_GLOBAL_DATA ::m_hcurStretch	Stocke le handle du curseur d’étirement horizontal.
AFX_GLOBAL_DATA ::m_hcurStretchVert	Stocke le handle du curseur d’étirement vertical.
AFX_GLOBAL_DATA ::m_hiconTool	Stocke le handle de l’icône d’outil.
AFX_GLOBAL_DATA ::m_nAutoHideToolBarMargin	Spécifie le décalage entre la barre d’outils de masquage automatique la plus à gauche et le côté gauche de la barre d’ancrage.
AFX_GLOBAL_DATA ::m_nAutoHideToolBarSpacing	Spécifie l’intervalle entre les barres d’outils de masquage automatique.
AFX_GLOBAL_DATA ::m_nDragFrameThicknessDock	Spécifie l’épaisseur du cadre de glissement qui est utilisé pour communiquer l’état d’ancrage.
AFX_GLOBAL_DATA ::m_nDragFrameThicknessFloat	Spécifie l’épaisseur du cadre de glissement qui est utilisé pour communiquer l’état flottant.

Notes

La plupart des données dans la structure AFX_GLOBAL_DATA sont initialisées au démarrage de votre application.

Hiérarchie d'héritage

AFX_GLOBAL_DATA

Spécifications

En-tête : afxglobals.h

AFX_GLOBAL_DATA ::bIsOSAlphaBlendingSupport

Indique si le système d’exploitation prend en charge le mélange alpha.

BOOL  bIsOSAlphaBlendingSupport;

Notes

TRUE indique que le mélange alpha est pris en charge ; sinon, FALSE.

AFX_GLOBAL_DATA ::CleanUp

Libère les ressources allouées par l’infrastructure, telles que les pinceaux, les polices et les DLL.

void CleanUp();

AFX_GLOBAL_DATA ::D 2D1MakeRotateMatrix

Crée une transformation de rotation qui pivote autour d’un point spécifié selon un angle spécifié.

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

Paramètres

angle
Angle de rotation au niveau des aiguilles d’une montre, en degrés.

centre
Point sur lequel faire pivoter.

matrice
Lorsque cette méthode est retournée, contient la nouvelle transformation de rotation. Vous devez allouer du stockage pour ce paramètre.

Valeur de retour

Retourne S_OK en cas de réussite ou une valeur d’erreur dans le cas contraire.

AFX_GLOBAL_DATA ::D rawParentBackground

Dessine l’arrière-plan du parent d’un contrôle dans la zone spécifiée.

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

Paramètres

Pwnd
[in] Pointeur vers la fenêtre d’un contrôle.

pDC
[in] Pointeur vers un contexte d’appareil.

lpRect
[in] Pointeur vers un rectangle qui limite la zone à dessiner. La valeur par défaut est NULL.

Valeur de retour

TRUE si cette méthode réussit ; sinon, FALSE.

AFX_GLOBAL_DATA ::D rawTextOnGlass

Dessine le texte spécifié dans le style visuel du thème spécifié.

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

Paramètres

hTheme
[in] Gérez les données de thème d’une fenêtre ou NULL. L’infrastructure utilise le thème spécifié pour dessiner le texte si ce paramètre n’est pas NULL et que les thèmes sont pris en charge. Sinon, l’infrastructure n’utilise pas de thème pour dessiner le texte.

Utilisez la méthode OpenThemeData pour créer un HTHEME.

pDC
[in] Pointeur vers un contexte d’appareil.

iPartId
[in] Partie de contrôle qui a l’apparence de texte souhaitée. Pour plus d’informations, consultez la colonne Composants de la table figurant dans Composants et états. Si cette valeur est égale à 0, le texte est dessiné avec la police par défaut ou une police sélectionnée dans le contexte de l’appareil.

iStateId
[in] État de contrôle qui a l’apparence de texte souhaitée. Pour plus d’informations, consultez la colonne États de la table figurant dans Composants et états.

strText
[in] Texte à dessiner.

Rect
[in] Limite de la zone dans laquelle le texte spécifié est dessiné.

dwFlags
[in] Combinaison de bits (OR) d’indicateurs qui spécifient la façon dont le texte spécifié est dessiné.

Si le paramètre hTheme est NULL ou si les thèmes ne sont pas pris en charge et activés, le paramètre nFormat de la méthode CDC ::D rawText décrit les indicateurs valides. Si les thèmes sont pris en charge, le paramètre dwFlags de la méthode DrawThemeTextEx décrit les indicateurs valides.

nGlowSize
[in] Taille d’un effet de lumière dessiné sur l’arrière-plan avant de dessiner le texte spécifié. La valeur par défaut est 0.

clrText
[in] Couleur dans laquelle le texte spécifié est dessiné. La valeur par défaut est la couleur par défaut.

Valeur de retour

TRUE si un thème est utilisé pour dessiner le texte spécifié ; sinon, FALSE.

Notes

Un thème définit le style visuel d’une application. Un thème n’est pas utilisé pour dessiner le texte si le paramètre hTheme a la valeur NULL, ou si la méthode DrawThemeTextEx n’est pas prise en charge, ou si la composition du Gestionnaire de fenêtres de bureau (DWM) est désactivée.

AFX_GLOBAL_DATA ::EnableAccessibilitySupport

Active ou désactive la prise en charge de Microsoft Active Accessibility.

void EnableAccessibilitySupport(BOOL bEnable=TRUE);

Paramètres

bEnable
[in] TRUE pour activer la prise en charge de l’accessibilité ; FALSE pour désactiver la prise en charge de l’accessibilité. La valeur par défaut est TRUE.

Notes

L’accessibilité active est une technologie COM qui améliore la façon dont les programmes et le système d’exploitation Windows fonctionnent avec des produits technologiques d’assistance. Il fournit des méthodes fiables pour exposer des informations sur les éléments d’interface utilisateur. Toutefois, un modèle d’accessibilité plus récent appelé Microsoft UI Automation est désormais disponible. Pour une comparaison des deux technologies, consultez UI Automation et Microsoft Active Accessibility.

Utilisez la méthode AFX_GLOBAL_DATA ::IsAccessibilitySupport pour déterminer si la prise en charge de Microsoft Active Accessibility est activée.

AFX_GLOBAL_DATA ::ExcludeTag

Supprime la paire de balises XML spécifiée dans une mémoire tampon spécifiée.

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

Paramètres

strBuffer
[in] Mémoire tampon du texte.

lpszTag
[in] Nom d’une paire de balises XML ouvrantes et fermante.

strTag
[out] Lorsque cette méthode est retournée, le paramètre strTag contient le texte entre les balises XML ouvrantes et fermante nommées par le paramètre lpszTag . Tout espace blanc de début ou de fin est coupé du résultat.

bIsCharsList
[in] TRUE pour convertir des symboles pour les caractères d’échappement dans le paramètre strTag en caractères d’échappement réels ; FALSE pour ne pas effectuer la conversion. La valeur par défaut est FALSE. Pour plus d'informations, consultez la section Notes.

Valeur de retour

TRUE si cette méthode réussit ; sinon, FALSE.

Notes

Une paire d’étiquettes XML se compose de balises d’ouverture et de fermeture nommées qui indiquent le début et la fin d’une exécution de texte dans la mémoire tampon spécifiée. Le paramètre strBuffer spécifie la mémoire tampon, et le paramètre lpszTag spécifie le nom des balises XML.

Utilisez les symboles du tableau suivant pour encoder un jeu de caractères d’échappement dans la mémoire tampon spécifiée. Spécifiez TRUE pour le paramètre bIsCharsList pour convertir les symboles du paramètre strTag en caractères d’échappement réels. Le tableau suivant utilise la macro _T() pour spécifier les chaînes de caractères de symbole et d’échappement.

Symbole	Caractère d’échappement
_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

Récupère la couleur actuelle de l’élément d’interface utilisateur spécifié.

COLORREF GetColor(int nColor);

Paramètres

nColor
[in] Valeur qui spécifie un élément d’interface utilisateur dont la couleur est récupérée. Pour obtenir la liste des valeurs valides, consultez le paramètre nIndex de la méthode GetSysColor .

Valeur de retour

Valeur de couleur RVB de l’élément d’interface utilisateur spécifié. Pour plus d'informations, consultez la section Notes.

Notes

Si le paramètre nColor est hors plage, la valeur de retour est égale à zéro. Étant donné que zéro est également une valeur RVB valide, vous ne pouvez pas utiliser cette méthode pour déterminer si une couleur système est prise en charge par le système d’exploitation actuel. Utilisez plutôt la méthode GetSysColorBrush , qui retourne NULL si la couleur n’est pas prise en charge.

AFX_GLOBAL_DATA ::GetDirect2dFactory

Retourne un pointeur vers l’interface ID2D1Factory stockée dans les données globales. Si l’interface n’est pas initialisée, elle est créée avec les paramètres par défaut.

ID2D1Factory* GetDirect2dFactory();

Valeur de retour

Pointeur vers l’interface ID2D1Factory si la création d’une fabrique réussit, ou NULL si la création échoue ou si le système d’exploitation actuel ne prend pas en charge D2D.

AFX_GLOBAL_DATA ::GetHandCursor

Récupère le curseur prédéfini qui ressemble à une main et dont l’identificateur est IDC_HAND.

HCURSOR GetHandCursor();

Valeur de retour

Poignée du curseur de main.

AFX_GLOBAL_DATA ::GetNonClientMetrics

Récupère les mesures associées à la zone non cliente des fenêtres non réduites.

BOOL GetNonClientMetrics(NONCLIENTMETRICS& info);

Paramètres

info
[in, out] Structure NONCLIENTMETRICS qui contient les métriques évolutives associées à la zone nonclient d’une fenêtre nonminimisée.

Valeur de retour

TRUE si cette méthode réussit ; sinon, FALSE.

AFX_GLOBAL_DATA ::GetTextHeight

Récupère la hauteur des caractères de texte dans la police actuelle.

int GetTextHeight(BOOL bHorz = TRUE);

Paramètres

bHorz
[in] TRUE pour récupérer la hauteur des caractères lorsque le texte s’exécute horizontalement ; FALSE pour récupérer la hauteur des caractères lorsque le texte s’exécute verticalement. La valeur par défaut est TRUE.

Valeur de retour

Hauteur de la police actuelle, qui est mesurée de son croissant à son descendeur.

AFX_GLOBAL_DATA ::GetWICFactory

Retourne un pointeur vers l’interface IWICImagingFactory stockée dans les données globales. Si l’interface n’est pas initialisée, elle est créée avec les paramètres par défaut.

IWICImagingFactory* GetWICFactory();

Valeur de retour

Pointeur vers l’interface IWICImagingFactory si la création d’une fabrique réussit, ou NULL si la création échoue ou si le système d’exploitation actuel ne prend pas en charge WIC.

AFX_GLOBAL_DATA ::GetWriteFactory

Retourne un pointeur vers l’interface IDWriteFactory stockée dans les données globales. Si l’interface n’est pas initialisée, elle est créée avec les paramètres par défaut.

IDWriteFactory* GetWriteFactory();

Valeur de retour

Pointeur vers l’interface IDWriteFactory si la création d’une fabrique réussit, ou NULL si la création échoue ou si le système d’exploitation actuel ne prend pas en charge DirectWrite.

AFX_GLOBAL_DATA ::InitD2D

Initialise les fabriques D2D, DirectWrite et WIC. Appelez cette méthode avant que la fenêtre principale soit initialisée.

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

Paramètres

d2dFactoryType
Modèle de thread de la fabrique D2D et les ressources qu’il crée.

writeFactoryType
Valeur qui spécifie si l’objet de fabrique d’écriture sera partagé ou isolé

Valeur de retour

Retourne TRUE si les usines étaient intilalizrd, FALSE - sinon

AFX_GLOBAL_DATA ::Is32BitIcons

Indique si les icônes 32 bits prédéfinies sont prises en charge.

BOOL Is32BitIcons() const;

Valeur de retour

TRUE si les icônes 32 bits prédéfinies sont prises en charge ; sinon, FALSE.

Notes

Cette méthode retourne TRUE si l’infrastructure prend en charge les icônes intégrées 32 bits, et si le système d’exploitation prend en charge 16 bits par pixel ou plus, et si les images ne sont pas affichées en contraste élevé.

AFX_GLOBAL_DATA ::IsAccessibilitySupport

Indique si la prise en charge de Microsoft Active Accessibility est activée.

BOOL IsAccessibilitySupport() const;

Valeur de retour

TRUE si la prise en charge de l’accessibilité est activée ; sinon, FALSE.

Notes

Microsoft Active Accessibility était la solution précédemment utilisée pour rendre les applications accessibles. Microsoft UI Automation est le nouveau modèle d’accessibilité pour Microsoft Windows et a été conçu pour répondre aux besoins des produits de technologie d’assistance et des outils de test automatisés.

Utilisez la méthode AFX_GLOBAL_DATA ::EnableAccessibilitySupport pour activer ou désactiver la prise en charge de l’accessibilité active.

AFX_GLOBAL_DATA ::IsD2DInitialized

Détermine si le D2D a été initialisé

BOOL IsD2DInitialized() const;

Valeur de retour

TRUE si D2D a été initialisé ; sinon FALSE.

AFX_GLOBAL_DATA ::IsDwmCompositionEnabled

Fournit un moyen simple d’appeler la méthode Windows DwmIsCompositionEnabled .

BOOL IsDwmCompositionEnabled();

Valeur de retour

TRUE si la composition du Gestionnaire de fenêtres de bureau (DWM) est activée ; sinon, FALSE.

AFX_GLOBAL_DATA ::IsHighContrastMode

Indique si les images sont actuellement affichées avec un contraste élevé.

BOOL IsHighContrastMode() const;

Valeur de retour

TRUE si les images sont actuellement affichées en mode contraste élevé noir ou blanc ; sinon, FALSE.

Notes

En mode contraste élevé noir, les bords face à la lumière sont blancs et l’arrière-plan est noir. En mode contraste élevé blanc, les bords face à la lumière sont noirs et l’arrière-plan est blanc.

AFX_GLOBAL_DATA ::IsWindowsLayerSupportAvailable

Indique si le système d’exploitation prend en charge les fenêtres superposées.

BOOL IsWindowsLayerSupportAvailable() const;

Valeur de retour

TRUE si les fenêtres superposées sont prises en charge ; sinon, FALSE.

Notes

Si des fenêtres superposées sont prises en charge, les marqueurs d’ancrage intelligent utilisent des fenêtres superposées.

AFX_GLOBAL_DATA ::m_bUseBuiltIn32BitIcons

Indique si l’infrastructure utilise des icônes de couleur 32 bits prédéfinies ou des icônes d’une résolution inférieure.

BOOL  m_bUseBuiltIn32BitIcons;

Notes

TRUE spécifie que l’infrastructure utilise des icônes de couleur 32 bits ; FALSE spécifie les icônes de résolution inférieure. Le AFX_GLOBAL_DATA::AFX_GLOBAL_DATA constructeur initialise ce membre sur TRUE.

Ce membre doit être défini au démarrage de l’application.

AFX_GLOBAL_DATA ::m_bUseSystemFont

Indique si une police système est utilisée pour les menus, les barres d’outils et les rubans.

BOOL m_bUseSystemFont;

Notes

TRUE spécifie d’utiliser une police système ; sinon, FALSE. Le AFX_GLOBAL_DATA::AFX_GLOBAL_DATA constructeur initialise ce membre sur FALSE.

Le test de ce membre n’est pas la seule façon pour l’infrastructure de déterminer la police à utiliser. La AFX_GLOBAL_DATA::UpdateFonts méthode teste également les polices par défaut et les autres polices pour déterminer quels styles visuels sont disponibles pour être appliqués aux menus, barres d’outils et rubans.

AFX_GLOBAL_DATA ::m_hcurHand

Stocke le handle du curseur en forme de main.

HCURSOR m_hcurHand;

AFX_GLOBAL_DATA ::m_hcurStretch

Stocke le handle du curseur d’étirement horizontal.

HCURSOR m_hcurStretch;

AFX_GLOBAL_DATA ::m_hcurStretchVert

Stocke le handle du curseur d’étirement vertical.

HCURSOR m_hcurStretchVert;

AFX_GLOBAL_DATA ::m_hiconTool

Stocke le handle de l’icône d’outil.

HICON m_hiconTool;

AFX_GLOBAL_DATA ::m_nAutoHideToolBarMargin

Spécifie le décalage de la barre d’outils de mise en page automatique la plus à gauche de la barre d’ancrage.

int  m_nAutoHideToolBarMargin;

Notes

Le AFX_GLOBAL_DATA::AFX_GLOBAL_DATA constructeur initialise ce membre à 4 pixels.

AFX_GLOBAL_DATA ::m_nAutoHideToolBarSpacing

Spécifie l’intervalle entre les barres d’outils de masquage automatique.

int   m_nAutoHideToolBarSpacing;

Notes

Le AFX_GLOBAL_DATA::AFX_GLOBAL_DATA constructeur initialise ce membre à 14 pixels.

AFX_GLOBAL_DATA ::m_nDragFrameThicknessDock

Spécifie l’épaisseur du cadre de glissement utilisé pour indiquer l’état ancré.

int  m_nDragFrameThicknessDock;

Notes

Le AFX_GLOBAL_DATA::AFX_GLOBAL_DATA constructeur initialise ce membre à 3 pixels.

AFX_GLOBAL_DATA ::m_nDragFrameThicknessFloat

Spécifie l’épaisseur du cadre de glissement utilisé pour indiquer l’état flottant.

int  m_nDragFrameThicknessFloat;

Notes

Le AFX_GLOBAL_DATA::AFX_GLOBAL_DATA constructeur initialise ce membre à 4 pixels.

AFX_GLOBAL_DATA ::OnSettingChange

Détecte l’état actuel des fonctionnalités de masquage automatique de la barre des tâches et de l’animation des menus du Bureau.

void OnSettingChange();

Notes

Cette méthode définit les variables d’infrastructure à l’état de certains attributs du bureau de l’utilisateur. Cette méthode détecte l’état actuel des fonctionnalités d’animation de menu, de fondu de menu et de barre de tâches.

AFX_GLOBAL_DATA ::RegisterWindowClass

Inscrit la classe de fenêtre MFC spécifiée.

CString RegisterWindowClass(LPCTSTR lpszClassNamePrefix);

Paramètres

lpszClassNamePrefix
[in] Nom de la classe de fenêtre à inscrire.

Valeur de retour

Nom qualifié de la classe inscrite si cette méthode réussit ; sinon, une exception de ressource.

Notes

La valeur de retour est une liste délimitée par deux-points de la chaîne de paramètre lpszClassNamePrefix et les représentations textuelles hexadécimales des handles de l’instance d’application actuelle ; curseur de l’application, qui est le curseur de flèche dont l’identificateur est IDC_ARROW ; et le pinceau d’arrière-plan. Pour plus d’informations sur l’inscription de classes de fenêtre MFC, consultez AfxRegisterClass.

AFX_GLOBAL_DATA ::Resume

Réinitialise les pointeurs de fonction internes qui accèdent à des méthodes prenant en charge les thèmes et les styles visuelsWindows.

BOOL Resume();

Valeur de retour

TRUE si cette méthode réussit ; sinon, FALSE. En mode débogage, cette méthode affirme si cette méthode échoue.

Notes

Cette méthode est appelée lorsque l’infrastructure reçoit le message WM_POWERBROADCAST .

AFX_GLOBAL_DATA ::SetLayeredAttrib

Fournit un moyen simple d’appeler la méthode Windows SetLayeredWindowAttributes .

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

Paramètres

hwnd
[in] Gérez la fenêtre superposée.

crKey
[in] Clé de couleur de transparence utilisée par le Gestionnaire de fenêtres de bureau pour composer la fenêtre superposée.

bAlpha
[in] Valeur alpha utilisée pour décrire l’opacité de la fenêtre superposée.

dwFlags
[in] Combinaison de bits (OR) d’indicateurs qui spécifient les paramètres de méthode à utiliser. Spécifiez LWA_COLORKEY pour utiliser le paramètre crKey comme couleur de transparence. Spécifiez LWA_ALPHA pour utiliser le paramètre bAlpha pour déterminer l’opacité de la fenêtre superposée.

Valeur de retour

TRUE si cette méthode réussit ; sinon, FALSE.

AFX_GLOBAL_DATA ::SetMenuFont

Crée la police logique spécifiée.

BOOL SetMenuFont(
    LPLOGFONT lpLogFont,
    BOOL bHorz);

Paramètres

lpLogFont
[in] Pointeur vers une structure qui contient les attributs d’une police.

bHorz
[in] TRUE pour spécifier que le texte s’exécute horizontalement ; FALSE pour spécifier que le texte s’exécute verticalement.

Valeur de retour

TRUE si cette méthode réussit ; sinon, FALSE. En mode débogage, cette méthode affirme si cette méthode échoue.

Notes

Cette méthode crée une police régulière horizontale, une police soulignée et une police en gras utilisée dans les éléments de menu par défaut. Cette méthode crée éventuellement une police verticale régulière. Pour plus d’informations sur les polices logiques, consultez CFont ::CreateFontIndirect.

AFX_GLOBAL_DATA ::UpdateFonts

Réinitialise les polices logiques qui sont utilisées par l’infrastructure.

void UpdateFonts();

Notes

Pour plus d’informations sur les polices logiques, consultez CFont::CreateFontIndirect.

AFX_GLOBAL_DATA ::UpdateSysColors

Initialise les couleurs, la profondeur de couleur, les pinceaux, les stylets et les images qui sont utilisés par l’infrastructure.

void UpdateSysColors();

AFX_GLOBAL_DATA ::bIsWindows7

Indique si l’application est exécutée sous Windows 7 ou version ultérieure.

BOOL bIsWindows7;

AFX_GLOBAL_DATA ::clrActiveCaptionGradient

Spécifie la couleur de dégradé du légende actif. Généralement utilisé pour les volets d’ancrage.

COLORREF clrActiveCaptionGradient;

AFX_GLOBAL_DATA ::clrInactiveCaptionGradient

Spécifie la couleur de dégradé du légende inactif. Généralement utilisé pour les volets d’ancrage.

COLORREF clrInactiveCaptionGradient;

AFX_GLOBAL_DATA ::GetITaskbarList

Crée et stocke dans les données globales un pointeur vers l’interface ITaskBarList .

ITaskbarList *GetITaskbarList();

Valeur de retour

Pointeur vers l’interface si la ITaskbarList création d’un objet de liste de barres de tâches réussit ; NULL si la création échoue ou si le système d’exploitation actuel est inférieur à Windows 7.

AFX_GLOBAL_DATA ::GetITaskbarList3

Crée et stocke dans les données globales un pointeur vers l’interface ITaskBarList3 .

ITaskbarList3 *GetITaskbarList3();

Valeur de retour

Pointeur vers l’interface si la ITaskbarList3 création d’un objet de liste de barres de tâches réussit ; NULL si la création échoue ou si le système d’exploitation actuel est inférieur à Windows 7.

AFX_GLOBAL_DATA ::GetShellAutohideBars

Détermine les positions des barres de masquage automatique de l’interpréteur de commandes.

int GetShellAutohideBars();

Valeur de retour

Valeur entière avec des indicateurs encodés qui spécifient des positions de barres de masquage automatique. Il peut combiner les valeurs suivantes : AFX_AUTOHIDE_BOTTOM, AFX_AUTOHIDE_TOP, AFX_AUTOHIDE_LEFT, AFX_AUTOHIDE_RIGHT.

AFX_GLOBAL_DATA ::ReleaseTaskBarRefs

Libère les interfaces obtenues via les méthodes et GetITaskbarList3 les GetITaskbarList méthodes.

void ReleaseTaskBarRefs();

AFX_GLOBAL_DATA ::ShellCreateItemFromParsingName

Crée et initialise un objet élément d’interpréteur de commandes à partir d’un nom de l’analyse.

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

Paramètres

pszPath
[in] Pointeur vers un nom complet.

Pbc
Pointeur vers un contexte de liaison qui contrôle l’opération d’analyse.

riid
Référence à un ID d’interface.

Ppv
[out] Lorsque cette fonction est retournée, contient le pointeur d’interface demandé dans riid. Cela sera généralement IShellItem ou IShellItem2.

Valeur de retour

Retourne S_OK en cas de réussite ; valeur d’erreur sinon.

Voir aussi

Graphique hiérarchique
Structures, styles, rappels et tables de messages
COLORREF
Parties et États
CDC ::D rawText
DrawThemeTextEx
Gestionnaire de fenêtres du Bureau
Activer et contrôler la composition DWM
UI Automation et Microsoft Active Accessibility
GetSysColor, fonction
GetSysColorBrush
NONCLIENTMETRICS Structure
AfxRegisterClass
AfxThrowResourceException
SetLayeredWindowAttributes