کلاس qspinbox

QSpinbox برای رسیدگی به عدد صحیح و مجموعه مقادیر گسسته (به عنوان مثال ، نام ماه) طراحی شده است. برای مقادیر نقطه شناور از Qdoublespinbox استفاده کنید.

QSpinbox به کاربر اجازه می دهد تا با کلیک بر روی دکمه های بالا/پایین یا فشار دادن بالا/پایین روی صفحه کلید ، مقداری را انتخاب کند تا مقدار نمایش داده شده را افزایش دهد. کاربر همچنین می تواند مقدار را به صورت دستی تایپ کند. جعبه چرخش از مقادیر عدد صحیح پشتیبانی می کند اما می تواند برای استفاده از رشته های مختلف با اعتبارسنجی () ، TextFromValue () و ValueFromText () استفاده شود.

هر بار که مقدار QSPinbox را تغییر می دهد سیگنال های ValueChanged () و TextChanged () را منتشر می کند ، اولی که int را ارائه می دهد و دومی QSTRING. سیگنال TextChanged () مقدار را با پیشوند () و پسوند () فراهم می کند. مقدار فعلی را می توان با مقدار () و با SetValue () تنظیم کرد.

با کلیک بر روی دکمه های بالا/پایین یا استفاده از فلش های بالا و پایین شتاب دهنده صفحه کلید ، مقدار فعلی را در مراحل SingleStep () افزایش یا کاهش می دهد. اگر می خواهید این رفتار را تغییر دهید می توانید مرحله عملکرد مجازی را دوباره () مجدداً تکرار کنید. حداقل و حداکثر مقدار و اندازه مرحله را می توان با استفاده از یکی از سازندگان تنظیم کرد و بعداً با setMinimum () ، setMaximum () و setsinglestep () تغییر یافت.

بیشتر جعبه های چرخش جهت دار هستند ، اما QSPinbox همچنین می تواند به عنوان یک جعبه چرخش دایره ای کار کند ، یعنی اگر دامنه 0-99 باشد و مقدار فعلی 99 باشد ، با کلیک بر روی "بالا" 0 در صورت بسته بندی () تنظیم می شود. اگر می خواهید رفتار دایره ای داشته باشید از setwrapping () استفاده کنید.

مقدار نمایش داده شده را می توان با رشته های دلخواه که به عنوان مثال ، ارز یا واحد اندازه گیری را نشان می دهد ، پیش بینی و ضمیمه شود. به SetPrefix () و setSuffix () مراجعه کنید. متن موجود در جعبه چرخش با متن () (که شامل پیشوند () و پسوند ()) یا با CleanText () (که هیچ پیشوند () ، بدون پسوند () و بدون فضای پیشرو یا دنباله دار) بازیابی می شود.

غالباً مطلوب است که علاوه بر دامنه مقادیر عددی ، انتخاب خاصی (اغلب پیش فرض) را به کاربر ارائه دهیم. برای نحوه انجام این کار با QSPinbox به SetSpecialValuEtext () مراجعه کنید.

زیر طبقه بندی qspinbox

در صورت استفاده از پیشوند () ، پسوند () ، و ویژه ValueText () کنترل کافی را ارائه نمی دهید ، شما qspinbox و مقدار Remplement fromText () و textfromvalue () را زیر کلاس قرار می دهید. به عنوان مثال ، در اینجا کد یک جعبه چرخش سفارشی وجود دارد که به کاربر امکان می دهد اندازه نماد را وارد کند (به عنوان مثال ، "32 x 32"):

برای کد منبع کامل به عنوان مثال نمادها را مشاهده کنید.

مستندات دارایی

[فقط خواندنی] CleanText: const qstring

این ویژگی متن جعبه چرخش را به استثنای هرگونه پیشوند ، پسوند یا فضای سفید پیشرو یا دنباله دار نگه می دارد.

توابع دسترسی:

[از 5. 2] DisplayInteGerbase: int

این ویژگی پایه ای را برای نمایش مقدار جعبه چرخش نگه می دارد

مقدار پیش فرض DisplayInteGerbase 10 است.

