Freigeben über

AFX_GLOBAL_DATA-Struktur

  • Artikel

Die AFX_GLOBAL_DATA -Struktur enthält Felder und Methoden, mit denen das Framework verwaltet oder die Darstellung und das Verhalten der Anwendung angepasst werden können.

Syntax

struct AFX_GLOBAL_DATA

Member

Öffentliche Konstruktoren

Name Beschreibung
AFX_GLOBAL_DATA::AFX_GLOBAL_DATA Erstellt eine AFX_GLOBAL_DATA -Struktur.
AFX_GLOBAL_DATA::~AFX_GLOBAL_DATA Destruktor.

Öffentliche Methoden

Name Beschreibung
AFX_GLOBAL_DATA::CleanUp Gibt Ressourcen frei, die vom Framework zugeordnet werden, z. B. Pinsel, Schriftarten und DLLs.
AFX_GLOBAL_DATA::D 2D1MakeRotateMatrix Erstellt eine Drehtransformation, die sich in einem angegebenen Winkel um einen angegebenen Punkt dreht.
AFX_GLOBAL_DATA::D rawParentBackground Zeichnet den Hintergrund des übergeordneten Elements eines Steuerelements im angegebenen Bereich.
AFX_GLOBAL_DATA::D rawTextOnGlass Zeichnet den angegebenen Text im Stil des angegebenen Designs.
AFX_GLOBAL_DATA::ExcludeTag Entfernt das angegebenen XML-Tagpaar aus einem angegebenen Puffer.
AFX_GLOBAL_DATA::GetColor Ruft die derzeitige Farbe eines angegebenen Benutzeroberflächen-Elements ab.
AFX_GLOBAL_DATA::GetDirect2dFactory Gibt einen Zeiger auf die ID2D1Factory -Schnittstelle zurück, die in den globalen Daten gespeichert ist. Wenn die Schnittstelle nicht initialisiert wurde, wird sie mit den Standardparametern erstellt.
AFX_GLOBAL_DATA::GetHandCursor Ruft den vordefinierten Cursor ab, der einer Hand ähnelt und dessen Bezeichner IDC_HANDlautet.
AFX_GLOBAL_DATA::GetITaskbarList Erstellt und speichert in den globalen Daten einen Zeiger auf die ITaskBarList-Schnittstelle.
AFX_GLOBAL_DATA::GetITaskbarList3 Erstellt und speichert in den globalen Daten einen Zeiger auf die ITaskBarList3-Schnittstelle.
AFX_GLOBAL_DATA::GetNonClientMetrics Ruft die Metriken ab, die dem Nichtclientbereich von nicht minimierten Fenstern zugeordnet sind.
AFX_GLOBAL_DATA::GetShellAutohideBars Bestimmt Positionen von Leisten zum automatischen Ausblenden einer Shell.
AFX_GLOBAL_DATA::GetTextHeight Ruft die Höhe von Textzeichen in der aktuellen Schriftart ab.
AFX_GLOBAL_DATA::GetWICFactory Gibt einen Zeiger auf die IWICImagingFactory -Schnittstelle zurück, die in den globalen Daten gespeichert ist. Wenn die Schnittstelle nicht initialisiert wurde, wird sie mit den Standardparametern erstellt.
AFX_GLOBAL_DATA::GetWriteFactory Gibt einen Zeiger auf die IDWriteFactory -Schnittstelle zurück, die in den globalen Daten gespeichert ist. Wenn die Schnittstelle nicht initialisiert wurde, wird sie mit den Standardparametern erstellt.
AFX_GLOBAL_DATA::InitD2D Initialisiert die Factorys D2D, DirectWriteund WIC . Rufen Sie diese Methode vor der Initialisierung des Hauptfensters auf.
AFX_GLOBAL_DATA::Is32BitIcons Gibt an, ob vordefinierte 32-Bit-Symbole unterstützt werden.
AFX_GLOBAL_DATA::IsD2DInitialized Bestimmt, ob D2D initialisiert wurde.
AFX_GLOBAL_DATA::IsDwmCompositionEnabled Stellt eine einfache Möglichkeit zum Aufrufen der DwmIsCompositionEnabled -Methode von Windows bereit.
AFX_GLOBAL_DATA::IsHighContrastMode Gibt an, ob Bilder nur mit hohem Kontrast angezeigt werden.
AFX_GLOBAL_DATA::OnSettingChange Erkennt den aktuellen Zustand der Funktionen zum automatischen Ausblenden der Menüanimation und Taskleisten auf dem Desktop.
AFX_GLOBAL_DATA::RegisterWindowClass Registriert die angegebene MFC-Fensterklasse.
AFX_GLOBAL_DATA::ReleaseTaskBarRefs Gibt Schnittstellen frei, die durch die Methoden GetITaskbarList und GetITaskbarList3 ermittelt wurden.
AFX_GLOBAL_DATA::Resume Initialisiert die internen Funktionszeiger für den Zugriff auf Methoden, die Designs und visuelle Stilein Windows unterstützen.
AFX_GLOBAL_DATA::SetLayeredAttrib Stellt eine einfache Möglichkeit zum Aufrufen der SetLayeredWindowAttributes -Methode von Windows bereit.
AFX_GLOBAL_DATA::SetMenuFont Erstellt die angegebene logische Schriftart.
AFX_GLOBAL_DATA::ShellCreateItemFromParsingName Erstellt und initialisiert ein Shellelementobjekt aus einem Analysenamen.
AFX_GLOBAL_DATA::UpdateFonts Initialisiert die logischen Schriftarten erneut, die vom Framework verwendet werden.
AFX_GLOBAL_DATA::UpdateSysColors Initialisiert die Farben, die Farbtiefe, die Stifte, die Pinsel und die Bilder, die vom Framework verwendet werden.

