carbidesdk/com.nokia.carbide.cpp.sdk.doc.user/reference/api/help-doc.html
author timkelly
Tue, 14 Apr 2009 10:18:48 -0500
changeset 91 2010205bb971
parent 2 d760517a8095
child 1704 24ac5a5cf80c
permissions -rw-r--r--
deprecate public API for new one that uses progress monitor (bug 7351)
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
2
cawthron
parents:
diff changeset
     1
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
cawthron
parents:
diff changeset
     2
<!--NewPage-->
cawthron
parents:
diff changeset
     3
<HTML>
cawthron
parents:
diff changeset
     4
<HEAD>
cawthron
parents:
diff changeset
     5
<!-- Generated by javadoc (build 1.5.0_15) on Tue Jan 06 17:31:57 CST 2009 -->
cawthron
parents:
diff changeset
     6
<META http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
cawthron
parents:
diff changeset
     7
<TITLE>
cawthron
parents:
diff changeset
     8
API Help (Carbide.c++ SDK API Reference)
cawthron
parents:
diff changeset
     9
</TITLE>
cawthron
parents:
diff changeset
    10
cawthron
parents:
diff changeset
    11
cawthron
parents:
diff changeset
    12
<LINK REL ="stylesheet" TYPE="text/css" HREF="stylesheet.css" TITLE="Style">
cawthron
parents:
diff changeset
    13
cawthron
parents:
diff changeset
    14
<SCRIPT type="text/javascript">
cawthron
parents:
diff changeset
    15
function windowTitle()
cawthron
parents:
diff changeset
    16
{
cawthron
parents:
diff changeset
    17
    parent.document.title="API Help (Carbide.c++ SDK API Reference)";
cawthron
parents:
diff changeset
    18
}
cawthron
parents:
diff changeset
    19
</SCRIPT>
cawthron
parents:
diff changeset
    20
<NOSCRIPT>
cawthron
parents:
diff changeset
    21
</NOSCRIPT>
cawthron
parents:
diff changeset
    22
cawthron
parents:
diff changeset
    23
</HEAD>
cawthron
parents:
diff changeset
    24
cawthron
parents:
diff changeset
    25
<BODY BGCOLOR="white" onload="windowTitle();">
cawthron
parents:
diff changeset
    26
cawthron
parents:
diff changeset
    27
cawthron
parents:
diff changeset
    28
<!-- ========= START OF TOP NAVBAR ======= -->
cawthron
parents:
diff changeset
    29
<A NAME="navbar_top"><!-- --></A>
cawthron
parents:
diff changeset
    30
<A HREF="#skip-navbar_top" title="Skip navigation links"></A>
cawthron
parents:
diff changeset
    31
<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
cawthron
parents:
diff changeset
    32
<TR>
cawthron
parents:
diff changeset
    33
<TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
cawthron
parents:
diff changeset
    34
<A NAME="navbar_top_firstrow"><!-- --></A>
cawthron
parents:
diff changeset
    35
<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">
cawthron
parents:
diff changeset
    36
  <TR ALIGN="center" VALIGN="top">
cawthron
parents:
diff changeset
    37
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A>&nbsp;</TD>
cawthron
parents:
diff changeset
    38
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <FONT CLASS="NavBarFont1">Package</FONT>&nbsp;</TD>
cawthron
parents:
diff changeset
    39
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <FONT CLASS="NavBarFont1">Class</FONT>&nbsp;</TD>
cawthron
parents:
diff changeset
    40
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <FONT CLASS="NavBarFont1">Use</FONT>&nbsp;</TD>
cawthron
parents:
diff changeset
    41
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="overview-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A>&nbsp;</TD>
cawthron
parents:
diff changeset
    42
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A>&nbsp;</TD>
cawthron
parents:
diff changeset
    43
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="index-files/index-1.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A>&nbsp;</TD>
cawthron
parents:
diff changeset
    44
  <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> &nbsp;<FONT CLASS="NavBarFont1Rev"><B>Help</B></FONT>&nbsp;</TD>
