org.symbian.tools.wrttools.doc.WRTKit/html/WRTKit_Displaying_content-GUID-57647864-5231-47e5-8ad5-f2adb1848760.html
<?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>