این خاصیت در QT 5. 2 معرفی شد.

توابع دسترسی:

حداکثر: int

این ویژگی حداکثر مقدار جعبه چرخش را در خود جای داده است

هنگام تنظیم این ویژگی حداقل در صورت لزوم تنظیم می شود تا اطمینان حاصل شود که دامنه معتبر است.

حداکثر مقدار پیش فرض 99 است.

توابع دسترسی:

حداقل: int

این ویژگی حداقل مقدار جعبه چرخش را در خود دارد

هنگام تنظیم این ویژگی ، حداکثر در صورت لزوم تنظیم می شود تا اطمینان حاصل شود که دامنه معتبر است.

حداقل مقدار پیش فرض 0 است.

توابع دسترسی:

پیشوند: qstring

این ویژگی پیشوند جعبه چرخش را در اختیار دارد

پیشوند تا شروع مقدار نمایش داده شده پیش بینی می شود. استفاده معمولی نمایش واحد اندازه گیری یا نماد ارزی است. مثلا:

برای خاموش کردن صفحه نمایش پیشوند ، این ویژگی را روی یک رشته خالی تنظیم کنید. پیش فرض پیشوند نیست. پیشوند وقتی مقدار () == حداقل () و ویژه ValueText () تنظیم می شود نمایش داده نمی شود.

اگر پیشوند تنظیم نشده باشد ، پیشوند () یک رشته خالی را برمی گرداند.

توابع دسترسی:

SingLestep: int

این ویژگی مقدار مرحله را در اختیار دارد

هنگامی که کاربر از فلش برای تغییر مقدار جعبه چرخش استفاده می کند ، مقدار با مقدار SingleStep افزایش یا کاهش می یابد. مقدار پیش فرض 1 است. تعیین مقدار SingLestep کمتر از 0 هیچ کاری انجام نمی دهد.

توابع دسترسی:

استپیت: پله

این ویژگی نوع مرحله را نگه می دارد.

نوع مرحله می تواند یک مرحله یا مرحله اعشاری تطبیقی باشد.

توابع دسترسی:

پسوند: qstring

این خاصیت پسوند جعبه چرخش را در اختیار دارد

پسوند به انتهای مقدار نمایش داده شده اضافه می شود. استفاده معمولی نمایش واحد اندازه گیری یا نماد ارزی است. مثلا:

برای خاموش کردن صفحه نمایش پسوند ، این ویژگی را روی یک رشته خالی تنظیم کنید. پیش فرض هیچ پسوند نیست. در صورت تنظیم ویژه ValueText () پسوند برای حداقل () نمایش داده نمی شود.

اگر هیچ پسوند تنظیم نشده باشد ، پسوند () یک رشته خالی را برمی گرداند.

توابع دسترسی:

مقدار: int

این ویژگی مقدار جعبه چرخش را در اختیار دارد

اگر مقدار جدید با مقدار قدیمی متفاوت باشد ، setValue () ValueChanged () منتشر می کند. ویژگی Value دارای سیگنال Notifier دوم است که شامل پیشوند و پسوند جعبه چرخش است.

توابع دسترسی:

سیگنال Notifier:

مستند سازی عملکرد عضو

qspinbox :: qspinbox (qwidget * والدین = nullptr)

یک جعبه چرخش را با 0 به عنوان حداقل مقدار و 99 به عنوان حداکثر مقدار ، یک مقدار مرحله از 1 ایجاد می کند. مقدار در ابتدا روی 0 تنظیم می شود.

[سیگنال ، از 5. 14] void qspinbox :: textchanged (const qstring & text)

این سیگنال هر زمان که متن جعبه چرخش تغییر یابد ساطع می شود. متن جدید در متن با پیشوند () و پسوند () منتقل می شود.

این عملکرد در QT 5. 14 معرفی شد.

[سیگنال] void qspinbox :: valuechanged (int i)

این سیگنال هر زمان که مقدار جعبه چرخش تغییر یابد ساطع می شود. مقدار عدد صحیح مقدار جدید در من منتقل می شود.

توجه: سیگنال Notifier برای مقدار خاصیت.

