![[Previous]](image-lib/prev.gif){kind=small} |
![[Bookset]](image-lib/contents.gif){kind=small} |
![[Next]](image-lib/next.gif){kind=small} |
|
|
|
The widget toolkit functions let you create or destroy widgets, or manipulate widgets and the relationships between them. These functions gather detailed information about widgets and their environment.
 |
For widget extension functions (which extend the attributes of a widget beyond its resources) and convenience functions (which simplify control over certain widget resources), see the Widget Reference. |
| Entry | Description |
|---|---|
| PtAddCallback() | Add a single callback entry to a callback list |
| PtAddCallbacks() | Add several callback entries to a callback list |
| PtAddData() | Add data to the provided data chain |
| PtAddEventHandler() | Add a single event handler entry to a widget |
| PtAddEventHandlers() | Add several event handler entries to a widget |
| PtAddHotkeyHandler() | Add a single hotkey handler entry to a widget |
| PtAppAddFd() | Add a file-descriptor function |
| PtAppAddFdPri() | Add a file-descriptor function, specifying a priority |
| PtAppAddInput() | Add an input processing function |
| PtAppAddSignalProc() | Add Photon signalling to a context |
| PtAppAddWorkProc() | Add a WorkProc (background) function |
| PtAppCreatePulse() | Create a Photon pulse |
| PtAppDeletePulse() | Delete a Photon pulse |
| PtAppInit() | Initialize an application and create the main window |
| PtAppPulseTrigger() | Deliver a pulse to yourself |
| PtAppRemoveFd() | Remove a file-descriptor function |
| PtAppRemoveInput() | Remove an input processing entry |
| PtAppRemoveSignal() | Remove Photon signalling from a context |
| PtAppRemoveSignalProc() | Remove Photon signalling from a context |
| PtAppRemoveWorkProc() | Remove a WorkProc processing function |
| PtArg_t | Which resource is affected when you get or set resources |
| Pt_ARG() | Macro for creating statically initialized argument lists |
| PtAskQuestion() | Display a question and request a response from the user |
| PtBasicWidgetCanvas() | Determine the PtBasic canvas for a widget |
| PtBkgdHandlerProcess() | Process all outstanding Photon events |
| PtCalcAbsPosition() | Calculate the position of a widget based on a position and another widget |
| PtChannelCreate() | Make sure the widget library is using a channel |
| PtChildType() | Determine the relationship between two widgets |
| PtClearWidget() | Destroy all widgets within a container |
| PtConsoleSwitch() | Switch to another virtual console |
| PtContainerBox() | Find the next widget in an area |
| PtContainerFindFocus() | Find the currently focused widget |
| PtContainerFocusNext() | Give focus to the next Pt_GETS_FOCUS widget |
| PtContainerFocusPrev() | Give focus to the previous Pt_GETS_FOCUS widget |
| PtContainerGiveFocus() | Give focus to a widget |
| PtContainerHit() | Find the nth widget in an area |
| PtContainerHold() | Prevent repairs to a container widget and its children |
| PtContainerNullFocus() | Nullify the focus of a widget |
| PtContainerRelease() | Decrement the hold count for a widget |
| PtCreateAppContext() | Create a new application context |
| PtCreateWidget() | Create a widget |
| PtDamageExtent() | Mark an area of a widget as damaged so that it will be redrawn |
| PtDamageWidget() | Mark a widget as damaged so it will be redrawn |
| PtDestroyWidget() | Remove a widget from the widget hierarchy |
| PtDeTranslateRect() | Translate events, extents, or canvases |
| PtEndFlux() | Decrement the global and container flux count |
| PtEventHandler() | Determine the widgets involved in an event |
| PtExtentWidget() | Force a widget to calculate its extent |
| PtExtentWidgetFamily() | Force a widget and its children to calculate their extents |
| PtFDProc_t | Pointer to a file-descriptor function |
| PtFileSelection() | Create a file-selector dialog |
| PtFindChildClass() | Find the first child that matches the specified class |
| PtFindChildClassMember() | Find the first child that's a subclass of the specified class |
| PtFindContainer() | Return the nearest container parent |
| PtFindData() | Find the first data block of a given type and subtype |
| PtFindDisjoint() | Return the nearest disjoint parent widget |
| PtFindFocusChild() | Find the closest focusable child widget |
| PtFindGuardian() | Find the widget responsible for another widget's actions |
| PtFindNextData() | Find the next data block of a given type and subtype |
| PtFlush() | Immediately repair widget damage |
| PtFontSelection() | Create a font-selector dialog |
| PtForwardWindowEvent() | Forward a window event |
| PtForwardWindowTaskEvent() | Forward a window event, given a process ID |
| PtFrameSize() | Determine the size of the window frame borders |
| PtGetAbsPosition() | Get the absolute position of a widget |
| PtGetControlFlags() | Get the flags from the _Pt_ control structure |
| PtGetParent() | Find the nearest widget with the same parent class |
| PtGetParentWidget() | Return the current default widget parent |
| PtGetRcvidPid() | Get the process ID (PID) from the receive ID (RCVID) |
| PtGetResources() | Retrieve resource values for a widget |
| PtGlobalFocusNext() | Give focus to next widget |
| PtGlobalFocusNextContainer() | Give focus to another container's widget |
| PtGlobalFocusNextFrom() | Give focus to the next widget behind the specified widget |
| PtGlobalFocusPrev() | Give focus to the previous widget |
| PtGlobalFocusPrevContainer() | Give focus to widget in previous container |
| PtGlobalFocusPrevFrom() | Give focus to widget previous to the specified widget |
| PtHit() | Identify a widget in the specified container |
| PtHold() | Prevent visible repair of all widgets |
| PtInflateBalloon() | Create a balloon widget |
| PtInit() | Initialize the widget library |
| PtInputCallbackProc_t | Pointer to a input callback function |
| PtIsFluxing() | Determine whether a container or its family is in flux |
| PtIsFocused() | Determine to what degree a widget is focused |
| PtLabelWidgetCanvas() | Determine the PtLabel canvas for a widget |
| PtMainLoop() | Implement an application main loop |
| PtMessageBox() | Pop up a message box |
| PtModalEnd() | Terminate modal-window processing |
| PtModalStart() | Initiate modal-window processing |
| PtNextTopLevelWidget() | Get a pointer to the next top-level widget |
| PtPositionMenu() | Set a menu's position |
| PtPrintSelection() | Create a print-selector dialog |
| PtProcessEvent() | Standard Photon event-handling function |
| PtPulseArmFd() | Create a pulse message to be sent to another process |
| PtPulseArmPid() | Create a pulse message to be sent to another process |
| PtPulseDeliver() | Send a pulse to another process |
| PtPulseDisarm() | Release resources allocated for a pulse message |
| PtQuerySystemInfo() | Query the system for information |
| PtRealizeWidget() | Initialize a widget and its children |
| PtReattach() | Send an application through the jump gate |
| PtRectIntersect() | Find the intersection of two rectangles |
| PtRectUnion() | Determine a bounding box for two rectangles |
| PtRelease() | Decrement the global widget hold count |
| PtRemoveCallback() | Remove a single callback entry from a callback list |
| PtRemoveCallbacks() | Remove several callback entries from a callback list |
| PtRemoveData() | Remove a link from a data chain |
| PtRemoveEventHandler() | Remove a single event-handler entry from a widget |
| PtRemoveEventHandlers() | Remove several event-handler entries from a widget |
| PtRemoveHotkeyHandler() | Remove a single hotkey handler entry from a widget |
| PtReParentWidget() | "Re-parent" a widget to a new container |
| PtRealizeWidget() | Initialize a widget and its children |
| PtResizeEventMsg() | Resize the event buffer |
| PtSendEventToWidget() | Give an event to a widget |
| PtSetAreaFromExtent() | Set an area based on the extent of a widget |
| PtSetAreaFromWidgetCanvas() | Set an area based on the canvas of a widget |
| PtSetArg() | Build argument lists for widgets |
| PtSetParentWidget() | Set the current parent widget |
| PtSetResources() | Set resources for a widget |
| PtSignalProc_t | Pointer to a signal-handling function |
| PtSpawn() | Spawn a new process |
| PtSpawnDeleteCallback() | Remove a child-termination callback |
| PtSpawnSetCallback() | Change the callback in a PtSpawn() control structure |
| PtSpawnWait() | Spawn a process and wait for its termination |
| PtStartFlux() | Increment the global and container flux count |
| PtSyncPhoton() | Synchronize Photon |
| PtSyncWidget() | Synchronize widget |
| PtTimerArm() | Arm a timer event on a widget |
| PtTranslateRect() | Translate a rectangle |
| PtUnlinkData() | Remove the provided data link from the data chain |
| PtUnrealizeWidget() | Unrealize a widget |
| PtUpdate() | Decrement the global hold count |
| PtValidParent() | Identify a valid parent for the specified widget |
| PtWidgetArea() | Retrieve a copy of a widget's area |
| PtWidgetBrotherBehind() | Get the brother behind a widget |
| PtWidgetBrotherInFront() | Get the brother in front of a widget |
| PtWidgetCanvas() | Determine the PtWidget canvas for a widget |
| PtWidgetChildBack() | Get the child that's farthest back in a container |
| PtWidgetChildFront() | Get the the child at the very front of a container |
| PtWidgetClass() | Return the class of a widget |
| PtWidgetClassFlags() | Retrieve a widget's class structure flags |
| PtWidgetDim() | Retrieve a copy of a widget's dimension |
| PtWidgetExtent() | Get a widget's extent |
| PtWidgetFamily() | Traverse the widget hierarchy |
| PtWidgetFlags() | Retrieve a widget's flags |
| PtWidgetHelpHit() | Find the first widget at a given position that has a help topic |
| PtWidgetInsert() | Insert a widget in the widget family hierarchy |
| PtWidgetIsClass() | Determine whether a widget is a specific class type |
| PtWidgetIsClassMember() | Determine whether a widget belongs to a specified class |
| PtWidgetIsRealized() | Determine whether a widget is realized |
| PtWidgetOffset() | Find the offset of a widget's origin |
| PtWidgetParent() | Get a widget's parent |
| PtWidgetRid() | Get a widget's region ID |
| PtWidgetSkip() | Skip to a widget in the next hierarchy |
| PtWidgetToBack() | Move a widget behind all its brothers |
| PtWidgetToFront() | Move a widget in front of all its brothers |
| PtWidgetTree() | Walk the widget tree from front to back |
| PtWidgetTreeTraverse() | Walk the widget family hierarchy from front to back |
| PtWidgetVisibleExtent() | Calculate the visible portion of a widget |
| PtWindowConsoleSwitch() | Switch to the console a given window's displayed on |
| PtWorkProc_t | Pointer to a work procedure function |
|
|
|