Struktur AFX_GLOBAL_DATA

Struktur AFX_GLOBAL_DATA berisi bidang dan metode yang digunakan untuk mengelola kerangka kerja atau menyesuaikan tampilan dan perilaku aplikasi Anda.

Sintaks

struct AFX_GLOBAL_DATA

Anggota

Konstruktor Publik

Nama	Deskripsi
`AFX_GLOBAL_DATA::AFX_GLOBAL_DATA`	Membangun `AFX_GLOBAL_DATA` struktur.
`AFX_GLOBAL_DATA::~AFX_GLOBAL_DATA`	Destruktor.

Metode Publik

Nama	Deskripsi
AFX_GLOBAL_DATA::Pembersihan	Merilis sumber daya yang dialokasikan oleh kerangka kerja, seperti kuas, font, dan DLL.
AFX_GLOBAL_DATA::D 2D1MakeRotateMatrix	Membuat transformasi rotasi yang diputar oleh sudut tertentu di sekitar titik tertentu.
AFX_GLOBAL_DATA::D rawParentBackground	Menggambar latar belakang induk kontrol di area yang ditentukan.
AFX_GLOBAL_DATA::D rawTextOnGlass	Menggambar teks yang ditentukan dalam gaya visual tema yang ditentukan.
AFX_GLOBAL_DATA::ExcludeTag	Menghapus pasangan tag XML yang ditentukan dari buffer tertentu.
AFX_GLOBAL_DATA::GetColor	Mengambil warna saat ini dari elemen antarmuka pengguna yang ditentukan.
AFX_GLOBAL_DATA::GetDirect2dFactory	Mengembalikan penunjuk ke `ID2D1Factory` antarmuka yang disimpan dalam data global. Jika antarmuka tidak diinisialisasi, antarmuka dibuat dan memiliki parameter default.
AFX_GLOBAL_DATA::GetHandCursor	Mengambil kursor yang telah ditentukan sebelumnya yang menyerupan tangan dan yang pengidentifikasinya adalah `IDC_HAND`.
AFX_GLOBAL_DATA::GetITaskbarList	Membuat dan menyimpan dalam data global penunjuk ke antarmuka ITaskBarList.
AFX_GLOBAL_DATA::GetITaskbarList3	Membuat dan menyimpan dalam data global penunjuk ke antarmuka ITaskBarList3.
AFX_GLOBAL_DATA::GetNonClientMetrics	Mengambil metrik yang terkait dengan area nonclient dari jendela yang tidak diminimalkan.
AFX_GLOBAL_DATA::GetShellAutohideBars	Menentukan posisi Bilah sembunyi otomatis Shell.
AFX_GLOBAL_DATA::GetTextHeight	Mengambil tinggi karakter teks dalam font saat ini.
AFX_GLOBAL_DATA::GetWICFactory	Mengembalikan penunjuk ke `IWICImagingFactory` antarmuka yang disimpan dalam data global. Jika antarmuka tidak diinisialisasi, antarmuka dibuat dan memiliki parameter default.
AFX_GLOBAL_DATA::GetWriteFactory	Mengembalikan penunjuk ke `IDWriteFactory` antarmuka yang disimpan dalam data global. Jika antarmuka tidak diinisialisasi, antarmuka dibuat dan memiliki parameter default.
AFX_GLOBAL_DATA::InitD2D	Menginisialisasi `D2D`pabrik , `DirectWrite`, dan `WIC` . Panggil metode ini sebelum jendela utama diinisialisasi.
AFX_GLOBAL_DATA::Is32BitIcons	Menunjukkan apakah ikon 32-bit yang telah ditentukan sebelumnya didukung.
AFX_GLOBAL_DATA::IsD2DInitialized	Menentukan apakah inisialisasi `D2D` .
AFX_GLOBAL_DATA::IsDwmCompositionEnabled	Menyediakan cara sederhana untuk memanggil metode Windows DwmIsCompositionEnabled .
AFX_GLOBAL_DATA::IsHighContrastMode	Menunjukkan apakah gambar saat ini ditampilkan dengan kontras tinggi.
AFX_GLOBAL_DATA::OnSettingChange	Mendeteksi status saat ini dari animasi menu desktop dan fitur autohide taskbar.
AFX_GLOBAL_DATA::RegisterWindowClass	Mendaftarkan kelas jendela MFC yang ditentukan.
AFX_GLOBAL_DATA::ReleaseTaskBarRefs	Rilis antarmuka yang diperoleh melalui metode GetITaskbarList dan GetITaskbarList3.
AFX_GLOBAL_DATA::Lanjutkan	Menginisialisasi ulang penunjuk fungsi internal yang mengakses metode yang mendukung tema Windows dan gaya visual.
AFX_GLOBAL_DATA::SetLayeredAttrib	Menyediakan cara sederhana untuk memanggil metode Windows SetLayeredWindowAttributes .
AFX_GLOBAL_DATA::SetMenuFont	Membuat font logis yang ditentukan.
AFX_GLOBAL_DATA::ShellCreateItemFromParsingName	Membuat dan menginisialisasi objek item Shell dari nama penguraian.
AFX_GLOBAL_DATA::UpdateFonts	Mengintialisasi ulang font logis yang digunakan oleh kerangka kerja.
AFX_GLOBAL_DATA::UpdateSysColors	Menginisialisasi warna, kedalaman warna, kuas, pena, dan gambar yang digunakan oleh kerangka kerja.

