AFX_GLOBAL_DATA 構造体

[アーティクル]
07/19/2022

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::D2D1MakeRotateMatrix	指定した点を中心に指定した角度ずつ回転する回転変換を作成します。
AFX_GLOBAL_DATA::DrawParentBackground	指定領域にコントロールの親の背景を描画します。
AFX_GLOBAL_DATA::DrawTextOnGlass	指定されたテーマの視覚スタイルで、指定されたテキストを描画します。
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::D2D1MakeRotateMatrix

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

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

パラメーター

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

センター
回転するポイント。

matrix
このメソッドから制御が戻った時点で、新しい回転変換が格納されます。このパラメーターにはストレージを割り当てる必要があります。

戻り値

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

AFX_GLOBAL_DATA::DrawParentBackground

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

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

パラメーター

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

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

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

戻り値

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

AFX_GLOBAL_DATA::DrawTextOnGlass

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

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 ではなく、テーマがサポートされている場合、フレームワークは指定されたテーマを使用してテキストを描画します。それ以外の場合、フレームワークは、テーマを使用せずにテキストを描画します。

OpenThemeData メソッドを使用して HTHEME を作成します。

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

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

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

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

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

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

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

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

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

戻り値

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

注釈

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

AFX_GLOBAL_DATA::EnableAccessibilitySupport

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

void EnableAccessibilitySupport(BOOL bEnable=TRUE);

パラメーター

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

Remarks

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

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

AFX_GLOBAL_DATA::ExcludeTag

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

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

パラメーター

strBuffer
からテキストのバッファー。

lpszTag
からXML の開始タグと終了タグのペアの名前。

strTag
入出力このメソッドから制御が戻るときに、 Strtag パラメーターには、 lpsztag パラメーターによって指定された開始 XML タグと終了 XML タグの間のテキストが含まれます。先頭または末尾の空白は、結果から削除されます。

bIsCharsList
から Strtag パラメーターのエスケープ文字のシンボルを実際のエスケープ文字に変換する場合は TRUE。変換を実行しない場合は FALSE。既定値は FALSE です。詳細については、「解説」を参照してください。

戻り値

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

注釈

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

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

Symbol	エスケープ文字
_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
から色を取得するユーザーインターフェイス要素を指定する値。有効な値の一覧については、「 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
[入力、出力]最小化されていないウィンドウの非クライアント領域に関連付けられているスケーラブルなメトリックを含む非 Clientmetrics 構造体。

戻り値

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

AFX_GLOBAL_DATA::GetTextHeight

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

int GetTextHeight(BOOL bHorz = TRUE);

パラメーター

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

戻り値

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

AFX_GLOBAL_DATA::GetWICFactory

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

IWICImagingFactory* GetWICFactory();

戻り値

ファクトリの作成が成功した場合は IWICImagingFactory インターフェイスへのポインター。作成に失敗した場合は NULL、現在の操作システムには 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 の新しいアクセシビリティモデルであり、その目的は支援技術製品と自動テストツールのニーズを解決することです。

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

AFX_GLOBAL_DATA::IsD2DInitialized

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

BOOL IsD2DInitialized() const;

戻り値

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

AFX_GLOBAL_DATA::IsDwmCompositionEnabled

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

BOOL IsDwmCompositionEnabled();

戻り値

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]レイヤードウィンドウを構成するためにデスクトップウィンドウマネージャーが使用する透明度カラーキー。

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

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

戻り値

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

AFX_GLOBAL_DATA::SetMenuFont

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

BOOL SetMenuFont(
    LPLOGFONT lpLogFont,
    BOOL bHorz);

パラメーター

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

bHorz
[in]テキストを水平方向に実行する場合は TRUE。テキストを垂直方向に実行する場合は FALSE。

戻り値

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

注釈

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

AFX_GLOBAL_DATA::UpdateFonts

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

void UpdateFonts();

注釈

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

AFX_GLOBAL_DATA::UpdateSysColors

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

void UpdateSysColors();

AFX_GLOBAL_DATA::bIsWindows7

アプリケーションが 7 以上で実行Windows示します。

BOOL bIsWindows7;

AFX_GLOBAL_DATA::clrActiveCaptionGradient

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

COLORREF clrActiveCaptionGradient;

AFX_GLOBAL_DATA::clrInactiveCaptionGradient

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

COLORREF clrInactiveCaptionGradient;

AFX_GLOBAL_DATA::GetITaskbarList

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

ITaskbarList *GetITaskbarList();

戻り値

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

AFX_GLOBAL_DATA::GetITaskbarList3

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

ITaskbarList3 *GetITaskbarList3();

戻り値

タスクバーリストオブジェクトITaskbarList3の作成が成功した場合のインターフェイスへのポインター。作成に失敗した場合、または現在の操作システムが 7 未満の場合Windows 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::D2D1MakeRotateMatrix

パラメーター

戻り値

AFX_GLOBAL_DATA::DrawParentBackground

パラメーター

戻り値

AFX_GLOBAL_DATA::DrawTextOnGlass

パラメーター

戻り値

注釈

AFX_GLOBAL_DATA::EnableAccessibilitySupport

パラメーター

Remarks

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

注釈

AFX_GLOBAL_DATA::m_nDragFrameThicknessDock

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

パブリックメソッド

プロテクトメソッド

データメンバー