cawthron
parents:
diff changeset
    45
  </TR>
cawthron
parents:
diff changeset
    46
</TABLE>
cawthron
parents:
diff changeset
    47
</TD>
cawthron
parents:
diff changeset
    48
<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
cawthron
parents:
diff changeset
    49
<b>Carbide.c++</b></EM>
cawthron
parents:
diff changeset
    50
</TD>
cawthron
parents:
diff changeset
    51
</TR>
cawthron
parents:
diff changeset
    52
cawthron
parents:
diff changeset
    53
<TR>
cawthron
parents:
diff changeset
    54
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
cawthron
parents:
diff changeset
    55
&nbsp;PREV&nbsp;
cawthron
parents:
diff changeset
    56
&nbsp;NEXT</FONT></TD>
cawthron
parents:
diff changeset
    57
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
cawthron
parents:
diff changeset
    58
  <A HREF="index.html?help-doc.html" target="_top"><B>FRAMES</B></A>  &nbsp;
cawthron
parents:
diff changeset
    59
&nbsp;<A HREF="help-doc.html" target="_top"><B>NO FRAMES</B></A>  &nbsp;
cawthron
parents:
diff changeset
    60
&nbsp;<SCRIPT type="text/javascript">
cawthron
parents:
diff changeset
    61
  <!--
cawthron
parents:
diff changeset
    62
  if(window==top) {
cawthron
parents:
diff changeset
    63
    document.writeln('<A HREF="allclasses-noframe.html"><B>All Classes</B></A>');
cawthron
parents:
diff changeset
    64
  }
cawthron
parents:
diff changeset
    65
  //-->
cawthron
parents:
diff changeset
    66
</SCRIPT>
cawthron
parents:
diff changeset
    67
<NOSCRIPT>
cawthron
parents:
diff changeset
    68
  <A HREF="allclasses-noframe.html"><B>All Classes</B></A>
cawthron
parents:
diff changeset
    69
</NOSCRIPT>
cawthron
parents:
diff changeset
    70
cawthron
parents:
diff changeset
    71
cawthron
parents:
diff changeset
    72
</FONT></TD>
cawthron
parents:
diff changeset
    73
</TR>
cawthron
parents:
diff changeset
    74
</TABLE>
cawthron
parents:
diff changeset
    75
<A NAME="skip-navbar_top"></A>
cawthron
parents:
diff changeset
    76
<!-- ========= END OF TOP NAVBAR ========= -->
cawthron
parents:
diff changeset
    77
cawthron
parents:
diff changeset
    78
<HR>
cawthron
parents:
diff changeset
    79
<CENTER>
cawthron
parents:
diff changeset
    80
<H1>
cawthron
parents:
diff changeset
    81
How This API Document Is Organized</H1>
cawthron
parents:
diff changeset
    82
</CENTER>
cawthron
parents:
diff changeset
    83
This API (Application Programming Interface) document has pages corresponding to the items in the navigation bar, described as follows.<H3>
cawthron
parents:
diff changeset
    84
Overview</H3>
cawthron
parents:
diff changeset
    85
<BLOCKQUOTE>
cawthron
parents:
diff changeset
    86
cawthron
parents:
diff changeset
    87
<P>
cawthron
parents:
diff changeset
    88
The <A HREF="overview-summary.html">Overview</A> page is the front page of this API document and provides a list of all packages with a summary for each.  This page can also contain an overall description of the set of packages.</BLOCKQUOTE>
cawthron
parents:
diff changeset
    89
<H3>
cawthron
parents:
diff changeset
    90
Package</H3>
cawthron
parents:
diff changeset
    91
<BLOCKQUOTE>
cawthron
parents:
diff changeset
    92
cawthron
parents:
diff changeset
    93
<P>
cawthron
parents:
diff changeset
    94
Each package has a page that contains a list of its classes and interfaces, with a summary for each. This page can contain four categories:<UL>
cawthron
parents:
diff changeset
    95