Metode yang Dilindungi

Nama	Deskripsi
AFX_GLOBAL_DATA::EnableAccessibilitySupport	Mengaktifkan atau menonaktifkan dukungan Aksesibilitas Aktif Microsoft. Aksesibilitas Aktif menyediakan metode yang dapat diandalkan untuk mengekspos informasi tentang elemen antarmuka pengguna.
AFX_GLOBAL_DATA::IsAccessibilitySupport	Menunjukkan apakah dukungan Aksesibilitas Aktif Microsoft diaktifkan.
AFX_GLOBAL_DATA::IsWindowsLayerSupportAvailable	Menunjukkan apakah sistem operasi mendukung jendela berlapis.

Anggota Data

Nama	Deskripsi
AFX_GLOBAL_DATA::bIsOSAlphaBlendingSupport	Menunjukkan apakah sistem operasi saat ini mendukung pencamburan alfa.
AFX_GLOBAL_DATA::bIsWindows7	Menunjukkan apakah aplikasi sedang dijalankan di bawah OS Windows 7 atau yang lebih tinggi
AFX_GLOBAL_DATA::clrActiveCaptionGradient	Menentukan warna gradien keterangan aktif. Umumnya digunakan untuk panel docking.
AFX_GLOBAL_DATA::clrInactiveCaptionGradient	Menentukan warna gradien keterangan aktif yang tidak aktif. Umumnya digunakan untuk panel docking.
AFX_GLOBAL_DATA::m_bUseBuiltIn32BitIcons	Menunjukkan apakah kerangka kerja menggunakan ikon warna 32-bit yang telah ditentukan sebelumnya atau ikon resolusi yang lebih rendah.
AFX_GLOBAL_DATA::m_bUseSystemFont	Menunjukkan apakah font sistem digunakan untuk menu, bilah alat, dan pita.
AFX_GLOBAL_DATA::m_hcurHand	Menyimpan handel untuk kursor tangan.
AFX_GLOBAL_DATA::m_hcurStretch	Menyimpan handel untuk kursor peregangan horizontal.
AFX_GLOBAL_DATA::m_hcurStretchVert	Menyimpan handel untuk kursor stretch vertikal.
AFX_GLOBAL_DATA::m_hiconTool	Menyimpan handel untuk ikon alat.
AFX_GLOBAL_DATA::m_nAutoHideToolBarMargin	Menentukan offset dari toolbar autohide paling kiri ke sisi kiri bilah docking.
AFX_GLOBAL_DATA::m_nAutoHideToolBarSpacing	Menentukan kesenjangan antara bilah alat autohide.
AFX_GLOBAL_DATA::m_nDragFrameThicknessDock	Menentukan ketebalan bingkai seret yang digunakan untuk mengomunikasikan status tertambat.
AFX_GLOBAL_DATA::m_nDragFrameThicknessFloat	Menentukan ketebalan bingkai seret yang digunakan untuk mengomunikasikan status mengambang.

Keterangan

Sebagian besar data dalam struktur diinisialisasi AFX_GLOBAL_DATA saat aplikasi Anda dimulai.

Hierarki Warisan

AFX_GLOBAL_DATA

Persyaratan

Header: afxglobals.h

AFX_GLOBAL_DATA::bIsOSAlphaBlendingSupport

Menunjukkan apakah sistem operasi mendukung pencamburan alfa.

BOOL  bIsOSAlphaBlendingSupport;

Keterangan

TRUE menunjukkan bahwa pencamburan alfa didukung; jika tidak, FALSE.

AFX_GLOBAL_DATA::Pembersihan

Merilis sumber daya yang dialokasikan oleh kerangka kerja, seperti kuas, font, dan DLL.

void CleanUp();

