author | tasneems@symbian.org |
Thu, 04 Mar 2010 15:42:37 -0800 | |
changeset 220 | 41890dfa56f5 |
permissions | -rw-r--r-- |
220
41890dfa56f5
Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff
changeset
|
1 |
<?xml version="1.0" encoding="UTF-8"?><!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> |
41890dfa56f5
Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff
changeset
|
2 |
<html lang="en" xml:lang="en"> |
41890dfa56f5
Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff
changeset
|
3 |
<head> |
41890dfa56f5
Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff
changeset
|
4 |
<meta content="text/html; charset=utf-8" http-equiv="Content-Type" /> |
41890dfa56f5
Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff
changeset
|
5 |
<meta name="copyright" content="(C) Copyright 2005" /> |
41890dfa56f5
Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff
changeset
|
6 |
<meta name="DC.rights.owner" content="(C) Copyright 2005" /> |
41890dfa56f5
Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff
changeset
|
7 |
<meta content="concept" name="DC.Type" /> |
41890dfa56f5
Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff
changeset
|
8 |
<meta name="DC.Title" content="Showing content in a view" /> |
41890dfa56f5
Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff
changeset
|
9 |
<meta scheme="URI" name="DC.Relation" content="WRTKit_Common_WRTKit_tasks-GUID-24870895-4449-4307-9a54-7c90f7b3905e.html" /> |
41890dfa56f5
Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff
changeset
|
10 |
<meta content="XHTML" name="DC.Format" /> |
41890dfa56f5
Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff
changeset
|
11 |
<meta content="GUID-7020D9EA-747D-42F3-B47C-16AD1F45DB82" name="DC.Identifier" /> |
41890dfa56f5
Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff
changeset
|
12 |
<meta content="en" name="DC.Language" /> |
41890dfa56f5
Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff
changeset
|
13 |
<link href="commonltr.css" type="text/css" rel="stylesheet" /> |
41890dfa56f5
Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff
changeset
|
14 |
<title> |
41890dfa56f5
Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff
changeset
|
15 |
Showing content in a view</title> |
41890dfa56f5
Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff
changeset
|
16 |
</head> |
41890dfa56f5
Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff
changeset
|
17 |
<body id="GUID-7020D9EA-747D-42F3-B47C-16AD1F45DB82"><a name="GUID-7020D9EA-747D-42F3-B47C-16AD1F45DB82"><!-- --></a> |
41890dfa56f5
Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff
changeset
|
18 |
|
41890dfa56f5
Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff
changeset
|
19 |
|
41890dfa56f5
Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff
changeset
|
20 |
|
41890dfa56f5
Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff
changeset
|
21 |
<h1 class="topictitle1"> |
41890dfa56f5
Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff
changeset
|
22 |
Showing content in a view</h1> |
41890dfa56f5
Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff
changeset
|
23 |
|
41890dfa56f5
Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff
changeset
|
24 |
<div> |
41890dfa56f5
Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff
changeset
|
25 |
|
41890dfa56f5
Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff
changeset
|
26 |
<p> |
41890dfa56f5
Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff
changeset
|
27 |
|
41890dfa56f5
Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff
changeset
|
28 |
The WRTKit has two controls for showing content inside a view. The |
41890dfa56f5
Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff
changeset
|
29 |
first of the controls is called Label and is useful for simple and |
41890dfa56f5
Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff
changeset
|
30 |
short information to be displayed, coupled with the control caption |
41890dfa56f5
Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff
changeset
|
31 |
that describes the information. |
41890dfa56f5
Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff
changeset
|
32 |
</p> |
41890dfa56f5
Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff
changeset
|
33 |
|
41890dfa56f5
Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff
changeset
|
34 |
<div class="fignone" id="GUID-7020D9EA-747D-42F3-B47C-16AD1F45DB82__GUID-EB15E9F3-204F-4772-B820-F3375D4C040A"><a name="GUID-7020D9EA-747D-42F3-B47C-16AD1F45DB82__GUID-EB15E9F3-204F-4772-B820-F3375D4C040A"><!-- --></a><span class="figcap">Figure 1. |
41890dfa56f5
Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff
changeset
|
35 |
Label control</span> |
41890dfa56f5
Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff
changeset
|
36 |
|
41890dfa56f5
Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff
changeset
|
37 |
|
41890dfa56f5
Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff
changeset
|
38 |
<br /><img src="Label_Control_Screenshot_1.png" /><br /> |
41890dfa56f5
Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff
changeset
|
39 |
</div> |
41890dfa56f5
Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff
changeset
|
40 |
|
41890dfa56f5
Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff
changeset
|
41 |
<p> |
41890dfa56f5
Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff
changeset
|
42 |
|
41890dfa56f5
Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff
changeset
|
43 |
The second control is called ContentPanel and is more sophisticated |
41890dfa56f5
Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff
changeset
|
44 |
than the Label control. ContentPanel controls can be created as |
41890dfa56f5
Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff
changeset
|
45 |
foldable, which means that they can expand and collapse their |
41890dfa56f5
Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff
changeset
|
46 |
content areas. Users can toggle the expanded and collapsed state by |
41890dfa56f5
Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff
changeset
|
47 |
clicking on the caption area of the ContentPanel. |
41890dfa56f5
Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff
changeset
|
48 |
</p> |
41890dfa56f5
Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff
changeset
|
49 |
|
41890dfa56f5
Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff
changeset
|
50 |
<div class="fignone" id="GUID-7020D9EA-747D-42F3-B47C-16AD1F45DB82__GUID-5EC096E5-EADF-4BD6-9D6A-1B331EAA2E66"><a name="GUID-7020D9EA-747D-42F3-B47C-16AD1F45DB82__GUID-5EC096E5-EADF-4BD6-9D6A-1B331EAA2E66"><!-- --></a><span class="figcap">Figure 2. |
41890dfa56f5
Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff
changeset
|
51 |
Foldable content panel</span> |
41890dfa56f5
Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff
changeset
|
52 |
|
41890dfa56f5
Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff
changeset
|
53 |
|
41890dfa56f5
Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff
changeset
|
54 |
<br /><img src="RSS_Reader_Main_Screenshot_2.png" /><br /> |
41890dfa56f5
Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff
changeset
|
55 |
</div> |
41890dfa56f5
Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff
changeset
|
56 |
|
41890dfa56f5
Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff
changeset
|
57 |
<p> |
41890dfa56f5
Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff
changeset
|
58 |
|
41890dfa56f5
Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff
changeset
|
59 |
The code below creates a Label control and a foldable ContentPanel |
41890dfa56f5
Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff
changeset
|
60 |
control and adds them to a view. The code assumes that a view has |
41890dfa56f5
Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff
changeset
|
61 |
already been created and that a variable called exampleView refers |
41890dfa56f5
Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff
changeset
|
62 |
to it. |
41890dfa56f5
Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff
changeset
|
63 |
</p> |
41890dfa56f5
Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff
changeset
|
64 |
|
41890dfa56f5
Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff
changeset
|
65 |
<pre> |
41890dfa56f5
Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff
changeset
|
66 |
|
41890dfa56f5
Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff
changeset
|
67 |
// create label |
41890dfa56f5
Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff
changeset
|
68 |
var nameLabel = new Label("label1", "Name"); |
41890dfa56f5
Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff
changeset
|
69 |
exampleView.addControl(nameLabel); |
41890dfa56f5
Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff
changeset
|
70 |
|
41890dfa56f5
Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff
changeset
|
71 |
// create foldable content panel |
41890dfa56f5
Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff
changeset
|
72 |
var infoPanel = new ContentPanel("info1", "Information", null, true); |
41890dfa56f5
Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff
changeset
|
73 |
exampleView.addControl(infoPanel); |
41890dfa56f5
Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff
changeset
|
74 |
</pre> |
41890dfa56f5
Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff
changeset
|
75 |
|
41890dfa56f5
Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff
changeset
|
76 |
<p> |
41890dfa56f5
Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff
changeset
|
77 |
|
41890dfa56f5
Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff
changeset
|
78 |
The first and second arguments are the same in the constructors for |
41890dfa56f5
Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff
changeset
|
79 |
both controls. The first is a unique identifier for the control and |
41890dfa56f5
Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff
changeset
|
80 |
the second is the control caption. The third argument is also the |
41890dfa56f5
Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff
changeset
|
81 |
same but is omitted for the label and null for the content panel |
41890dfa56f5
Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff
changeset
|
82 |
since in both cases we don't specify any content at this point. The |
41890dfa56f5
Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff
changeset
|
83 |
fourth argument for the content panel is a boolean that specifies |
41890dfa56f5
Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff
changeset
|
84 |
whether the control should be foldable or not. |
41890dfa56f5
Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff
changeset
|
85 |
</p> |
41890dfa56f5
Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff
changeset
|
86 |
|
41890dfa56f5
Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff
changeset
|
87 |
<p> |
41890dfa56f5
Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff
changeset
|
88 |
|
41890dfa56f5
Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff
changeset
|
89 |
The value for a label can be set and retrieved using the getText() and |
41890dfa56f5
Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff
changeset
|
90 |
setText() methods. For content panels the content in the content area |
41890dfa56f5
Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff
changeset
|
91 |
can be set and retrieved using getContent() and setContent(). The |
41890dfa56f5
Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff
changeset
|
92 |
content is defined as an XHTML fragment and can contain arbitrarily |
41890dfa56f5
Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff
changeset
|
93 |
complex XHTML, including images or even JavaScript. |
41890dfa56f5
Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff
changeset
|
94 |
</p> |
41890dfa56f5
Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff
changeset
|
95 |
|
41890dfa56f5
Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff
changeset
|
96 |
<pre> |
41890dfa56f5
Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff
changeset
|
97 |
|
41890dfa56f5
Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff
changeset
|
98 |
// set the text for the label |
41890dfa56f5
Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff
changeset
|
99 |
nameLabel.setText("John Smith"); |
41890dfa56f5
Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff
changeset
|
100 |
|
41890dfa56f5
Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff
changeset
|
101 |
// set content for the content panel |
41890dfa56f5
Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff
changeset
|
102 |
infoPanel.setContent("<b>This is bolded!</b><br/>This is plain text on the second line."); |
41890dfa56f5
Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff
changeset
|
103 |
</pre> |
41890dfa56f5
Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff
changeset
|
104 |
|
41890dfa56f5
Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff
changeset
|
105 |
<p> |
41890dfa56f5
Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff
changeset
|
106 |
|
41890dfa56f5
Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff
changeset
|
107 |
Foldable ContentPanel controls can be programmatically collapsed or |
41890dfa56f5
Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff
changeset
|
108 |
expanded using the setExpanded() method. The expanded state can be |
41890dfa56f5
Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff
changeset
|
109 |
retrieved using the isExpanded() method. |
41890dfa56f5
Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff
changeset
|
110 |
</p> |
41890dfa56f5
Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff
changeset
|
111 |
|
41890dfa56f5
Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff
changeset
|
112 |
<pre> |
41890dfa56f5
Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff
changeset
|
113 |
|
41890dfa56f5
Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff
changeset
|
114 |
// retrieve the expanded state |
41890dfa56f5
Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff
changeset
|
115 |
var expanded = infoPanel.isExpanded(); |
41890dfa56f5
Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff
changeset
|
116 |
|
41890dfa56f5
Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff
changeset
|
117 |
// collapse the content panel |
41890dfa56f5
Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff
changeset
|
118 |
infoPanel.setExpanded(false); |
41890dfa56f5
Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff
changeset
|
119 |
</pre> |
41890dfa56f5
Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff
changeset
|
120 |
|
41890dfa56f5
Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff
changeset
|
121 |
</div> |
41890dfa56f5
Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff
changeset
|
122 |
|
41890dfa56f5
Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff
changeset
|
123 |
<div> |
41890dfa56f5
Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff
changeset
|
124 |
<div class="familylinks"> |
41890dfa56f5
Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff
changeset
|
125 |
<div class="parentlink"><strong>Parent topic:</strong> <a href="WRTKit_Common_WRTKit_tasks-GUID-24870895-4449-4307-9a54-7c90f7b3905e.html">Common WRTKit tasks</a></div> |
41890dfa56f5
Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff
changeset
|
126 |
</div> |
41890dfa56f5
Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff
changeset
|
127 |
</div> |
41890dfa56f5
Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff
changeset
|
128 |
|
41890dfa56f5
Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff
changeset
|
129 |
</body> |
41890dfa56f5
Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff
changeset
|
130 |
</html> |