Documentation Photon 1.13

Hello, can anyone tell me where I can find Photon 1.13 Toolkit´s documentaion? I´ve found only Photon 1.12 and 1.14´s docs.

Thanks

The Photon 1.12 docs should also apply to 1.13.

Are there no New Resources??

Sorry – I was thinking about the printed docs (Photon 1.12 was a long time ago).

We printed some “What’s New in 1.12” books, and we later printed 1.13 docs. If you have the printed docs from 1998, they’re for 1.13. As you’ve probably discovered, we have the 1.14 HTML docs on our website (www.qnx.com).

What did you want to know about Photon 1.13?

I´d like to know about new widget´s features.
I´m “upgrading” my 1.12 application to 1.14, but I´ve found some troubles, so, maybe this can be explained with 1.13 documentation.
Thanks

Here’s a summary of the changes to the widgets in 1.13. It’s from the preface to the Widget Reference. I hope it helps you.

What’s new in Photon 1.13

New functionality

  • PtCalendar
  • PtClock
  • PtTab

New content in the docs

PtHtml
A table of additional supported entities has been added.
PtList
The following convenience functions have been added:
o PtListGotoPos()
o PtListRemovePositions()
o PtListSelectPos()
o PtListShowPos()
o PtListUnselectPos()
PtMessage
Pt_ARG_MSG_ESCAPE is a new resource. It specifies the number of the
button that Esc is bound to. If the value is 0 (the default), the Esc
key is disabled; otherwise the callback for the specified button is
invoked when Esc is pressed. This addition doesn’t affect the default
behavior of the widget.
PtNumeric
Pt_ARG_NUMERIC_FLAGS has a new flag, Pt_NUMERIC_HEXADECIMAL, that causes
the value of a PtNumericInteger to be displayed in hexadecimal.
PtNumericInteger
To display the value in hexadecimal, set Pt_NUMERIC_HEXADECIMAL in the
Pt_ARG_NUMERIC_FLAGS resource.
PtTerminal
The following convenience functions have been added:
o PtTerminalCopy()
o PtTerminalGetSelection()
o PtTerminalPasteClipboard()
o PtTerminalPasteSelection()
o PtTerminalSelectWord()
PtTty
The structure pointed to by the Pt_ARG_TTY_SPAWN_OPTIONS resource is now
of type PtSpawnOptions_t. It’s described in the entry for PtSpawn() in
the Photon Library Reference.
PtWindow
Ph_WM_STATE_ISBLOCKED has been added to the possible bits for
Pt_ARG_WINDOW_STATE.

The event_state and rid members of the PhWindowEvent_t structure are now 
described. 

Corrections

PtBasic
Pt_ARG_BANDWIDTH_THRESHOLD has been added to the list of new resources.
This resource is used only by a few widgets.

The default value for Pt_ARG_TRANS_PATTERN is Pg_PAT_NONE. 
The following resources are inherited by all descendents of PtBasic: 

  o	Pt_ARG_HIGHLIGHT_ROUNDNESS 
  o	Pt_CB_REPEAT 

PtBkgd
Pt_ARG_HELP_TOPIC has been added to the list of inherited resources.
PtButton
The following have been added to the list of inherited resources:
o Pt_ARG_ACCEL_KEY
o Pt_ARG_BALLOON_COLOR
o Pt_ARG_BALLOON_FILL_COLOR
o Pt_ARG_BALLOON_POSITION
o Pt_ARG_LABEL_DATA
o Pt_ARG_LABEL_FLAGS
o Pt_ARG_LABEL_TYPE
o Pt_ARG_UNDERLINE_TYPE
o Pt_ARG_UNDERLINE1
o Pt_ARG_UNDERLINE2
o Pt_CB_BLOCKED
o Pt_CB_REPEAT
PtContainer
The Pt_ARG_ANCHOR_OFFSETS resource for descendents of PtContainer isn’t
displayed in PhAB because PhAB sets it automatically.
PtDBContainer
Pt_ARG_ANCHOR_FLAGS and Pt_ARG_ANCHOR_OFFSETS have been added to the
list of inherited resources.
PtDivider
Pt_ARG_DIVIDER_SIZES is the array of positions and sizes of realized
children of the divider.

Pt_ARG_BANDWIDTH_THRESHOLD is inherited from PtBasic. 

PtEllipse
Pt_ARG_DASH_SCALE has been added to the list of inherited resources.
PtFileSel
The synopsis of PtFSGetSelIndexes() has been corrected; buffer and the
function’s returned value are both of type unsigned short *.