AFX_GLOBAL_DATA::D 2D1MakeRotateMatrix

Membuat transformasi rotasi yang diputar oleh sudut tertentu di sekitar titik tertentu.

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

Parameter

sudut
Sudut rotasi searah jarum jam, dalam derajat.

pusat
Titik yang akan diputar.

matriks
Ketika metode ini kembali, berisi transformasi rotasi baru. Anda harus mengalokasikan penyimpanan untuk parameter ini.

Tampilkan Nilai

Mengembalikan S_OK jika berhasil, atau nilai kesalahan sebaliknya.

AFX_GLOBAL_DATA::D rawParentBackground

Menggambar latar belakang induk kontrol di area yang ditentukan.

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

Parameter

pWnd
[di] Penunjuk ke jendela kontrol.

pDC
[di] Penunjuk ke konteks perangkat.

lpRect
[di] Penunjuk ke persegi panjang yang mengikat area untuk menggambar. Nilai defaultnya adalah NULL.

Tampilkan Nilai

TRUE jika metode ini berhasil; jika tidak, FALSE.

AFX_GLOBAL_DATA::D rawTextOnGlass

Menggambar teks yang ditentukan dalam gaya visual tema yang ditentukan.

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
[di] Menangani ke data tema jendela, atau NULL. Kerangka kerja menggunakan tema yang ditentukan untuk menggambar teks jika parameter ini bukan NULL dan tema didukung. Jika tidak, kerangka kerja tidak menggunakan tema untuk menggambar teks.

Gunakan metode OpenThemeData untuk membuat HTHEME.

pDC
[di] Penunjuk ke konteks perangkat.

iPartId
[di] Bagian kontrol yang memiliki tampilan teks yang diinginkan. Untuk informasi selengkapnya, lihat kolom Bagian tabel di Bagian dan Status. Jika nilai ini adalah 0, teks digambar dalam font default, atau font dipilih ke dalam konteks perangkat.

iStateId
[di] Status kontrol yang memiliki tampilan teks yang diinginkan. Untuk informasi selengkapnya, lihat kolom Status tabel di Bagian dan Status.

strText
[di] Teks yang akan digambar.

rect
[di] Batas area tempat teks yang ditentukan digambar.

dwFlags
[di] Kombinasi bitwise (OR) bendera yang menentukan bagaimana teks yang ditentukan digambar.

Jika parameter hTheme adalah NULL atau jika tema tidak didukung dan diaktifkan, parameter nFormat metode CDC::D rawText menjelaskan bendera yang valid. Jika tema didukung, parameter dwFlags dari metode DrawThemeTextEx menjelaskan bendera yang valid.

nGlowSize
[di] Ukuran efek cahaya yang digambar di latar belakang sebelum menggambar teks yang ditentukan. Nilai default adalah 0.

clrText
[di] Warna di mana teks yang ditentukan digambar. Nilai defaultnya adalah warna default.

Tampilkan Nilai

TRUE jika tema digunakan untuk menggambar teks yang ditentukan; jika tidak, FALSE.

Keterangan

Tema mendefinisikan gaya visual aplikasi. Tema tidak digunakan untuk menggambar teks jika parameter hTheme adalah NULL, atau jika metode DrawThemeTextEx tidak didukung, atau jika komposisi Desktop Window Manager (DWM) dinonaktifkan.

AFX_GLOBAL_DATA::EnableAccessibilitySupport

Mengaktifkan atau menonaktifkan dukungan Aksesibilitas Aktif Microsoft.

void EnableAccessibilitySupport(BOOL bEnable=TRUE);

Parameter

bEnable
[di] TRUE untuk mengaktifkan dukungan aksesibilitas; FALSE untuk menonaktifkan dukungan aksesibilitas. Nilai defaultnya adalah TRUE.

Keterangan

Aksesibilitas Aktif adalah teknologi berbasis COM yang meningkatkan cara program dan sistem operasi Windows bekerja sama dengan produk teknologi bantuan. Ini menyediakan metode yang dapat diandalkan untuk mengekspos informasi tentang elemen antarmuka pengguna. Namun, model aksesibilitas yang lebih baru yang disebut Microsoft UI Automation sekarang tersedia. Untuk perbandingan kedua teknologi tersebut, lihat Automasi UI dan Aksesibilitas Aktif Microsoft.

Gunakan metode AFX_GLOBAL_DATA::IsAccessibilitySupport untuk menentukan apakah dukungan Aksesibilitas Aktif Microsoft diaktifkan.

AFX_GLOBAL_DATA::ExcludeTag