Geschützte Methoden

Name Beschreibung
AFX_GLOBAL_DATA::EnableAccessibilitySupport Aktiviert oder deaktiviert Microsoft Active Accessibility-Unterstützung. Active Accessibility stellt zuverlässige Methoden zum Anzeigen von Informationen über Benutzeroberflächenelemente bereit.
AFX_GLOBAL_DATA::IsAccessibilitySupport Gibt an, ob Microsoft Active Accessibility-Unterstützung aktiviert ist.
AFX_GLOBAL_DATA::IsWindowsLayerSupportAvailable Gibt an, ob das Betriebssystem überlappende Fenster unterstützt.

Datenelemente

Name Beschreibung
AFX_GLOBAL_DATA::bIsOsAlphaBlendingSupport Gibt an, ob das aktuelle Betriebssystem Alphablending unterstützt.
AFX_GLOBAL_DATA::bIsWindows7 Gibt an, ob die Anwendung unter dem Betriebssystem Windows 7 oder höher ausgeführt wird.
AFX_GLOBAL_DATA::clrActiveCaptionGradient Gibt den Farbverlauf der aktiven Beschriftung an. Wird im Allgemeinen für andockbare Bereiche verwendet.
AFX_GLOBAL_DATA::clrInactiveCaptionGradient Gibt den Farbverlauf der inaktiven Beschriftung an. Wird im Allgemeinen für andockbare Bereiche verwendet.
AFX_GLOBAL_DATA::m_bUseBuiltIn32BitIcons Gibt an, ob das Framework vordefinierte 32-Bit-Farbsymbole oder Symbole mit einer niedrigeren Auflösung verwendet.
AFX_GLOBAL_DATA::m_bUseSystemFont Gibt an, ob eine Systemschriftart für Menüs, Symbolleisten und Menübänder verwendet wird.
AFX_GLOBAL_DATA::m_hcurHand Speichert das Handle für den Hand-Cursor.
AFX_GLOBAL_DATA::m_hcurStretch Speichert das Handle für den horizontalen Streckungs-Cursor.
AFX_GLOBAL_DATA::m_hcurStretchVert Speichert das Handle für den vertikalen Streckungs-Cursor.
AFX_GLOBAL_DATA::m_hiconTool Speichert das Handle für das Werkzeugsymbol.
AFX_GLOBAL_DATA::m_nAutoHideToolBarMargin Gibt den Offset von der äußersten linken Symbolleiste zum automatischen Ausblenden von der linken Seite der Andockleiste an.
AFX_GLOBAL_DATA::m_nAutoHideToolBarSpacing Gibt die Lücke zwischen Symbolleisten zum automatischen Ausblenden an.
AFX_GLOBAL_DATA::m_nDragFrameThicknessDock Gibt die Breite des Ziehrahmens an, mit dem der angedockten Zustand übermittelt wird.
AFX_GLOBAL_DATA::m_nDragFrameThicknessFloat Gibt die Breite des Ziehrahmens an, mit dem der unverankerte Zustand übermittelt wird.

Hinweise

Die meisten Daten in der AFX_GLOBAL_DATA -Struktur werden beim Start der Anwendung initialisiert.

Vererbungshierarchie

AFX_GLOBAL_DATA

Anforderungen

Header: afxglobals.h

AFX_GLOBAL_DATA::bIsOsAlphaBlendingSupport

Gibt an, ob das Betriebssystem alpha-Blending unterstützt.

