AFX_GLOBAL_DATA struktúra

Megjegyzés:

A Microsoft Foundation Classes (MFC) könyvtár továbbra is támogatott. A továbbiakban azonban nem adunk hozzá funkciókat, és nem frissítjük a dokumentációt.

A AFX_GLOBAL_DATA struktúra olyan mezőket és metódusokat tartalmaz, amelyek a keretrendszer kezelésére vagy az alkalmazás megjelenésének és viselkedésének testreszabására szolgálnak.

Szemantika

struct AFX_GLOBAL_DATA

Tagok

Nyilvános konstruktorok

Név	Description
AFX_GLOBAL_DATA::AFX_GLOBAL_DATA	Szerkezetet AFX_GLOBAL_DATA hoz létre.
AFX_GLOBAL_DATA::~AFX_GLOBAL_DATA	Destruktor.

Nyilvános metódusok

Név	Description
AFX_GLOBAL_DATA::Törlés	Felszabadítja a keretrendszer által lefoglalt erőforrásokat, például ecseteket, betűtípusokat és DLL-eket.
AFX_GLOBAL_DATA::D 2D1MakeRotateMatrix	Forgatási átalakítást hoz létre, amely meghatározott szögben forog egy adott pont körül.
AFX_GLOBAL_DATA::D rawParentBackground	A vezérlőelem szülőjének hátterét rajzolja meg a megadott területen.
AFX_GLOBAL_DATA::D rawTextOnGlass	A megadott szöveget a megadott téma vizuális stílusában rajzolja meg.
AFX_GLOBAL_DATA::ExcludeTag	Eltávolítja a megadott XML-címkepárt egy megadott pufferből.
AFX_GLOBAL_DATA::GetColor	A megadott felhasználói felület elem aktuális színét kéri le.
AFX_GLOBAL_DATA::GetDirect2dFactory	A globális adatokban tárolt felületre mutató mutatót ID2D1Factory ad vissza. Ha a felület nincs inicializálva, létrejön, és az alapértelmezett paraméterekkel rendelkezik.
AFX_GLOBAL_DATA::GetHandCursor	Lekéri az előre definiált kurzort, amely hasonlít egy kézre, és amelynek azonosítója .IDC_HAND
AFX_GLOBAL_DATA::GetITaskbarList	A globális adatokban létrehoz és tárol egy mutatót az ITaskBarList felületre.
AFX_GLOBAL_DATA::GetITaskbarList3	A globális adatokban egy mutatót hoz létre és tárol az ITaskBarList3 felületre.
AFX_GLOBAL_DATA::GetNonClientMetrics	Lekéri a nemminimizált ablakok nemclient területéhez társított metrikákat.
AFX_GLOBAL_DATA::GetShellAutohideBars	Meghatározza a Shell automatikus elrejtősávjainak pozícióit.
AFX_GLOBAL_DATA::GetTextHeight	Az aktuális betűtípus szövegkarakterek magasságát kéri le.
AFX_GLOBAL_DATA::GetWICFactory	A globális adatokban tárolt felületre mutató mutatót IWICImagingFactory ad vissza. Ha a felület nincs inicializálva, létrejön, és az alapértelmezett paraméterekkel rendelkezik.
AFX_GLOBAL_DATA::GetWriteFactory	A globális adatokban tárolt felületre mutató mutatót IDWriteFactory ad vissza. Ha a felület nincs inicializálva, létrejön, és az alapértelmezett paraméterekkel rendelkezik.
AFX_GLOBAL_DATA::InitD2D	Inicializálja D2Da gyárakat DirectWriteés WIC a gyárakat. Hívja meg ezt a metódust a főablak inicializálása előtt.
AFX_GLOBAL_DATA::Is32BitIcons	Azt jelzi, hogy az előre definiált 32 bites ikonok támogatottak-e.
AFX_GLOBAL_DATA::IsD2DInitialized	Meghatározza, hogy az D2D inicializálás megtörtént-e.
AFX_GLOBAL_DATA::IsDwmCompositionEnabled	A Windows DwmIsCompositionEnabled metódus meghívásának egyszerű módja.
AFX_GLOBAL_DATA::IsHighContrastMode	Azt jelzi, hogy a képek jelenleg nagy kontrasztban jelennek-e meg.
AFX_GLOBAL_DATA::OnSettingChange	Észleli az asztal menüanimációinak és a tálca automatikus felfedési funkcióinak aktuális állapotát.
AFX_GLOBAL_DATA::RegisterWindowClass	Regisztrálja a megadott MFC-ablakosztályt.
AFX_GLOBAL_DATA::ReleaseTaskBarRefs	Felszabadítja a GetITaskbarList és a GetITaskbarList3 metódusokkal beszerzett felületeket.
AFX_GLOBAL_DATA::Önéletrajz	Újrainicializálja a belső függvénymutatókat, amelyek a Windows-témákat és vizuális stílusokat támogató metódusokhoz férnek hozzá.
AFX_GLOBAL_DATA::SetLayeredAttrib	A Windows SetLayeredWindowAttributes metódus meghívásának egyszerű módja.
AFX_GLOBAL_DATA::SetMenuFont	Létrehozza a megadott logikai betűtípust.
AFX_GLOBAL_DATA::ShellCreateItemFromParsingName	Létrehoz és inicializál egy Shell-elemobjektumot egy elemzési névből.
AFX_GLOBAL_DATA::UpdateFonts	Újrainializálja a keretrendszer által használt logikai betűtípusokat.
AFX_GLOBAL_DATA::UpdateSysColors	Inicializálja a keretrendszer által használt színeket, színmélységeket, ecseteket, tollakat és képeket.