Menghapus pasangan tag XML yang ditentukan dari buffer tertentu.

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

Parameter

strBuffer
[di] Buffer teks.

lpszTag
[di] Nama sepasang tag XML pembuka dan penutupan.

strTag
[out] Ketika metode ini kembali, parameter strTag berisi teks yang berada di antara tag XML pembuka dan penutupan yang dinamai oleh parameter lpszTag . Spasi kosong di depan atau di belakang dipangkas dari hasilnya.

bIsCharsList
[di] TRUE untuk mengonversi simbol untuk karakter escape dalam parameter strTag menjadi karakter escape aktual; FALSE tidak melakukan konversi. Nilai defaultnya adalah FALSE. Untuk informasi selengkapnya, lihat Keterangan.

Tampilkan Nilai

TRUE jika metode ini berhasil; jika tidak, FALSE.

Keterangan

Pasangan tag XML terdiri dari tag pembukaan dan penutup bernama yang menunjukkan awal dan akhir eksekusi teks dalam buffer yang ditentukan. Parameter strBuffer menentukan buffer, dan parameter lpszTag menentukan nama tag XML.

Gunakan simbol dalam tabel berikut untuk mengodekan sekumpulan karakter escape dalam buffer yang ditentukan. Tentukan TRUE untuk parameter bIsCharsList untuk mengonversi simbol dalam parameter strTag menjadi karakter escape aktual. Tabel berikut menggunakan makro _T() untuk menentukan string karakter simbol dan escape.

Simbol	Karakter escape
_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

Mengambil warna saat ini dari elemen antarmuka pengguna yang ditentukan.

COLORREF GetColor(int nColor);

Parameter

nColor
[di] Nilai yang menentukan elemen antarmuka pengguna yang warnanya diambil. Untuk daftar nilai yang valid, lihat parameter nIndex dari metode GetSysColor .

Tampilkan Nilai

Nilai warna RGB dari elemen antarmuka pengguna yang ditentukan. Untuk informasi selengkapnya, lihat Keterangan.

Keterangan

Jika parameter nColor berada di luar rentang, nilai yang dikembalikan adalah nol. Karena nol juga merupakan nilai RGB yang valid, Anda tidak dapat menggunakan metode ini untuk menentukan apakah warna sistem didukung oleh sistem operasi saat ini. Sebagai gantinya , gunakan metode GetSysColorBrush , yang mengembalikan NULL jika warna tidak didukung.

AFX_GLOBAL_DATA::GetDirect2dFactory

Mengembalikan penunjuk ke antarmuka ID2D1Factory yang disimpan dalam data global. Jika antarmuka tidak diinisialisasi, antarmuka dibuat dan memiliki parameter default.

ID2D1Factory* GetDirect2dFactory();

Tampilkan Nilai

Penunjuk ke antarmuka ID2D1Factory jika pembuatan pabrik berhasil, atau NULL jika pembuatan gagal atau Sistem Operasi saat ini tidak memiliki dukungan D2D.

AFX_GLOBAL_DATA::GetHandCursor

Mengambil kursor yang telah ditentukan sebelumnya yang menyerupan tangan dan pengidentifikasinya IDC_HAND.

HCURSOR GetHandCursor();

Tampilkan Nilai

Handel kursor tangan.

AFX_GLOBAL_DATA::GetNonClientMetrics

Mengambil metrik yang terkait dengan area nonclient dari jendela yang tidak diminimalkan.

BOOL GetNonClientMetrics(NONCLIENTMETRICS& info);

Parameter

info
[masuk, keluar] Struktur NONCLIENTMETRICS yang berisi metrik yang dapat diskalakan yang terkait dengan area nonkelola dari jendela yang tidak diminimalkan.

Tampilkan Nilai

TRUE jika metode ini berhasil; jika tidak, FALSE.

AFX_GLOBAL_DATA::GetTextHeight

Mengambil tinggi karakter teks dalam font saat ini.

int GetTextHeight(BOOL bHorz = TRUE);

Parameter

bHorz
[di] TRUE untuk mengambil tinggi karakter saat teks berjalan secara horizontal; FALSE untuk mengambil tinggi karakter saat teks berjalan secara vertikal. Nilai defaultnya adalah TRUE.

Tampilkan Nilai

Tinggi font saat ini, yang diukur dari percender-nya ke turunannya.

AFX_GLOBAL_DATA::GetWICFactory

Mengembalikan penunjuk ke antarmuka IWICImagingFactory yang disimpan dalam data global. Jika antarmuka tidak diinisialisasi, antarmuka dibuat dan memiliki parameter default.

IWICImagingFactory* GetWICFactory();