<LI>Interfaces (italic)<LI>Classes<LI>Enums<LI>Exceptions<LI>Errors<LI>Annotation Types</UL>
cawthron
parents:
diff changeset
    96
</BLOCKQUOTE>
cawthron
parents:
diff changeset
    97
<H3>
cawthron
parents:
diff changeset
    98
Class/Interface</H3>
cawthron
parents:
diff changeset
    99
<BLOCKQUOTE>
cawthron
parents:
diff changeset
   100
cawthron
parents:
diff changeset
   101
<P>
cawthron
parents:
diff changeset
   102
Each class, interface, nested class and nested interface has its own separate page. Each of these pages has three sections consisting of a class/interface description, summary tables, and detailed member descriptions:<UL>
cawthron
parents:
diff changeset
   103
<LI>Class inheritance diagram<LI>Direct Subclasses<LI>All Known Subinterfaces<LI>All Known Implementing Classes<LI>Class/interface declaration<LI>Class/interface description
cawthron
parents:
diff changeset
   104
<P>
cawthron
parents:
diff changeset
   105
<LI>Nested Class Summary<LI>Field Summary<LI>Constructor Summary<LI>Method Summary
cawthron
parents:
diff changeset
   106
<P>
cawthron
parents:
diff changeset
   107
<LI>Field Detail<LI>Constructor Detail<LI>Method Detail</UL>
cawthron
parents:
diff changeset
   108
Each summary entry contains the first sentence from the detailed description for that item. The summary entries are alphabetical, while the detailed descriptions are in the order they appear in the source code. This preserves the logical groupings established by the programmer.</BLOCKQUOTE>
cawthron
parents:
diff changeset
   109
</BLOCKQUOTE>
cawthron
parents:
diff changeset
   110
<H3>
cawthron
parents:
diff changeset
   111
Annotation Type</H3>
cawthron
parents:
diff changeset
   112
<BLOCKQUOTE>
cawthron
parents:
diff changeset
   113
cawthron
parents:
diff changeset
   114
<P>
cawthron
parents:
diff changeset
   115
Each annotation type has its own separate page with the following sections:<UL>
cawthron
parents:
diff changeset
   116
<LI>Annotation Type declaration<LI>Annotation Type description<LI>Required Element Summary<LI>Optional Element Summary<LI>Element Detail</UL>
cawthron
parents:
diff changeset
   117
</BLOCKQUOTE>
cawthron
parents:
diff changeset
   118
</BLOCKQUOTE>
cawthron
parents:
diff changeset
   119
<H3>
cawthron
parents:
diff changeset
   120
Enum</H3>
cawthron
parents:
diff changeset
   121
<BLOCKQUOTE>
cawthron
parents:
diff changeset
   122
cawthron
parents:
diff changeset
   123
<P>
cawthron
parents:
diff changeset
   124
Each enum has its own separate page with the following sections:<UL>
cawthron
parents:
diff changeset
   125
<LI>Enum declaration<LI>Enum description<LI>Enum Constant Summary<LI>Enum Constant Detail</UL>
cawthron
parents:
diff changeset
   126
</BLOCKQUOTE>
cawthron
parents:
diff changeset
   127
<H3>
cawthron
parents:
diff changeset
   128
Use</H3>
cawthron
parents:
diff changeset
   129
<BLOCKQUOTE>
cawthron
parents:
diff changeset
   130
Each documented package, class and interface has its own Use page.  This page describes what packages, classes, methods, constructors and fields use any part of the given class or package. Given a class or interface A, its Use page includes subclasses of A, fields declared as A, methods that return A, and methods and constructors with parameters of type A.  You can access this page by first going to the package, class or interface, then clicking on the "Use" link in the navigation bar.</BLOCKQUOTE>
cawthron
parents:
diff changeset
   131
<H3>
cawthron
parents:
diff changeset
   132
Tree (Class Hierarchy)</H3>
cawthron
parents:
diff changeset
   133
<BLOCKQUOTE>
cawthron
parents:
diff changeset
   134