[مجازی] qspinbox ::~qspinbox ()

[نادیده گرفتن محافظت شده مجازی] BOOL QSPINBOX :: رویداد (رویداد qevent *)

[نادیده گرفتن محافظت شده مجازی] void qspinbox :: fixup (qstring & input) const

void qspinbox :: setRange (حداقل int ، حداکثر int)

عملکرد راحتی برای تنظیم حداقل و حداکثر مقادیر با یک تماس عملکردی واحد.

برابر است با:

[از 5. 12] void qspinbox :: setSteptype (qabstractspinbox :: steptype steptype)

نوع مرحله را برای جعبه چرخش به Steptype تنظیم می کند ، که یک مرحله یا مرحله اعشاری تطبیقی است.

مرحله اعشاری تطبیقی بدان معنی است که اندازه مرحله به طور مداوم به یک قدرت ده زیر مقدار فعلی تنظیم می شود. بنابراین هنگامی که مقدار 1100 است ، مرحله روی 100 تنظیم می شود ، بنابراین یک بار آن را به 1200 افزایش می دهد. برای 1200 پله آن را به 1300 می رساند. برای مقادیر منفی ، کنار گذاشتن ا ز-1100 ب ه-1200 می رود.

Step direction is taken into account to handle edges cases, so that stepping down from 100 takes the value to 99 instead of 90. Thus a step up followed by a step down -- or vice versa -- always lands on the starting value; 99 > 100 >99

تنظیم این امر باعث می شود جعبه چرخش از ارزش SingLestep نادیده بگیرد ، اگرچه در صورت خاموش شدن مرحله اعشاری تطبیقی ، SingLestep به اجرا در می آید.

توجه: عملکرد تنظیم کننده برای Steptype.

این عملکرد در QT 5. 12 معرفی شد.

[محافظت شده مجازی] QString qspinbox :: textfromvalue (مقدار int) const

این تابع مجازی هر زمان که نیاز به نمایش مقدار داده شده داشته باشد توسط جعبه چرخش استفاده می شود. اجرای پیش فرض رشته ای حاوی مقدار چاپ شده به روش استاندارد با استفاده از QWidget::locale(). toString() را برمی گرداند، اما با حذف هزار جداکننده، مگر اینکه setGroupSeparatorShown() تنظیم شود. پیاده سازی مجدد ممکن است هر چیزی را برگرداند.(نمونه را در توضیحات مفصل ببینید.)

توجه: QSpinBox این تابع را برای specialValueText() فراخوانی نمی کند و نه پیشوند() و نه پسوند () نباید در مقدار برگشتی گنجانده شود.

اگر این را مجدداً پیاده سازی کنید، ممکن است نیاز داشته باشید که valueFromText() و validate() را مجدداً پیاده سازی کنید.

[نسخ مجازی محافظت شده] QValidator::State QSpinBox:: اعتبارسنجی (QString & text, int & pos ) const

[مجازی محافظت شده] int QSpinBox:: valueFromText (const QString & text ) const

این تابع مجازی هر زمان که نیاز به تفسیر متن وارد شده توسط کاربر به عنوان مقدار داشته باشد توسط جعبه چرخش استفاده می شود.

زیر کلاس هایی که باید مقادیر جعبه چرخش را به روشی غیر عددی نمایش دهند، باید این تابع را دوباره پیاده سازی کنند.

توجه: QSpinBox () specialValueText را به طور جداگانه مدیریت می کند. این تابع فقط به مقادیر دیگر مربوط می شود.

© 2022 شرکت Qt Ltd. اسناد ارائه شده در اینجا متعلق به صاحبان مربوطه است. اسناد ارائه شده در اینجا تحت شرایط مجوز اسناد آزاد گنو نسخه 1. 3 که توسط بنیاد نرم افزار آزاد منتشر شده است، دارای مجوز هستند. Qt و لوگوهای مربوطه علائم تجاری The Qt Company Ltd. در فنلاند و/یا سایر کشورهای جهان هستند. سایر علائم تجاری متعلق به صاحبان مربوطه می باشد.