CSpinButtonCtrl Sınıfı

Windows ortak döndürme düğmesi denetiminin işlevselliğini sağlar.

Sözdizimi

class CSpinButtonCtrl : public CWnd

Üyeler

Ortak Oluşturucular

Veri Akışı Adı	Açıklama
CSpinButtonCtrl::CSpinButtonCtrl	Bir CSpinButtonCtrl nesne oluşturur.

Genel Yöntemler

Veri Akışı Adı	Açıklama
CSpinButtonCtrl::Create	Döndürme düğmesi denetimi oluşturur ve bunu bir CSpinButtonCtrl nesneye ekler.
CSpinButtonCtrl::CreateEx	Belirtilen Windows genişletilmiş stilleriyle bir döndürme düğmesi denetimi oluşturur ve bunu bir CSpinButtonCtrl nesneye ekler.
CSpinButtonCtrl::GetAccel	Döndürme düğmesi denetimi için hızlandırma bilgilerini alır.
CSpinButtonCtrl::GetBase	Döndürme düğmesi denetimi için geçerli tabanı alır.
CSpinButtonCtrl::GetBuddy	Geçerli arkadaş penceresine bir işaretçi alır.
CSpinButtonCtrl::GetPos	Döndürme düğmesi denetiminin geçerli konumunu alır.
CSpinButtonCtrl::GetRange	Döndürme düğmesi denetimi için üst ve alt sınırları (aralık) alır.
CSpinButtonCtrl::SetAccel	Döndürme düğmesi denetimi için hızlandırmayı ayarlar.
CSpinButtonCtrl::SetBase	Döndürme düğmesi denetiminin tabanını ayarlar.
CSpinButtonCtrl::SetBuddy	Döndürme düğmesi denetimi için arkadaş penceresini ayarlar.
CSpinButtonCtrl::SetPos	Denetim için geçerli konumu ayarlar.
CSpinButtonCtrl::SetRange	Döndürme düğmesi denetimi için üst ve alt sınırları (aralık) ayarlar.

Açıklamalar

"Döndürme düğmesi denetimi" (yukarı aşağı denetim olarak da bilinir), kullanıcının kaydırma konumu veya eşlikçi denetiminde görüntülenen sayı gibi bir değeri artırmak veya küçültmek için tıklayabileceği bir ok düğmeleri çiftidir. Döndürme düğmesi denetimiyle ilişkili değer, geçerli konumu olarak adlandırılır. Döndürme düğmesi denetimi çoğunlukla "arkadaş penceresi" olarak adlandırılan bir yardımcı denetimle kullanılır.

Bu denetim (ve dolayısıyla CSpinButtonCtrl sınıfı) yalnızca Windows 95/98 ve Windows NT sürüm 3.51 ve üzeri altında çalışan programlarda kullanılabilir.

Kullanıcıya, bir döndürme düğmesi denetimi ve onun arkadaş penceresi genellikle tek bir denetim gibi görünür. Döndürme düğmesi denetiminin kendisini otomatik olarak arkadaş penceresinin yanına yerleştireceğini ve arkadaş penceresinin resim yazısını otomatik olarak geçerli konumuna ayarlayacağını belirtebilirsiniz. Kullanıcıdan sayısal giriş istemesi için düzenleme denetimiyle bir döndürme düğmesi denetimi kullanabilirsiniz.

Yukarı oka tıklanması geçerli konumu maksimuma doğru, aşağı oka tıklanması ise geçerli konumu minimuma doğru taşır. Varsayılan olarak, en az 100, en fazla 0'dır. En düşük ayar maksimum ayardan büyük olduğunda (örneğin, varsayılan ayarlar kullanıldığında), yukarı oka tıklandığında konum değeri azalır ve aşağı oka tıklandığında bu değer artar.

Arkadaş penceresi olmayan döndürme düğmesi denetimi, bir tür basitleştirilmiş kaydırma çubuğu işlevi görür. Örneğin, bir sekme denetimi bazen kullanıcının ek sekmeleri görünüme kaydırmasını sağlamak için bir döndürme düğmesi denetimi görüntüler.

kullanma CSpinButtonCtrlhakkında daha fazla bilgi için bkz . Denetimler ve CSpinButtonCtrl Kullanma.

Devralma Hiyerarşisi

CObject

CCmdTarget

CWnd

CSpinButtonCtrl

Gereksinimler

Üst bilgi: afxcmn.h

CSpinButtonCtrl::Create