Védett metódusok

Név	Description
AFX_GLOBAL_DATA::EnableAccessibilitySupport	Engedélyezi vagy letiltja a Microsoft Active Accessibility támogatását. Az Aktív akadálymentesség megbízható módszereket biztosít a felhasználói felület elemeinek információinak feltáráshoz.
AFX_GLOBAL_DATA::IsAccessibilitySupport	Azt jelzi, hogy engedélyezve van-e a Microsoft Active Accessibility támogatása.
AFX_GLOBAL_DATA::IsWindowsLayerSupportAvailable	Azt jelzi, hogy az operációs rendszer támogatja-e a rétegzett ablakokat.

Adattagok

Név	Description
AFX_GLOBAL_DATA::bIsOSAlphaBlendingSupport	Azt jelzi, hogy a jelenlegi operációs rendszer támogatja-e az alfa-keverést.
AFX_GLOBAL_DATA::bIsWindows7	Azt jelzi, hogy az alkalmazás Windows 7 operációs rendszeren vagy újabb rendszeren fut-e
AFX_GLOBAL_DATA::clrActiveCaptionGradient	Az aktív felirat színátmenetes színét adja meg. Általában dokkoló ablaktáblákhoz használatos.
AFX_GLOBAL_DATA::clrInactiveCaptionGradient	Az inaktív aktív felirat színátmenetes színét adja meg. Általában dokkoló ablaktáblákhoz használatos.
AFX_GLOBAL_DATA::m_bUseBuiltIn32BitIcons	Azt jelzi, hogy a keretrendszer előre definiált 32 bites színikonokat vagy alacsonyabb felbontású ikonokat használ-e.
AFX_GLOBAL_DATA::m_bUseSystemFont	Azt jelzi, hogy a rendszer betűtípust használ-e menükhöz, eszköztárakhoz és menüszalagokhoz.
AFX_GLOBAL_DATA::m_hcurHand	A kézi kurzor fogópontját tárolja.
AFX_GLOBAL_DATA::m_hcurStretch	A vízszintes nyújtású kurzor fogópontját tárolja.
AFX_GLOBAL_DATA::m_hcurStretchVert	A függőleges nyújtású kurzor fogópontját tárolja.
AFX_GLOBAL_DATA::m_hiconTool	Az eszköz ikonjának fogópontját tárolja.
AFX_GLOBAL_DATA::m_nAutoHideToolBarMargin	Megadja az eltolást a bal szélső automatikus felfedési eszköztártól a dokkolósáv bal oldalára.
AFX_GLOBAL_DATA::m_nAutoHideToolBarSpacing	Megadja az automatikusan megjelenő eszköztárak közötti rést.
AFX_GLOBAL_DATA::m_nDragFrameThicknessDock	Megadja a rögzített állapot kommunikációjára használt húzási keret vastagságát.
AFX_GLOBAL_DATA::m_nDragFrameThicknessFloat	Megadja a lebegő állapot kommunikációjára használt húzási keret vastagságát.

Megjegyzések

A struktúra adatainak AFX_GLOBAL_DATA többsége inicializálva lesz az alkalmazás indításakor.

