PtNumericFloat

Floating-point numeric widget

Class hierarchy:

PtWidget → PtBasic → PtContainer → PtCompound → PtNumeric → PtNumericFloat

For more information, see the diagram of the widget hierarchy.

PhAB icon:

Public header:

<photon/PtNumericFloat.h>

Description:

The PtNumericFloat class is a numeric widget that lets you enter floating-point values between given minimum and maximum values. You can also use an incorporated PtScrollbar to increase or decrease the value by a set amount.

A PtNumericFloat widget.

In addition, you can use the resources defined by PtNumeric to add prefix and suffix strings, and use comma separators. You can use Pt_ARG_NUMERIC_PRECISION to specify the precision of the number (i.e. the number of decimal places, for example, 1,000.00).

PtNumericFloat defines several resources with a C type of double * and a Pt type of Struct. Remember that you can't set and get them as if they were scalar values. Here's how to set the widget's value:

double number = 5.55;

PtSetResource (ABW_base_float, Pt_ARG_NUMERIC_VALUE,
               &number, 0);

Here's how to get the value:

double *number;

PtGetResource (ABW_base_float, Pt_ARG_NUMERIC_VALUE,
               &number, 0);
printf ("Value is %f\n", *number);

---

PtNumericFloat isn't included in the shared ph library because it uses floating-point operations. If you use it in a non-PhAB application, link with the static library. For more information, see Compiling and linking a non-PhAB application in the Programming Photon without PhAB chapter of the Photon Programmer's Guide.

---

New resources:

Pt_ARG_NUMERIC_INCREMENT

The value by which to increase or decrease the value when the up/down buttons are pressed.

Pt_ARG_NUMERIC_MAX

The maximum value for the widget.

Pt_ARG_NUMERIC_MIN

The minimum value for the widget.

Pt_ARG_NUMERIC_PRECISION

The precision or number of displayed decimal places of the widget's current value.

Pt_ARG_NUMERIC_VALUE

The current value of the widget.

Pt_CB_NUMERIC_CHANGED

A list of PtCallback_t structures that define the callbacks invoked when the widget's value changes.

If the widget has the Pt_CALLBACKS_ACTIVE bit set in its Pt_ARG_FLAGS resource, these callbacks are also invoked when your application changes the Pt_ARG_NUMERIC_VALUE with a call to PtSetResource() or PtSetResources(), or if the Pt_ARG_NUMERIC_VALUE is changed indirectly by a change to Pt_ARG_NUMERIC_MIN or Pt_ARG_NUMERIC_MAX.

Each callback is passed a PtCallbackInfo_t structure that contains at least the following members:

reason

Pt_CB_NUMERIC_CHANGED

reason_subtype

A subtype that indicates why the callback was invoked:

• Pt_NUMERIC_CHANGED — the text in the numeric's text field has been changed.
• Pt_NUMERIC_SET — PtSetResource() or PtSetResources() was called to change the current value.
• Pt_NUMERIC_UPDOWN_ACTIVATE — a button was pressed to change the current value.
• Pt_NUMERIC_UPDOWN_REPEAT — a button was held down to change the current value.

event

A pointer to a PhEvent_t structure that describes the event that caused the callback to be invoked, or NULL if there isn't an event.

cbdata

A pointer to a PtNumericFloatCallback_t structure that contains at least:

• double numeric_value — the current value of the widget

These callbacks should return Pt_CONTINUE.

Exported subordinate children:

Unless the resources are already defined in PtNumericFloat, the PtNumericFloat class uses the resources of its exported subordinate child, PtScrollbar.

The PtNumericFloat class “inherits” all the resources of its exported subordinate child. Where PtNumericFloat and its exported subordinate child both define resources having the same name, the resource defined in PtNumericFloat takes precedence.

Inherited resources:

If the widget modifies an inherited resource, the “Default override” column indicates the new value. This modification affects any subclasses of the widget.

Pt_CB_ACTIVATE

If cbinfo->reason_subtype is Pt_NUMERIC_ACTIVATE, the callback was invoked because you changed the value and pressed Enter while in PtNumericFloat's text field.