Döndürme düğmesi denetimi oluşturur ve bunu bir CSpinButtonCtrl nesneye ekler..

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

Parametreler

dwStyle
Döndürme düğmesi denetiminin stilini belirtir. Denetime döndürme düğmesi denetim stillerinin herhangi bir bileşimini uygulayın. Bu stiller, Windows SDK'sında Yukarı Aşağı Denetim Stilleri'nde açıklanmıştır.

Rect
Döndürme düğmesi denetiminin boyutunu ve konumunu belirtir. CRect nesnesi veya RECT yapısı olabilir

pParentWnd
Döndürme düğmesi denetiminin üst penceresine (genellikle bir ) işaret eden bir CDialogişaretçi. NULL olmamalıdır.

Nıd
Döndürme düğmesi denetiminin kimliğini belirtir.

Dönüş Değeri

Başlatma başarılı olursa sıfır olmayan; aksi takdirde 0.

Açıklamalar

bir nesneyi iki adımda oluşturursunuz CSpinButtonCtrl İlk olarak oluşturucuyu çağırın ve ardından döndürme düğmesi denetimini oluşturan ve nesneye ekleyen öğesini çağırınCreateCSpinButtonCtrl.

Genişletilmiş pencere stilleriyle bir döndürme düğmesi denetimi oluşturmak için yerine CSpinButtonCtrl::CreateEx Createçağrısı yapın.

CSpinButtonCtrl::CreateEx

Bir denetim (alt pencere) oluşturur ve bunu nesnesiyle CSpinButtonCtrl ilişkilendirir.

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

Parametreler

dwExStyle
Oluşturulan denetimin genişletilmiş stilini belirtir. Genişletilmiş windows stillerinin listesi için Windows SDK'sında CreateWindowEx için dwExStyle parametresine bakın.

dwStyle
Döndürme düğmesi denetiminin stilini belirtir. Denetime döndürme düğmesi denetim stillerinin herhangi bir bileşimini uygulayın. Bu stiller, Windows SDK'sında Yukarı Aşağı Denetim Stilleri'nde açıklanmıştır.

Rect
pParentWnd istemci koordinatlarında oluşturulacak pencerenin boyutunu ve konumunu açıklayan rect yapısına başvuru.

pParentWnd
Denetimin üst öğesi olan pencere işaretçisi.

Nıd
Denetimin alt pencere kimliği.

Dönüş Değeri

Başarılı olursa sıfır olmayan; aksi takdirde 0.

Açıklamalar

Windows genişletilmiş stil ön biçimi WS_EX_ tarafından belirtilen genişletilmiş Windows stilleri uygulamak için Oluştur yerine kullanınCreateEx.

CSpinButtonCtrl::CSpinButtonCtrl

Bir CSpinButtonCtrl nesne oluşturur.

CSpinButtonCtrl();

CSpinButtonCtrl::GetAccel

Döndürme düğmesi denetimi için hızlandırma bilgilerini alır.

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

Parametreler

nAccel
pAccel tarafından belirtilen dizideki öğe sayısı.

pAccel
Hızlandırma bilgilerini alan UDACCEL yapıları dizisinin işaretçisi.

Dönüş Değeri

Alınan hızlandırıcı yapılarının sayısı.

CSpinButtonCtrl::GetBase

Döndürme düğmesi denetimi için geçerli tabanı alır.

UINT GetBase() const;

Dönüş Değeri

Geçerli temel değer.

CSpinButtonCtrl::GetBuddy

Geçerli arkadaş penceresine bir işaretçi alır.

CWnd* GetBuddy() const;

Dönüş Değeri

Geçerli arkadaş penceresinin işaretçisi.

CSpinButtonCtrl::GetPos

Döndürme düğmesi denetiminin geçerli konumunu alır.

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

Parametreler

lpbError
Değer başarıyla alınırsa sıfır olarak ayarlanmış bir boole değerinin işaretçisi veya hata oluşursa sıfır olmayan. Bu parametre NULL olarak ayarlanırsa hatalar bildirılmaz.

Dönüş Değeri

İlk sürüm, düşük sıralı sözcükte 16 bit geçerli konumu döndürür. Hata oluştuğunda yüksek sıralı sözcük sıfırdan farklı olur.

İkinci sürüm 32 bit konumu döndürür.

Açıklamalar

Döndürülen değeri işlediğinde denetim, arkadaş penceresinin resim yazısına göre geçerli konumunu güncelleştirir. Bir arkadaş penceresi yoksa veya resim yazısı geçersiz veya aralık dışı bir değer belirtiyorsa denetim bir hata döndürür.

