org.symbian.wrttools.doc.WRTKit/html/WRTKit_Displaying_content-GUID-57647864-5231-47e5-8ad5-f2adb1848760.html
author tasneems@symbian.org
Thu, 04 Mar 2010 15:42:37 -0800
changeset 220 41890dfa56f5
permissions -rw-r--r--
Fixed 2046 - added support for WRTKit help
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
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="Displaying content" />
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
     9
<meta scheme="URI" name="DC.Relation" content="WRTKit_Developing_widgets_using_the_WRTKit-GUID-a321db96-0a01-4e55-b24b-96905f40cb5c.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-57647864-5231-47E5-8AD5-F2ADB1848760" 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
Displaying content</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-57647864-5231-47E5-8AD5-F2ADB1848760"><a name="GUID-57647864-5231-47E5-8AD5-F2ADB1848760"><!-- --></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
Displaying content</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 contains two controls that are intended simply for displaying content 
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
    29
            of some kind. The simplest of these is the Label control, which is simply 
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
    30
            showing a piece of text below its caption. Labels are useful in situations where 
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
    31
            there is some short data that needs to be shown without requiring any kind of 
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
    32
            interactivity. E.g. in an address book widget, each information field for a 
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
    33
            contact could be shown using its own label. One label for the contact's name, 
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
    34
            one for the phone number, etc. The control caption would indicate what the 
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
    35
            information is (e.g. "Name") and the label's value would indicate the actual
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
    36
            piece of data (e.g. "John Smith").
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
    37
        </p>
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
    38
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
    39
        <p>
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
            For situations where the content is more complex or longer, the WRTKit offers a 
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
    42
            control called ContentPanel. The ContentPanel control can be foldable or non-
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
    43
            foldable. In its non-foldable mode a ContentPanel is similar to the label 
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
    44
            control and shows a caption and a content area. In the foldable mode the caption 
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
    45
            area is interactive and can be used to collapse and expand the content area. 
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
    46
            This helps shortening the space that the content takes up on in a view, while 
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
    47
            still allowing users to expand interesting content for a closer look. E.g. an 
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
    48
            email reader widget could use this to show each email in a folder in its own 
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
    49
            content panel so that the control caption is the email subject and the content 
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
    50
            area contains the full email.
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
    51
        </p>
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
        <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. 
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
    54
Foldable content panel</span>
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
    55
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
            <br /><img src="RSS_Reader_Main_Screenshot_2.png" /><br />
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
    58
        </div>
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
    59
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
    60
        <p>
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
    61
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
    62
            Foldable ContentPanel controls can be created either in expanded or collapsed 
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
    63
            mode and can be programmatically expanded and collapsed in addition to allowing 
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
    64
            users to manually expand and collapse them.
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
    65
        </p>
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
        <p>
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
    68
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
    69
            If a non-folding ContentPanel control is used without a caption, it is for all 
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
    70
            practical purposes just a canvas to which any content can be inserted. The 
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
    71
            content in the content panel area is defined as an XHTML fragment and can be used 
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
    72
            to include arbitrarily complex content, e.g. content that contains images, 
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
    73
            JavaScript code, etc.
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
    74
        </p>
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
    </div>
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
<div>
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
    79
<div class="familylinks">
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
    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>
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
    81
</div>
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
    82
</div>
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
    83
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
    84
</body>
41890dfa56f5 Fixed 2046 - added support for WRTKit help
tasneems@symbian.org
parents:
diff changeset
    85
</html>