There is a <A HREF="overview-tree.html">Class Hierarchy</A> page for all packages, plus a hierarchy for each package. Each hierarchy page contains a list of classes and a list of interfaces. The classes are organized by inheritance structure starting with <code>java.lang.Object</code>. The interfaces do not inherit from <code>java.lang.Object</code>.<UL>
cawthron
parents:
diff changeset
   135
<LI>When viewing the Overview page, clicking on "Tree" displays the hierarchy for all packages.<LI>When viewing a particular package, class or interface page, clicking "Tree" displays the hierarchy for only that package.</UL>
cawthron
parents:
diff changeset
   136
</BLOCKQUOTE>
cawthron
parents:
diff changeset
   137
<H3>
cawthron
parents:
diff changeset
   138
Deprecated API</H3>
cawthron
parents:
diff changeset
   139
<BLOCKQUOTE>
cawthron
parents:
diff changeset
   140
The <A HREF="deprecated-list.html">Deprecated API</A> page lists all of the API that have been deprecated. A deprecated API is not recommended for use, generally due to improvements, and a replacement API is usually given. Deprecated APIs may be removed in future implementations.</BLOCKQUOTE>
cawthron
parents:
diff changeset
   141
<H3>
cawthron
parents:
diff changeset
   142
Index</H3>
cawthron
parents:
diff changeset
   143
<BLOCKQUOTE>
cawthron
parents:
diff changeset
   144
The <A HREF="index-files/index-1.html">Index</A> contains an alphabetic list of all classes, interfaces, constructors, methods, and fields.</BLOCKQUOTE>
cawthron
parents:
diff changeset
   145
<H3>
cawthron
parents:
diff changeset
   146
Prev/Next</H3>
cawthron
parents:
diff changeset
   147
These links take you to the next or previous class, interface, package, or related page.<H3>
cawthron
parents:
diff changeset
   148
Frames/No Frames</H3>
cawthron
parents:
diff changeset
   149
These links show and hide the HTML frames.  All pages are available with or without frames.
cawthron
parents:
diff changeset
   150
<P>
cawthron
parents:
diff changeset
   151
<H3>
cawthron
parents:
diff changeset
   152
Serialized Form</H3>
cawthron
parents:
diff changeset
   153
Each serializable or externalizable class has a description of its serialization fields and methods. This information is of interest to re-implementors, not to developers using the API. While there is no link in the navigation bar, you can get to this information by going to any serialized class and clicking "Serialized Form" in the "See also" section of the class description.
cawthron
parents:
diff changeset
   154
<P>
cawthron
parents:
diff changeset
   155
<H3>
cawthron
parents:
diff changeset
   156
Constant Field Values</H3>
cawthron
parents:
diff changeset
   157
The <a href="constant-values.html">Constant Field Values</a> page lists the static final fields and their values.
cawthron
parents:
diff changeset
   158
<P>
cawthron
parents:
diff changeset
   159
<FONT SIZE="-1">
cawthron
parents:
diff changeset
   160
<EM>
cawthron
parents:
diff changeset
   161
This help file applies to API documentation generated using the standard doclet.</EM>
cawthron
parents:
diff changeset
   162
</FONT>
cawthron
parents:
diff changeset
   163
<BR>
cawthron
parents:
diff changeset
   164
<HR>
cawthron
parents:
diff changeset
   165
cawthron
parents:
diff changeset
   166
cawthron
parents:
diff changeset
   167
<!-- ======= START OF BOTTOM NAVBAR ====== -->
cawthron
parents:
diff changeset
   168
<A NAME="navbar_bottom"><!-- --></A>
cawthron
parents:
diff changeset
   169
<A HREF="#skip-navbar_bottom" title="Skip navigation links"></A>
cawthron
parents:
diff changeset
   170
<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
cawthron
parents:
diff changeset
   171
<TR>
cawthron
parents:
diff changeset
   172
<TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
cawthron
parents:
diff changeset
   173
<A NAME="navbar_bottom_firstrow"><!-- --></A>
cawthron
parents:
diff changeset
   174
