AFX_GLOBAL_DATA 構造体

[アーティクル]
08/04/2024

AFX_GLOBAL_DATA 構造体は、フレームワークを管理するため、またはアプリケーションの外観および動作をカスタマイズするために使用されるフィールドおよびメソッドを格納します。

構文

struct AFX_GLOBAL_DATA

メンバー

パブリックコンストラクター

名前	説明
`AFX_GLOBAL_DATA::AFX_GLOBAL_DATA`	`AFX_GLOBAL_DATA` 構造体を構築します。
`AFX_GLOBAL_DATA::~AFX_GLOBAL_DATA`	デストラクターです。

パブリックメソッド

名前	説明
AFX_GLOBAL_DATA::CleanUp	ブラシ、フォント、DLL など、フレームワークにより割り当てられたリソースを解放します。
AFX_GLOBAL_DATA::D 2D1MakeRotateMatrix	指定した点を中心に指定した角度ずつ回転する回転変換を作成します。
AFX_GLOBAL_DATA::D rawParentBackground	指定領域にコントロールの親の背景を描画します。
AFX_GLOBAL_DATA::D rawTextOnGlass	指定されたテーマの視覚スタイルで、指定されたテキストを描画します。
AFX_GLOBAL_DATA::ExcludeTag	指定された XML タグペアを、指定されたバッファーから削除します。
AFX_GLOBAL_DATA::GetColor	指定されたユーザーインターフェイス要素の現在の色を取得します。
AFX_GLOBAL_DATA::GetDirect2dFactory	グローバルデータに格納されている `ID2D1Factory` インターフェイスへのポインターを返します。インターフェイスが初期化されていない場合は、既定のパラメーターでインターフェイスが作成されます。
AFX_GLOBAL_DATA::GetHandCursor	手の形をした組み込みカーソル (識別子は `IDC_HAND`) を取得します。
AFX_GLOBAL_DATA::GetITaskbarList	ITaskBarList インターフェイスへのポインターを作成し、グローバルデータに格納します。
AFX_GLOBAL_DATA::GetITaskbarList3	ITaskBarList3 インターフェイスへのポインターを作成し、グローバルデータに格納します。
AFX_GLOBAL_DATA::GetNonClientMetrics	最小化されていないウィンドウの非クライアント領域に関連付けられたメトリックを取得します。
AFX_GLOBAL_DATA::GetShellAutohideBars	シェルの自動非表示バーの位置を決定します。
AFX_GLOBAL_DATA::GetTextHeight	現在のフォントのテキスト文字の高さを取得します。
AFX_GLOBAL_DATA::GetWICFactory	グローバルデータに格納されている `IWICImagingFactory` インターフェイスへのポインターを返します。インターフェイスが初期化されていない場合は、既定のパラメーターでインターフェイスが作成されます。
AFX_GLOBAL_DATA::GetWriteFactory	グローバルデータに格納されている `IDWriteFactory` インターフェイスへのポインターを返します。インターフェイスが初期化されていない場合は、既定のパラメーターでインターフェイスが作成されます。
AFX_GLOBAL_DATA::InitD2D	`D2D`、 `DirectWrite`、および `WIC` の各ファクトリを初期化します。このメソッドは、メインウィンドウが初期化される前に呼び出します。
AFX_GLOBAL_DATA::Is32BitIcons	定義済みの 32 ビットアイコンがサポートされているかどうかを示します。
AFX_GLOBAL_DATA::IsD2DInitialized	`D2D` が初期化されているかどうかを調べます。
AFX_GLOBAL_DATA::IsDwmCompositionEnabled	Windows の DwmIsCompositionEnabled のメソッドを簡単な方法で呼び出すことができます。
AFX_GLOBAL_DATA::IsHighContrastMode	イメージが現在、ハイコントラストで表示されているかどうかを判定します。
AFX_GLOBAL_DATA::OnSettingChange	デスクトップのメニューアニメーションとタスクバーの自動非表示機能の現在の状態を検出します。
AFX_GLOBAL_DATA::RegisterWindowClass	指定された MFC ウィンドウクラスを登録します。
AFX_GLOBAL_DATA::ReleaseTaskBarRefs	GetITaskbarList メソッドおよび GetITaskbarList3 メソッドを通じて取得されたインターフェイスを解放します。
AFX_GLOBAL_DATA::Resume	Windows のテーマと視覚スタイルをサポートするメソッドにアクセスする内部関数ポインターを再初期化します。
AFX_GLOBAL_DATA::SetLayeredAttrib	Windows の SetLayeredWindowAttributes メソッドを簡単な方法で呼び出すことができます。
AFX_GLOBAL_DATA::SetMenuFont	指定された論理フォントを作成します。
AFX_GLOBAL_DATA::ShellCreateItemFromParsingName	解析名からシェル項目オブジェクトを作成して初期化します。
AFX_GLOBAL_DATA::UpdateFonts	フレームワークにより使用される論理フォントを再初期化します。
AFX_GLOBAL_DATA::UpdateSysColors	フレームワークで使用される色、色深度、ブラシ、ペン、およびイメージを初期化します。