The reason_subtype for a Pt_CB_FS_STATE callback is either 
Pt_TREE_COLLAPSING or Pt_TREE_EXPANDING. 
If the Pt_FS_SINGLE_LEVEL flag is set in the Pt_ARG_FS_FLAGS resource, 
the item field for a Pt_CB_FS_STATE callback is always NULL because all 
the previous items are destroyed when you select a new directory in 
single-level mode. 
Pt_FS_NEW_ITEM and Pt_FS_HANDLER have been added to the list of reason 
subtypes for the Pt_CB_FS_BKGD_HANDLER callback. 
Pt_CB_SCROLL_MOVE has been added to the list of inherited resources. 

PtGauge
The names of Pt_ARG_GAUGE_VALUE_PREFIX and Pt_ARG_GAUGE_VALUE_SUFFIX
have been corrected in the list of new resources.
PtGenTree
The C type for Pt_CB_GEN_TREE_INPUT is PtCallback_t *, not
PtCallbackInfo_t.

Pt_CB_SCROLL_MOVE has been added to the list of inherited resources. 

PtGraphic
The description of Pt_ARG_DASH_SCALE in the list of new resources has
been improved.
PtHtml
Pt_ARG_HTML_FLAGS has been added to the list of new resources.

Pt_ARG_HTML_SCROLL_WIDTH is the width of the vertical scrollbar and the 
height of the horizontal scrollbar, in pixels. 

PtLabel
The C type for Pt_ARG_HORIZONTAL_ALIGNMENT is unsigned char, not
unsigned short.
PtLine
Pt_ARG_DASH_SCALE and Pt_ARG_GRAPHIC_FLAGS have been added to the list
of inherited resources.
PtList
This widget uses the Tab character as a column separator.

Pt_CB_SCROLL_MOVE has been added to the list of inherited resources. 

PtMenu
The complete menu example has been corrected to use PhDim_t instead of
PhPoint_t for Pt_ARG_DIM resources.

The default override for Pt_ARG_RESIZE_FLAGS in the list of inherited 
resources is Pt_RESIZE_XY_AS_REQUIRED, not Pt_RESIZE_AS_REQUIRED. 

PtMenuBar
Pt_ARG_ANCHOR_OFFSETS and Pt_ARG_HELP_TOPIC have been added to the list
of inherited resources.
PtMultiText
Pt_CB_TEXT_CHANGED is inherited from PtText, not PtWidget.
PtNumeric
Pt_ARG_NUMERIC_SPACING has been added to the table of new resources.

The default override for Pt_ARG_RESIZE_FLAGS in the list of inherited 
resources is Pt_RESIZE_XY_AS_REQUIRED, not Pt_RESIZE_AS_REQUIRED. 

PtNumericFloat
The C type for Pt_CB_NUMERIC_CHANGED is PtCallback_t *, not
PtCallbackInfo_t, and the Pt type is Link.

Pt_ARG_NUMERIC_SPACING has been added to the table of inherited 
resources. 
The default override for Pt_ARG_RESIZE_FLAGS in the list of inherited 
resources is Pt_RESIZE_XY_AS_REQUIRED, not Pt_RESIZE_AS_REQUIRED. 

PtNumericInteger
The C type for Pt_CB_NUMERIC_CHANGED is PtCallback_t *, not
PtCallbackInfo_t, and the Pt type is Link.

Pt_ARG_NUMERIC_SPACING has been added to the table of inherited 
resources. 
The default override for Pt_ARG_RESIZE_FLAGS in the list of inherited 
resources is Pt_RESIZE_XY_AS_REQUIRED, not Pt_RESIZE_AS_REQUIRED. 

PtOnOffButton
The C type for Pt_CB_ONOFF_NEW_VALUE is PtCallback_t *, not PtCallback_t
.

The following have been added to the list of inherited resources: 

  o	Pt_ARG_ACCEL_KEY 
  o	Pt_ARG_BALLOON_COLOR 
  o	Pt_ARG_BALLOON_FILL_COLOR 
  o	Pt_ARG_BALLOON_POSITION 
  o	Pt_ARG_INDICATOR_DEPTH 
  o	Pt_ARG_LABEL_BALLOON 
  o	Pt_ARG_LABEL_DATA 
  o	Pt_ARG_LABEL_FLAGS 
  o	Pt_ARG_LABEL_TYPE 
  o	Pt_ARG_UNDERLINE_TYPE 
  o	Pt_ARG_UNDERLINE1 
  o	Pt_ARG_UNDERLINE2 


PtOnOffButton inherits Pt_ARG_SET_COLOR, not Pt_ARG_SET_FILL, from 
PtToggleButton. 