BOOL  bIsOSAlphaBlendingSupport;

Hinweise

TRUE gibt an, dass Alphamischung unterstützt wird; andernfalls FALSE.

AFX_GLOBAL_DATA::CleanUp

Gibt Ressourcen frei, die vom Framework zugeordnet werden, z. B. Pinsel, Schriftarten und DLLs.

void CleanUp();

AFX_GLOBAL_DATA::D 2D1MakeRotateMatrix

Erstellt eine Drehtransformation, die sich in einem angegebenen Winkel um einen angegebenen Punkt dreht.

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

Parameter

Winkel
Der Drehwinkel im Uhrzeigersinn in Grad.

Zentrum
Der Punkt, an dem gedreht werden soll.

matrix
Wenn diese Methode zurückgegeben wird, enthält sie die neue Drehungstransformation. Sie müssen Speicher für diesen Parameter zuweisen.

Rückgabewert

Gibt S_OK bei erfolgreicher Ausführung oder andernfalls einen Fehlerwert zurück.

AFX_GLOBAL_DATA::D rawParentBackground

Zeichnet den Hintergrund des übergeordneten Elements eines Steuerelements im angegebenen Bereich.

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

Parameter

pWnd
[in] Zeiger auf das Fenster eines Steuerelements.

pDC
[in] Zeiger auf einen Gerätekontext.

lpRect
[in] Zeigen Sie auf ein Rechteck, das den zu zeichnenden Bereich begrenzt. Der Standardwert ist NULL.

Rückgabewert

TRUE, wenn diese Methode erfolgreich ist; andernfalls FALSE.

AFX_GLOBAL_DATA::D rawTextOnGlass

Zeichnet den angegebenen Text im Stil des angegebenen Designs.

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

Parameter

hTheme
[in] Behandeln Sie die Designdaten eines Fensters oder NULL. Das Framework verwendet das angegebene Design, um den Text zu zeichnen, wenn dieser Parameter nicht NULL ist und Designs unterstützt werden. Andernfalls verwendet das Framework kein Design zum Zeichnen des Texts.

Verwenden Sie die OpenThemeData-Methode , um ein HTHEME zu erstellen.

pDC
[in] Zeiger auf einen Gerätekontext.

iPartId
[in] Der Steuerelementteil mit der gewünschten Textdarstellung. Weitere Informationen finden Sie im Artikel Parts and States(Teile und Zustände) in der Tabellenspalte „Part“ (Teil). Wenn der Wert 0 lautet, wird der Text in der Standardschriftart oder in einer im Gerätekontext ausgewählten Schriftart gezeichnet.

iStateId
[in] Der Steuerelementstatus, der die gewünschte Textdarstellung aufweist. Weitere Informationen finden Sie im Artikel Parts and States(Teile und Zustände) in der Tabellenspalte „States“ (Zustände).

strText
[in] Der zu zeichnende Text.

Rect
[in] Die Grenze des Bereichs, in dem der angegebene Text gezeichnet wird.

dwFlags
[in] Eine bitweise Kombination (OR) von Flags, die angeben, wie der angegebene Text gezeichnet wird.

Wenn der hTheme-Parameter ist NULL oder wenn Designs nicht unterstützt und aktiviert werden, beschreibt der nFormat-Parameter der CDC::D rawText-Methode die gültigen Flags. Wenn Designs unterstützt werden, beschreibt der dwFlags-Parameter der DrawThemeTextEx-Methode die gültigen Flags.

nGlowSize
[in] Die Größe eines Leuchteffekts, der auf dem Hintergrund gezeichnet wird, bevor der angegebene Text gezeichnet wird. Der Standardwert ist 0.

clrText
[in] Die Farbe, in der der angegebene Text gezeichnet wird. Der Standardwert ist die Standardfarbe.

Rückgabewert

TRUE, wenn ein Design verwendet wird, um den angegebenen Text zu zeichnen; andernfalls FALSE.

Hinweise

Ein Design definiert den visuellen Stil einer Anwendung. Ein Design wird nicht verwendet, um den Text zu zeichnen, wenn der hTheme-Parameter NULL ist oder die DrawThemeTextEx-Methode nicht unterstützt wird oder wenn die Komposition des Desktopfenster-Managers (DWM) deaktiviert ist.

AFX_GLOBAL_DATA::EnableAccessibilitySupport

Aktiviert oder deaktiviert Microsoft Active Accessibility-Unterstützung.

void EnableAccessibilitySupport(BOOL bEnable=TRUE);

Parameter

bEnable
[in] TRUE, um die Unterstützung der Barrierefreiheit zu ermöglichen; FALSE zum Deaktivieren der Barrierefreiheitsunterstützung. Der Standardwert ist TRUE.

