... XmSpinBoxValidatePosition - Online Linux Manual PageSection : library call

NAMEXmSpinBoxValidatePosition — translate the current value of the specified XmSpinBox child into a valid position

SYNOPSIS#include <Xm/SpinBox​.h> int XmSpinBoxValidatePosition( Widget textfield, int *position);

DESCRIPTIONThe XmSpinBoxValidatePosition function is a utility that can be used by applications wanting to implement a policy for tracking user modifications to editable XmSpinBox children of type XmNUMERIC​. The specifics of when and how the user​'s modifications take effect is left up to the application​. text_field The text_field argument specifies the widget ID of the child of the XmSpinBox that is being modified​. The requirement on text_field is that it holds the accessTextual trait (already a requirement for children of XmSpinBox)​. This way, XmSpinBox can extract the string out of the text_field widget (even if it is not an XmTextField)​. position The location pointed to by the position argument is assigned the result of the translation done by XmSpinBoxValidatePosition​. XmSpinBoxValidatePosition first checks to make sure this is an XmNUMERIC XmSpinBox child​. If it is not, XSmpinBoxValidatePosition sets position to the current position and returns XmCURRENT_VALUE​. XmSpinBoxValidatePosition attempts to translate the input string to a floating point number​. If this translation fails, XmSpinBoxValidatePosition sets position to the current position and returns XmCURRENT_VALUE​. XmSpinBoxValidatePosition converts the floating point number to an integer using the XmNdecimalPoints resource​. Extra decimal places are truncated​. The resulting integer is range checked to make sure it falls within the valid range defined by XmNminimumValue and XmNmaximumValue inclusive​. If the input falls outside this range, XmSpinBoxValidatePosition sets position to the nearest limit and returns either XmMINIMUM_VALUE or XmMAXIMUM_VALUE​. Finally, XmSpinBoxValidatePosition checks the integer to make sure it belongs to the series defined by XmNminimumValue ​.​.​. XmNminimumValue + ((n - 1) * XmNincrementValue)​. If the integer does not belong to this series, XmSpinBoxValidatePosition sets position to the nearest element which is less than or equal to the integer and returns XmINCREMENT_VALUE​. Otherwise, XmSpinBoxValidatePosition assigns the integer to position and returns XmVALID_VALUE​.

RETURN VALUEThe XmSpinBoxValidatePosition function returns the status of the validation​. The set of possible values returned is as follows: XmCURRENT_VALUE Cannot convert, returning current position_value​. XmMINIMUM_VALUE Less than min​. XmMAXIMUM_VALUE More than max​. XmINCREMENT_VALUE Not on increment​. XmVALID_VALUE Okay​.

EXAMPLESThis first example demonstrates how the XmSpinBoxValidatePosition function could be used from inside an XmNmodifyVerifyCallback callback installed on the XmSpinBox or the XmSimpleSpinBox: /* * Install a callback on a spin box arrow press​. */ XtAddCallback(sb, XmNmodifyVerifyCallback, ModifyVerifyCB, NULL); XtAddCallback(simple_sb, XmNmodifyVerifyCallback, ModifyVerifyCB, NULL);with the callback doing: void ModifyVerifyCB(widget, call_data, client_data) { XmSpinBoxCallbackStruct *cbs = (XmSpinBoxCallbackStruct*) call_data; int position; Widget textual = NULL; if (XtIsSubclass(w, xmSimpleSpinBoxWidgetClass)) { Arg args[1]; XtSetArg(args[0], XmNtextField, &textual); XtGetValues(w, args, 1); } else if (XtIsSubclass(w, xmSpinBoxWidgetClass)) textual = cbs->widget; else textual = (Widget) NULL; ​.​.​. if (XmSpinBoxValidatePosition(textual, &position) == XmCURRENT_VALUE) XBell(XtDisplay(w), 0); else cbs->position = position; }This second example demonstrates how the XmSpinBoxValidatePosition function could be used from inside an XmNactivateCallback callback installed on the TextField child of the XmSpinBox: /* * Install a callback on a spin box arrow press​. */ XtAddCallback(tf, XmNactivateCallback, ModifyVerifyChildCB, NULL);with the callback doing: void ModifyVerifyChildCB(widget, call_data, client_data) { int position; Widget textual = widget; Arg args[1]; if (XmSpinBoxValidatePosition (textual, &position) == XmCURRENT_VALUE) XBell(XtDisplay(widget), 0); /* Set the position constraint resource of the textfield */ XtSetArg(args[0], XmNposition, position); XtSetValues(textual, args, 1); }

SEE ALSOXmSpinBox(3), XmCreateSpinBox(3) ...
0
Johanes Gumabo
Data Size   :   17,081 byte
man-XmSpinBoxValidatePosition.3Build   :   2024-12-05, 20:55   :  
Visitor Screen   :   x
Visitor Counter ( page / site )   :   2 / 197,975
Visitor ID   :     :  
Visitor IP   :   3.148.115.43   :  
Visitor Provider   :   AMAZON-02   :  
Provider Position ( lat x lon )   :   39.962500 x -83.006100   :   x
Provider Accuracy Radius ( km )   :   1000   :  
Provider City   :   Columbus   :  
Provider Province   :   Ohio ,   :   ,
Provider Country   :   United States   :  
Provider Continent   :   North America   :  
Visitor Recorder   :   Version   :  
Visitor Recorder   :   Library   :  
Online Linux Manual Page   :   Version   :   Online Linux Manual Page - Fedora.40 - march=x86-64 - mtune=generic - 24.12.05
Online Linux Manual Page   :   Library   :   lib_c - 24.10.03 - march=x86-64 - mtune=generic - Fedora.40
Online Linux Manual Page   :   Library   :   lib_m - 24.10.03 - march=x86-64 - mtune=generic - Fedora.40
Data Base   :   Version   :   Online Linux Manual Page Database - 24.04.13 - march=x86-64 - mtune=generic - fedora-38
Data Base   :   Library   :   lib_c - 23.02.07 - march=x86-64 - mtune=generic - fedora.36

Very long time ago, I have the best tutor, Wenzel Svojanovsky . If someone knows the email address of Wenzel Svojanovsky , please send an email to johanes_gumabo@yahoo.co.id .
If error, please print screen and send to johanes_gumabo@yahoo.co.id
Under development. Support me via PayPal.

ERROR : Need New Coding :         (parse_manual_page_|249|XmSpinBoxValidatePosition.3|2|..|... )         (parse_manual_page_|249|XmSpinBoxValidatePosition.3|204|..|... )