Bagikan melalui

Kelas CSpinButtonctrl

  • Artikel

Menyediakan fungsionalitas kontrol tombol putar umum Windows.

Sintaks

class CSpinButtonCtrl : public CWnd

Anggota

Konstruktor Publik

Nama Deskripsi
CSpinButtonctrl::CSpinButtonCtrl Membuat CSpinButtonCtrl objek.

Metode Publik

Nama Deskripsi
CSpinButtonctrl::Create Membuat kontrol tombol putar dan melampirkannya ke CSpinButtonCtrl objek.
CSpinButtonctrl::CreateEx Membuat kontrol tombol putar dengan gaya perluasan Windows yang ditentukan dan melampirkannya ke CSpinButtonCtrl objek.
CSpinButtonctrl::GetAccel Mengambil informasi akselerasi untuk kontrol tombol putar.
CSpinButtonctrl::GetBase Mengambil basis saat ini untuk kontrol tombol putar.
CSpinButtonCtrl::GetBuddy Mengambil penunjuk ke jendela teman saat ini.
CSpinButtonctrl::GetPos Mengambil posisi kontrol tombol putar saat ini.
CSpinButtonCtrl::GetRange Mengambil batas atas dan bawah (rentang) untuk kontrol tombol putar.
CSpinButtonctrl::SetAccel Mengatur akselerasi untuk kontrol tombol putar.
CSpinButtonctrl::SetBase Mengatur dasar untuk kontrol tombol putar.
CSpinButtonCtrl::SetBuddy Mengatur jendela teman untuk kontrol tombol putar.
CSpinButtonctrl::SetPos Mengatur posisi saat ini untuk kontrol.
CSpinButtonCtrl::SetRange Mengatur batas atas dan bawah (rentang) untuk kontrol tombol putar.

Keterangan

"Kontrol tombol putar" (juga dikenal sebagai kontrol naik turun) adalah sepasang tombol panah yang dapat diklik pengguna untuk meningkatkan atau mengurangi nilai, seperti posisi gulir atau angka yang ditampilkan dalam kontrol pendamping. Nilai yang terkait dengan kontrol tombol putar disebut posisinya saat ini. Kontrol tombol putar paling sering digunakan dengan kontrol pendamping, yang disebut "jendela teman."

Kontrol ini (dan oleh karena itu CSpinButtonCtrl kelas) hanya tersedia untuk program yang berjalan di bawah Windows 95/98 dan Windows NT versi 3.51 dan yang lebih baru.

Untuk pengguna, kontrol tombol putar dan jendela temannya sering terlihat seperti kontrol tunggal. Anda dapat menentukan bahwa kontrol tombol putar secara otomatis memposisikan dirinya sendiri di samping jendela temannya, dan secara otomatis mengatur keterangan jendela teman ke posisinya saat ini. Anda dapat menggunakan kontrol tombol putar dengan kontrol edit untuk meminta input numerik kepada pengguna.

Mengklik panah atas memindahkan posisi saat ini ke arah maksimum, dan mengklik panah bawah memindahkan posisi saat ini ke arah minimum. Secara default, minimumnya adalah 100 dan maksimumnya adalah 0. Setiap kali pengaturan minimum lebih besar dari pengaturan maksimum (misalnya, ketika pengaturan default digunakan), mengklik panah atas mengurangi nilai posisi dan mengklik panah bawah akan meningkatkannya.

Kontrol tombol putar tanpa jendela teman berfungsi sebagai semacam bilah gulir yang disederhanakan. Misalnya, kontrol tab terkadang menampilkan kontrol tombol putar untuk memungkinkan pengguna menggulir tab tambahan ke tampilan.

Untuk informasi selengkapnya tentang menggunakan CSpinButtonCtrl, lihat Kontrol dan Menggunakan CSpinButtonCtrl.

Hierarki Warisan

CObject

CCmdTarget

CWnd

CSpinButtonCtrl

Persyaratan

Header: afxcmn.h

CSpinButtonctrl::Create

Membuat kontrol tombol putar dan melampirkannya ke CSpinButtonCtrl objek..

virtual BOOL Create(
    DWORD dwStyle,
    const RECT& rect,
    CWnd* pParentWnd,
    UINT nID);

Parameter