保護メソッド

名前	説明
AFX_GLOBAL_DATA::EnableAccessibilitySupport	Microsoft Active Accessibility のサポートを有効または無効にします。 Active Accessibility は、ユーザーインターフェイス要素に関する情報を公開するための信頼できる方法を提供します。
AFX_GLOBAL_DATA::IsAccessibilitySupport	Microsoft Active Accessibility のサポートが有効かどうかを示します。
AFX_GLOBAL_DATA::IsWindowsLayerSupportAvailable	オペレーティングシステムがレイヤードウィンドウをサポートするかどうかを示します。

データメンバー

名前	説明
AFX_GLOBAL_DATA::bIsOSAlphaBlendingSupport	現在のオペレーティングシステムがアルファブレンドをサポートするかどうかを示します。
AFX_GLOBAL_DATA::bIsWindows7	アプリケーションが Windows 7 OS 以上で実行されているかどうかを示します。
AFX_GLOBAL_DATA::clrActiveCaptionGradient	アクティブなキャプションのグラデーションの色を指定します。通常、ドッキングペインで使用されます。
AFX_GLOBAL_DATA::clrInactiveCaptionGradient	アクティブでないキャプションのグラデーションの色を指定します。通常、ドッキングペインで使用されます。
AFX_GLOBAL_DATA::m_bUseBuiltIn32BitIcons	事前定義された 32 ビットカラーアイコンと低解像度のアイコンのどちらをフレームワークで使用するかを指定します。
AFX_GLOBAL_DATA::m_bUseSystemFont	メニュー、ツールバー、およびリボンに対してシステムフォントが使用されるかどうかを示します。
AFX_GLOBAL_DATA::m_hcurHand	手の形のカーソルのハンドルを格納します。
AFX_GLOBAL_DATA::m_hcurStretch	水平方向の伸縮カーソルのハンドルを格納します。
AFX_GLOBAL_DATA::m_hcurStretchVert	垂直方向の伸縮カーソルのハンドルを格納します。
AFX_GLOBAL_DATA::m_hiconTool	ツールアイコンのハンドルを格納します。
AFX_GLOBAL_DATA::m_nAutoHideToolBarMargin	左端の自動的に隠すツールバーからドッキングバーの左側までのオフセットを指定します。
AFX_GLOBAL_DATA::m_nAutoHideToolBarSpacing	自動的に隠すツールバーの間の間隔を指定します。
AFX_GLOBAL_DATA::m_nDragFrameThicknessDock	ドッキング状態を知らせるのに使用するドラッグフレームの幅を指定します。
AFX_GLOBAL_DATA::m_nDragFrameThicknessFloat	フローティング状態を知らせるのに使用するドラッグフレームの幅を指定します。

解説

AFX_GLOBAL_DATA 構造体内のデータのほとんどは、アプリケーションの起動時に初期化されます。

継承階層

AFX_GLOBAL_DATA

要件

ヘッダー : afxglobals.h

AFX_GLOBAL_DATA::bIsOSAlphaBlendingSupport

オペレーティングシステムがアルファブレンドをサポートしているかどうかを示します。

BOOL  bIsOSAlphaBlendingSupport;

解説

TRUE はアルファブレンドがサポートされていることを示します。それ以外の場合は FALSE。