Hinweise

Die aktive Barrierefreiheit ist eine COM-basierte Technologie, die die Art und Weise verbessert, wie Programme und das Windows-Betriebssystem mit Hilfstechnologieprodukten zusammenarbeiten. Es bietet zuverlässige Methoden zum Verfügbarmachen von Informationen zu Benutzeroberflächenelementen. Ein neueres Barrierefreiheitsmodell namens Microsoft Benutzeroberflächenautomatisierung ist jetzt verfügbar. Einen Vergleich der beiden Technologien finden Sie unter Benutzeroberflächenautomatisierung und Microsoft Active Accessibility.

Verwenden Sie die AFX_GLOBAL_DATA::IsAccessibilitySupport-Methode , um zu bestimmen, ob die Unterstützung für die Barrierefreiheit von Microsoft active aktiviert ist.

AFX_GLOBAL_DATA::ExcludeTag

Entfernt das angegebenen XML-Tagpaar aus einem angegebenen Puffer.

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

Parameter

strBuffer
[in] Ein Puffer von Text.

lpszTag
[in] Der Name eines Paars von öffnenden und schließenden XML-Tags.

strTag
[out] Wenn diese Methode zurückgegeben wird, enthält der strTag-Parameter den Text zwischen den öffnenden und schließenden XML-Tags, die vom lpszTag-Parameter benannt werden. Alle führenden oder nachfolgenden Leerzeichen werden aus dem Ergebnis gekürzt.

bIsCharsList
[in] TRUE zum Konvertieren von Symbolen für Escapezeichen im strTag-Parameter in tatsächliche Escapezeichen; FALSE, um die Konvertierung nicht auszuführen. Der Standardwert ist FALSE. Weitere Informationen finden Sie in den Hinweisen.

Rückgabewert

TRUE, wenn diese Methode erfolgreich ist; andernfalls FALSE.

Hinweise

Ein XML-Tag-Paar besteht aus benannten öffnenden und schließenden Tags, die den Anfang und das Ende einer Textausführung im angegebenen Puffer angeben. Der parameter strBuffer gibt den Puffer an, und der lpszTag-Parameter gibt den Namen der XML-Tags an.

Verwenden Sie die Symbole in der folgenden Tabelle, um einen Satz von Escapezeichen im angegebenen Puffer zu codieren. Geben Sie TRUE für den bIsCharsList-Parameter an, um die Symbole im strTag-Parameter in tatsächliche Escapezeichen zu konvertieren. In der folgenden Tabelle wird das Makro _T() verwendet, um das Symbol und die Escapezeichenzeichenfolgen anzugeben.

Symbol Escapezeichen
_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

Ruft die derzeitige Farbe eines angegebenen Benutzeroberflächen-Elements ab.

COLORREF GetColor(int nColor);

Parameter

nColor
[in] Ein Wert, der ein Benutzeroberflächenelement angibt, dessen Farbe abgerufen wird. Eine Liste der gültigen Werte finden Sie im nIndex-Parameter der GetSysColor-Methode .

Rückgabewert

Der RGB-Farbwert des angegebenen Benutzeroberflächenelements. Weitere Informationen finden Sie in den Hinweisen.

Hinweise

Wenn der nColor-Parameter außerhalb des Bereichs liegt, ist der Rückgabewert null. Da Null auch ein gültiger RGB-Wert ist, können Sie diese Methode nicht verwenden, um zu bestimmen, ob eine Systemfarbe vom aktuellen Betriebssystem unterstützt wird. Verwenden Sie stattdessen die GetSysColorBrush-Methode , die NULL zurückgibt, wenn die Farbe nicht unterstützt wird.

AFX_GLOBAL_DATA::GetDirect2dFactory

Gibt einen Zeiger auf die ID2D1Factory-Schnittstelle zurück, die in den globalen Daten gespeichert ist. Wenn die Schnittstelle nicht initialisiert wurde, wird sie mit den Standardparametern erstellt.

ID2D1Factory* GetDirect2dFactory();

Rückgabewert

Ein Zeiger auf die ID2D1Factory-Schnittstelle, wenn die Erstellung einer Factory erfolgreich ist, oder NULL, wenn die Erstellung fehlschlägt oder das aktuelle Betriebssystem keine D2D-Unterstützung aufweist.

AFX_GLOBAL_DATA::GetHandCursor

Ruft den vordefinierten Cursor ab, der einer Hand ähnelt und dessen Bezeichner IDC_HAND ist.

HCURSOR GetHandCursor();

Rückgabewert

Der Ziehpunkt des Handcursors.

