How to Implement CNumEdit in Your MFC Application
Summary
CNumEdit is a custom MFC edit control for numeric input (integers/floats) with built‑in validation, range limits, formatting, and optional spin behavior. The steps below assume a C++ MFC application using Visual Studio.
1. Add CNumEdit source to your project
- Copy CNumEdit.h and CNumEdit.cpp into your project’s Source/Include folders.
- Include the header in the dialog or view class that will host the control:
cpp
#include “CNumEdit.h”
2. Add an Edit control in the dialog resource
- Open the dialog in the Resource Editor.
- Place a standard Edit Control where you want numeric input.
- Set a unique Control ID (e.g., IDCNUMEDIT).
- (Optional) Set Styles: Visible, Tab Stop; remove Multiline.
3. Subclass the control in your dialog class
- Add a member variable to the dialog class header:
cpp
CNumEdit mnumEdit; - In OnInitDialog(), subclass the control:
cpp
BOOL CMyDialog::OnInitDialog() { CDialogEx::OnInitDialog(); m_numEdit.SubclassDlgItem(IDCNUMEDIT, this); // further configuration… return TRUE; }
4. Configure numeric behavior
- Set range, decimals, and other options via provided methods (API names may vary by implementation). Example common calls:
cpp
m_numEdit.SetRange(minValue, maxValue); // integer range m_numEdit.SetDecimalPlaces(2); // for floats m_numEdit.SetAllowNegative(TRUE); mnumEdit.SetThousandsSeparator(TRUE); - If CNumEdit supports spin buttons, attach or enable them:
cpp
m_numEdit.EnableSpin(TRUE); m_numEdit.SetSpinRange(minValue, maxValue); mnumEdit.SetSpinIncrement(1.0);
5. Retrieve and set values
- To read the current value:
cpp
double val = mnumEdit.GetValue(); - To set programmatically:
cpp
m_numEdit.SetValue(123.45);
6. Validation and notifications
- Handle control notifications (e.g., EN_CHANGE, ENKILLFOCUS) in your dialog to validate or react to changes:
cpp
void CMyDialog::OnEnKillfocusNumedit() { double v = mnumEdit.GetValue(); // enforce business rules… } - Use CNumEdit’s validation callback or override methods if provided to enforce custom parsing/formatting.
7. Localization and formatting
- Set locale/decimal separator if supported:
cpp
m_numEdit.SetLocale(LOCALE_USER_DEFAULT); - Provide format masks or custom display formatting if the class exposes them.
8. Error handling and user feedback
- On invalid input, use mnumEdit.ShowErrorTooltip(…) or standard message boxes.
- Optionally highlight the control background on error:
cpp
m_numEdit.SetBackgroundColor(RGB(255,220,220));
9. Keyboard and clipboard behavior
- Ensure CNumEdit handles Paste and keyboard navigation properly; if not, override PreTranslateMessage or WM_PASTE to sanitize input.
10. Testing
- Test edge cases: min/max, empty input, negative numbers, large precision, locale decimal/comma, paste of invalid text.
If you want, I can produce a small, complete example C++/MFC project snippet (header + implementation) using a typical CNumEdit API tailored to your specific CNumEdit version—tell me which features your CNumEdit supports (integers, floats, spin, thousands separator).
Leave a Reply