Tampilkan Nilai

Penunjuk ke antarmuka IWICImagingFactory jika pembuatan pabrik berhasil, atau NULL jika pembuatan gagal atau Sistem Operasi saat ini tidak memiliki dukungan WIC.

AFX_GLOBAL_DATA::GetWriteFactory

Mengembalikan penunjuk ke antarmuka IDWriteFactory yang disimpan dalam data global. Jika antarmuka tidak diinisialisasi, antarmuka dibuat dan memiliki parameter default.

IDWriteFactory* GetWriteFactory();

Tampilkan Nilai

Penunjuk ke antarmuka IDWriteFactory jika pembuatan pabrik berhasil, atau NULL jika pembuatan gagal atau Sistem Operasi saat ini tidak memiliki dukungan DirectWrite.

AFX_GLOBAL_DATA::InitD2D

Menginisialisasi pabrik D2D, DirectWrite, dan WIC. Panggil metode ini sebelum jendela utama diinisialisasi.

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

Parameter

d2dFactoryType
Model utas pabrik D2D dan sumber daya yang dibuatnya.

writeFactoryType
Nilai yang menentukan apakah objek pabrik tulis akan dibagikan atau diisolasi

Tampilkan Nilai

Mengembalikan TRUE jika pabrik tidak ditilalizrd, FALSE - jika tidak

AFX_GLOBAL_DATA::Is32BitIcons

Menunjukkan apakah ikon 32-bit yang telah ditentukan sebelumnya didukung.

BOOL Is32BitIcons() const;

Tampilkan Nilai

TRUE jika ikon 32-bit yang telah ditentukan sebelumnya didukung; jika tidak, FALSE.

Keterangan

Metode ini mengembalikan TRUE jika kerangka kerja mendukung ikon bawaan 32-bit, dan jika sistem operasi mendukung 16 bit per piksel atau lebih, dan jika gambar tidak ditampilkan dengan kontras tinggi.

AFX_GLOBAL_DATA::IsAccessibilitySupport

Menunjukkan apakah dukungan Aksesibilitas Aktif Microsoft diaktifkan.

BOOL IsAccessibilitySupport() const;

Tampilkan Nilai

TRUE jika dukungan aksesibilitas diaktifkan; jika tidak, FALSE.

Keterangan

Microsoft Active Accessibility adalah solusi sebelumnya untuk membuat aplikasi dapat diakses. Microsoft UI Automation adalah model aksesibilitas baru untuk Microsoft Windows dan dimaksudkan untuk memenuhi kebutuhan produk teknologi bantuan dan alat pengujian otomatis.

Gunakan metode AFX_GLOBAL_DATA::EnableAccessibilitySupport untuk mengaktifkan atau menonaktifkan dukungan Aksesibilitas Aktif.

AFX_GLOBAL_DATA::IsD2DInitialized

Menentukan apakah D2D diinisialisasi

BOOL IsD2DInitialized() const;

Tampilkan Nilai

TRUE jika D2D diinisialisasi; jika tidak FALSE.

AFX_GLOBAL_DATA::IsDwmCompositionEnabled

Menyediakan cara sederhana untuk memanggil metode Windows DwmIsCompositionEnabled .

BOOL IsDwmCompositionEnabled();

Tampilkan Nilai

TRUE jika komposisi Desktop Window Manager (DWM) diaktifkan; jika tidak, FALSE.

AFX_GLOBAL_DATA::IsHighContrastMode

Menunjukkan apakah gambar saat ini ditampilkan dengan kontras tinggi.

BOOL IsHighContrastMode() const;

Tampilkan Nilai

TRUE jika gambar saat ini ditampilkan dalam mode kontras tinggi hitam atau putih; jika tidak, FALSE.

Keterangan

Dalam mode kontras tinggi hitam, tepi yang menghadap cahaya berwarna putih dan latar belakangnya hitam. Dalam mode kontras tinggi putih, tepi yang menghadap cahaya berwarna hitam dan latar belakang berwarna putih.

AFX_GLOBAL_DATA::IsWindowsLayerSupportAvailable

Menunjukkan apakah sistem operasi mendukung jendela berlapis.

BOOL IsWindowsLayerSupportAvailable() const;

Tampilkan Nilai

TRUE jika jendela berlapis didukung; jika tidak, FALSE.

Keterangan

Jika jendela berlapis didukung, penanda docking pintar menggunakan jendela berlapis.

AFX_GLOBAL_DATA::m_bUseBuiltIn32BitIcons