Öröklési hierarchia

AFX_GLOBAL_DATA

Requirements

Fejléc: afxglobals.h

AFX_GLOBAL_DATA::bIsOSAlphaBlendingSupport

Azt jelzi, hogy az operációs rendszer támogatja-e az alfa-keverést.

BOOL  bIsOSAlphaBlendingSupport;

Megjegyzések

A TRUE azt jelzi, hogy az alfa-keverés támogatott; egyéb esetben HAMIS.

AFX_GLOBAL_DATA::Törlés

Felszabadítja a keretrendszer által lefoglalt erőforrásokat, például ecseteket, betűtípusokat és DLL-eket.

void CleanUp();

AFX_GLOBAL_DATA::D 2D1MakeRotateMatrix

Forgatási átalakítást hoz létre, amely meghatározott szögben forog egy adott pont körül.

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

Paraméterek

Szög
Az óramutató járásával megegyező elforgatási szög fokban.

középső
Az a pont, amely körül forog.

Mátrix
Amikor ez a metódus visszatér, az új rotációs átalakítást tartalmazza. Ehhez a paraméterhez tárterületet kell lefoglalnia.

Visszaadott érték

A S_OK adja vissza, ha sikeres, vagy ha más hibaértéket ad vissza.

AFX_GLOBAL_DATA::D rawParentBackground

A vezérlőelem szülőjének hátterét rajzolja meg a megadott területen.

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

Paraméterek

pWnd
[in] Mutató egy vezérlő ablakára.

Pdc
[in] Mutasson egy eszközkörnyezetre.

lpRect
[in] Mutasson egy téglalapra, amely a rajzolandó területet határolja. Az alapértelmezett érték NULL.

Visszaadott érték

IGAZ, ha ez a módszer sikeres; egyéb esetben HAMIS.

AFX_GLOBAL_DATA::D rawTextOnGlass

A megadott szöveget a megadott téma vizuális stílusában rajzolja meg.

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

Paraméterek

hTheme
[in] Kezelje egy ablak témaadatait, vagy NULL értéket. A keretrendszer a megadott témával rajzolja meg a szöveget, ha ez a paraméter nem NULL értékű, és a témák támogatottak. Ellenkező esetben a keretrendszer nem használ témát a szöveg rajzolásához.

Az OpenThemeData metódus használatával hozzon létre egy HTHEME-t.

Pdc
[in] Mutasson egy eszközkörnyezetre.

iPartId
[in] A kívánt szöveg megjelenésű vezérlőrész. További információkért tekintse meg a tábla Alkatrészek oszlopát a Részek és állapotok területen. Ha ez az érték 0, a szöveg az alapértelmezett betűtípusban lesz megrajzolva, vagy az eszközkörnyezetben kijelölt betűtípus.

iStateId
[in] A kívánt szöveg megjelenésű vezérlőállapot. További információkért tekintse meg a tábla Állapotok oszlopát a Részek és államok területen.

strText
[in] A rajzolni kívánt szöveg.

téglalap
[in] Annak a területnek a határa, amelyben a megadott szöveg meg van rajzolva.

dwFlags
[in] A megadott szöveg rajzolásának módját meghatározó jelzők bitenkénti kombinációja (OR).

Ha a hTheme paraméter vagy NULL a témák nem támogatottak és engedélyezve vannak, a CDC::D rawText metódus nFormat paramétere az érvényes jelzőket írja le. Ha a témák támogatottak, a DrawThemeTextEx metódus dwFlags paramétere az érvényes jelzőket írja le.

nGlowSize
[in] A háttérre rajzolt ragyogáseffektus mérete a megadott szöveg rajzolása előtt. Az alapértelmezett érték 0.

clrText
[in] Az a szín, amelyben a megadott szöveg rajzolva van. Az alapértelmezett érték az alapértelmezett szín.

Visszaadott érték

IGAZ, ha egy téma a megadott szöveg rajzolására szolgál; egyéb esetben HAMIS.

Megjegyzések

A téma egy alkalmazás vizuális stílusát határozza meg. A téma nem használható a szöveg rajzolására, ha a hTheme paraméter NULL, vagy ha a DrawThemeTextEx metódus nem támogatott, vagy ha a Desktop Window Manager (DWM) kompozíció le van tiltva.

AFX_GLOBAL_DATA::EnableAccessibilitySupport

Engedélyezi vagy letiltja a Microsoft Active Accessibility támogatását.

