... 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|..|... )