context: <?cs include:"doctype.cs" ?>
  <?cs include:"macros.cs" ?>
  <html<?cs if:devsite ?> devsite<?cs /if ?>>
  <?cs include:"head_tag.cs" ?>
  <body class="gc-documentation <?cs if:(reference.gms || reference.gcm) ?>google<?cs /if ?>
    <?cs if:(guide||develop||training||reference||tools||sdk) ?>develop<?cs
    elif:design ?>design<?cs
    elif:distribute ?>distribute<?cs
    /if ?>" itemscope itemtype="http://schema.org/Article">
    <div id="doc-api-level" class="<?cs var:class.since ?>" style="display:none"></div>
    <a name="top"></a>
  <?cs include:"header.cs" ?>
  
  <div class="col-12"  id="doc-col">
  
  <div id="api-info-block">
  
  <?cs # are there inherited members ?>
  <?cs each:cl=class.inherited ?>
    <?cs if:subcount(cl.methods) ?>
     <?cs set:inhmethods = #1 ?>
    <?cs /if ?>
    <?cs if:subcount(cl.constants) ?>
     <?cs set:inhconstants = #1 ?>
    <?cs /if ?>
    <?cs if:subcount(cl.fields) ?>
     <?cs set:inhfields = #1 ?>
    <?cs /if ?>
    <?cs if:subcount(cl.attrs) ?>
     <?cs set:inhattrs = #1 ?>
    <?cs /if ?>
  <?cs /each ?>
  
  <div class="sum-details-links">
  <?cs if:inhattrs || inhconstants || inhfields || inhmethods || (!class.subclasses.hidden &&
       (subcount(class.subclasses.direct) || subcount(class.subclasses.indirect))) ?>
  Summary:
  <?cs if:subcount(class.inners) ?>
    <a href="#nestedclasses">Nested Classes</a>
    <?cs set:linkcount = #1 ?>
  <?cs /if ?>
  <?cs if:subcount(class.attrs) ?>
    <?cs if:linkcount ?>&#124; <?cs /if ?><a href="#lattrs">XML Attrs</a>
    <?cs set:linkcount = #1 ?>
  <?cs /if ?>
  <?cs if:inhattrs ?>
    <?cs if:linkcount ?>&#124; <?cs /if ?><a href="#inhattrs">Inherited XML Attrs</a>
    <?cs set:linkcount = #1 ?>
  <?cs /if ?>
  <?cs if:subcount(class.enumConstants) ?>
    <?cs if:linkcount ?>&#124; <?cs /if ?><a href="#enumconstants">Enums</a>
    <?cs set:linkcount = #1 ?>
  <?cs /if ?>
  <?cs if:subcount(class.constants) ?>
    <?cs if:linkcount ?>&#124; <?cs /if ?><a href="#constants">Constants</a>
    <?cs set:linkcount = #1 ?>
  <?cs /if ?>
  <?cs if:inhconstants ?>
    <?cs if:linkcount ?>&#124; <?cs /if ?><a href="#inhconstants">Inherited Constants</a>
    <?cs set:linkcount = #1 ?>
  <?cs /if ?>
  <?cs if:subcount(class.fields) ?>
    <?cs if:linkcount ?>&#124; <?cs /if ?><a href="#lfields">Fields</a>
    <?cs set:linkcount = #1 ?>
  <?cs /if ?>
  <?cs if:inhfields ?>
    <?cs if:linkcount ?>&#124; <?cs /if ?><a href="#inhfields">Inherited Fields</a>
    <?cs set:linkcount = #1 ?>
  <?cs /if ?>
  <?cs if:subcount(class.ctors.public) ?>
    <?cs if:linkcount ?>&#124; <?cs /if ?><a href="#pubctors">Ctors</a>
    <?cs set:linkcount = #1 ?>
  <?cs /if ?>
  <?cs if:subcount(class.ctors.protected) ?>
    <?cs if:linkcount ?>&#124; <?cs /if ?><a href="#proctors">Protected Ctors</a>
    <?cs set:linkcount = #1 ?>
  <?cs /if ?>
  <?cs if:subcount(class.methods.public) ?>
    <?cs if:linkcount ?>&#124; <?cs /if ?><a href="#pubmethods">Methods</a>
    <?cs set:linkcount = #1 ?>
  <?cs /if ?>
  <?cs if:subcount(class.methods.protected) ?>
    <?cs if:linkcount ?>&#124; <?cs /if ?><a href="#promethods">Protected Methods</a>
    <?cs set:linkcount = #1 ?>
  <?cs /if ?>
  <?cs if:inhmethods ?>
    <?cs if:linkcount ?>&#124; <?cs /if ?><a href="#inhmethods">Inherited Methods</a>
  <?cs /if ?>
  &#124; <a href="#" onclick="return toggleAllClassInherited()" id="toggleAllClassInherited">[Expand All]</a>
  <?cs /if ?>
  </div><!-- end sum-details-links -->
  <div class="api-level">
    <?cs call:since_tags(class) ?><?cs
    if:class.deprecatedsince
      ?><br>Deprecated since <a href="<?cs var:toroot ?>guide/topics/manifest/uses-sdk-element.html#ApiLevels"
          >API level <?cs var:class.deprecatedsince ?></a><?cs
    /if ?>
    <?cs call:federated_refs(class) ?>
  </div>
  </div><!-- end api-info-block -->
  
  <?cs # this next line must be exactly like this to be parsed by eclipse ?>
  <!-- ======== START OF CLASS DATA ======== -->
  
  <div id="jd-header">
      <?cs var:class.scope ?>
      <?cs var:class.static ?> 
      <?cs var:class.final ?> 
      <?cs var:class.abstract ?>
      <?cs var:class.kind ?>
  <h1 itemprop="name"><?cs var:class.name ?></h1>
  
  <?cs set:colspan = subcount(class.inheritance) ?>
  <?cs each:supr = class.inheritance ?>
    <?cs if:colspan == 2 ?>
      extends <?cs call:type_link(supr.short_class) ?><br/>
    <?cs /if ?>
    <?cs if:last(supr) && subcount(supr.interfaces) ?>
        implements 
        <?cs each:t=supr.interfaces ?>
          <?cs call:type_link(t) ?> 
        <?cs /each ?>
    <?cs /if ?>
    <?cs set:colspan = colspan-1 ?>
  <?cs /each ?>
  
  </div><!-- end header -->
  
  <div id="naMessage"></div>
  
  <div id="jd-content" class="api apilevel-<?cs var:class.since ?>">
  <table class="jd-inheritance-table">
  <?cs set:colspan = subcount(class.inheritance) ?>
  <?cs each:supr = class.inheritance ?>
      <tr>
          <?cs loop:i = 1, (subcount(class.inheritance)-colspan), 1 ?>
              <td class="jd-inheritance-space">&nbsp;<?cs if:(subcount(class.inheritance)-colspan) == i ?>&nbsp;&nbsp;&#x21b3;<?cs /if ?></td>
          <?cs /loop ?> 	
          <td colspan="<?cs var:colspan ?>" class="jd-inheritance-class-cell"><?cs
              if:colspan == 1
                  ?><?cs call:class_name(class.qualifiedType) ?><?cs 
              else 
                  ?><?cs call:type_link(supr.class) ?><?cs
              /if ?></td>
      </tr>
      <?cs set:colspan = colspan-1 ?>
  <?cs /each ?>
  </table>
  
  <?cs # this next line must be exactly like this to be parsed by eclipse ?>
  
  <?cs if:subcount(class.subclasses.direct) && !class.subclasses.hidden ?>
  <table class="jd-sumtable jd-sumtable-subclasses"><tr><td colspan="12" style="border:none;margin:0;padding:0;">
  <?cs call:expando_trigger("subclasses-direct", "closed") ?>Known Direct Subclasses
  <?cs call:expandable_class_list("subclasses-direct", class.subclasses.direct, "list") ?>
  </td></tr></table>
  <?cs /if ?>
  
  <?cs if:subcount(class.subclasses.indirect) && !class.subclasses.hidden ?>
  <table class="jd-sumtable jd-sumtable-subclasses"><tr><td colspan="12" style="border:none;margin:0;padding:0;">
  <?cs call:expando_trigger("subclasses-indirect", "closed") ?>Known Indirect Subclasses
  <?cs call:expandable_class_list("subclasses-indirect", class.subclasses.indirect, "list") ?>
  </td></tr></table>
  <?cs /if ?>
  
  <div class="jd-descr">
  <?cs call:deprecated_warning(class) ?>
  <?cs if:subcount(class.descr) ?>
  <h2>Class Overview</h2>
  <p itemprop="articleBody"><?cs call:tag_list(class.descr) ?></p>
  <?cs /if ?>
  
  <?cs call:see_also_tags(class.seeAlso) ?>
  
  </div><!-- jd-descr -->
  
  
  <?cs # summary macros ?>
  
  <?cs def:write_method_summary(methods, included) ?>
  <?cs set:count = #1 ?>
  <?cs each:method = methods ?>
  	 <?cs # The apilevel-N class MUST BE LAST in the sequence of class names ?>
      <tr class="<?cs if:count % #2 ?>alt-color<?cs /if ?> api apilevel-<?cs var:method.since ?>" >
          <td class="jd-typecol"><nobr>
              <?cs var:method.abstract ?>
              <?cs var:method.synchronized ?>
              <?cs var:method.final ?>
              <?cs var:method.static ?>
              <?cs call:type_link(method.generic) ?>
              <?cs call:type_link(method.returnType) ?></nobr>
          </td>
          <td class="jd-linkcol" width="100%"><nobr>
          <span class="sympad"><?cs call:cond_link(method.name, toroot, method.href, included) ?></span>(<?cs call:parameter_list(method.params) ?>)</nobr>
          <?cs if:subcount(method.shortDescr) || subcount(method.deprecated) ?>
          <div class="jd-descrdiv"><?cs call:short_descr(method) ?></div>
    <?cs /if ?>
    </td></tr>
  <?cs set:count = count + #1 ?>
  <?cs /each ?>
  <?cs /def ?>
  
  <?cs def:write_field_summary(fields, included) ?>
  <?cs set:count = #1 ?>
      <?cs each:field=fields ?>
        <tr class="<?cs if:count % #2 ?>alt-color<?cs /if ?> api apilevel-<?cs var:field.since ?>" >
            <td class="jd-typecol"><nobr>
            <?cs var:field.scope ?>
            <?cs var:field.static ?>
            <?cs var:field.final ?>
            <?cs call:type_link(field.type) ?></nobr></td>
            <td class="jd-linkcol"><?cs call:cond_link(field.name, toroot, field.href, included) ?></td>
            <td class="jd-descrcol" width="100%"><?cs call:short_descr(field) ?></td>
        </tr>
        <?cs set:count = count + #1 ?>
      <?cs /each ?>
  <?cs /def ?>
  
  <?cs def:write_constant_summary(fields, included) ?>
  <?cs set:count = #1 ?>
      <?cs each:field=fields ?>
      <tr class="<?cs if:count % #2 ?>alt-color<?cs /if ?> api apilevel-<?cs var:field.since ?>" >
          <td class="jd-typecol"><?cs call:type_link(field.type) ?></td>
          <td class="jd-linkcol"><?cs call:cond_link(field.name, toroot, field.href, included) ?></td>
          <td class="jd-descrcol" width="100%"><?cs call:short_descr(field) ?></td>
      </tr>
      <?cs set:count = count + #1 ?>
      <?cs /each ?>
  <?cs /def ?>
  
  <?cs def:write_attr_summary(attrs, included) ?>
  <?cs set:count = #1 ?>
      <tr>
          <td><nobr><em>Attribute Name</em></nobr></td>
          <td><nobr><em>Related Method</em></nobr></td>
          <td><nobr><em>Description</em></nobr></td>
      </tr>
      <?cs each:attr=attrs ?>
      <tr class="<?cs if:count % #2 ?>alt-color<?cs /if ?> api apilevel-<?cs var:attr.since ?>" >
          <td class="jd-linkcol"><?cs if:included ?><a href="<?cs var:toroot ?><?cs var:attr.href ?>"><?cs /if ?><?cs var:attr.name ?><?cs if:included ?></a><?cs /if ?></td>
          <td class="jd-linkcol"><?cs each:m=attr.methods ?>
              <?cs call:cond_link(m.name, toroot, m.href, included) ?>
              <?cs /each ?>
          </td>
          <td class="jd-descrcol" width="100%"><?cs call:short_descr(attr) ?>&nbsp;</td>
      </tr>
      <?cs set:count = count + #1 ?>
      <?cs /each ?>
  <?cs /def ?>
  
  <?cs def:write_inners_summary(classes) ?>
  <?cs set:count = #1 ?>
    <?cs each:cl=class.inners ?>
      <tr class="<?cs if:count % #2 ?>alt-color<?cs /if ?> api apilevel-<?cs var:cl.since ?>" >
        <td class="jd-typecol"><nobr>
          <?cs var:cl.scope ?>
          <?cs var:cl.static ?> 
          <?cs var:cl.final ?> 
          <?cs var:cl.abstract ?>
          <?cs var:cl.kind ?></nobr></td>
        <td class="jd-linkcol"><?cs call:type_link(cl.type) ?></td>
        <td class="jd-descrcol" width="100%"><?cs call:short_descr(cl) ?>&nbsp;</td>
      </tr>
      <?cs set:count = count + #1 ?>
      <?cs /each ?>
  <?cs /def ?>
  
  <?cs # end macros ?>
  
  <div class="jd-descr">
  <?cs # make sure there's a summary view to display ?>
  <?cs if:subcount(class.inners)
       || subcount(class.attrs)
       || inhattrs
       || subcount(class.enumConstants)
       || subcount(class.constants)
       || inhconstants
       || subcount(class.fields)
       || inhfields
       || subcount(class.ctors.public)
       || subcount(class.ctors.protected)
       || subcount(class.methods.public)
       || subcount(class.methods.protected)
       || inhmethods ?>
  <h2>Summary</h2>
  
  <?cs if:subcount(class.inners) ?>
  <?cs # this next line must be exactly like this to be parsed by eclipse ?>
  <!-- ======== NESTED CLASS SUMMARY ======== -->
  <table id="nestedclasses" class="jd-sumtable"><tr><th colspan="12">Nested Classes</th></tr>
  <?cs call:write_inners_summary(class.inners) ?>
  <?cs /if ?>
  
  <?cs # this next line must be exactly like this to be parsed by eclipse ?>
  <?cs if:subcount(class.attrs) ?>
  <!-- =========== FIELD SUMMARY =========== -->
  <table id="lattrs" class="jd-sumtable"><tr><th colspan="12">XML Attributes</th></tr>
  <?cs call:write_attr_summary(class.attrs, 1) ?>
  <?cs /if ?>
  
  <?cs # if there are inherited attrs, write the table ?>
  <?cs if:inhattrs ?>
  <?cs # this next line must be exactly like this to be parsed by eclipse ?>
  <!-- =========== FIELD SUMMARY =========== -->
  <table id="inhattrs" class="jd-sumtable"><tr><th>
    <a href="#" class="toggle-all" onclick="return toggleAllInherited(this, null)">[Expand]</a>
    <div style="clear:left;">Inherited XML Attributes</div></th></tr>
  <?cs each:cl=class.inherited ?>
  <?cs if:subcount(cl.attrs) ?>
  <tr class="api apilevel-<?cs var:cl.since ?>" >
  <td colspan="12">
  <?cs call:expando_trigger("inherited-attrs-"+cl.qualified, "closed") ?>From <?cs var:cl.kind ?>
  <?cs call:cond_link(cl.qualified, toroot, cl.link, cl.included) ?>
  <div id="inherited-attrs-<?cs var:cl.qualified ?>">
    <div id="inherited-attrs-<?cs var:cl.qualified ?>-list"
          class="jd-inheritedlinks">
    </div>
    <div id="inherited-attrs-<?cs var:cl.qualified ?>-summary" style="display: none;">
      <table class="jd-sumtable-expando">
      <?cs call:write_attr_summary(cl.attrs, cl.included) ?></table>
    </div>
  </div>
  </td></tr>
  <?cs /if ?>
  <?cs /each ?>
  </table>
  <?cs /if ?>
  
  <?cs if:subcount(class.enumConstants) ?>
  <?cs # this next line must be exactly like this to be parsed by eclipse ?>
  <!-- =========== ENUM CONSTANT SUMMARY =========== -->
  <table id="enumconstants" class="jd-sumtable"><tr><th colspan="12">Enum Values</th></tr>
  <?cs set:count = #1 ?>
      <?cs each:field=class.enumConstants ?>
      <tr class="<?cs if:count % #2 ?>alt-color<?cs /if ?> api apilevel-<?cs var:field.since ?>" >
          <td class="jd-descrcol"><?cs call:type_link(field.type) ?>&nbsp;</td>
          <td class="jd-linkcol"><?cs call:cond_link(field.name, toroot, field.href, cl.included) ?>&nbsp;</td>
          <td class="jd-descrcol" width="100%"><?cs call:short_descr(field) ?>&nbsp;</td>
      </tr>
      <?cs set:count = count + #1 ?>
      <?cs /each ?>
  <?cs /if ?>
  
  <?cs if:subcount(class.constants) ?>
  <?cs # this next line must be exactly like this to be parsed by eclipse ?>
  <!-- =========== ENUM CONSTANT SUMMARY =========== -->
  <table id="constants" class="jd-sumtable"><tr><th colspan="12">Constants</th></tr>
  <?cs call:write_constant_summary(class.constants, 1) ?>
  </table>
  <?cs /if ?>
  
  <?cs # if there are inherited constants, write the table ?>
  <?cs if:inhconstants ?>
  <?cs # this next line must be exactly like this to be parsed by eclipse ?>
  <!-- =========== ENUM CONSTANT SUMMARY =========== -->
  <table id="inhconstants" class="jd-sumtable"><tr><th>
    <a href="#" class="toggle-all" onclick="return toggleAllInherited(this, null)">[Expand]</a>
    <div style="clear:left;">Inherited Constants</div></th></tr>
  <?cs each:cl=class.inherited ?>
  <?cs if:subcount(cl.constants) ?>
  <tr class="api apilevel-<?cs var:cl.since ?>" >
  <td colspan="12">
  <?cs call:expando_trigger("inherited-constants-"+cl.qualified, "closed") ?>From <?cs var:cl.kind ?>
  <?cs call:cond_link(cl.qualified, toroot, cl.link, cl.included) ?>
  <div id="inherited-constants-<?cs var:cl.qualified ?>">
    <div id="inherited-constants-<?cs var:cl.qualified ?>-list"
          class="jd-inheritedlinks">
    </div>
    <div id="inherited-constants-<?cs var:cl.qualified ?>-summary" style="display: none;">
      <table class="jd-sumtable-expando">
      <?cs call:write_constant_summary(cl.constants, cl.included) ?></table>
    </div>
  </div>
  </td></tr>
  <?cs /if ?>
  <?cs /each ?>
  </table>
  <?cs /if ?>
  
  <?cs if:subcount(class.fields) ?>
  <?cs # this next line must be exactly like this to be parsed by eclipse ?>
  <!-- =========== FIELD SUMMARY =========== -->
  <table id="lfields" class="jd-sumtable"><tr><th colspan="12">Fields</th></tr>
  <?cs call:write_field_summary(class.fields, 1) ?>
  </table>
  <?cs /if ?>
  
  <?cs # if there are inherited fields, write the table ?>
  <?cs if:inhfields ?>
  <?cs # this next line must be exactly like this to be parsed by eclipse ?>
  <!-- =========== FIELD SUMMARY =========== -->
  <table id="inhfields" class="jd-sumtable"><tr><th>
    <a href="#" class="toggle-all" onclick="return toggleAllInherited(this, null)">[Expand]</a>
    <div style="clear:left;">Inherited Fields</div></th></tr>
  <?cs each:cl=class.inherited ?>
  <?cs if:subcount(cl.fields) ?>
  <tr class="api apilevel-<?cs var:cl.since ?>" >
  <td colspan="12">
  <?cs call:expando_trigger("inherited-fields-"+cl.qualified, "closed") ?>From <?cs var:cl.kind ?>
  <?cs call:cond_link(cl.qualified, toroot, cl.link, cl.included) ?>
  <div id="inherited-fields-<?cs var:cl.qualified ?>">
  
gt:   <div id="inherited-fields-<?cs var:cl.qualified ?>-list"