void EnableAccessibilitySupport(BOOL bEnable=TRUE);

Paraméterek

bEnable
[in] IGAZ a kisegítő lehetőségek támogatásának engedélyezéséhez; HAMIS a kisegítő lehetőségek támogatásának letiltásához. Az alapértelmezett érték TRUE.

Megjegyzések

Az aktív akadálymentesség egy COM-alapú technológia, amely javítja a programok és a Windows operációs rendszer együttműködését a kisegítő technológiai termékekkel. Megbízható módszereket biztosít a felhasználói felület elemeinek információinak feltáráshoz. A Microsoft UI Automation nevű újabb akadálymentességi modell azonban már elérhető. A két technológia összehasonlítását a felhasználói felület automatizálása és a Microsoft Active Accessibility című témakörben tekinti meg.

Az AFX_GLOBAL_DATA::IsAccessibilitySupport metódussal állapítsa meg, hogy engedélyezve van-e a Microsoft Active Accessibility támogatása.

AFX_GLOBAL_DATA::ExcludeTag

Eltávolítja a megadott XML-címkepárt egy megadott pufferből.

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

Paraméterek

strBuffer
[in] Egy szövegpuffer.

lpszTag
[in] A nyitó és záró XML-címkék neve.

strTag
[kifelé] A metódus visszatérésekor az strTag paraméter tartalmazza az lpszTag paraméter által elnevezett nyitó és záró XML-címkék közötti szöveget. A kezdő vagy záró szóközt a rendszer levágja az eredményből.

bIsCharsList
[in] IGAZ, ha az strTag paraméterben lévő menekülési karakterek szimbólumait tényleges feloldó karakterekké konvertálja; HAMIS, ha nem hajtja végre az átalakítást. Az alapértelmezett érték HAMIS. További információ: Megjegyzések.

Visszaadott érték

IGAZ, ha ez a módszer sikeres; egyéb esetben HAMIS.

Megjegyzések

Az XML-címkepár nevesített nyitó és záró címkékből áll, amelyek a megadott pufferben lévő szövegfuttatás kezdetét és végét jelzik. A strBuffer paraméter megadja a puffert, az lpszTag paraméter pedig az XML-címkék nevét.

A következő táblázatban szereplő szimbólumokkal kódolhatja a megadott pufferben lévő feloldó karakterek készletét. Adja meg az IGAZ értéket a bIsCharsList paraméterhez az strTag paraméter szimbólumainak tényleges feloldó karakterekké alakításához. Az alábbi táblázat a _T() makróval adja meg a szimbólumot és a feloldó karakter sztringeket.

Szimbólum	Escape karakter
_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

A megadott felhasználói felület elem aktuális színét kéri le.

COLORREF GetColor(int nColor);

Paraméterek

nColor
[in] Olyan érték, amely egy olyan felhasználói felületi elemet határoz meg, amelynek a színe lekért. Az érvényes értékek listáját a GetSysColor metódus nIndex paraméterében találja.

Visszaadott érték

A megadott felhasználói felület elem RGB színértéke. További információ: Megjegyzések.

Megjegyzések

Ha az nColor paraméter kívül esik a tartományon, a visszatérési érték nulla. Mivel a nulla is érvényes RGB-érték, ezzel a módszerrel nem állapíthatja meg, hogy az aktuális operációs rendszer támogatja-e a rendszer színét. Ehelyett használja a GetSysColorBrush metódust, amely null értéket ad vissza, ha a szín nem támogatott.

AFX_GLOBAL_DATA::GetDirect2dFactory

A globális adatokban tárolt ID2D1Factory felületre mutató mutatót ad vissza. Ha a felület nincs inicializálva, létrejön, és az alapértelmezett paraméterekkel rendelkezik.

ID2D1Factory* GetDirect2dFactory();

Visszaadott érték

Az ID2D1Factory felületre mutató mutató, ha egy gyár létrehozása sikeres, vagy null értékű, ha a létrehozás sikertelen, vagy ha a jelenlegi operációs rendszer nem rendelkezik D2D-támogatással.

AFX_GLOBAL_DATA::GetHandCursor

Lekéri az előre definiált kurzort, amely hasonlít egy kézre, és amelynek azonosítója IDC_HAND.

HCURSOR GetHandCursor();

Visszaadott érték

A kézi kurzor fogópontja.

AFX_GLOBAL_DATA::GetNonClientMetrics