dwStyle
Menentukan gaya kontrol tombol putar. Terapkan kombinasi gaya kontrol tombol putar ke kontrol. Gaya ini dijelaskan dalam Gaya Kontrol Naik Turun di Windows SDK.

rect
Menentukan ukuran dan posisi kontrol tombol putar. Ini bisa berupa objek CRect atau struktur RECT

pParentWnd
Penunjuk ke jendela induk kontrol tombol putar, biasanya .CDialog Ini tidak boleh NULL.

Nid
Menentukan ID kontrol tombol putar.

Tampilkan Nilai

Bukan nol jika inisialisasi berhasil; jika tidak, 0.

Keterangan

Anda membuat CSpinButtonCtrl objek dalam dua langkah Pertama, panggil konstruktor, lalu panggil Create, yang membuat kontrol tombol putar dan melampirkannya ke CSpinButtonCtrl objek.

Untuk membuat kontrol tombol putar dengan gaya jendela yang diperluas, panggil CSpinButtonCtrl::CreateEx alih-alih Create.

CSpinButtonctrl::CreateEx

Membuat kontrol (jendela anak) dan mengaitkannya dengan CSpinButtonCtrl objek.

virtual BOOL CreateEx(
    DWORD dwExStyle,
    DWORD dwStyle,
    const RECT& rect,
    CWnd* pParentWnd,
    UINT nID);

Parameter

dwExStyle
Menentukan gaya kontrol yang diperluas yang sedang dibuat. Untuk daftar gaya windows yang diperluas, lihat parameter dwExStyle untuk CreateWindowEx di Windows SDK.

dwStyle
Menentukan gaya kontrol tombol putar. Terapkan kombinasi gaya kontrol tombol putar ke kontrol. Gaya ini dijelaskan dalam Gaya Kontrol Naik Turun di Windows SDK.

rect
Referensi ke struktur RECT yang menjelaskan ukuran dan posisi jendela yang akan dibuat, dalam koordinat klien pParentWnd.

pParentWnd
Penunjuk ke jendela yang merupakan induk kontrol.

Nid
ID jendela anak kontrol.

Tampilkan Nilai

Bukan nol jika berhasil; jika tidak, 0.

Keterangan

Gunakan CreateEx alih-alih Buat untuk menerapkan gaya Windows yang diperluas, yang ditentukan oleh preface gaya windows yang diperluas WS_EX_.

CSpinButtonctrl::CSpinButtonCtrl

Membuat CSpinButtonCtrl objek.

CSpinButtonCtrl();

CSpinButtonctrl::GetAccel

Mengambil informasi akselerasi untuk kontrol tombol putar.

UINT GetAccel(
    int nAccel,
    UDACCEL* pAccel) const;

Parameter

nAccel
Jumlah elemen dalam array yang ditentukan oleh pAccel.

pAccel
Penunjuk ke array struktur UDACCEL yang menerima informasi akselerasi.

Tampilkan Nilai

Jumlah struktur akselerator yang diambil.

CSpinButtonctrl::GetBase

Mengambil basis saat ini untuk kontrol tombol putar.

UINT GetBase() const;

Tampilkan Nilai

Nilai dasar saat ini.

CSpinButtonCtrl::GetBuddy

Mengambil penunjuk ke jendela teman saat ini.

CWnd* GetBuddy() const;

Tampilkan Nilai

Penunjuk ke jendela teman saat ini.

CSpinButtonctrl::GetPos

Mengambil posisi kontrol tombol putar saat ini.

int GetPos() const;  int GetPos32(LPBOOL lpbError = NULL) const;

Parameter

lpbError
Penunjuk ke nilai boolean yang diatur ke nol jika nilai berhasil diambil atau bukan nol jika terjadi kesalahan. Jika parameter ini diatur ke NULL, kesalahan tidak dilaporkan.

Tampilkan Nilai

Versi pertama mengembalikan posisi saat ini 16-bit dalam kata berurutan rendah. Kata berurutan tinggi bukan nol jika terjadi kesalahan.

Versi kedua mengembalikan posisi 32-bit.

Keterangan

Ketika memproses nilai yang dikembalikan, kontrol memperbarui posisinya saat ini berdasarkan keterangan jendela teman. Kontrol mengembalikan kesalahan jika tidak ada jendela teman atau jika keterangan menentukan nilai yang tidak valid atau di luar rentang.

CSpinButtonCtrl::GetRange