Menunjukkan apakah kerangka kerja menggunakan ikon warna 32-bit yang telah ditentukan sebelumnya atau ikon resolusi yang lebih rendah.

BOOL  m_bUseBuiltIn32BitIcons;

Keterangan

TRUE menentukan bahwa kerangka kerja menggunakan ikon warna 32-bit; FALSE menentukan ikon resolusi yang lebih rendah. AFX_GLOBAL_DATA::AFX_GLOBAL_DATA Konstruktor menginisialisasi anggota ini ke TRUE.

Anggota ini harus diatur pada pengaktifan aplikasi.

AFX_GLOBAL_DATA::m_bUseSystemFont

Menunjukkan apakah font sistem digunakan untuk menu, bilah alat, dan pita.

BOOL m_bUseSystemFont;

Keterangan

TRUE menentukan untuk menggunakan font sistem; jika tidak, FALSE. AFX_GLOBAL_DATA::AFX_GLOBAL_DATA Konstruktor menginisialisasi anggota ini ke FALSE.

Menguji anggota ini bukan satu-satunya cara bagi kerangka kerja untuk menentukan font yang akan digunakan. Metode ini AFX_GLOBAL_DATA::UpdateFonts juga menguji font default dan alternatif untuk menentukan gaya visual apa yang tersedia untuk diterapkan ke menu, toolbar, dan pita.

AFX_GLOBAL_DATA::m_hcurHand

Menyimpan handel untuk kursor tangan.

HCURSOR m_hcurHand;

AFX_GLOBAL_DATA::m_hcurStretch

Menyimpan handel untuk kursor peregangan horizontal.

HCURSOR m_hcurStretch;

AFX_GLOBAL_DATA::m_hcurStretchVert

Menyimpan handel untuk kursor stretch vertikal.

HCURSOR m_hcurStretchVert;

AFX_GLOBAL_DATA::m_hiconTool

Menyimpan handel untuk ikon alat.

HICON m_hiconTool;

AFX_GLOBAL_DATA::m_nAutoHideToolBarMargin

Menentukan offset dari toolbar autohide paling kiri ke sisi kiri bilah dok.

int  m_nAutoHideToolBarMargin;

Keterangan

AFX_GLOBAL_DATA::AFX_GLOBAL_DATA Konstruktor menginisialisasi anggota ini menjadi 4 piksel.

AFX_GLOBAL_DATA::m_nAutoHideToolBarSpacing

Menentukan kesenjangan antara bilah alat autohide.

int   m_nAutoHideToolBarSpacing;

Keterangan

AFX_GLOBAL_DATA::AFX_GLOBAL_DATA Konstruktor menginisialisasi anggota ini menjadi 14 piksel.

AFX_GLOBAL_DATA::m_nDragFrameThicknessDock

Menentukan ketebalan bingkai seret yang digunakan untuk menunjukkan status tertambat.

int  m_nDragFrameThicknessDock;

Keterangan

AFX_GLOBAL_DATA::AFX_GLOBAL_DATA Konstruktor menginisialisasi anggota ini menjadi 3 piksel.

AFX_GLOBAL_DATA::m_nDragFrameThicknessFloat

Menentukan ketebalan bingkai seret yang digunakan untuk menunjukkan status mengambang.

int  m_nDragFrameThicknessFloat;

Keterangan

AFX_GLOBAL_DATA::AFX_GLOBAL_DATA Konstruktor menginisialisasi anggota ini menjadi 4 piksel.

AFX_GLOBAL_DATA::OnSettingChange

Mendeteksi status saat ini dari animasi menu desktop dan fitur autohide taskbar.

void OnSettingChange();

Keterangan

Metode ini menetapkan variabel kerangka kerja ke status atribut tertentu dari desktop pengguna. Metode ini mendeteksi status animasi menu, pudar menu, dan fitur autohide bilah tugas saat ini.

AFX_GLOBAL_DATA::RegisterWindowClass

Mendaftarkan kelas jendela MFC yang ditentukan.

CString RegisterWindowClass(LPCTSTR lpszClassNamePrefix);

Parameter

lpszClassNamePrefix
[di] Nama kelas jendela yang akan didaftarkan.

Tampilkan Nilai

Nama kelas terdaftar yang memenuhi syarat jika metode ini berhasil; jika tidak, pengecualian sumber daya.

Keterangan

Nilai pengembalian adalah daftar string parameter lpszClassNamePrefix yang dibatasi titik dua, dan representasi teks heksadesimal dari handel instans aplikasi saat ini; kursor aplikasi, yang merupakan kursor panah yang pengidentifikasinya IDC_ARROW; dan kuas latar belakang. Untuk informasi selengkapnya tentang mendaftarkan kelas jendela MFC, lihat AfxRegisterClass.

