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"> |
|
2 <html lang="en" xml:lang="en"> |
|
3 <head> |
|
4 <meta content="text/html; charset=utf-8" http-equiv="Content-Type" /> |
|
5 <meta name="copyright" content="(C) Copyright 2005" /> |
|
6 <meta name="DC.rights.owner" content="(C) Copyright 2005" /> |
|
7 <meta content="concept" name="DC.Type" /> |
|
8 <meta name="DC.Title" content="Displaying content" /> |
|
9 <meta scheme="URI" name="DC.Relation" content="WRTKit_Developing_widgets_using_the_WRTKit-GUID-a321db96-0a01-4e55-b24b-96905f40cb5c.html" /> |
|
10 <meta content="XHTML" name="DC.Format" /> |
|
11 <meta content="GUID-57647864-5231-47E5-8AD5-F2ADB1848760" name="DC.Identifier" /> |
|
12 <meta content="en" name="DC.Language" /> |
|
13 <link href="commonltr.css" type="text/css" rel="stylesheet" /> |
|
14 <title> |
|
15 Displaying content</title> |
|
16 </head> |
|
17 <body id="GUID-57647864-5231-47E5-8AD5-F2ADB1848760"><a name="GUID-57647864-5231-47E5-8AD5-F2ADB1848760"><!-- --></a> |
|
18 |
|
19 |
|
20 |
|
21 <h1 class="topictitle1"> |
|
22 Displaying content</h1> |
|
23 |
|
24 <div> |
|
25 |
|
26 <p> |
|
27 |
|
28 The WRTKit contains two controls that are intended simply for displaying content |
|
29 of some kind. The simplest of these is the Label control, which is simply |
|
30 showing a piece of text below its caption. Labels are useful in situations where |
|
31 there is some short data that needs to be shown without requiring any kind of |
|
32 interactivity. E.g. in an address book widget, each information field for a |
|
33 contact could be shown using its own label. One label for the contact's name, |
|
34 one for the phone number, etc. The control caption would indicate what the |
|
35 information is (e.g. "Name") and the label's value would indicate the actual |
|
36 piece of data (e.g. "John Smith"). |
|
37 </p> |
|
38 |
|
39 <p> |
|
40 |
|
41 For situations where the content is more complex or longer, the WRTKit offers a |
|
42 control called ContentPanel. The ContentPanel control can be foldable or non- |
|
43 foldable. In its non-foldable mode a ContentPanel is similar to the label |
|
44 control and shows a caption and a content area. In the foldable mode the caption |
|
45 area is interactive and can be used to collapse and expand the content area. |
|
46 This helps shortening the space that the content takes up on in a view, while |
|
47 still allowing users to expand interesting content for a closer look. E.g. an |
|
48 email reader widget could use this to show each email in a folder in its own |
|
49 content panel so that the control caption is the email subject and the content |
|
50 area contains the full email. |
|
51 </p> |
|
52 |
|
53 <div class="fignone" id="GUID-57647864-5231-47E5-8AD5-F2ADB1848760__GUID-741DA525-1982-4CCE-9D99-926B6719716F"><a name="GUID-57647864-5231-47E5-8AD5-F2ADB1848760__GUID-741DA525-1982-4CCE-9D99-926B6719716F"><!-- --></a><span class="figcap">Figure 1. |
|
54 Foldable content panel</span> |
|
55 |
|
56 |
|
57 <br /><img src="RSS_Reader_Main_Screenshot_2.png" /><br /> |
|
58 </div> |
|
59 |
|
60 <p> |
|
61 |
|
62 Foldable ContentPanel controls can be created either in expanded or collapsed |
|
63 mode and can be programmatically expanded and collapsed in addition to allowing |
|
64 users to manually expand and collapse them. |
|
65 </p> |
|
66 |
|
67 <p> |
|
68 |
|
69 If a non-folding ContentPanel control is used without a caption, it is for all |
|
70 practical purposes just a canvas to which any content can be inserted. The |
|
71 content in the content panel area is defined as an XHTML fragment and can be used |
|
72 to include arbitrarily complex content, e.g. content that contains images, |
|
73 JavaScript code, etc. |
|
74 </p> |
|
75 |
|
76 </div> |
|
77 |
|
78 <div> |
|
79 <div class="familylinks"> |
|
80 <div class="parentlink"><strong>Parent topic:</strong> <a href="WRTKit_Developing_widgets_using_the_WRTKit-GUID-a321db96-0a01-4e55-b24b-96905f40cb5c.html">Developing widgets using the WRTKit</a></div> |
|
81 </div> |
|
82 </div> |
|
83 |
|
84 </body> |
|
85 </html> |
|