Lekéri a nemminimizált ablakok nemclient területéhez társított metrikákat.

BOOL GetNonClientMetrics(NONCLIENTMETRICS& info);

Paraméterek

infó
[be, ki] NONCLIENTMETRICS struktúra, amely a nemminimizált ablak nemclient területéhez társított méretezhető metrikákat tartalmazza.

Visszaadott érték

IGAZ, ha ez a módszer sikeres; egyéb esetben HAMIS.

AFX_GLOBAL_DATA::GetTextHeight

Az aktuális betűtípus szövegkarakterek magasságát kéri le.

int GetTextHeight(BOOL bHorz = TRUE);

Paraméterek

bHorz
[in] IGAZ érték a karakterek magasságának lekéréséhez, amikor a szöveg vízszintesen fut; HAMIS a karakterek magasságának lekéréséhez, amikor a szöveg függőlegesen fut. Az alapértelmezett érték TRUE.

Visszaadott érték

Az aktuális betűtípus magassága, amely a felmenőjétől a csökkenőig mérve van.

AFX_GLOBAL_DATA::GetWICFactory

A globális adatokban tárolt IWICImagingFactory felületre mutató mutatót ad vissza. Ha a felület nincs inicializálva, létrejön, és az alapértelmezett paraméterekkel rendelkezik.

IWICImagingFactory* GetWICFactory();

Visszaadott érték

Az IWICImagingFactory felületre mutató mutató, ha egy gyár létrehozása sikeres, vagy null értékű, ha a létrehozás sikertelen, vagy a jelenlegi operációs rendszer nem támogatja a WIC-t.

AFX_GLOBAL_DATA::GetWriteFactory

A globális adatokban tárolt IDWriteFactory felületre mutató mutatót ad vissza. Ha a felület nincs inicializálva, létrejön, és az alapértelmezett paraméterekkel rendelkezik.

IDWriteFactory* GetWriteFactory();

Visszaadott érték

Az IDWriteFactory felületre mutató mutató, ha egy gyár létrehozása sikeres, vagy null értékű, ha a létrehozás meghiúsul, vagy ha a jelenlegi operációs rendszer nem támogatja a DirectWrite-t.

AFX_GLOBAL_DATA::InitD2D

Inicializálja a D2D-, DirectWrite- és WIC-gyárakat. Hívja meg ezt a metódust a főablak inicializálása előtt.

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

Paraméterek

d2dFactoryType
A D2D-gyár szálmodellje és az általa létrehozott erőforrások.

writeFactoryType
Egy érték, amely meghatározza, hogy az írás-előállító objektum meg lesz-e osztva vagy elkülönítve

Visszaadott érték

IGAZ értéket ad vissza, ha a gyárak intilalizrd, HAMIS - egyébként

AFX_GLOBAL_DATA::Is32BitIcons

Azt jelzi, hogy az előre definiált 32 bites ikonok támogatottak-e.

BOOL Is32BitIcons() const;

Visszaadott érték

IGAZ, ha az előre definiált 32 bites ikonok támogatottak; egyéb esetben HAMIS.

Megjegyzések

Ez a metódus IGAZ értéket ad vissza, ha a keretrendszer támogatja a 32 bites beépített ikonokat, és ha az operációs rendszer képpontonként vagy annál nagyobb 16 bitet támogat, és ha a képek nem jelennek meg nagy kontrasztban.

AFX_GLOBAL_DATA::IsAccessibilitySupport

Azt jelzi, hogy engedélyezve van-e a Microsoft Active Accessibility támogatása.

BOOL IsAccessibilitySupport() const;

Visszaadott érték

IGAZ, ha az akadálymentesség támogatása engedélyezve van; egyéb esetben HAMIS.

Megjegyzések

A Microsoft Active Accessibility volt a korábbi megoldás az alkalmazások akadálymentesítésére. A Microsoft UI Automation a Microsoft Windows új akadálymentességi modellje, amely a kisegítő technológiai termékek és az automatizált tesztelési eszközök igényeinek kielégítésére szolgál.

Használja a AFX_GLOBAL_DATA::EnableAccessibilitySupport metódust az aktív kisegítő lehetőségek támogatásának engedélyezéséhez vagy letiltásához.

AFX_GLOBAL_DATA::IsD2DInitialized

Meghatározza, hogy a D2D inicializálva lett-e

BOOL IsD2DInitialized() const;

Visszaadott érték