AFX_GLOBAL_DATA::Lanjutkan

Menginisialisasi ulang penunjuk fungsi internal yang mengakses metode yang mendukung tema Windows dan gaya visual.

BOOL Resume();

Tampilkan Nilai

TRUE jika metode ini berhasil; jika tidak, FALSE. Dalam mode debug, metode ini menegaskan apakah metode ini tidak berhasil.

Keterangan

Metode ini dipanggil ketika kerangka kerja menerima pesan WM_POWERBROADCAST .

AFX_GLOBAL_DATA::SetLayeredAttrib

Menyediakan cara sederhana untuk memanggil metode Windows SetLayeredWindowAttributes .

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

Parameter

hwnd
[di] Tangani ke jendela berlapis.

crKey
[di] Kunci warna transparansi yang digunakan Manajer Jendela Desktop untuk menyusun jendela berlapis.

bAlpha
[di] Nilai alfa yang digunakan untuk menggambarkan keburaman jendela berlapis.

dwFlags
[di] Kombinasi bitwise (OR) bendera yang menentukan parameter metode mana yang akan digunakan. Tentukan LWA_COLORKEY untuk menggunakan parameter crKey sebagai warna transparansi. Tentukan LWA_ALPHA untuk menggunakan parameter bAlpha untuk menentukan keburaman jendela berlapis.

Tampilkan Nilai

TRUE jika metode ini berhasil; jika tidak, FALSE.

AFX_GLOBAL_DATA::SetMenuFont

Membuat font logis yang ditentukan.

BOOL SetMenuFont(
    LPLOGFONT lpLogFont,
    BOOL bHorz);

Parameter

lpLogFont
[di] Penunjuk ke struktur yang berisi atribut font.

bHorz
[di] TRUE untuk menentukan bahwa teks berjalan secara horizontal; FALSE untuk menentukan bahwa teks berjalan secara vertikal.

Tampilkan Nilai

TRUE jika metode ini berhasil; jika tidak, FALSE. Dalam mode debug, metode ini menegaskan apakah metode ini tidak berhasil.

Keterangan

Metode ini membuat font reguler horizontal, font bergaris bawah, dan font tebal yang digunakan dalam item menu default. Metode ini secara opsional membuat font vertikal reguler. Untuk informasi selengkapnya tentang font logis, lihat CFont::CreateFontIndirect.

AFX_GLOBAL_DATA::UpdateFonts

Mengintialisasi ulang font logis yang digunakan oleh kerangka kerja.

void UpdateFonts();

Keterangan

Untuk informasi selengkapnya tentang font logis, lihat CFont::CreateFontIndirect.

AFX_GLOBAL_DATA::UpdateSysColors

Menginisialisasi warna, kedalaman warna, kuas, pena, dan gambar yang digunakan oleh kerangka kerja.

void UpdateSysColors();

AFX_GLOBAL_DATA::bIsWindows7

Menunjukkan apakah aplikasi sedang dijalankan di bawah Windows 7 atau yang lebih tinggi.

BOOL bIsWindows7;

AFX_GLOBAL_DATA::clrActiveCaptionGradient

Menentukan warna gradien dari keterangan aktif. Umumnya digunakan untuk panel docking.

COLORREF clrActiveCaptionGradient;

AFX_GLOBAL_DATA::clrInactiveCaptionGradient

Menentukan warna gradien dari keterangan tidak aktif. Umumnya digunakan untuk panel docking.

COLORREF clrInactiveCaptionGradient;

AFX_GLOBAL_DATA::GetITaskbarList

Membuat dan menyimpan dalam data global penunjuk ke ITaskBarList antarmuka.

ITaskbarList *GetITaskbarList();

Tampilkan Nilai

Penunjuk ke ITaskbarList antarmuka jika pembuatan objek daftar bilah tugas berhasil; NULL jika pembuatan gagal atau jika Sistem Operasi saat ini kurang dari Windows 7.

AFX_GLOBAL_DATA::GetITaskbarList3

Membuat dan menyimpan dalam data global penunjuk ke ITaskBarList3 antarmuka.

ITaskbarList3 *GetITaskbarList3();

Tampilkan Nilai

Penunjuk ke ITaskbarList3 antarmuka jika pembuatan objek daftar bilah tugas berhasil; NULL jika pembuatan gagal atau jika Sistem Operasi saat ini kurang dari Windows 7.

AFX_GLOBAL_DATA::GetShellAutohideBars

Menentukan posisi Bilah sembunyi otomatis Shell.

