<html dir="ltr" xmlns:mshelp="http://msdn.microsoft.com/mshelp"
xmlns:silverlightsdk="http://msdn.microsoft.com/silverlight" xmlns=
"http://www.w3.org/1999/xhtml">
<head>
<meta name="keywords" content="online documentation, web online help, web help, chm2web" />
<meta http-equiv="Content-Style-Type" content="text/css" />
<meta name="generator" content="chm2web Standard 2.7 (unicode)" />
<meta http-equiv="Content-Type" content=
"text/html; charset=utf-8" />
<title>Add Method</title>
<link rel="stylesheet" href="../../default.css" type="text/css" />
<script type="text/JavaScript" src="../../files/supply.js"></script>
<script type="text/JavaScript">
chmtop.c2wtopf.pageid = "reference/m_collection_add.htm";
</script>
</head>
<body topmargin="0"><script type="text/JavaScript">
if (window.name != "content")
document.write(" <table width=\"100%\" bgcolor=\"#e1e1e1\"cellspacing=\"2\" cellpadding=\"0\" style=\"border-collapse: collapse; font-family: sans-serif; font-size: 14px; color: #000000; text-decoration: none; \"> <tr> <td align=\"center\" style=\"border-bottom: 2px solid gray\" > <br> Click <a href=\"../../index.html?page=source%2freference%2fm_collection_add.htm\">here</a> to show toolbars of the Web Online Help System: <a href=\"../../index.html?page=source%2freference%2fm_collection_add.htm\">show toolbars</a><br> </td></tr></table><br> ");
</script>
<!-- !chm2web! -->
<span id="sdkbannersection"></span>
<div class="tableSection"><span id="sdkbannersection"></span>
<table class="buttonbarshade" cellspacing="0">
<tr>
<td> </td>
</tr>
</table>
</div>
<div class="tableSection"><span id="sdkbannersection"></span>
<table class="buttonbartable" cellspacing="0">
<tr id="hdr">
<td class="runninghead" nowrap="nowrap"><img src=
"../common/logo.png" height="21" alt="Silverlight SDK" />
</td>
</tr>
</table>
</div>
<p><span class="betaboilerplate"><font color="gray" pointsize="8.5"
face="Verdana">[This topic is pre-release documentation and is
subject to change in future releases. Blank topics are included as
placeholders.]</font></span>
</p>
<h1><a name="silverlight_collection_add_method"></a>Add Method</h1>
<div id="mainSection">
<div id="mainBody">
<p>Adds an object to the end of the collection.</p>
<div id="syntaxblock">
<table class="auto_syntaxtable" id="syntaxtable" style=
"width: 90%; background: #CCCCCC; border: none;">
<tr id="xamlSyntaxBlock">
<th class="syntaxblocklanguage" nowrap="nowrap" style=
"width: 150px; background: #EEEEEE; vertical-align: top;">XAML</th>
<td class="syntaxblockcode" style="background:white;">
<div class="codesyntax">You cannot use methods in XAML.</div>
</td>
</tr>
<tr id="scriptingSyntaxBlock">
<th class="syntaxblocklanguage" nowrap="nowrap" style=
"width: 150px; background: #EEEEEE; vertical-align: top;">
Scripting</th>
<td class="syntaxblockcode" style="background:white;">
<div class="codesyntax" style=
"font-family: 'Courier New', Courier, monospace;">
<i>object</i>.add(<b>value</b>)</div>
</td>
</tr>
</table>
</div>
<div id="parametersection">
<h4>Parameters</h4>
<div class="tableSection">
<table class="parametertable">
<tr>
<td class="parametername"><i>value</i>
</td>
<td class="parameterdesc"><b>Object</b>
<p>The object to add to the collection.</p>
</td>
</tr>
</table>
</div>
</div>
<h4>Return Value</h4>
<p>Returns the zero-based index of the inserted object in the
collection if successful; otherwise, returns null.</p>
<h4>Remarks</h4>
<p>You can add XAML content to objects that support child objects,
such as the <b>Canvas</b> object. The following JavaScript example
shows to create a <b>TextBlock</b> and add it to the root
<b>Canvas</b> object by using the <b>Add</b> method on the object's
collection of children. Note that the <b>Opacity</b> property is 0,
so the fragment will not be initially visible. Using the
<b>Opacity</b> property to control an object's visibility avoids
having to modify the Silverlight object hierarchy.</p>
<div class="snippetdistributor_codesnippet" id=
"referencing_objects_snip#AddingObjects">
<div style="width: 99%;">
<table class="codeexampletable" style=
"border: 1px solid #999999; background: #CCCCCC; width: 99%;">
<tr>
<th class="codelanguagecell" style=
"background: #CCCCCC; text-align: left;">JavaScript</th>
</tr>
<tr>
<td class="codeblockcell" style=
"background: #e6e6e6; border: none;">
<pre class="codeblock" style=
"background: transparent; border: none; margin: 0px; padding: 0px; font-family:'Courier New', Courier, monospace;">
var textBlock;
function onLoaded(sender, eventArgs)
{
// Retrieve the id of the plugin.
var plugin = sender.getHost();
// Define and create a XAML fragment.
var xamlFragment = '<TextBlock Canvas.Top="200" Opacity=".5" Text="Click for more info" />';
textBlock = plugin.content.createFromXaml(xamlFragment);
// Add the TextBlock to the root Canvas object.
sender.children.add(textBlock);
}
// Toggle the Opacity property for the TextBlock.
function onToggle()
{
if (textBlock.opacity)
{
textBlock.opacity = 0;
}
else
{
textBlock.opacity = 1;
}
}
</pre>
</td>
</tr>
</table>
</div>
</div>
<h4>Applies To</h4>
<p><a href=
"o_colorkeyframecollection.htm">ColorKeyFrameCollection</a>,
<a href=
"o_doublekeyframecollection.htm">DoubleKeyFrameCollection</a>,
<a href="o_gradientstopcollection.htm">GradientStopCollection</a>,
<a href="o_pathfigurecollection.htm">PathFigureCollection</a>,
<a href="o_pathsegmentcollection.htm">PathSegmentCollection</a>,
<a href=
"o_pointkeyframecollection.htm">PointKeyFrameCollection</a>,
<a href="o_strokecollection.htm">StrokeCollection</a>, <a href=
"o_styluspointcollection.htm">StylusPointCollection</a>, <a href=
"o_triggeractioncollection.htm">TriggerActionCollection</a>,
<a href="o_triggercollection.htm">TriggerCollection</a>, <a href=
"o_uielementcollection.htm">UIElementCollection</a></p>
<h4>See Also</h4>
<p><a href="m_collection_insert.htm">Insert</a>, <a href=
"../conceptual/referencing_objects.htm">Referencing and Modifying
Silverlight Objects</a></p>
</div>
</div>
<script type="text/JavaScript">
var fe = FindFrame("toc", top);
if ((fe != null) && (chmtop.c2wtopf.jstree != null)) {
if (chmtop.c2wtopf.FITEMS[chmtop.c2wtopf.pagenum] != chmtop.c2wtopf.pageid)
chmtop.c2wtopf.jstree.OpenTreeNode("source/" + chmtop.c2wtopf.pageid);
}
</script>
<!-- CHM2WEB -->
<!-- DO NOT DELETE OR MODIFY THIS CODE WITHOUT
WRITTEN PERMISSION OF A!K RESEARCH LABS -->
<table width="100%" cellspacing="0" cellpadding="0"
style="margin-top: 0pt; border-collapse: collapse;">
<tr> <td align="right" style="background-color:white; border-top: 1px solid gray;">
<a href="http://chm2web.aklabs.com" target="_blank" style="font-family: sans-serif; font-size: 11px; text-decoration: none;"><font color="gray">Converted from CHM to HTML with <b>chm2web Standard 2.7 (unicode)</b></font></a>
</td></tr></table>
<!-- /CHM2WEB -->
</body>
</html>