Fungsi DrawFrameControl (winuser.h)

Artikel
03/13/2024

Fungsi DrawFrameControl menggambar kontrol bingkai dari jenis dan gaya yang ditentukan.

Sintaks

BOOL DrawFrameControl(
  [in] HDC    hdc,
  [in] LPRECT lprc,
  [in] UINT   uType,
  [in] UINT   uState
);

Parameter

[in] hdc

Handel ke konteks perangkat jendela untuk menggambar kontrol.

[in] lprc

Penunjuk ke struktur RECT yang berisi koordinat logis persegi panjang pembatas untuk kontrol bingkai.

[in] uType

Jenis kontrol bingkai yang akan digambar. Parameter ini bisa menjadi salah satu nilai berikut.

Nilai	Makna
DFC_BUTTON	Tombol standar
DFC_CAPTION	Bilah judul
DFC_MENU	Bilah menu
DFC_POPUPMENU	Item menu popup.
DFC_SCROLL	Bilah gulir

[in] uState

Status awal kontrol bingkai. Jika uType DFC_BUTTON, uState bisa menjadi salah satu nilai berikut.

Nilai	Makna
DFCS_BUTTON3STATE	Tombol tiga status
DFCS_BUTTONCHECK	Kotak centang
DFCS_BUTTONPUSH	Tombol tekan
DFCS_BUTTONRADIO	Tombol radio
DFCS_BUTTONRADIOIMAGE	Gambar untuk tombol radio (gambar kebutuhan tidak sama)
DFCS_BUTTONRADIOMASK	Masker untuk tombol radio (nonsquare perlu masker)

Jika uType DFC_CAPTION, uState bisa menjadi salah satu nilai berikut.

Nilai	Makna
DFCS_CAPTIONCLOSE	Tombol Tutup
DFCS_CAPTIONHELP	Tombol Bantuan
DFCS_CAPTIONMAX	Tombol Maksimalkan
DFCS_CAPTIONMIN	Tombol Minimalkan
DFCS_CAPTIONRESTORE	Tombol Pulihkan

Jika uType DFC_MENU, uState bisa menjadi salah satu nilai berikut.

Nilai	Makna
DFCS_MENUARROW	Panah submenu
DFCS_MENUARROWRIGHT	Panah submenu menunjuk ke kiri. Ini digunakan untuk menu bertingkat kanan-ke-kiri yang digunakan dengan bahasa kanan-ke-kiri seperti Arab atau Ibrani.
DFCS_MENUBULLET	Peluru
DFCS_MENUCHECK	Tanda centang

Jika uType DFC_SCROLL, uState bisa menjadi salah satu nilai berikut.

Nilai	Makna
DFCS_SCROLLCOMBOBOX	Bilah gulir kotak kombo
DFCS_SCROLLDOWN	Panah bawah bilah gulir
DFCS_SCROLLLEFT	Panah kiri bilah gulir
DFCS_SCROLLRIGHT	Panah kanan bilah gulir
DFCS_SCROLLSIZEGRIP	Pegangan ukuran di sudut kanan bawah jendela
DFCS_SCROLLSIZEGRIPRIGHT	Pegangan ukuran di sudut kiri bawah jendela. Ini digunakan dengan bahasa kanan-ke-kiri seperti Arab atau Ibrani.
DFCS_SCROLLUP	Panah atas bilah gulir

Gaya berikut dapat digunakan untuk menyesuaikan persegi panjang pembatas tombol tekan.

Nilai	Makna
DFCS_ADJUSTRECT	Persegi panjang pembatas disesuaikan untuk mengecualikan tepi sekitar tombol tekan.

Satu atau beberapa nilai berikut ini dapat digunakan untuk mengatur status kontrol yang akan digambar.

Nilai	Makna
DFCS_CHECKED	Tombol dicentang.
DFCS_FLAT	Tombol memiliki batas datar.
DFCS_HOT	Tombol dilacak.
DFCS_INACTIVE	Tombol tidak aktif (berwarna abu-abu).
DFCS_MONO	Tombol memiliki batas monokrom.
DFCS_PUSHED	Tombol didorong.
DFCS_TRANSPARENT	Latar belakang tetap tidak tersentuh. Bendera ini hanya dapat digabungkan dengan DFCS_MENUARROWUP atau DFCS_MENUARROWDOWN.

Mengembalikan nilai

Jika fungsi berhasil, nilai yang dikembalikan bukan nol.

Jika fungsi gagal, nilai yang dikembalikan adalah nol.

Keterangan

Jika uType DFC_MENU atau DFC_BUTTON dan uState tidak DFCS_BUTTONPUSH, kontrol bingkai adalah masker hitam-putih (yaitu, kontrol bingkai hitam pada latar belakang putih). Dalam kasus seperti itu, aplikasi harus meneruskan handel ke kontrol perangkat memori bitmap. Aplikasi kemudian dapat menggunakan bitmap terkait sebagai parameter hbmMask ke fungsi MaskBlt , atau dapat menggunakan konteks perangkat sebagai parameter ke fungsi BitBlt menggunakan ROP seperti SRCAND dan SRCINVERT.

Virtualisasi DPI

API ini tidak berpartisipasi dalam virtualisasi DPI. Input yang diberikan selalu dalam hal piksel fisik, dan tidak terkait dengan konteks panggilan.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	winuser.h (termasuk Windows.h)
Pustaka	User32.lib
DLL	User32.dll
Set API	ext-ms-win-ntuser-draw-l1-1-2 (diperkenalkan dalam Windows 10, versi 10.0.10240)

Lihat juga

Fungsi Melukis dan Menggambar

Gambaran Umum Melukis dan Menggambar

RECT

Bagikan melalui