int GetShellAutohideBars();

Tampilkan Nilai

Nilai bilangan bulat dengan bendera yang dikodekan yang menentukan posisi bilah sembunyi otomatis. Ini dapat menggabungkan nilai berikut: AFX_AUTOHIDE_BOTTOM, AFX_AUTOHIDE_TOP, AFX_AUTOHIDE_LEFT, AFX_AUTOHIDE_RIGHT.

AFX_GLOBAL_DATA::ReleaseTaskBarRefs

Merilis antarmuka yang diperoleh melalui GetITaskbarList metode dan GetITaskbarList3 .

void ReleaseTaskBarRefs();

AFX_GLOBAL_DATA::ShellCreateItemFromParsingName

Membuat dan menginisialisasi objek item Shell dari nama penguraian.

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

Parameter

pszPath
[di] Penunjuk ke nama tampilan.

Pbc
Penunjuk ke konteks ikatan yang mengontrol operasi penguraian.

riid
Referensi ke ID antarmuka.

ppv
[out] Ketika fungsi ini kembali, berisi pointer antarmuka yang diminta dalam riid. Ini biasanya akan IShellItem atau IShellItem2.

Tampilkan Nilai

Mengembalikan S_OK jika berhasil; nilai kesalahan jika tidak.

Lihat juga

Bagan Hierarki
Struktur, Gaya, Panggilan Balik, serta Peta Pesan
COLORREF
Bagian dan Status
CDC::D rawText
DrawThemeTextEx
Manajer Jendela Desktop
Mengaktifkan dan Mengontrol Komposisi DWM
Automasi UI dan Aksesibilitas Aktif Microsoft
Fungsi GetSysColor
GetSysColorBrush
Struktur NONCLIENTMETRICS
AfxRegisterClass
AfxThrowResourceException
SetLayeredWindowAttributes

Saran dan Komentar

Apakah halaman ini membantu?

Last updated on 2025-11-07

Bagikan melalui

Struktur AFX_GLOBAL_DATA

Sintaks

Anggota

Konstruktor Publik

Metode Publik

Metode yang Dilindungi

Anggota Data

Keterangan

Hierarki Warisan

Persyaratan

AFX_GLOBAL_DATA::bIsOSAlphaBlendingSupport

Keterangan

AFX_GLOBAL_DATA::Pembersihan

AFX_GLOBAL_DATA::D 2D1MakeRotateMatrix

Parameter

Tampilkan Nilai

AFX_GLOBAL_DATA::D rawParentBackground

Parameter

Tampilkan Nilai

AFX_GLOBAL_DATA::D rawTextOnGlass

Parameter

Tampilkan Nilai

Keterangan

AFX_GLOBAL_DATA::EnableAccessibilitySupport

Parameter

Keterangan

AFX_GLOBAL_DATA::ExcludeTag

Parameter

Tampilkan Nilai

Keterangan

AFX_GLOBAL_DATA::GetColor

Parameter

Tampilkan Nilai

Keterangan

AFX_GLOBAL_DATA::GetDirect2dFactory

Tampilkan Nilai

AFX_GLOBAL_DATA::GetHandCursor

Tampilkan Nilai

AFX_GLOBAL_DATA::GetNonClientMetrics

Parameter

Tampilkan Nilai

AFX_GLOBAL_DATA::GetTextHeight

Parameter

Tampilkan Nilai

AFX_GLOBAL_DATA::GetWICFactory

Tampilkan Nilai

AFX_GLOBAL_DATA::GetWriteFactory

Tampilkan Nilai

AFX_GLOBAL_DATA::InitD2D

Parameter

Tampilkan Nilai

AFX_GLOBAL_DATA::Is32BitIcons

Tampilkan Nilai

Keterangan

AFX_GLOBAL_DATA::IsAccessibilitySupport

Tampilkan Nilai

Keterangan

AFX_GLOBAL_DATA::IsD2DInitialized

Tampilkan Nilai

AFX_GLOBAL_DATA::IsDwmCompositionEnabled

Tampilkan Nilai

AFX_GLOBAL_DATA::IsHighContrastMode

Tampilkan Nilai

Keterangan

AFX_GLOBAL_DATA::IsWindowsLayerSupportAvailable

Tampilkan Nilai

Keterangan

AFX_GLOBAL_DATA::m_bUseBuiltIn32BitIcons

Keterangan

AFX_GLOBAL_DATA::m_bUseSystemFont

Keterangan

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

Keterangan

AFX_GLOBAL_DATA::m_nAutoHideToolBarSpacing

Keterangan