CSpinButtonCtrl::GetRange

Döndürme düğmesi denetimi için üst ve alt sınırları (aralık) alır.

DWORD GetRange() const;

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

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

Parametreler

indirmek
Denetim için alt sınırı alan bir tamsayıya başvuru.

Üst
Denetim için üst sınırı alan bir tamsayıya başvuru.

Dönüş Değeri

İlk sürüm, üst ve alt sınırları içeren 32 bitlik bir değer döndürür. Düşük sıralı sözcük denetimin üst sınırı, yüksek sıralı sözcük ise alt sınırdır.

Açıklamalar

Üye işlevi GetRange32 , döndürme düğmesi denetiminin aralığını 32 bit tamsayı olarak alır.

CSpinButtonCtrl::SetAccel

Döndürme düğmesi denetimi için hızlandırmayı ayarlar.

BOOL SetAccel(
    int nAccel,
    UDACCEL* pAccel);

Parametreler

nAccel
pAccel tarafından belirtilen UDACCEL yapılarının sayısı.

pAccel
Hızlandırma bilgilerini içeren UDACCEL yapıları dizisinin işaretçisi. Öğeler üyeye göre nSec artan düzende sıralanmalıdır.

Dönüş Değeri

Başarılı olursa sıfır olmayan; aksi takdirde 0.

CSpinButtonCtrl::SetBase

Döndürme düğmesi denetiminin tabanını ayarlar.

int SetBase(int nBase);

Parametreler

nBase
Denetim için yeni temel değer. Ondalık için 10 veya onaltılık için 16 olabilir.

Dönüş Değeri

Başarılı olursa önceki temel değer veya geçersiz bir taban verilirse sıfır.

Açıklamalar

Taban değer, arkadaş penceresinin sayıları ondalık veya onaltılık basamak olarak görüntüleyip görüntülemediğini belirler. Onaltılık sayılar her zaman işaretsizdir; ondalık sayılar imzalı.

CSpinButtonCtrl::SetBuddy

Döndürme düğmesi denetimi için arkadaş penceresini ayarlar.

CWnd* SetBuddy(CWnd* pWndBuddy);

Parametreler

pWndBuddy
Yeni arkadaş penceresinin işaretçisi.

Dönüş Değeri

Önceki arkadaş penceresinin işaretçisi.

Açıklamalar

Döndürme denetimi neredeyse her zaman düzenleme denetimi gibi bazı içerikleri görüntüleyen başka bir pencereyle ilişkilendirilir. Bu diğer pencere, döndürme denetiminin "dostu" olarak adlandırılır.

CSpinButtonCtrl::SetPos

Döndürme düğmesi denetimi için geçerli konumu ayarlar.

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

Parametreler

nPos
Denetim için yeni konum. Bu değer, denetimin üst ve alt sınırları tarafından belirtilen aralıkta olmalıdır.

Dönüş Değeri

Önceki konum (için SetPos16 bit duyarlık, için SetPos3232 bit duyarlık).

Açıklamalar

SetPos32 32 bit konumu ayarlar.

CSpinButtonCtrl::SetRange

Döndürme düğmesi denetimi için üst ve alt sınırları (aralık) ayarlar.

void SetRange(
    short nLower,
    short nUpper);

void SetRange32(
    int nLower,
    int nUpper);

Parametreler

nLower ve nUpper
Denetim için üst ve alt sınırlar. için SetRange, hiçbir sınır UD_MAXVAL'den büyük veya UD_MINVAL'den küçük olamaz; buna ek olarak, iki sınır arasındaki fark UD_MAXVAL aşamaz. SetRange32 sınırlar üzerinde herhangi bir kısıtlama uygulamaz; herhangi bir tamsayı kullanın.

Açıklamalar

Üye işlevi SetRange32 , döndürme düğmesi denetimi için 32 bit aralığı ayarlar.

Not

Döndürme düğmesinin varsayılan aralığı en fazla sıfır (0) ve en düşük değeri 100 olarak ayarlanmıştır. En büyük değer minimum değerden küçük olduğundan, yukarı oka tıklandığında konum azaltılır ve aşağı oka tıklandığında artırılır. Bu değerleri ayarlamak için kullanın CSpinButtonCtrl::SetRange .

Ayrıca bkz.

MFC Örnek CMNCTRL2
CWnd Sınıfı
Hiyerarşi Grafiği
CSliderCtrl Sınıfı