PtRegion

A Photon region

Class hierarchy:

PtWidget → PtBasic → PtContainer → PtRegion

Immediate subclasses:

• PtServer

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

PhAB icon:

None — instantiate it by calling PtCreateWidget().

Public header:

<photon/PtRegion.h>

Description:

PtRegion is ideal for controlling a region without foregoing the convenience of the Photon widget library interface. With PtRegion, you can control a region without having to modify the standard main loop function.

---

For more information about regions, see PhRegion_t in the Photon Library Reference, and the Regions chapter of the Photon Programmer's Guide.

---

New resources:

Pt_ARG_REGION_FIELDS

This resource indicates which portions of the region were changed the last time that you set any resources, including the flags, sensitivity, opacity, origin, and position.

The following bits can be used to define a field in a region change (PhRegionChange()) or open (PhRegionOpen()). For more information, see <PhT.h>.

---

The Ph_REGION_HANDLE, Ph_REGION_ORIGIN, and Ph_REGION_RECT bits are set up automatically when the widget is initialized.

---

Any time you change PtRegion's Pt_ARG_POS or Pt_ARG_AREA resource, the Ph_REGION_ORIGIN bit is changed automatically.

The Ph_REGION_BEHIND bit defines which region this region will be opened in front of. The specified region becomes the brother in behind. A value of 0 makes the region the rearmost child of its parent when created.

Any time you change PtRegion's Pt_ARG_AREA or Pt_ARG_DIM resource, the Ph_REGION_RECT bit is changed automatically.

Pt_ARG_REGION_FLAGS

Defines the region type and behavior:

• Ph_WINDOW_REGION
• Ph_WND_MGR_REGION
• Ph_GRAFX_REGION
• Ph_PTR_REGION
• Ph_KBD_REGION
• Ph_PRINT_REGION
• Ph_INPUTGROUP_REGION
• Ph_AUXPTR_REGION
• Ph_FORCE_FRONT
• Ph_FOLLOW_IG_SIZE
• Ph_FORCE_BOUNDARY
• Ph_NO_COMPRESSION
• Ph_CURSOR_SET

Pt_ARG_REGION_INFRONT

Defines which region (rid) this region will be opened behind. The specified region becomes the brother in front. A value of 0 makes the region the frontmost child of its parent when created.

Pt_ARG_REGION_INPUT_GROUP

Associates the region with the specified input group.

Pt_ARG_REGION_OPAQUE

A bitmask that defines which events this region is opaque to. For a list of event types, see PhEvent_t in the Photon Library Reference.

Pt_ARG_REGION_PARENT

Specifies the ID (rid) of the region that will be this region's parent.

Pt_ARG_REGION_RECTANGLES

This resource allows you to create a region with more than one rectangle. When this array has at least one element, the widget uses the rectangle(s) in the array rather than its own extent for the rectangle set of its region.

Pt_ARG_REGION_SENSE

A bitmask that defines which events this region is sensitive to. For a list of event types, see PhEvent_t in the Photon Library Reference.

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.