AFX_GLOBAL_DATA::GetNonClientMetrics

Ruft die Metriken ab, die dem Nichtclientbereich von nicht minimierten Fenstern zugeordnet sind.

BOOL GetNonClientMetrics(NONCLIENTMETRICS& info);

Parameter

info
[in, out] Eine NONCLIENTMETRICS-Struktur , die die skalierbaren Metriken enthält, die dem Nichtclientbereich eines nichtminimisierten Fensters zugeordnet sind.

Rückgabewert

TRUE, wenn diese Methode erfolgreich ist; andernfalls FALSE.

AFX_GLOBAL_DATA::GetTextHeight

Ruft die Höhe von Textzeichen in der aktuellen Schriftart ab.

int GetTextHeight(BOOL bHorz = TRUE);

Parameter

bHorz
[in] TRUE, um die Höhe von Zeichen abzurufen, wenn Text horizontal ausgeführt wird; FALSE, um die Höhe von Zeichen abzurufen, wenn Text vertikal ausgeführt wird. Der Standardwert ist TRUE.

Rückgabewert

Die Höhe der aktuellen Schriftart, die vom Aufsteigenden zum Absteigenden gemessen wird.

AFX_GLOBAL_DATA::GetWICFactory

Gibt einen Zeiger auf die IWICImagingFactory-Schnittstelle zurück, die in den globalen Daten gespeichert ist. Wenn die Schnittstelle nicht initialisiert wurde, wird sie mit den Standardparametern erstellt.

IWICImagingFactory* GetWICFactory();

Rückgabewert

Ein Zeiger auf die IWICImagingFactory-Schnittstelle, wenn die Erstellung einer Factory erfolgreich ist, oder NULL, wenn die Erstellung fehlschlägt oder das aktuelle Operation System keine WIC-Unterstützung hat.

AFX_GLOBAL_DATA::GetWriteFactory

Gibt einen Zeiger auf die IDWriteFactory-Schnittstelle zurück, die in den globalen Daten gespeichert ist. Wenn die Schnittstelle nicht initialisiert wurde, wird sie mit den Standardparametern erstellt.

IDWriteFactory* GetWriteFactory();

Rückgabewert

Ein Zeiger auf die IDWriteFactory-Schnittstelle, wenn die Erstellung einer Factory erfolgreich ist, oder NULL, wenn die Erstellung fehlschlägt oder das aktuelle Betriebssystem keine DirectWrite-Unterstützung aufweist.

AFX_GLOBAL_DATA::InitD2D

Initialisiert D2D-, DirectWrite- und WIC-Fabriken. Rufen Sie diese Methode vor der Initialisierung des Hauptfensters auf.

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

Parameter

d2dFactoryType
Das Threadingmodell der D2D-Factory und der von ihr erstellten Ressourcen.

writeFactoryType
Ein Wert, der angibt, ob das Schreibfactoryobjekt freigegeben oder isoliert wird

Rückgabewert

Gibt WAHR zurück, wenn die Fabriken intilalizrd, FALSE - andernfalls

AFX_GLOBAL_DATA::Is32BitIcons

Gibt an, ob vordefinierte 32-Bit-Symbole unterstützt werden.

BOOL Is32BitIcons() const;

Rückgabewert

TRUE, wenn vordefinierte 32-Bit-Symbole unterstützt werden; andernfalls FALSE.

Hinweise

Diese Methode gibt WAHR zurück, wenn das Framework integrierte 32-Bit-Symbole unterstützt und wenn das Betriebssystem 16 Bit pro Pixel oder mehr unterstützt und Bilder nicht im hohen Kontrast angezeigt werden.

AFX_GLOBAL_DATA::IsAccessibilitySupport

Gibt an, ob Microsoft Active Accessibility-Unterstützung aktiviert ist.

BOOL IsAccessibilitySupport() const;

Rückgabewert

TRUE, wenn die Barrierefreiheitsunterstützung aktiviert ist; andernfalls FALSE.

Hinweise

Microsoft Active Accessibility war die vorherige Lösung zum Ermöglichen des Zugriffs auf Clientanwendungen. Die Microsoft-Benutzeroberflächenautomatisierung ist das neue Zugriffsmodell für Microsoft Windows und richtet sich an die Bedürfnisse von Hilfstechnologieprodukten und automatisierte Testtools.

Verwenden Sie die AFX_GLOBAL_DATA::EnableAccessibilitySupport-Methode, um die Unterstützung für die aktive Barrierefreiheit zu aktivieren oder zu deaktivieren.

AFX_GLOBAL_DATA::IsD2DInitialized

Bestimmt, ob die D2D initialisiert wurde.