IGAZ, ha a D2D inicializálva lett; egyéb esetben HAMIS.

AFX_GLOBAL_DATA::IsDwmCompositionEnabled

A Windows DwmIsCompositionEnabled metódus meghívásának egyszerű módja.

BOOL IsDwmCompositionEnabled();

Visszaadott érték

IGAZ, ha a Desktop Window Manager (DWM) összetétele engedélyezve van; egyéb esetben HAMIS.

AFX_GLOBAL_DATA::IsHighContrastMode

Azt jelzi, hogy a képek jelenleg nagy kontrasztban jelennek-e meg.

BOOL IsHighContrastMode() const;

Visszaadott érték

IGAZ, ha a képek jelenleg fekete vagy fehér kontrasztos módban jelennek meg; egyéb esetben HAMIS.

Megjegyzések

Fekete kontrasztos módban a fény felé néző élek fehérek, a háttér pedig fekete. Fehér kontrasztos módban a fény felé néző élek feketeek, a háttér pedig fehér.

AFX_GLOBAL_DATA::IsWindowsLayerSupportAvailable

Azt jelzi, hogy az operációs rendszer támogatja-e a rétegzett ablakokat.

BOOL IsWindowsLayerSupportAvailable() const;

Visszaadott érték

IGAZ, ha a rétegzett ablakok támogatottak; egyéb esetben HAMIS.

Megjegyzések

Ha a rétegzett ablakok támogatottak, az intelligens dokkolójelölők rétegzett ablakokat használnak.

AFX_GLOBAL_DATA::m_bUseBuiltIn32BitIcons

Azt jelzi, hogy a keretrendszer előre definiált 32 bites színikonokat vagy alacsonyabb felbontású ikonokat használ-e.

BOOL  m_bUseBuiltIn32BitIcons;

Megjegyzések

A TRUE azt határozza meg, hogy a keretrendszer 32 bites színikonokat használjon; A FALSE kisebb felbontás ikonokat ad meg. A AFX_GLOBAL_DATA::AFX_GLOBAL_DATA konstruktor a tagot TRUE értékre inicializálja.

Ezt a tagot az alkalmazás indításakor kell beállítani.

AFX_GLOBAL_DATA::m_bUseSystemFont

Azt jelzi, hogy a rendszer betűtípust használ-e menükhöz, eszköztárakhoz és menüszalagokhoz.

BOOL m_bUseSystemFont;

Megjegyzések

A TRUE a rendszer betűtípusának használatát határozza meg; egyéb esetben HAMIS. A AFX_GLOBAL_DATA::AFX_GLOBAL_DATA konstruktor hamisra inicializálja ezt a tagot.

Nem ez a tag tesztelése az egyetlen módja annak, hogy a keretrendszer meghatározza a használni kívánt betűtípust. A AFX_GLOBAL_DATA::UpdateFonts metódus emellett teszteli az alapértelmezett és az alternatív betűtípusokat is, hogy meghatározza, milyen vizuális stílusok alkalmazhatók a menükre, eszköztárakra és menüszalagokra.

AFX_GLOBAL_DATA::m_hcurHand

A kézi kurzor fogópontját tárolja.

HCURSOR m_hcurHand;

AFX_GLOBAL_DATA::m_hcurStretch

A vízszintes nyújtású kurzor fogópontját tárolja.

HCURSOR m_hcurStretch;

AFX_GLOBAL_DATA::m_hcurStretchVert

A függőleges nyújtású kurzor fogópontját tárolja.

HCURSOR m_hcurStretchVert;

AFX_GLOBAL_DATA::m_hiconTool

Az eszköz ikonjának fogópontját tárolja.

HICON m_hiconTool;

AFX_GLOBAL_DATA::m_nAutoHideToolBarMargin

Megadja az eltolást a bal szélső automatikus felfedési eszköztártól a dokkolósáv bal oldalára.

int  m_nAutoHideToolBarMargin;

Megjegyzések

A AFX_GLOBAL_DATA::AFX_GLOBAL_DATA konstruktor 4 képpontra inicializálja ezt a tagot.

AFX_GLOBAL_DATA::m_nAutoHideToolBarSpacing

Megadja az automatikusan megjelenő eszköztárak közötti rést.

int   m_nAutoHideToolBarSpacing;

Megjegyzések

A AFX_GLOBAL_DATA::AFX_GLOBAL_DATA konstruktor 14 képpontra inicializálja ezt a tagot.

