Athena Widget Set - C Language Interface - X Consortium ... - X.Org

Table of Contents1. Athena Widgets and The Intrinsics ................................................................... 1Introduction to the X Toolkit ......................................................................... 1Terminology .................................................................................................... 2Underlying Model .......................................................................................... 3Conventions Used in this Manual .................................................................. 4Format of the Widget Reference Chapters .................................................... 4Input Focus .................................................................................................... 62. Using Widgets ................................................................................................... 7Using Widgets ................................................................................................ 7Setting the Locale .................................................................................. 7Initializing the Toolkit ............................................................................ 7Creating a Widget .................................................................................. 8Common Resources ................................................................................ 9Resource Conversions .......................................................................... 10Realizing a Widget ............................................................................... 11Processing Events ................................................................................ 11Standard Widget Manipulation Functions ............................................ 12Using the Client Callback Interface ..................................................... 14Programming Considerations ............................................................... 15Example Programs ............................................................................... 203. Simple Widgets ............................................................................................... 21Command Widget ......................................................................................... 21Resources ............................................................................................. 22Command Actions ................................................................................. 23Grip Widget .................................................................................................. 25Resources ............................................................................................. 25Grip Actions .......................................................................................... 26Label Widget ................................................................................................ 27Resources ............................................................................................. 28List Widget ................................................................................................... 29Resources ............................................................................................. 30List Actions ........................................................................................... 32List Callbacks ....................................................................................... 33Changing the List ................................................................................. 33Highlighting an Item ............................................................................ 34Unhighlighting an Item ........................................................................ 34Retrieving the Currently Selected Item ............................................... 34Restrictions ........................................................................................... 34Panner Widget .............................................................................................. 35Resources ............................................................................................. 35Panner Actions ...................................................................................... 38Panner Callbacks .................................................................................. 39Repeater Widget .......................................................................................... 39Resources ............................................................................................. 39Repeater Actions .................................................................................. 42Scrollbar Widget .......................................................................................... 42Resources ............................................................................................. 43Scrollbar Actions .................................................................................. 45Scrollbar Callbacks ............................................................................... 46Convenience Routines .......................................................................... 47Setting Float Resources ....................................................................... 47iii