BOOL IsD2DInitialized() const;

Rückgabewert

TRUE, wenn D2D initialisiert wurde; andernfalls FALSE.

AFX_GLOBAL_DATA::IsDwmCompositionEnabled

Stellt eine einfache Möglichkeit zum Aufrufen der DwmIsCompositionEnabled -Methode von Windows bereit.

BOOL IsDwmCompositionEnabled();

Rückgabewert

TRUE, wenn die Komposition des Desktopfenster-Managers (DWM) aktiviert ist; andernfalls FALSE.

AFX_GLOBAL_DATA::IsHighContrastMode

Gibt an, ob Bilder nur mit hohem Kontrast angezeigt werden.

BOOL IsHighContrastMode() const;

Rückgabewert

TRUE, wenn Bilder derzeit im Modus mit hohem Kontrast in Schwarz oder Weiß angezeigt werden; andernfalls FALSE.

Hinweise

Im Modus mit hohem Kontrast in Schwarz sind die Ränder, die das Licht zeigen, weiß, und der Hintergrund ist schwarz. Im Modus mit hohem Kontrast in Weiß sind die Ränder, die sich auf das Licht richten, schwarz und der Hintergrund weiß.

AFX_GLOBAL_DATA::IsWindowsLayerSupportAvailable

Gibt an, ob das Betriebssystem überlappende Fenster unterstützt.

BOOL IsWindowsLayerSupportAvailable() const;

Rückgabewert

TRUE, wenn mehrschichtige Fenster unterstützt werden; andernfalls FALSE.

Hinweise

Wenn mehrschichtige Fenster unterstützt werden, verwenden intelligente Dockingmarker mehrschichtige Fenster.

AFX_GLOBAL_DATA::m_bUseBuiltIn32BitIcons

Gibt an, ob das Framework vordefinierte 32-Bit-Farbsymbole oder Symbole mit einer niedrigeren Auflösung verwendet.

BOOL  m_bUseBuiltIn32BitIcons;

Hinweise

TRUE gibt an, dass das Framework 32-Bit-Farbsymbole verwendet; FALSE gibt Symbole mit niedrigerer Auflösung an. Der AFX_GLOBAL_DATA::AFX_GLOBAL_DATA Konstruktor initialisiert dieses Element auf TRUE.

Dieses Element muss beim Starten der Anwendung festgelegt werden.

AFX_GLOBAL_DATA::m_bUseSystemFont

Gibt an, ob eine Systemschriftart für Menüs, Symbolleisten und Menübänder verwendet wird.

BOOL m_bUseSystemFont;

Hinweise

TRUE gibt an, dass eine Systemschriftart verwendet wird; andernfalls FALSE. Der AFX_GLOBAL_DATA::AFX_GLOBAL_DATA Konstruktor initialisiert dieses Element auf FALSE.

Das Testen dieses Elements ist nicht die einzige Möglichkeit für das Framework, die zu verwendende Schriftart zu bestimmen. Die AFX_GLOBAL_DATA::UpdateFonts Methode testet außerdem Standard- und Alternative Schriftarten, um zu bestimmen, welche visuellen Formatvorlagen auf Menüs, Symbolleisten und Menübänder angewendet werden können.

AFX_GLOBAL_DATA::m_hcurHand

Speichert das Handle für den Hand-Cursor.

HCURSOR m_hcurHand;

AFX_GLOBAL_DATA::m_hcurStretch

Speichert das Handle für den horizontalen Streckungs-Cursor.

HCURSOR m_hcurStretch;

AFX_GLOBAL_DATA::m_hcurStretchVert

Speichert das Handle für den vertikalen Streckungs-Cursor.

HCURSOR m_hcurStretchVert;

AFX_GLOBAL_DATA::m_hiconTool

Speichert das Handle für das Werkzeugsymbol.

HICON m_hiconTool;

AFX_GLOBAL_DATA::m_nAutoHideToolBarMargin

Gibt den Offset von der äußerst linken Autohidesymbolleiste auf der linken Seite der Dockleiste an.

int  m_nAutoHideToolBarMargin;

Hinweise

Der AFX_GLOBAL_DATA::AFX_GLOBAL_DATA Konstruktor initialisiert dieses Element auf 4 Pixel.

AFX_GLOBAL_DATA::m_nAutoHideToolBarSpacing

Gibt die Lücke zwischen Symbolleisten zum automatischen Ausblenden an.

int   m_nAutoHideToolBarSpacing;

Hinweise

Der AFX_GLOBAL_DATA::AFX_GLOBAL_DATA Konstruktor initialisiert dieses Element auf 14 Pixel.