PtPixel
Pt_ARG_LINE_WIDTH, Pt_CB_GOT_FOCUS, and Pt_CB_LOST_FOCUS have been added
to the list of inherited resources.
PtPolygon
Pt_ARG_DASH_SCALE, Pt_CB_GOT_FOCUS, and Pt_CB_LOST_FOCUS have been added
to the list of inherited resources.
PtPrintSel
The name of Pt_ARG_PRINT_FLAGS has been corrected in the list of new
resources, and a new flag, Pt_PRINTSEL_NO_PREVIEW, has been added.
PtRaw
The example at the end of the Description has been corrected to use
PhDim_t instead of PhPoint_t for Pt_ARG_DIM resources.

Pt_CB_GOT_FOCUS and Pt_CB_LOST_FOCUS have been added to the list of 
inherited resources. 

PtRect
Pt_ARG_DASH_SCALE has been added to the list of inherited resources.
PtScrollArea
The C type for Pt_CB_SCROLLED_X and Pt_CB_SCROLLED_Y is PtCallback_t *,
not PtCallback_t.
PtScrollbar
Pt_ARG_BANDWIDTH_THRESHOLD is inherited from PtBasic.

Pt_ARG_INCREMENT defines the value (based on the scrollbar's maximum and 
minimum values), not the number of pixels, that the widget will scroll 
by when the user clicks the arrow buttons. 

PtTerminal
Pt_ARG_BANDWIDTH_THRESHOLD is inherited from PtBasic.
PtText
It’s better to use a Pt_CB_MODIFY_VERIFY callback than an edit mask to
verify input.

If Pt_CHANGE_ACTIVATE is set in the Pt_ARG_TEXT_FLAGS resource, then if 
the text is changed and the widget loses focus, the Pt_CB_ACTIVATE
 callback is invoked with the Pt_CHANGE_ACTIVATE (not Pt_EDIT_ACTIVATE) 
subtype. 
The following have been added to the list of inherited resources: 

  o	Pt_ARG_BALLOON_COLOR 
  o	Pt_ARG_BALLOON_FILL_COLOR 
  o	Pt_ARG_BALLOON_POSITION 

PtToggleButton
The following have been added to the list of inherited resources:
o Pt_ARG_BALLOON_COLOR
o Pt_ARG_BALLOON_FILL_COLOR
o Pt_ARG_BALLOON_POSITION
o Pt_ARG_LABEL_BALLOON
PtTree
This widget uses the Tab character as a column separator.

Pt_CB_SCROLL_MOVE has been added to the list of inherited resources. 
Don't use PtTreeModifyItem() to modify an item that hasn't yet been 
added to the tree. 

PtTty
Pt_ARG_BANDWIDTH_THRESHOLD is inherited from PtBasic.
PtUpDown
Pt_ARG_TRANS_PATTERN is inherited from PtBasic.
PtWidget
Pt_ARG_DIM is of type PhDim_t, not PhPoint_t.

The C type for Pt_CB_REALIZED and Pt_CB_UNREALIZED is PtCallback_t *, 
not PtCallback_t. 
Pt_ARG_DATA has been added to the list of new resources, although it 
should be used only when building custom widgets. 
Pt_ARG_BITMAP_CURSOR and Pt_CB_BLOCKED are inherited by all descendants 
of PtWidget. 

PtWindow
The default value of Pt_ARG_WINDOW_NOTIFY_FLAGS is
Ph_WM_RESIZE|Ph_WM_CLOSE| Ph_WM_HELP.

You can change the state by setting Pt_ARG_WINDOW_STATE before the 
window is realized. After it's been realized, you'll need to call 
PtForwardWindowEvent() or PtForwardWindowTaskEvent(). 
A window can't have a border or margins, so the following inherited 
resources aren't supported: 

  o	Pt_ARG_BORDER_WIDTH 
  o	Pt_ARG_BOT_BORDER_COLOR 
  o	Pt_ARG_MARGIN_HEIGHT 
  o	Pt_ARG_MARGIN_WIDTH 
  o	Pt_ARG_TOP_BORDER_COLOR 

RtMeter
The full meter example has been corrected to use PhDim_t instead of
PhArea_t for Pt_ARG_DIM resources.

Pt_ARG_TRANS_PATTERN is inherited from PtBasic. 

RtProgress
The default value of Pt_ARG_RESIZE_FLAGS inherited from PtWidget is
Pt_RESIZE_XY_AS_REQUIRED.

In addition, the description of each widget now includes its icon (if
any) from PhAB’s widget bar.

Thank you very much.
That was it.

Regards
Paulista