AFX_GLOBAL_DATA::CleanUp

ブラシ、フォント、DLL など、フレームワークにより割り当てられたリソースを解放します。

void CleanUp();

AFX_GLOBAL_DATA::D 2D1MakeRotateMatrix

指定した点を中心に指定した角度ずつ回転する回転変換を作成します。

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

パラメーター

angle
時計回りの回転角度 (度単位)。

center
回転する点。

行列
このメソッドが戻るときに、新しい回転変換を格納します。このパラメーターにはストレージを割り当てる必要があります。

戻り値

成功した場合はS_OKを返し、それ以外の場合はエラー値を返します。

AFX_GLOBAL_DATA::D rawParentBackground

指定領域にコントロールの親の背景を描画します。

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

パラメーター

pWnd
[in]コントロールのウィンドウへのポインター。

pDC
[in]デバイスコンテキストへのポインター。

lpRect
[in]描画する領域を囲む四角形へのポインター。既定値は NULL です。

戻り値

このメソッドが成功した場合は TRUE。それ以外の場合は FALSE。

AFX_GLOBAL_DATA::D rawTextOnGlass

指定されたテーマの視覚スタイルで、指定されたテキストを描画します。

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

パラメーター

hTheme
[in]ウィンドウのテーマデータ (NULL) を処理します。このパラメーターが NULL ではなく、テーマがサポートされている場合、フレームワークは指定されたテーマを使用してテキストを描画します。それ以外の場合、フレームワークは、テーマを使用せずにテキストを描画します。

HTHEME を作成するには、 OpenThemeData メソッドを使用します。

pDC
[in]デバイスコンテキストへのポインター。

iPartId
[in]目的のテキストの外観を持つコントロールパーツ。詳細については、「 Parts and States (パーツと状態)」の表の「Parts (パーツ)」列を参照してください。この値が 0 の場合、テキストは既定のフォント、またはデバイスコンテキストに選択されているフォントで描画されます。

iStateId
[in]目的のテキストの外観を持つコントロールの状態。詳細については、「 Parts and States (パーツと状態)」の表の「States (状態)」列を参照してください。

strText
[in]描画するテキスト。

rect
[in]指定したテキストが描画される領域の境界。

dwFlags
[in]指定したテキストの描画方法を指定するフラグのビットごとの組み合わせ (OR)。

hTheme パラメーターがNULLされている場合、またはテーマがサポートおよび有効になっていない場合、CDC::D rawText メソッドの nFormat パラメーターは有効なフラグを記述します。テーマがサポートされている場合、DrawThemeTextEx メソッドの dwFlags パラメーターは有効なフラグを記述します。

nGlowSize
[in]指定したテキストを描画する前に背景に描画される光彩効果のサイズ。既定値は0です。

clrText
[in]指定したテキストが描画される色。既定値は既定の色です。

戻り値

指定したテキストを描画するためにテーマを使用する場合は TRUE。それ以外の場合は FALSE。

解説

テーマは、アプリケーションの視覚スタイルを定義します。 hTheme パラメーターが NULL の場合、または DrawThemeTextEx メソッドがサポートされていない場合、またはDesktop Window Manager (DWM) コンポジション無効になっている場合は、テーマを使用してテキストを描画しません。

AFX_GLOBAL_DATA::EnableAccessibilitySupport

Microsoft Active Accessibility のサポートを有効または無効にします。

void EnableAccessibilitySupport(BOOL bEnable=TRUE);

パラメーター

bEnable
[in]アクセシビリティサポートを有効にする場合は TRUE。アクセシビリティサポートを無効にする場合は FALSE。既定値は TRUE です。

解説

Active Accessibility は、プログラムと Windows オペレーティングシステムが支援技術製品と連携する方法を改善する COM ベースのテクノロジです。ユーザーインターフェイス要素に関する情報を公開するための信頼性の高いメソッドが提供されます。ただし、Microsoft UI オートメーションと呼ばれる新しいアクセシビリティモデルが利用できるようになりました。 2 つのテクノロジの比較については、「UI オートメーションと Microsoft Active Accessibility」を参照してください。

AFX_GLOBAL_DATA::IsAccessibilitySupport メソッドを使用して、Microsoft Active Accessibility サポートが有効になっているかどうかを確認します。