AFX_GLOBAL_DATA::m_nDragFrameThicknessDock

Gibt die Stärke des Ziehrahmens an, der verwendet wird, um den angedockten Zustand anzugeben.

int  m_nDragFrameThicknessDock;

Hinweise

Der AFX_GLOBAL_DATA::AFX_GLOBAL_DATA Konstruktor initialisiert dieses Element auf 3 Pixel.

AFX_GLOBAL_DATA::m_nDragFrameThicknessFloat

Gibt die Stärke des Ziehrahmens an, der verwendet wird, um den unverankerten Zustand anzugeben.

int  m_nDragFrameThicknessFloat;

Hinweise

Der AFX_GLOBAL_DATA::AFX_GLOBAL_DATA Konstruktor initialisiert dieses Element auf 4 Pixel.

AFX_GLOBAL_DATA::OnSettingChange

Erkennt den aktuellen Zustand der Funktionen zum automatischen Ausblenden der Menüanimation und Taskleisten auf dem Desktop.

void OnSettingChange();

Hinweise

Diese Methode legt Frameworkvariablen auf den Status bestimmter Attribute des Desktops des Benutzers fest. Diese Methode erkennt den aktuellen Status der Features für Menüanimation, Menüblenden und Automatisches Einblenden der Taskleiste.

AFX_GLOBAL_DATA::RegisterWindowClass

Registriert die angegebene MFC-Fensterklasse.

CString RegisterWindowClass(LPCTSTR lpszClassNamePrefix);

Parameter

lpszClassNamePrefix
[in] Der Name der zu registrierenden Fensterklasse.

Rückgabewert

Der qualifizierte Name der registrierten Klasse, wenn diese Methode erfolgreich ist; andernfalls eine Ressourcen ausnahme.

Hinweise

Der Rückgabewert ist eine durch Doppelpunkt getrennte Liste der lpszClassNamePrefix-Parameterzeichenfolge und die hexadezimalen Textdarstellungen der Handles der aktuellen Anwendungsinstanz; der Anwendungscursor, der Pfeilcursor, dessen Bezeichner IDC_ARROW ist; und der Hintergrundpinsel. Weitere Informationen zum Registrieren von MFC-Fensterklassen finden Sie unter AfxRegisterClass.

AFX_GLOBAL_DATA::Resume

Initialisiert die internen Funktionszeiger für den Zugriff auf Methoden, die Designs und visuelle Stilein Windows unterstützen.

BOOL Resume();

Rückgabewert

TRUE, wenn diese Methode erfolgreich ist; andernfalls FALSE. Im Debugmodus gibt diese Methode an, ob diese Methode nicht erfolgreich ist.

Hinweise

Diese Methode wird aufgerufen, wenn das Framework die WM_POWERBROADCAST Nachricht empfängt.

AFX_GLOBAL_DATA::SetLayeredAttrib

Stellt eine einfache Möglichkeit zum Aufrufen der SetLayeredWindowAttributes -Methode von Windows bereit.

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

Parameter

hwnd
[in] Behandeln sie das überschichtete Fenster.

crKey
[in] Der Transparenzfarbschlüssel, den der Desktopfenster-Manager zum Verfassen des mehrschichtigen Fensters verwendet.

bAlpha
[in] Der Alphawert, der verwendet wird, um die Deckkraft des überschichteten Fensters zu beschreiben.

dwFlags
[in] Eine bitweise Kombination (OR) von Flags, die angeben, welche Methodenparameter verwendet werden sollen. Geben Sie LWA_COLORKEY an, um den crKey-Parameter als Transparenzfarbe zu verwenden. Geben Sie LWA_ALPHA an, um die Deckkraft des überschichteten Fensters mithilfe des bAlpha-Parameters zu bestimmen.

Rückgabewert

TRUE, wenn diese Methode erfolgreich ist; andernfalls FALSE.

AFX_GLOBAL_DATA::SetMenuFont

Erstellt die angegebene logische Schriftart.

BOOL SetMenuFont(
    LPLOGFONT lpLogFont,
    BOOL bHorz);

Parameter

lpLogFont
[in] Zeigen Sie auf eine Struktur, die die Attribute einer Schriftart enthält.

bHorz
[in] TRUE, um anzugeben, dass der Text horizontal ausgeführt wird; FALSE, um anzugeben, dass der Text vertikal ausgeführt wird.

Rückgabewert

TRUE, wenn diese Methode erfolgreich ist; andernfalls FALSE. Im Debugmodus gibt diese Methode an, ob diese Methode nicht erfolgreich ist.

Hinweise