AFX_GLOBAL_DATA::m_nDragFrameThicknessDock

Megadja a rögzített állapot jelzésére használt húzási keret vastagságát.

int  m_nDragFrameThicknessDock;

Megjegyzések

A AFX_GLOBAL_DATA::AFX_GLOBAL_DATA konstruktor 3 képpontra inicializálja ezt a tagot.

AFX_GLOBAL_DATA::m_nDragFrameThicknessFloat

Megadja a lebegő állapot jelzésére használt húzási keret vastagságát.

int  m_nDragFrameThicknessFloat;

Megjegyzések

A AFX_GLOBAL_DATA::AFX_GLOBAL_DATA konstruktor 4 képpontra inicializálja ezt a tagot.

AFX_GLOBAL_DATA::OnSettingChange

Észleli az asztal menüanimációinak és a tálca automatikus felfedési funkcióinak aktuális állapotát.

void OnSettingChange();

Megjegyzések

Ez a módszer a keretrendszerváltozókat a felhasználó asztalának bizonyos attribútumainak állapotára állítja be. Ez a metódus észleli a menüanimációk aktuális állapotát, a menü elhalványulását és a tálca automatikus felfedési funkcióit.

AFX_GLOBAL_DATA::RegisterWindowClass

Regisztrálja a megadott MFC-ablakosztályt.

CString RegisterWindowClass(LPCTSTR lpszClassNamePrefix);

Paraméterek

lpszClassNamePrefix
[in] A regisztrálandó ablakosztály neve.

Visszaadott érték

A regisztrált osztály minősített neve, ha ez a módszer sikeres; egyéb esetben erőforrás-kivételt.

Megjegyzések

A visszatérési érték az lpszClassNamePrefix paramétersztring kettőspontokkal tagolt listája, valamint az aktuális alkalmazáspéldány leíróinak hexadecimális szöveges ábrázolása; az alkalmazáskurzor, amely az a nyílmutató, amelynek azonosítója IDC_ARROW; és a háttérkefe. További információ az MFC-ablakosztályok regisztrálásáról: AfxRegisterClass.

AFX_GLOBAL_DATA::Önéletrajz

Újrainicializálja a belső függvénymutatókat, amelyek a Windows-témákat és vizuális stílusokat támogató metódusokhoz férnek hozzá.

BOOL Resume();

Visszaadott érték

IGAZ, ha ez a módszer sikeres; egyéb esetben HAMIS. Hibakeresési módban ez a módszer azt állítja, hogy ez a módszer sikertelen.

Megjegyzések

Ezt a metódust akkor hívjuk meg, amikor a keretrendszer megkapja a WM_POWERBROADCAST üzenetet.

AFX_GLOBAL_DATA::SetLayeredAttrib

A Windows SetLayeredWindowAttributes metódus meghívásának egyszerű módja.

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

Paraméterek

hwnd
[in] Fogópont a rétegzett ablakhoz.

crKey
[in] Az asztali ablakkezelő által a rétegzett ablak írásához használt áttetszőségi színkulcs.

bAlpha
[in] A rétegzett ablak átlátszatlanságát leíró alfa érték.

dwFlags
[in] A használandó metódusparamétereket meghatározó jelzők bitenkénti kombinációja (OR). Adja meg a LWA_COLORKEY, hogy a crKey paramétert használja áttetszőségi színként. Adja meg a LWA_ALPHA, hogy a bAlpha paraméter használatával határozza meg a rétegzett ablak átlátszóságát.

Visszaadott érték

IGAZ, ha ez a módszer sikeres; egyéb esetben HAMIS.

AFX_GLOBAL_DATA::SetMenuFont

Létrehozza a megadott logikai betűtípust.

BOOL SetMenuFont(
    LPLOGFONT lpLogFont,
    BOOL bHorz);

Paraméterek

lpLogFont
[in] Mutató egy betűtípus attribútumait tartalmazó szerkezetre.

bHorz
[in] IGAZ érték annak megadásához, hogy a szöveg vízszintesen fusson; HAMIS, ha meg szeretné adni, hogy a szöveg függőlegesen fusson.

Visszaadott érték

IGAZ, ha ez a módszer sikeres; egyéb esetben HAMIS. Hibakeresési módban ez a módszer azt állítja, hogy ez a módszer sikertelen.

Megjegyzések