Mengambil batas atas dan bawah (rentang) untuk kontrol tombol putar.

DWORD GetRange() const;

void GetRange(
    int& lower,
    int& upper) const;

void GetRange32(
    int& lower,
    int &upper) const;

Parameter

lower
Referensi ke bilangan bulat yang menerima batas bawah untuk kontrol.

upper
Referensi ke bilangan bulat yang menerima batas atas untuk kontrol.

Tampilkan Nilai

Versi pertama mengembalikan nilai 32-bit yang berisi batas atas dan bawah. Kata urutan rendah adalah batas atas untuk kontrol, dan kata urutan tinggi adalah batas bawah.

Keterangan

Fungsi GetRange32 anggota mengambil rentang kontrol tombol putar sebagai bilangan bulat 32-bit.

CSpinButtonctrl::SetAccel

Mengatur akselerasi untuk kontrol tombol putar.

BOOL SetAccel(
    int nAccel,
    UDACCEL* pAccel);

Parameter

nAccel
Jumlah struktur UDACCEL yang ditentukan oleh pAccel.

pAccel
Penunjuk ke array struktur UDACCEL, yang berisi informasi akselerasi. Elemen harus diurutkan dalam urutan naik berdasarkan nSec anggota.

Tampilkan Nilai

Bukan nol jika berhasil; jika tidak, 0.

CSpinButtonctrl::SetBase

Mengatur dasar untuk kontrol tombol putar.

int SetBase(int nBase);

Parameter

nBase
Nilai dasar baru untuk kontrol. Bisa 10 untuk desimal atau 16 untuk heksadesimal.

Tampilkan Nilai

Nilai dasar sebelumnya jika berhasil, atau nol jika basis yang tidak valid diberikan.

Keterangan

Nilai dasar menentukan apakah jendela teman menampilkan angka dalam digit desimal atau heksadesimal. Angka heksadesimal selalu tidak ditandatangani; angka desimal ditandatangani.

CSpinButtonCtrl::SetBuddy

Mengatur jendela teman untuk kontrol tombol putar.

CWnd* SetBuddy(CWnd* pWndBuddy);

Parameter

pWndBuddy
Arahkan ke jendela teman baru.

Tampilkan Nilai

Penunjuk ke jendela teman sebelumnya.

Keterangan

Kontrol putar hampir selalu dikaitkan dengan jendela lain, seperti kontrol edit, yang menampilkan beberapa konten. Jendela lain ini disebut "buddy" dari spin control.

CSpinButtonctrl::SetPos

Mengatur posisi saat ini untuk kontrol tombol putar.

int SetPos(int nPos);
int SetPos32(int nPos);

Parameter

nPos
Posisi baru untuk kontrol. Nilai ini harus dalam rentang yang ditentukan oleh batas atas dan bawah untuk kontrol.

Tampilkan Nilai

Posisi sebelumnya (presisi 16-bit untuk SetPos, presisi 32-bit untuk SetPos32).

Keterangan

SetPos32 mengatur posisi 32-bit.

CSpinButtonCtrl::SetRange

Mengatur batas atas dan bawah (rentang) untuk kontrol tombol putar.

void SetRange(
    short nLower,
    short nUpper);

void SetRange32(
    int nLower,
    int nUpper);

Parameter

nLower dan nUpper
Batas atas dan bawah untuk kontrol. Untuk SetRange, batasan tidak boleh lebih besar dari UD_MAXVAL atau kurang dari UD_MINVAL; selain itu, perbedaan antara kedua batas tidak boleh melebihi UD_MAXVAL. SetRange32 menempatkan tidak ada batasan pada batas; gunakan bilangan bulat apa pun.

Keterangan

Fungsi SetRange32 anggota mengatur rentang 32-bit untuk kontrol tombol putar.

Catatan

Rentang default untuk tombol putar memiliki maksimum yang diatur ke nol (0) dan minimum diatur ke 100. Karena nilai maksimum kurang dari nilai minimum, mengklik panah atas akan mengurangi posisi dan mengklik panah bawah akan menambahnya. Gunakan CSpinButtonCtrl::SetRange untuk menyesuaikan nilai-nilai ini.

Lihat juga

Sampel CMNCTRL2 MFC
Kelas CWnd
Bagan Hierarki
Kelas CSliderCtrl