Fungsi DrawFrameControl (winuser.h)

  • Artikel

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