Ez a módszer egy vízszintes normál betűtípust, egy aláhúzott betűtípust és egy félkövér betűtípust hoz létre, amelyet az alapértelmezett menüelemekben használnak. Ez a módszer opcionálisan létrehoz egy normál függőleges betűtípust. További információ a logikai betűtípusokról: CFont::CreateFontIndirect.

AFX_GLOBAL_DATA::UpdateFonts

Újrainializálja a keretrendszer által használt logikai betűtípusokat.

void UpdateFonts();

Megjegyzések

A logikai betűtípusokkal kapcsolatos további információkért lásd: CFont::CreateFontIndirect.

AFX_GLOBAL_DATA::UpdateSysColors

Inicializálja a keretrendszer által használt színeket, színmélységeket, ecseteket, tollakat és képeket.

void UpdateSysColors();

AFX_GLOBAL_DATA::bIsWindows7

Azt jelzi, hogy az alkalmazás Windows 7 vagy újabb rendszerben van-e végrehajtva.

BOOL bIsWindows7;

AFX_GLOBAL_DATA::clrActiveCaptionGradient

Az aktív felirat színátmenetes színét adja meg. Általában dokkoló ablaktáblákhoz használatos.

COLORREF clrActiveCaptionGradient;

AFX_GLOBAL_DATA::clrInactiveCaptionGradient

Az inaktív felirat színátmenetes színét adja meg. Általában dokkoló ablaktáblákhoz használatos.

COLORREF clrInactiveCaptionGradient;

AFX_GLOBAL_DATA::GetITaskbarList

A globális adatokban létrehoz és tárol egy mutatót az ITaskBarList interfészhez.

ITaskbarList *GetITaskbarList();

Visszaadott érték

Mutató a ITaskbarList felületre, ha egy feladatsáv listaobjektumának létrehozása sikeres; NULL értékű, ha a létrehozás sikertelen, vagy ha a jelenlegi operációs rendszer kisebb, mint a Windows 7.

AFX_GLOBAL_DATA::GetITaskbarList3

A globális adatokban létrehoz és tárol egy mutatót az ITaskBarList3 interfészhez.

ITaskbarList3 *GetITaskbarList3();

Visszaadott érték

Mutató a ITaskbarList3 felületre, ha egy feladatsáv listaobjektumának létrehozása sikeres; NULL értékű, ha a létrehozás sikertelen, vagy ha a jelenlegi operációs rendszer kisebb, mint a Windows 7.

AFX_GLOBAL_DATA::GetShellAutohideBars

Meghatározza a Shell automatikus elrejtősávjainak pozícióit.

int GetShellAutohideBars();

Visszaadott érték

Az automatikus elrejtősávok pozícióit meghatározó kódolt jelzőkkel rendelkező egész számérték. A következő értékeket kombinálhatja: AFX_AUTOHIDE_BOTTOM, AFX_AUTOHIDE_TOP, AFX_AUTOHIDE_LEFT, AFX_AUTOHIDE_RIGHT.

AFX_GLOBAL_DATA::ReleaseTaskBarRefs

Felszabadítja a felületeket, amelyeket a metódusok és GetITaskbarList3 a GetITaskbarList metódusok segítségével szereznek be.

void ReleaseTaskBarRefs();

AFX_GLOBAL_DATA::ShellCreateItemFromParsingName

Létrehoz és inicializál egy Shell-elemobjektumot egy elemzési névből.

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

Paraméterek

pszPath
[in] Egy megjelenítendő névre mutató mutató.

Pbc
Az elemzési műveletet vezérlő kötési környezet mutatója.

riid
Hivatkozás egy felületazonosítóra.

Ppv
[kifelé] Amikor ez a függvény visszatér, a rendszer a riidben kért felületmutatót tartalmazza. Ez általában vagy IShellItemIShellItem2.

Visszaadott érték

Sikeres S_OK ad vissza; hibaértéket.

Lásd még

hierarchiadiagram
Struktúrák, stílusok, visszahívások és üzenettérképek
COLORREF
Alkatrészek és államok
CDC::D rawText
DrawThemeTextEx
Asztali ablakkezelő
DWM-összetétel engedélyezése és szabályozása
A felhasználói felület automatizálása és a Microsoft aktív akadálymentessége
GetSysColor függvény
GetSysColorBrush
NONCLIENTMETRICS struktúra
AfxRegisterClass
AfxThrowResourceException
SetLayeredWindowAttributes