This shows you the differences between two versions of the page.
software:gui-designer:joins [2013/10/07 03:46] jarrod [Serial Joins] |
software:gui-designer:joins [2013/10/29 03:22] (current) jarrod |
||
---|---|---|---|
Line 66: | Line 66: | ||
A list join is used to identify a List object. | A list join is used to identify a List object. | ||
- | Within guiDesigner, list join numbers will appear on a red background above the object the join is assigned to when 'View > Display Object Join Numbers' is enabled. | + | Within guiDesigner, list join numbers will appear on a purple (dark red in older versions of guiDesigner) background above the object the join is assigned to when 'View > Display Object Join Numbers' is enabled. |
+ | |||
+ | The image below gives shows how a basic list join system can work. Please note that this is only showing one of many possible ways that list joins can work. | ||
+ | |||
+ | {{:software:gui-designer:list-joins.png?nolink|}} | ||
+ | |||
+ | In this example, the user is selecting an album. A list is then being populated with the album track information. It would work as follows: | ||
+ | - The user selects the album by pressing the "Select Album" button. This could be any way of selecting an album e.g. pressing an album cover | ||
+ | - iViewer requests the album track list from the media server | ||
+ | - iViewer then looks at the data returned from the media server and determines if it is a track item. (In this example we are loading one track item at a time, and tracks 1 and 2 have already been loaded) | ||
+ | - iViewer creates a new list item at the end of list join 20 (the list we are populating with track items) | ||
+ | - iViewer then sets serial join 1 to the track number of the next track. In this case it is track 3 | ||
+ | - Then iViewer sets serial join 2 as the track name | ||
+ | - The process then starts again with the next track until there are no tracks remaining | ||
===== Join Numbers ===== | ===== Join Numbers ===== |