AFX_GLOBAL_DATA::ExcludeTag

指定された XML タグペアを、指定されたバッファーから削除します。

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

パラメーター

strBuffer
[in]テキストのバッファー。

lpszTag
[in]開く XML タグと終了 XML タグのペアの名前。

strTag
[out]このメソッドから制御が戻るときに、 strTag パラメーターには、 lpszTag パラメーターによって名前が付けられた開始 XML タグと終了 XML タグの間にあるテキストが含まれます。先頭または末尾の空白は結果からトリミングされます。

bIsCharsList
[in]true を指定すると、 strTag パラメーター内のエスケープ文字のシンボルが実際のエスケープ文字に変換されます。変換を実行しない場合は FALSE。既定値は FALSE です。詳細については、「解説」を参照してください。

戻り値

このメソッドが成功した場合は TRUE。それ以外の場合は FALSE。

解説

XML タグペアは、指定されたバッファー内のテキストの実行の開始と終了を示す名前付きの開始タグと終了タグで構成されます。 strBuffer パラメーターはバッファーを指定し、lpszTag パラメーターは XML タグの名前を指定します。

次の表の記号を使用して、指定したバッファー内のエスケープ文字のセットをエンコードします。 strTag パラメーターのシンボルを実際のエスケープ文字に変換するには、bIsCharsList パラメーターに TRUE を指定します。次の表では、 _T() マクロを使用して、記号とエスケープ文字列を指定します。

