About This Manual

The Building Custom Widgets guide is intended for Photon programmers who want to create custom widgets.

If you're familiar with earlier versions of Photon, you should read the What's New appendix to find out what has changed in this version..

This manual contains everything you need to know about building your own Photon widgets. Sample code is used throughout this manual to demonstrate new concepts.

When you want to:	Go to:
Learn about widget concepts, attributes, and behavior	Overview
Initialize a widget class, set up a widget instance structure, or set application resources	Life Cycle of a Widget
Define a widget class, its resources, methods, or actions	Anatomy of a Widget
Choose a widget superclass to base your custom widget on	Using Widget Superclasses
Customize a list widget	Creating a List Widget
Customize a tree widget	Creating a Tree Widget
Add a custom widget to the PhAB widget palette	Binding Widgets into PhAB
Manage widgets using the supplied convenience functions	Widget Building Library API
Create a custom PhAB resource editor for your widget's resources	Creating custom resource editors
Read about the resource editor plugin API	The resource editor API
See an example of a resource editor plugin	Resource editor plugin example
Read widget-building tips	Miscellaneous Widget-Building Tips
Find out what's new in this release	What's New
Look up Photon terms	Glossary

Typographical conventions

Throughout this manual, we use certain typographical conventions to distinguish technical terms. In general, the conventions we use conform to those found in IEEE POSIX publications. The following table summarizes our conventions:

Reference	Example
Code examples	`if( stream == NULL )`
Command options	`-lR`
Commands	`make`
Environment variables	PATH
File and pathnames	`/dev/null`
Function names	exit()
Keyboard chords	Ctrl-Alt-Delete
Keyboard input	`something you type`
Keyboard keys	Enter
Program output	`login:`
Programming constants	NULL
Programming data types	`unsigned short`
Programming literals	`0xFF`, `"message string"`
Variable names	stdin
User-interface components	Cancel

We use an arrow (→) in directions for accessing menu items, like this:

You'll find the Other... menu item under Perspective-->Show View.

We use notes, cautions, and warnings to highlight important messages:

Notes point out something important or useful.

Cautions tell you about commands or procedures that may have unwanted or undesirable side effects.

Warnings tell you about commands or procedures that could be dangerous to your files, your hardware, or even yourself.

Note to Windows users

In our documentation, we use a forward slash (/) as a delimiter in all pathnames, including those pointing to Windows files.

We also generally follow POSIX/UNIX filesystem conventions.

Technical support

To obtain technical support for any QNX product, visit the Support area on our website (www.qnx.com). You'll find a wide range of support options, including community forums.