org.symbian.wrttools.doc.WRTKit/html/WRTKit_Displaying_content-GUID-57647864-5231-47e5-8ad5-f2adb1848760.html
--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/org.symbian.wrttools.doc.WRTKit/html/WRTKit_Displaying_content-GUID-57647864-5231-47e5-8ad5-f2adb1848760.html Thu Mar 04 15:42:37 2010 -0800
@@ -0,0 +1,85 @@
+<?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">
+<html lang="en" xml:lang="en">
+<head>
+<meta content="text/html; charset=utf-8" http-equiv="Content-Type" />
+<meta name="copyright" content="(C) Copyright 2005" />
+<meta name="DC.rights.owner" content="(C) Copyright 2005" />
+<meta content="concept" name="DC.Type" />
+<meta name="DC.Title" content="Displaying content" />
+<meta scheme="URI" name="DC.Relation" content="WRTKit_Developing_widgets_using_the_WRTKit-GUID-a321db96-0a01-4e55-b24b-96905f40cb5c.html" />
+<meta content="XHTML" name="DC.Format" />
+<meta content="GUID-57647864-5231-47E5-8AD5-F2ADB1848760" name="DC.Identifier" />
+<meta content="en" name="DC.Language" />
+<link href="commonltr.css" type="text/css" rel="stylesheet" />
+<title>
+Displaying content</title>
+</head>
+<body id="GUID-57647864-5231-47E5-8AD5-F2ADB1848760"><a name="GUID-57647864-5231-47E5-8AD5-F2ADB1848760"><!-- --></a>
+
+
+
+ <h1 class="topictitle1">
+Displaying content</h1>
+
+ <div>
+
+ <p>
+
+ The WRTKit contains two controls that are intended simply for displaying content
+ of some kind. The simplest of these is the Label control, which is simply
+ showing a piece of text below its caption. Labels are useful in situations where
+ there is some short data that needs to be shown without requiring any kind of
+ interactivity. E.g. in an address book widget, each information field for a
+ contact could be shown using its own label. One label for the contact's name,
+ one for the phone number, etc. The control caption would indicate what the
+ information is (e.g. "Name") and the label's value would indicate the actual
+ piece of data (e.g. "John Smith").
+ </p>
+
+ <p>
+
+ For situations where the content is more complex or longer, the WRTKit offers a
+ control called ContentPanel. The ContentPanel control can be foldable or non-
+ foldable. In its non-foldable mode a ContentPanel is similar to the label
+ control and shows a caption and a content area. In the foldable mode the caption
+ area is interactive and can be used to collapse and expand the content area.
+ This helps shortening the space that the content takes up on in a view, while
+ still allowing users to expand interesting content for a closer look. E.g. an
+ email reader widget could use this to show each email in a folder in its own
+ content panel so that the control caption is the email subject and the content
+ area contains the full email.
+ </p>
+
+ <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.
+Foldable content panel</span>
+
+
+ <br /><img src="RSS_Reader_Main_Screenshot_2.png" /><br />
+ </div>
+
+ <p>
+
+ Foldable ContentPanel controls can be created either in expanded or collapsed
+ mode and can be programmatically expanded and collapsed in addition to allowing
+ users to manually expand and collapse them.
+ </p>
+
+ <p>
+
+ If a non-folding ContentPanel control is used without a caption, it is for all
+ practical purposes just a canvas to which any content can be inserted. The
+ content in the content panel area is defined as an XHTML fragment and can be used
+ to include arbitrarily complex content, e.g. content that contains images,
+ JavaScript code, etc.
+ </p>
+
+ </div>
+
+<div>
+<div class="familylinks">
+<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>
+</div>
+</div>
+
+</body>
+</html>
\ No newline at end of file