記号	エスケープ文字
_T("\\t")	_T("\t")
_T("\\n")	_T("\n")
_T("\\r")	_T("\r")
_T("\\b")	_T("\b")
_T("LT")	_T("<")
_T("GT")	_T(">")
_T("AMP")	_T(">)

AFX_GLOBAL_DATA::GetColor

指定されたユーザーインターフェイス要素の現在の色を取得します。

COLORREF GetColor(int nColor);

パラメーター

nColor
[in]色を取得するユーザーインターフェイス要素を指定する値。有効な値の一覧については、GetSysColor メソッドの nIndex パラメーターを参照してください。

戻り値

指定したユーザーインターフェイス要素の RGB 色の値。詳細については、「解説」を参照してください。

解説

nColor パラメーターが範囲外の場合、戻り値は 0 です。 0 も有効な RGB 値であるため、このメソッドを使用して、システムの色が現在のオペレーティングシステムでサポートされているかどうかを判断することはできません。代わりに、 GetSysColorBrush メソッドを使用します。このメソッドは、色がサポートされていない場合は NULL を返します。

AFX_GLOBAL_DATA::GetDirect2dFactory

グローバルデータに格納されている ID2D1Factory インターフェイスへのポインターを返します。インターフェイスが初期化されていない場合は、既定のパラメーターでインターフェイスが作成されます。

ID2D1Factory* GetDirect2dFactory();

戻り値

ファクトリの作成が成功した場合は ID2D1Factory インターフェイスへのポインター。作成が失敗した場合、または現在のオペレーションシステムで D2D がサポートされていない場合は NULL。

AFX_GLOBAL_DATA::GetHandCursor

手に似た、識別子がIDC_HANDされている定義済みのカーソルを取得します。

HCURSOR GetHandCursor();

戻り値

手カーソルのハンドル。

AFX_GLOBAL_DATA::GetNonClientMetrics

最小化されていないウィンドウの非クライアント領域に関連付けられたメトリックを取得します。

BOOL GetNonClientMetrics(NONCLIENTMETRICS& info);

パラメーター

info
[入力、出力] NONCLIENTMETRICS 非ミニサイズウィンドウの非クライアント領域に関連付けられたスケーラブルなメトリックを格納する構造体。

戻り値

このメソッドが成功した場合は TRUE。それ以外の場合は FALSE。

AFX_GLOBAL_DATA::GetTextHeight

現在のフォントのテキスト文字の高さを取得します。

int GetTextHeight(BOOL bHorz = TRUE);

パラメーター

bHorz
[in]テキストが水平方向に実行されるときに文字の高さを取得する場合は TRUE。テキストが垂直方向に実行されるときに文字の高さを取得する場合は FALSE。既定値は TRUE です。

戻り値

現在のフォントの高さ。アセンダーから降順に測定されます。

AFX_GLOBAL_DATA::GetWICFactory

グローバルデータに格納されている IWICImagingFactory インターフェイスへのポインターを返します。インターフェイスが初期化されていない場合は、既定のパラメーターでインターフェイスが作成されます。

IWICImagingFactory* GetWICFactory();

戻り値

ファクトリの作成が成功した場合は IWICImagingFactory インターフェイスへのポインター。作成が失敗した場合、または現在のオペレーションシステムで WIC がサポートされていない場合は NULL。

AFX_GLOBAL_DATA::GetWriteFactory

グローバルデータに格納されている IDWriteFactory インターフェイスへのポインターを返します。インターフェイスが初期化されていない場合は、既定のパラメーターでインターフェイスが作成されます。

IDWriteFactory* GetWriteFactory();

戻り値

ファクトリの作成が成功した場合は IDWriteFactory インターフェイスへのポインター。作成が失敗した場合、または現在のオペレーションシステムで DirectWrite がサポートされていない場合は NULL。

AFX_GLOBAL_DATA::InitD2D

D2D、DirectWrite、WIC ファクトリを初期化します。このメソッドは、メインウィンドウが初期化される前に呼び出します。

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

パラメーター

d2dFactoryType
D2D ファクトリのスレッドモデルと、それが作成するリソース。

writeFactoryType
書き込みファクトリオブジェクトを共有するか分離するかを指定する値

戻り値

ファクトリが intilalizrd であった場合は TRUE、それ以外の場合は FALSE を返します。

AFX_GLOBAL_DATA::Is32BitIcons

定義済みの 32 ビットアイコンがサポートされているかどうかを示します。

BOOL Is32BitIcons() const;

戻り値

定義済みの 32 ビットアイコンがサポートされている場合は TRUE。それ以外の場合は FALSE。

解説

フレームワークが 32 ビットの組み込みアイコンをサポートしている場合、およびオペレーティングシステムがピクセルあたり 16 ビット以上をサポートしている場合、およびイメージがハイコントラストで表示されない場合、このメソッドは TRUE を返します。

AFX_GLOBAL_DATA::IsAccessibilitySupport

Microsoft Active Accessibility のサポートが有効かどうかを示します。

BOOL IsAccessibilitySupport() const;

戻り値

アクセシビリティサポートが有効な場合は TRUE。それ以外の場合は FALSE。

解説

Microsoft Active Accessibility は、アプリケーションをアクセス可能にするための以前のソリューションでした。 Microsoft UI オートメーションは Microsoft Windows の新しいアクセシビリティモデルであり、その目的は支援技術製品と自動テストツールのニーズを解決することです。

active Accessibility サポートを有効または無効にするには、 AFX_GLOBAL_DATA::EnableAccessibilitySupport メソッドを使用します。

AFX_GLOBAL_DATA::IsD2DInitialized

D2D が初期化されたかどうかを判断します

BOOL IsD2DInitialized() const;

戻り値

D2D が初期化された場合は TRUE。それ以外の場合は FALSE。

AFX_GLOBAL_DATA::IsDwmCompositionEnabled

Windows の DwmIsCompositionEnabled のメソッドを簡単な方法で呼び出すことができます。

BOOL IsDwmCompositionEnabled();

戻り値

Desktop Window Manager (DWM) コンポジションが有効な場合は TRUE。それ以外の場合は FALSE。

AFX_GLOBAL_DATA::IsHighContrastMode

イメージが現在、ハイコントラストで表示されているかどうかを判定します。

BOOL IsHighContrastMode() const;

戻り値

イメージが現在黒または白のハイコントラストモードで表示されている場合は TRUE。それ以外の場合は FALSE。

解説

黒ハイコントラストモードでは、ライトに面するエッジは白で、背景は黒です。白ハイコントラストモードでは、ライトに面するエッジは黒で、背景は白です。

AFX_GLOBAL_DATA::IsWindowsLayerSupportAvailable

オペレーティングシステムがレイヤードウィンドウをサポートするかどうかを示します。

BOOL IsWindowsLayerSupportAvailable() const;

戻り値

階層化ウィンドウがサポートされている場合は TRUE。それ以外の場合は FALSE。

解説

レイヤードウィンドウがサポートされている場合は、 スマートドッキング マーカーでレイヤーウィンドウが使用されます。

AFX_GLOBAL_DATA::m_bUseBuiltIn32BitIcons

事前定義された 32 ビットカラーアイコンと低解像度のアイコンのどちらをフレームワークで使用するかを指定します。

BOOL  m_bUseBuiltIn32BitIcons;

解説

TRUE は、フレームワークが 32 ビットカラーアイコンを使用することを指定します。FALSE は、解像度の低いアイコンを指定します。 AFX_GLOBAL_DATA::AFX_GLOBAL_DATA コンストラクターは、このメンバーを TRUE に初期化します。

このメンバーは、アプリケーションの起動時に設定する必要があります。

AFX_GLOBAL_DATA::m_bUseSystemFont

メニュー、ツールバー、およびリボンに対してシステムフォントが使用されるかどうかを示します。

BOOL m_bUseSystemFont;

解説

TRUE は、システムフォントを使用することを指定します。それ以外の場合は FALSE。 AFX_GLOBAL_DATA::AFX_GLOBAL_DATA コンストラクターは、このメンバーを FALSE に初期化します。

このメンバーのテストは、フレームワークが使用するフォントを決定する唯一の方法ではありません。 AFX_GLOBAL_DATA::UpdateFontsメソッドでは、既定のフォントと代替フォントもテストして、メニュー、ツールバー、リボンに適用できるビジュアルスタイルを決定します。

AFX_GLOBAL_DATA::m_hcurHand

手の形のカーソルのハンドルを格納します。

HCURSOR m_hcurHand;

AFX_GLOBAL_DATA::m_hcurStretch

水平方向の伸縮カーソルのハンドルを格納します。

HCURSOR m_hcurStretch;

AFX_GLOBAL_DATA::m_hcurStretchVert

垂直方向の伸縮カーソルのハンドルを格納します。

HCURSOR m_hcurStretchVert;

AFX_GLOBAL_DATA::m_hiconTool

ツールアイコンのハンドルを格納します。

HICON m_hiconTool;

AFX_GLOBAL_DATA::m_nAutoHideToolBarMargin

左端の自動非表示ツールバーからドックバーの左側までのオフセットを指定します。

int  m_nAutoHideToolBarMargin;

解説

AFX_GLOBAL_DATA::AFX_GLOBAL_DATA コンストラクターは、このメンバーを 4 ピクセルに初期化します。

AFX_GLOBAL_DATA::m_nAutoHideToolBarSpacing

自動的に隠すツールバーの間の間隔を指定します。

int   m_nAutoHideToolBarSpacing;

解説

AFX_GLOBAL_DATA::AFX_GLOBAL_DATA コンストラクターは、このメンバーを 14 ピクセルに初期化します。

AFX_GLOBAL_DATA::m_nDragFrameThicknessDock

ドッキング状態を示すために使用するドラッグフレームの太さを指定します。

int  m_nDragFrameThicknessDock;

解説

AFX_GLOBAL_DATA::AFX_GLOBAL_DATA コンストラクターは、このメンバーを 3 ピクセルに初期化します。

AFX_GLOBAL_DATA::m_nDragFrameThicknessFloat

フローティング状態を示すために使用されるドラッグフレームの太さを指定します。

int  m_nDragFrameThicknessFloat;

解説

AFX_GLOBAL_DATA::AFX_GLOBAL_DATA コンストラクターは、このメンバーを 4 ピクセルに初期化します。

AFX_GLOBAL_DATA::OnSettingChange

デスクトップのメニューアニメーションとタスクバーの自動非表示機能の現在の状態を検出します。

void OnSettingChange();

解説

このメソッドは、フレームワーク変数をユーザーのデスクトップの特定の属性の状態に設定します。このメソッドは、メニューアニメーション、メニューフェード、タスクバーの自動非表示機能の現在の状態を検出します。

AFX_GLOBAL_DATA::RegisterWindowClass

指定された MFC ウィンドウクラスを登録します。

CString RegisterWindowClass(LPCTSTR lpszClassNamePrefix);

パラメーター

lpszClassNamePrefix
[in]登録するウィンドウクラスの名前。

戻り値

このメソッドが成功した場合の登録済みクラスの修飾名。それ以外の場合は、リソース例外。

解説

戻り値は、 lpszClassNamePrefix パラメーター文字列のコロンで区切られたリスト、および現在のアプリケーションインスタンスのハンドルの 16 進テキスト表現です。アプリケーションカーソルは、識別子がIDC_ARROW矢印カーソル、および背景ブラシです。 MFC ウィンドウクラスの登録の詳細については、「 AfxRegisterClassを参照してください。

AFX_GLOBAL_DATA::Resume

Windows のテーマと視覚スタイルをサポートするメソッドにアクセスする内部関数ポインターを再初期化します。

BOOL Resume();

戻り値

このメソッドが成功した場合は TRUE。それ以外の場合は FALSE。デバッグモードでは、このメソッドは、このメソッドが失敗した場合にアサートします。

解説

このメソッドは、フレームワークが WM_POWERBROADCAST メッセージを受信したときに呼び出されます。

AFX_GLOBAL_DATA::SetLayeredAttrib

Windows の SetLayeredWindowAttributes メソッドを簡単な方法で呼び出すことができます。

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

パラメーター

hwnd
[in]階層化されたウィンドウへのハンドル。

crKey
[in] Desktop ウィンドウマネージャーが階層化されたウィンドウを構成するために使用する透明度の色キー。

bAlpha
[in]レイヤードウィンドウの不透明度を表すために使用されるアルファ値。

dwFlags
[in]使用するメソッドパラメーターを指定するフラグのビットごとの組み合わせ (OR)。透明度の色として crKey パラメーターを使用するLWA_COLORKEYを指定します。 bAlpha パラメーターを使用してレイヤーウィンドウの不透明度を決定するLWA_ALPHAを指定します。

戻り値

このメソッドが成功した場合は TRUE。それ以外の場合は FALSE。

AFX_GLOBAL_DATA::SetMenuFont

指定された論理フォントを作成します。

BOOL SetMenuFont(
    LPLOGFONT lpLogFont,
    BOOL bHorz);

パラメーター

lpLogFont
[in]フォントの属性を含む構造体へのポインター。

bHorz
[in]テキストが水平方向に実行されることを指定する場合は TRUE。テキストが垂直方向に実行されることを指定する場合は FALSE。

戻り値

解説

このメソッドは、水平標準フォント、下線付きフォント、および既定のメニュー項目で使用される太字のフォントを作成します。このメソッドは、必要に応じて通常の垂直フォントを作成します。論理フォントの詳細については、「 CFont::CreateFontIndirect」を参照してください。

AFX_GLOBAL_DATA::UpdateFonts

フレームワークにより使用される論理フォントを再初期化します。

void UpdateFonts();

解説

論理フォントの詳細については、「 CFont::CreateFontIndirect」を参照してください。

AFX_GLOBAL_DATA::UpdateSysColors

フレームワークで使用される色、色深度、ブラシ、ペン、およびイメージを初期化します。

void UpdateSysColors();

AFX_GLOBAL_DATA::bIsWindows7

アプリケーションが Windows 7 以降で実行されているかどうかを示します。

BOOL bIsWindows7;

AFX_GLOBAL_DATA::clrActiveCaptionGradient

アクティブなキャプションのグラデーションの色を指定します。通常、ドッキングペインで使用されます。

COLORREF clrActiveCaptionGradient;

AFX_GLOBAL_DATA::clrInactiveCaptionGradient

非アクティブなキャプションのグラデーションの色を指定します。通常、ドッキングペインで使用されます。

COLORREF clrInactiveCaptionGradient;

AFX_GLOBAL_DATA::GetITaskbarList

グローバルデータを作成し、 ITaskBarList インターフェイスへのポインターを格納します。

ITaskbarList *GetITaskbarList();

戻り値

タスクバーリストオブジェクトの作成が成功した場合の ITaskbarList インターフェイスへのポインター。作成に失敗した場合、または現在のオペレーションシステムが Windows 7 未満の場合は NULL。

AFX_GLOBAL_DATA::GetITaskbarList3

グローバルデータを作成し、 ITaskBarList3 インターフェイスへのポインターを格納します。

ITaskbarList3 *GetITaskbarList3();

戻り値

タスクバーリストオブジェクトの作成が成功した場合の ITaskbarList3 インターフェイスへのポインター。作成に失敗した場合、または現在のオペレーションシステムが Windows 7 未満の場合は NULL。

AFX_GLOBAL_DATA::GetShellAutohideBars

シェルの自動非表示バーの位置を決定します。

int GetShellAutohideBars();

戻り値

自動非表示バーの位置を指定するエンコードされたフラグを持つ整数値。 AFX_AUTOHIDE_BOTTOM、AFX_AUTOHIDE_TOP、AFX_AUTOHIDE_LEFT、AFX_AUTOHIDE_RIGHTの値を組み合わせることができます。

AFX_GLOBAL_DATA::ReleaseTaskBarRefs

GetITaskbarListメソッドと GetITaskbarList3 メソッドを使用して取得したインターフェイスを解放します。

void ReleaseTaskBarRefs();

AFX_GLOBAL_DATA::ShellCreateItemFromParsingName

解析名からシェル項目オブジェクトを作成して初期化します。

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

パラメーター

pszPath
[in]表示名へのポインター。

pbc
解析操作を制御するバインドコンテキストへのポインター。

riid
インターフェイス ID に対する参照。

ppv
[out]この関数が戻るときに、 riid で要求されたインターフェイスポインターを格納します。通常、これは IShellItem または IShellItem2です。

戻り値

成功した場合はS_OKを返します。それ以外の場合はエラー値。

次の方法で共有

AFX_GLOBAL_DATA 構造体

構文

メンバー

パブリック コンストラクター

パブリック メソッド

保護メソッド

データ メンバー

解説

継承階層

要件

AFX_GLOBAL_DATA::bIsOSAlphaBlendingSupport

解説

AFX_GLOBAL_DATA::CleanUp

AFX_GLOBAL_DATA::D 2D1MakeRotateMatrix

パラメーター

戻り値

AFX_GLOBAL_DATA::D rawParentBackground

パラメーター

戻り値

AFX_GLOBAL_DATA::D rawTextOnGlass

パラメーター

戻り値

解説

AFX_GLOBAL_DATA::EnableAccessibilitySupport

パラメーター

解説

AFX_GLOBAL_DATA::ExcludeTag

パラメーター

戻り値

解説

AFX_GLOBAL_DATA::GetColor

パラメーター

戻り値

解説

AFX_GLOBAL_DATA::GetDirect2dFactory

戻り値

AFX_GLOBAL_DATA::GetHandCursor

戻り値

AFX_GLOBAL_DATA::GetNonClientMetrics

パラメーター

戻り値

AFX_GLOBAL_DATA::GetTextHeight

パラメーター

戻り値

AFX_GLOBAL_DATA::GetWICFactory

戻り値

AFX_GLOBAL_DATA::GetWriteFactory

戻り値

AFX_GLOBAL_DATA::InitD2D

パラメーター

戻り値

AFX_GLOBAL_DATA::Is32BitIcons

戻り値

解説

AFX_GLOBAL_DATA::IsAccessibilitySupport

戻り値

解説

AFX_GLOBAL_DATA::IsD2DInitialized

戻り値

AFX_GLOBAL_DATA::IsDwmCompositionEnabled

戻り値

AFX_GLOBAL_DATA::IsHighContrastMode

戻り値

解説

AFX_GLOBAL_DATA::IsWindowsLayerSupportAvailable

戻り値

解説

AFX_GLOBAL_DATA::m_bUseBuiltIn32BitIcons

解説

AFX_GLOBAL_DATA::m_bUseSystemFont

解説

AFX_GLOBAL_DATA::m_hcurHand

AFX_GLOBAL_DATA::m_hcurStretch

AFX_GLOBAL_DATA::m_hcurStretchVert

AFX_GLOBAL_DATA::m_hiconTool

AFX_GLOBAL_DATA::m_nAutoHideToolBarMargin

解説

AFX_GLOBAL_DATA::m_nAutoHideToolBarSpacing

解説

パブリックコンストラクター

パブリックメソッド

データメンバー