<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">
cawthron
parents:
diff changeset
   175
  <TR ALIGN="center" VALIGN="top">
cawthron
parents:
diff changeset
   176
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A>&nbsp;</TD>
cawthron
parents:
diff changeset
   177
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <FONT CLASS="NavBarFont1">Package</FONT>&nbsp;</TD>
cawthron
parents:
diff changeset
   178
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <FONT CLASS="NavBarFont1">Class</FONT>&nbsp;</TD>
cawthron
parents:
diff changeset
   179
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <FONT CLASS="NavBarFont1">Use</FONT>&nbsp;</TD>
cawthron
parents:
diff changeset
   180
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="overview-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A>&nbsp;</TD>
cawthron
parents:
diff changeset
   181
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A>&nbsp;</TD>
cawthron
parents:
diff changeset
   182
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="index-files/index-1.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A>&nbsp;</TD>
cawthron
parents:
diff changeset
   183
  <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> &nbsp;<FONT CLASS="NavBarFont1Rev"><B>Help</B></FONT>&nbsp;</TD>
cawthron
parents:
diff changeset
   184
  </TR>
cawthron
parents:
diff changeset
   185
</TABLE>
cawthron
parents:
diff changeset
   186
</TD>
cawthron
parents:
diff changeset
   187
<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
cawthron
parents:
diff changeset
   188
<b>Carbide.c++</b></EM>
cawthron
parents:
diff changeset
   189
</TD>
cawthron
parents:
diff changeset
   190
</TR>
cawthron
parents:
diff changeset
   191
cawthron
parents:
diff changeset
   192
<TR>
cawthron
parents:
diff changeset
   193
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
cawthron
parents:
diff changeset
   194
&nbsp;PREV&nbsp;
cawthron
parents:
diff changeset
   195
&nbsp;NEXT</FONT></TD>
cawthron
parents:
diff changeset
   196
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
cawthron
parents:
diff changeset
   197
  <A HREF="index.html?help-doc.html" target="_top"><B>FRAMES</B></A>  &nbsp;
cawthron
parents:
diff changeset
   198
&nbsp;<A HREF="help-doc.html" target="_top"><B>NO FRAMES</B></A>  &nbsp;
cawthron
parents:
diff changeset
   199
&nbsp;<SCRIPT type="text/javascript">
cawthron
parents:
diff changeset
   200
  <!--
cawthron
parents:
diff changeset
   201
  if(window==top) {
cawthron
parents:
diff changeset
   202
    document.writeln('<A HREF="allclasses-noframe.html"><B>All Classes</B></A>');
cawthron
parents:
diff changeset
   203
  }
cawthron
parents:
diff changeset
   204
  //-->
cawthron
parents:
diff changeset
   205
</SCRIPT>
cawthron
parents:
diff changeset
   206
<NOSCRIPT>
cawthron
parents:
diff changeset
   207
  <A HREF="allclasses-noframe.html"><B>All Classes</B></A>
cawthron
parents:
diff changeset
   208
</NOSCRIPT>
cawthron
parents:
diff changeset
   209
cawthron
parents:
diff changeset
   210
cawthron
parents:
diff changeset
   211
</FONT></TD>
cawthron
parents:
diff changeset
   212
</TR>
cawthron
parents:
diff changeset
   213
</TABLE>
cawthron
parents:
diff changeset
   214
<A NAME="skip-navbar_bottom"></A>
cawthron
parents:
diff changeset
   215
<!-- ======== END OF BOTTOM NAVBAR ======= -->
cawthron
parents:
diff changeset
   216
cawthron
parents:
diff changeset
   217
<HR>
cawthron
parents:
diff changeset
   218
<div id="footer">Copyright &copy; 2009 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. <br>License: <a href="http://www.eclipse.org/legal/epl-v10.html">http://www.eclipse.org/legal/epl-v10.html</a></div>
cawthron
parents:
diff changeset
   219
</BODY>
cawthron
parents:
diff changeset
   220
</HTML>