Diese Methode erstellt eine horizontale reguläre Schriftart, eine unterstrichene Schriftart und eine fett formatierte Schriftart, die in Standardmenüelementen verwendet wird. Diese Methode erstellt optional eine normale vertikale Schriftart. Weitere Informationen zu logischen Schriftarten finden Sie unter "CFont::CreateFontIndirect".

AFX_GLOBAL_DATA::UpdateFonts

Initialisiert die logischen Schriftarten erneut, die vom Framework verwendet werden.

void UpdateFonts();

Hinweise

Weitere Informationen zu logischen Schriftarten finden Sie unter CFont::CreateFontIndirect.

AFX_GLOBAL_DATA::UpdateSysColors

Initialisiert die Farben, die Farbtiefe, die Stifte, die Pinsel und die Bilder, die vom Framework verwendet werden.

void UpdateSysColors();

AFX_GLOBAL_DATA::bIsWindows7

Gibt an, ob die Anwendung unter Windows 7 oder höher ausgeführt wird.

BOOL bIsWindows7;

AFX_GLOBAL_DATA::clrActiveCaptionGradient

Gibt die Farbverlaufsfarbe des aktiven Untertitel an. Wird im Allgemeinen für andockbare Bereiche verwendet.

COLORREF clrActiveCaptionGradient;

AFX_GLOBAL_DATA::clrInactiveCaptionGradient

Gibt die Farbverlaufsfarbe der inaktiven Untertitel an. Wird im Allgemeinen für andockbare Bereiche verwendet.

COLORREF clrInactiveCaptionGradient;

AFX_GLOBAL_DATA::GetITaskbarList

Erstellt und speichert in den globalen Daten einen Zeiger auf die ITaskBarList Schnittstelle.

ITaskbarList *GetITaskbarList();

Rückgabewert

Ein Zeiger auf die Schnittstelle, wenn das ITaskbarList Erstellen eines Aufgabenleistenlistenobjekts erfolgreich ist; NULL, wenn die Erstellung fehlschlägt oder das aktuelle Betriebssystem kleiner als Windows 7 ist.

AFX_GLOBAL_DATA::GetITaskbarList3

Erstellt und speichert in den globalen Daten einen Zeiger auf die ITaskBarList3 Schnittstelle.

ITaskbarList3 *GetITaskbarList3();

Rückgabewert

Ein Zeiger auf die Schnittstelle, wenn das ITaskbarList3 Erstellen eines Aufgabenleistenlistenobjekts erfolgreich ist; NULL, wenn die Erstellung fehlschlägt oder das aktuelle Betriebssystem kleiner als Windows 7 ist.

AFX_GLOBAL_DATA::GetShellAutohideBars

Bestimmt Positionen von Leisten zum automatischen Ausblenden einer Shell.

int GetShellAutohideBars();

Rückgabewert

Ein ganzzahliger Wert mit codierten Flags, die Positionen der automatischen Ausblendeleisten angeben. Es kann die folgenden Werte kombinieren: AFX_AUTOHIDE_BOTTOM, AFX_AUTOHIDE_TOP, AFX_AUTOHIDE_LEFT, AFX_AUTOHIDE_RIGHT.

AFX_GLOBAL_DATA::ReleaseTaskBarRefs

Veröffentlicht Schnittstellen, die über die GetITaskbarList und GetITaskbarList3 methoden abgerufen werden.

void ReleaseTaskBarRefs();

AFX_GLOBAL_DATA::ShellCreateItemFromParsingName

Erstellt und initialisiert ein Shellelementobjekt aus einem Analysenamen.

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

Parameter

pszPath
[in] Ein Zeiger auf einen Anzeigenamen.

Pbc
Ein Zeiger auf einen Bindungskontext, der den Analysevorgang steuert.

riid
Ein Verweis auf eine Schnittstellen-ID.

Ppv
[out] Wenn diese Funktion zurückgegeben wird, enthält sie den in riid angeforderten Schnittstellenzeiger. Dies ist in der Regel IShellItem oder IShellItem2.

Rückgabewert

Gibt S_OK zurück, wenn dies erfolgreich ist; andernfalls ein Fehlerwert.

Siehe auch

Hierarchiediagramm
Strukturen, Stile, Rückrufe und Meldungszuordnungen
COLORREF
Teile und Staaten
CDC::D rawText
DrawThemeTextEx
Desktopfenster-Manager
Aktivieren und Steuern der DWM-Komposition
Benutzeroberflächenautomatisierung und Microsoft Active Accessibility
GetSysColor-Funktion
GetSysColorBrush
NONCLIENTMETRICS-Struktur
AfxRegisterClass
AfxThrowResourceException
SetLayeredWindowAttributes