1<!DOCTYPE html><!-- This page is a placeholder for generated extensions api doc. Note: 2 1) The <head> information in this page is significant, should be uniform 3 across api docs and should be edited only with knowledge of the 4 templating mechanism. 5 3) All <body>.innerHTML is genereated as an rendering step. If viewed in a 6 browser, it will be re-generated from the template, json schema and 7 authored overview content. 8 4) The <body>.innerHTML is also generated by an offline step so that this 9 page may easily be indexed by search engines. 10--><html xmlns="http://www.w3.org/1999/xhtml"><head> 11 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> 12 <link href="css/ApiRefStyles.css" rel="stylesheet" type="text/css"> 13 <link href="css/print.css" rel="stylesheet" type="text/css" media="print"> 14 <script type="text/javascript" src="../../../third_party/jstemplate/jstemplate_compiled.js"> 15 </script> 16 <script type="text/javascript" src="js/api_page_generator.js"></script> 17 <script type="text/javascript" src="js/bootstrap.js"></script> 18 <script type="text/javascript" src="js/sidebar.js"></script> 19 <title>Windows - Google Chrome Extensions - Google Code</title></head> 20 <body> <div id="gc-container" class="labs"> 21 <div id="devModeWarning"> 22 You are viewing extension docs in chrome via the 'file:' scheme: are you expecting to see local changes when you refresh? You'll need run chrome with --allow-file-access-from-files. 23 </div> 24 <!-- SUBTEMPLATES: DO NOT MOVE FROM THIS LOCATION --> 25 <!-- In particular, sub-templates that recurse, must be used by allowing 26 jstemplate to make a copy of the template in this section which 27 are not operated on by way of the jsskip="true" --> 28 <div style="display:none"> 29 30 <!-- VALUE --> 31 <div id="valueTemplate"> 32 <dt> 33 <var>paramName</var> 34 <em> 35 36 <!-- TYPE --> 37 <div style="display:inline"> 38 ( 39 <span class="optional">optional</span> 40 <span class="enum">enumerated</span> 41 <span id="typeTemplate"> 42 <span> 43 <a> Type</a> 44 </span> 45 <span> 46 <span> 47 array of <span><span></span></span> 48 </span> 49 <span>paramType</span> 50 <span></span> 51 </span> 52 </span> 53 ) 54 </div> 55 56 </em> 57 </dt> 58 <dd class="todo"> 59 Undocumented. 60 </dd> 61 <dd> 62 Description of this parameter from the json schema. 63 </dd> 64 <dd> 65 This parameter was added in version 66 <b><span></span></b>. 67 You must omit this parameter in earlier versions, 68 and you may omit it in any version. If you require this 69 parameter, the manifest key 70 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 71 can ensure that your extension won't be run in an earlier browser version. 72 </dd> 73 74 <!-- OBJECT PROPERTIES --> 75 <dd> 76 <dl> 77 <div> 78 <div> 79 </div> 80 </div> 81 </dl> 82 </dd> 83 84 <!-- OBJECT METHODS --> 85 <dd> 86 <div></div> 87 </dd> 88 89 <!-- OBJECT EVENT FIELDS --> 90 <dd> 91 <div></div> 92 </dd> 93 94 <!-- FUNCTION PARAMETERS --> 95 <dd> 96 <div></div> 97 </dd> 98 99 </div> <!-- /VALUE --> 100 101 <div id="functionParametersTemplate"> 102 <h5>Parameters</h5> 103 <dl> 104 <div> 105 <div> 106 </div> 107 </div> 108 </dl> 109 </div> 110 </div> <!-- /SUBTEMPLATES --> 111 112 <a id="top"></a> 113 <div id="skipto"> 114 <a href="#gc-pagecontent">Skip to page content</a> 115 <a href="#gc-toc">Skip to main navigation</a> 116 </div> 117 <!-- API HEADER --> 118 <table id="header" width="100%" cellspacing="0" border="0"> 119 <tbody><tr> 120 <td valign="middle"><a href="http://code.google.com/"><img src="images/code_labs_logo.gif" height="43" width="161" alt="Google Code Labs" style="border:0; margin:0;"></a></td> 121 <td valign="middle" width="100%" style="padding-left:0.6em;"> 122 <form action="http://www.google.com/cse" id="cse" style="margin-top:0.5em"> 123 <div id="gsc-search-box"> 124 <input type="hidden" name="cx" value="002967670403910741006:61_cvzfqtno"> 125 <input type="hidden" name="ie" value="UTF-8"> 126 <input type="text" name="q" value="" size="55"> 127 <input class="gsc-search-button" type="submit" name="sa" value="Search"> 128 <br> 129 <span class="greytext">e.g. "page action" or "tabs"</span> 130 </div> 131 </form> 132 133 <script type="text/javascript" src="http://www.google.com/jsapi"></script> 134 <script type="text/javascript">google.load("elements", "1", {packages: "transliteration"});</script> 135 <script type="text/javascript" src="http://www.google.com/coop/cse/t13n?form=cse&t13n_langs=en"></script> 136 <script type="text/javascript" src="http://www.google.com/coop/cse/brand?form=cse&lang=en"></script> 137 </td> 138 </tr> 139 </tbody></table> 140 141 <div id="codesiteContent" class=""> 142 143 <a id="gc-topnav-anchor"></a> 144 <div id="gc-topnav"> 145 <h1>Google Chrome Extensions (<a href="http://code.google.com/labs/">Labs</a>)</h1> 146 <ul id="home" class="gc-topnav-tabs"> 147 <li id="home_link"> 148 <a href="index.html" title="Google Chrome Extensions home page">Home</a> 149 </li> 150 <li id="docs_link"> 151 <a href="docs.html" title="Official Google Chrome Extensions documentation">Docs</a> 152 </li> 153 <li id="faq_link"> 154 <a href="faq.html" title="Answers to frequently asked questions about Google Chrome Extensions">FAQ</a> 155 </li> 156 <li id="samples_link"> 157 <a href="samples.html" title="Sample extensions (with source code)">Samples</a> 158 </li> 159 <li id="group_link"> 160 <a href="http://groups.google.com/a/chromium.org/group/chromium-extensions" title="Google Chrome Extensions developer forum">Group</a> 161 </li> 162 </ul> 163 </div> <!-- end gc-topnav --> 164 165 <div class="g-section g-tpl-170"> 166 <!-- SIDENAV --> 167 <div class="g-unit g-first" id="gc-toc"> 168 <ul> 169 <li><a href="getstarted.html">Getting Started</a></li> 170 <li><a href="overview.html">Overview</a></li> 171 <li><a href="whats_new.html">What's New?</a></li> 172 <li><h2><a href="devguide.html">Developer's Guide</a></h2> 173 <ul> 174 <li>Browser UI 175 <ul> 176 <li><a href="browserAction.html">Browser Actions</a></li> 177 <li><a href="contextMenus.html">Context Menus</a></li> 178 <li><a href="notifications.html">Desktop Notifications</a></li> 179 <li><a href="omnibox.html">Omnibox</a></li> 180 <li><a href="options.html">Options Pages</a></li> 181 <li><a href="override.html">Override Pages</a></li> 182 <li><a href="pageAction.html">Page Actions</a></li> 183 </ul> 184 </li> 185 <li>Browser Interaction 186 <ul> 187 <li><a href="bookmarks.html">Bookmarks</a></li> 188 <li><a href="cookies.html">Cookies</a></li> 189 <li><a href="events.html">Events</a></li> 190 <li><a href="history.html">History</a></li> 191 <li><a href="management.html">Management</a></li> 192 <li><a href="tabs.html">Tabs</a></li> 193 <li class="leftNavSelected">Windows</li> 194 </ul> 195 </li> 196 <li>Implementation 197 <ul> 198 <li><a href="a11y.html">Accessibility</a></li> 199 <li><a href="background_pages.html">Background Pages</a></li> 200 <li><a href="content_scripts.html">Content Scripts</a></li> 201 <li><a href="xhr.html">Cross-Origin XHR</a></li> 202 <li><a href="idle.html">Idle</a></li> 203 <li><a href="i18n.html">Internationalization</a></li> 204 <li><a href="messaging.html">Message Passing</a></li> 205 <li><a href="npapi.html">NPAPI Plugins</a></li> 206 </ul> 207 </li> 208 <li>Finishing 209 <ul> 210 <li><a href="hosting.html">Hosting</a></li> 211 <li><a href="external_extensions.html">Other Deployment Options</a></li> 212 </ul> 213 </li> 214 </ul> 215 </li> 216 <li><h2><a href="apps.html">Packaged Apps</a></h2></li> 217 <li><h2><a href="tutorials.html">Tutorials</a></h2> 218 <ul> 219 <li><a href="tut_debugging.html">Debugging</a></li> 220 <li><a href="tut_analytics.html">Google Analytics</a></li> 221 <li><a href="tut_oauth.html">OAuth</a></li> 222 </ul> 223 </li> 224 <li><h2>Reference</h2> 225 <ul> 226 <li>Formats 227 <ul> 228 <li><a href="manifest.html">Manifest Files</a></li> 229 <li><a href="match_patterns.html">Match Patterns</a></li> 230 </ul> 231 </li> 232 <li><a href="permission_warnings.html">Permission Warnings</a></li> 233 <li><a href="api_index.html">chrome.* APIs</a></li> 234 <li><a href="api_other.html">Other APIs</a></li> 235 </ul> 236 </li> 237 <li><h2><a href="samples.html">Samples</a></h2></li> 238 <div class="line"> </div> 239 <li><h2>More</h2> 240 <ul> 241 <li><a href="http://code.google.com/chrome/webstore/docs/index.html">Chrome Web Store</a></li> 242 <li><a href="http://code.google.com/chrome/apps/docs/developers_guide.html">Hosted Apps</a></li> 243 <li><a href="themes.html">Themes</a></li> 244 </ul> 245 </li> 246 </ul> 247 </div> 248 <script> 249 initToggles(); 250 </script> 251 252 <div class="g-unit" id="gc-pagecontent"> 253 <div id="pageTitle"> 254 <h1 class="page_title">Windows</h1> 255 </div> 256 <!-- TABLE OF CONTENTS --> 257 <div id="toc"> 258 <h2>Contents</h2> 259 <ol> 260 <li> 261 <a href="#manifest">Manifest</a> 262 <ol> 263 <li style="display: none; "> 264 <a>h3Name</a> 265 </li> 266 </ol> 267 </li><li> 268 <a href="#current-window">The current window</a> 269 <ol> 270 <li style="display: none; "> 271 <a>h3Name</a> 272 </li> 273 </ol> 274 </li><li> 275 <a href="#examples"> Examples </a> 276 <ol> 277 <li style="display: none; "> 278 <a>h3Name</a> 279 </li> 280 </ol> 281 </li> 282 <li> 283 <a href="#apiReference">API reference: chrome.windows</a> 284 <ol> 285 <li> 286 <a href="#properties">Properties</a> 287 <ol> 288 <li> 289 <a href="#property-WINDOW_ID_NONE">WINDOW_ID_NONE</a> 290 </li> 291 </ol> 292 </li> 293 <li> 294 <a href="#global-methods">Methods</a> 295 <ol> 296 <li> 297 <a href="#method-create">create</a> 298 </li><li> 299 <a href="#method-get">get</a> 300 </li><li> 301 <a href="#method-getAll">getAll</a> 302 </li><li> 303 <a href="#method-getCurrent">getCurrent</a> 304 </li><li> 305 <a href="#method-getLastFocused">getLastFocused</a> 306 </li><li> 307 <a href="#method-remove">remove</a> 308 </li><li> 309 <a href="#method-update">update</a> 310 </li> 311 </ol> 312 </li> 313 <li> 314 <a href="#global-events">Events</a> 315 <ol> 316 <li> 317 <a href="#event-onCreated">onCreated</a> 318 </li><li> 319 <a href="#event-onFocusChanged">onFocusChanged</a> 320 </li><li> 321 <a href="#event-onRemoved">onRemoved</a> 322 </li> 323 </ol> 324 </li> 325 <li> 326 <a href="#types">Types</a> 327 <ol> 328 <li> 329 <a href="#type-Window">Window</a> 330 </li> 331 </ol> 332 </li> 333 </ol> 334 </li> 335 </ol> 336 </div> 337 <!-- /TABLE OF CONTENTS --> 338 339 <!-- Standard content lead-in for experimental API pages --> 340 <p id="classSummary" style="display: none; "> 341 For information on how to use experimental APIs, see the <a href="experimental.html">chrome.experimental.* APIs</a> page. 342 </p> 343 344 <!-- STATIC CONTENT PLACEHOLDER --> 345 <div id="static"><div id="pageData-name" class="pageData">Windows</div> 346 347<!-- BEGIN AUTHORED CONTENT --> 348<p id="classSummary"> 349Use the <code>chrome.windows</code> module 350to interact with browser windows. 351You can use this module to 352create, modify, and rearrange windows in the browser. 353</p> 354 355<img src="images/windows.png" width="256" height="76" alt="Two windows, each with one tab"> 356 357<h2 id="manifest">Manifest</h2> 358<p> 359To use the windows API, 360you must declare the "tabs" permission 361in <a href="manifest.html">manifest.json</a>. 362(No, that isn't a typo — 363the window and tabs modules interact so closely we 364decided to just share one permission between them.) 365For example: 366</p> 367 368<pre>{ 369 "name": "My extension", 370 ... 371 <b>"permissions": ["tabs"]</b>, 372 ... 373}</pre> 374 375<h2 id="current-window">The current window</h2> 376 377<p>Many functions in the extension system 378take an optional <var>windowId</var> parameter, 379which defaults to the current window. 380</p> 381 382<p>The <em>current window</em> is the window that 383contains the code that is currently executing. 384It's important to realize that this can be 385different from the topmost or focused window. 386</p> 387 388<p>For example, say an extension 389creates a few tabs or windows from a single HTML file, 390and that the HTML file 391contains a call to 392<a href="tabs.html#method-getSelected">chrome.tabs.getSelected</a>. 393The current window is the window that contains the page that made 394the call, no matter what the topmost window is. 395</p> 396 397<p>In the case of the <a href="background_pages.html">background page</a>, 398the value of the current window falls back to the last active window. Under some 399circumstances, there may be no current window for background pages. 400</p> 401 402<h2 id="examples"> Examples </h2> 403 404<p> 405You can find simple examples of using the windows module in the 406<a href="http://src.chromium.org/viewvc/chrome/trunk/src/chrome/common/extensions/docs/examples/api/windows/">examples/api/windows</a> 407directory. 408Another example is in the 409<a href="http://src.chromium.org/viewvc/chrome/trunk/src/chrome/common/extensions/docs/examples/api/tabs/inspector/tabs_api.html?content-type=text/plain">tabs_api.html</a> file 410of the 411<a href="http://src.chromium.org/viewvc/chrome/trunk/src/chrome/common/extensions/docs/examples/api/tabs/inspector/">inspector</a> 412example. 413For other examples and for help in viewing the source code, see 414<a href="samples.html">Samples</a>. 415</p> 416 417<!-- END AUTHORED CONTENT --> 418</div> 419 420 <!-- API PAGE --> 421 <div class="apiPage"> 422 <a name="apiReference"></a> 423 <h2>API reference: chrome.windows</h2> 424 425 <!-- PROPERTIES --> 426 <div class="apiGroup"> 427 <a name="properties"></a> 428 <h3 id="properties">Properties</h3> 429 430 <div> 431 <a name="property-WINDOW_ID_NONE"></a> 432 <h4>WINDOW_ID_NONE</h4> 433 <div class="summary"> 434 <!-- Note: intentionally longer 80 columns --> 435 <span>chrome.windows.</span><span>WINDOW_ID_NONE</span> 436 </div> 437 <div> 438 <dt> 439 <var>WINDOW_ID_NONE</var> 440 <em> 441 442 <!-- TYPE --> 443 <div style="display:inline"> 444 ( 445 <span class="optional" style="display: none; ">optional</span> 446 <span class="enum" style="display: none; ">enumerated</span> 447 <span id="typeTemplate"> 448 <span style="display: none; "> 449 <a> Type</a> 450 </span> 451 <span> 452 <span style="display: none; "> 453 array of <span><span></span></span> 454 </span> 455 <span>integer</span> 456 <span style="display: none; "></span> 457 </span> 458 </span> 459 ) 460 </div> 461 462 </em> 463 </dt> 464 <dd class="todo" style="display: none; "> 465 Undocumented. 466 </dd> 467 <dd>The windowId value that represents the absence of a chrome browser window.</dd> 468 <dd style="display: none; "> 469 This parameter was added in version 470 <b><span></span></b>. 471 You must omit this parameter in earlier versions, 472 and you may omit it in any version. If you require this 473 parameter, the manifest key 474 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 475 can ensure that your extension won't be run in an earlier browser version. 476 </dd> 477 478 <!-- OBJECT PROPERTIES --> 479 <dd style="display: none; "> 480 <dl> 481 <div> 482 <div> 483 </div> 484 </div> 485 </dl> 486 </dd> 487 488 <!-- OBJECT METHODS --> 489 <dd style="display: none; "> 490 <div></div> 491 </dd> 492 493 <!-- OBJECT EVENT FIELDS --> 494 <dd style="display: none; "> 495 <div></div> 496 </dd> 497 498 <!-- FUNCTION PARAMETERS --> 499 <dd style="display: none; "> 500 <div></div> 501 </dd> 502 503 </div> 504 </div> 505 506 </div> <!-- /apiGroup --> 507 508 <!-- METHODS --> 509 <div id="methodsTemplate" class="apiGroup"> 510 <a name="global-methods"></a> 511 <h3>Methods</h3> 512 513 <!-- iterates over all functions --> 514 <div class="apiItem"> 515 <a name="method-create"></a> <!-- method-anchor --> 516 <h4>create</h4> 517 518 <div class="summary"><span style="display: none; ">void</span> 519 <!-- Note: intentionally longer 80 columns --> 520 <span>chrome.windows.create</span>(<span class="optional"><span style="display: none; ">, </span><span>object</span> 521 <var><span>createData</span></var></span><span class="optional"><span>, </span><span>function</span> 522 <var><span>callback</span></var></span>)</div> 523 524 <div class="description"> 525 <p class="todo" style="display: none; ">Undocumented.</p> 526 <p>Creates (opens) a new browser with any optional sizing, position or default URL provided.</p> 527 528 <!-- PARAMETERS --> 529 <h4>Parameters</h4> 530 <dl> 531 <div> 532 <div> 533 <dt> 534 <var>createData</var> 535 <em> 536 537 <!-- TYPE --> 538 <div style="display:inline"> 539 ( 540 <span class="optional">optional</span> 541 <span class="enum" style="display: none; ">enumerated</span> 542 <span id="typeTemplate"> 543 <span style="display: none; "> 544 <a> Type</a> 545 </span> 546 <span> 547 <span style="display: none; "> 548 array of <span><span></span></span> 549 </span> 550 <span>object</span> 551 <span style="display: none; "></span> 552 </span> 553 </span> 554 ) 555 </div> 556 557 </em> 558 </dt> 559 <dd class="todo"> 560 Undocumented. 561 </dd> 562 <dd style="display: none; "> 563 Description of this parameter from the json schema. 564 </dd> 565 <dd style="display: none; "> 566 This parameter was added in version 567 <b><span></span></b>. 568 You must omit this parameter in earlier versions, 569 and you may omit it in any version. If you require this 570 parameter, the manifest key 571 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 572 can ensure that your extension won't be run in an earlier browser version. 573 </dd> 574 575 <!-- OBJECT PROPERTIES --> 576 <dd> 577 <dl> 578 <div> 579 <div> 580 <dt> 581 <var>url</var> 582 <em> 583 584 <!-- TYPE --> 585 <div style="display:inline"> 586 ( 587 <span class="optional">optional</span> 588 <span class="enum" style="display: none; ">enumerated</span> 589 <span id="typeTemplate"> 590 <span style="display: none; "> 591 <a> Type</a> 592 </span> 593 <span> 594 <span style="display: none; "> 595 array of <span><span></span></span> 596 </span> 597 <span>string or array of string</span> 598 <span style="display: none; "></span> 599 </span> 600 </span> 601 ) 602 </div> 603 604 </em> 605 </dt> 606 <dd class="todo" style="display: none; "> 607 Undocumented. 608 </dd> 609 <dd>A URL or list of URLs to open as tabs in the window. Fully-qualified URLs must include a scheme (i.e. 'http://www.google.com', not 'www.google.com'). Relative URLs will be relative to the current page within the extension. Defaults to the New Tab Page.</dd> 610 <dd style="display: none; "> 611 This parameter was added in version 612 <b><span></span></b>. 613 You must omit this parameter in earlier versions, 614 and you may omit it in any version. If you require this 615 parameter, the manifest key 616 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 617 can ensure that your extension won't be run in an earlier browser version. 618 </dd> 619 620 <!-- OBJECT PROPERTIES --> 621 <dd style="display: none; "> 622 <dl> 623 <div> 624 <div> 625 </div> 626 </div> 627 </dl> 628 </dd> 629 630 <!-- OBJECT METHODS --> 631 <dd style="display: none; "> 632 <div></div> 633 </dd> 634 635 <!-- OBJECT EVENT FIELDS --> 636 <dd style="display: none; "> 637 <div></div> 638 </dd> 639 640 <!-- FUNCTION PARAMETERS --> 641 <dd style="display: none; "> 642 <div></div> 643 </dd> 644 645 </div> 646 </div><div> 647 <div> 648 <dt> 649 <var>tabId</var> 650 <em> 651 652 <!-- TYPE --> 653 <div style="display:inline"> 654 ( 655 <span class="optional">optional</span> 656 <span class="enum" style="display: none; ">enumerated</span> 657 <span id="typeTemplate"> 658 <span style="display: none; "> 659 <a> Type</a> 660 </span> 661 <span> 662 <span style="display: none; "> 663 array of <span><span></span></span> 664 </span> 665 <span>integer</span> 666 <span style="display: none; "></span> 667 </span> 668 </span> 669 ) 670 </div> 671 672 </em> 673 </dt> 674 <dd class="todo" style="display: none; "> 675 Undocumented. 676 </dd> 677 <dd>The id of the tab for which you want to adopt to the new window.</dd> 678 <dd style="display: none; "> 679 This parameter was added in version 680 <b><span></span></b>. 681 You must omit this parameter in earlier versions, 682 and you may omit it in any version. If you require this 683 parameter, the manifest key 684 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 685 can ensure that your extension won't be run in an earlier browser version. 686 </dd> 687 688 <!-- OBJECT PROPERTIES --> 689 <dd style="display: none; "> 690 <dl> 691 <div> 692 <div> 693 </div> 694 </div> 695 </dl> 696 </dd> 697 698 <!-- OBJECT METHODS --> 699 <dd style="display: none; "> 700 <div></div> 701 </dd> 702 703 <!-- OBJECT EVENT FIELDS --> 704 <dd style="display: none; "> 705 <div></div> 706 </dd> 707 708 <!-- FUNCTION PARAMETERS --> 709 <dd style="display: none; "> 710 <div></div> 711 </dd> 712 713 </div> 714 </div><div> 715 <div> 716 <dt> 717 <var>left</var> 718 <em> 719 720 <!-- TYPE --> 721 <div style="display:inline"> 722 ( 723 <span class="optional">optional</span> 724 <span class="enum" style="display: none; ">enumerated</span> 725 <span id="typeTemplate"> 726 <span style="display: none; "> 727 <a> Type</a> 728 </span> 729 <span> 730 <span style="display: none; "> 731 array of <span><span></span></span> 732 </span> 733 <span>integer</span> 734 <span style="display: none; "></span> 735 </span> 736 </span> 737 ) 738 </div> 739 740 </em> 741 </dt> 742 <dd class="todo" style="display: none; "> 743 Undocumented. 744 </dd> 745 <dd>The number of pixels to position the new window from the left edge of the screen. If not specified, the new window is offset naturally from the last focusd window.</dd> 746 <dd style="display: none; "> 747 This parameter was added in version 748 <b><span></span></b>. 749 You must omit this parameter in earlier versions, 750 and you may omit it in any version. If you require this 751 parameter, the manifest key 752 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 753 can ensure that your extension won't be run in an earlier browser version. 754 </dd> 755 756 <!-- OBJECT PROPERTIES --> 757 <dd style="display: none; "> 758 <dl> 759 <div> 760 <div> 761 </div> 762 </div> 763 </dl> 764 </dd> 765 766 <!-- OBJECT METHODS --> 767 <dd style="display: none; "> 768 <div></div> 769 </dd> 770 771 <!-- OBJECT EVENT FIELDS --> 772 <dd style="display: none; "> 773 <div></div> 774 </dd> 775 776 <!-- FUNCTION PARAMETERS --> 777 <dd style="display: none; "> 778 <div></div> 779 </dd> 780 781 </div> 782 </div><div> 783 <div> 784 <dt> 785 <var>top</var> 786 <em> 787 788 <!-- TYPE --> 789 <div style="display:inline"> 790 ( 791 <span class="optional">optional</span> 792 <span class="enum" style="display: none; ">enumerated</span> 793 <span id="typeTemplate"> 794 <span style="display: none; "> 795 <a> Type</a> 796 </span> 797 <span> 798 <span style="display: none; "> 799 array of <span><span></span></span> 800 </span> 801 <span>integer</span> 802 <span style="display: none; "></span> 803 </span> 804 </span> 805 ) 806 </div> 807 808 </em> 809 </dt> 810 <dd class="todo" style="display: none; "> 811 Undocumented. 812 </dd> 813 <dd>The number of pixels to position the new window from the top edge of the screen. If not specified, the new window is offset naturally from the last focusd window.</dd> 814 <dd style="display: none; "> 815 This parameter was added in version 816 <b><span></span></b>. 817 You must omit this parameter in earlier versions, 818 and you may omit it in any version. If you require this 819 parameter, the manifest key 820 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 821 can ensure that your extension won't be run in an earlier browser version. 822 </dd> 823 824 <!-- OBJECT PROPERTIES --> 825 <dd style="display: none; "> 826 <dl> 827 <div> 828 <div> 829 </div> 830 </div> 831 </dl> 832 </dd> 833 834 <!-- OBJECT METHODS --> 835 <dd style="display: none; "> 836 <div></div> 837 </dd> 838 839 <!-- OBJECT EVENT FIELDS --> 840 <dd style="display: none; "> 841 <div></div> 842 </dd> 843 844 <!-- FUNCTION PARAMETERS --> 845 <dd style="display: none; "> 846 <div></div> 847 </dd> 848 849 </div> 850 </div><div> 851 <div> 852 <dt> 853 <var>width</var> 854 <em> 855 856 <!-- TYPE --> 857 <div style="display:inline"> 858 ( 859 <span class="optional">optional</span> 860 <span class="enum" style="display: none; ">enumerated</span> 861 <span id="typeTemplate"> 862 <span style="display: none; "> 863 <a> Type</a> 864 </span> 865 <span> 866 <span style="display: none; "> 867 array of <span><span></span></span> 868 </span> 869 <span>integer</span> 870 <span style="display: none; "></span> 871 </span> 872 </span> 873 ) 874 </div> 875 876 </em> 877 </dt> 878 <dd class="todo" style="display: none; "> 879 Undocumented. 880 </dd> 881 <dd>The width in pixels of the new window. If not specified defaults to a natural width.</dd> 882 <dd style="display: none; "> 883 This parameter was added in version 884 <b><span></span></b>. 885 You must omit this parameter in earlier versions, 886 and you may omit it in any version. If you require this 887 parameter, the manifest key 888 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 889 can ensure that your extension won't be run in an earlier browser version. 890 </dd> 891 892 <!-- OBJECT PROPERTIES --> 893 <dd style="display: none; "> 894 <dl> 895 <div> 896 <div> 897 </div> 898 </div> 899 </dl> 900 </dd> 901 902 <!-- OBJECT METHODS --> 903 <dd style="display: none; "> 904 <div></div> 905 </dd> 906 907 <!-- OBJECT EVENT FIELDS --> 908 <dd style="display: none; "> 909 <div></div> 910 </dd> 911 912 <!-- FUNCTION PARAMETERS --> 913 <dd style="display: none; "> 914 <div></div> 915 </dd> 916 917 </div> 918 </div><div> 919 <div> 920 <dt> 921 <var>height</var> 922 <em> 923 924 <!-- TYPE --> 925 <div style="display:inline"> 926 ( 927 <span class="optional">optional</span> 928 <span class="enum" style="display: none; ">enumerated</span> 929 <span id="typeTemplate"> 930 <span style="display: none; "> 931 <a> Type</a> 932 </span> 933 <span> 934 <span style="display: none; "> 935 array of <span><span></span></span> 936 </span> 937 <span>integer</span> 938 <span style="display: none; "></span> 939 </span> 940 </span> 941 ) 942 </div> 943 944 </em> 945 </dt> 946 <dd class="todo" style="display: none; "> 947 Undocumented. 948 </dd> 949 <dd>The height in pixels of the new window. If not specified defaults to a natural height.</dd> 950 <dd style="display: none; "> 951 This parameter was added in version 952 <b><span></span></b>. 953 You must omit this parameter in earlier versions, 954 and you may omit it in any version. If you require this 955 parameter, the manifest key 956 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 957 can ensure that your extension won't be run in an earlier browser version. 958 </dd> 959 960 <!-- OBJECT PROPERTIES --> 961 <dd style="display: none; "> 962 <dl> 963 <div> 964 <div> 965 </div> 966 </div> 967 </dl> 968 </dd> 969 970 <!-- OBJECT METHODS --> 971 <dd style="display: none; "> 972 <div></div> 973 </dd> 974 975 <!-- OBJECT EVENT FIELDS --> 976 <dd style="display: none; "> 977 <div></div> 978 </dd> 979 980 <!-- FUNCTION PARAMETERS --> 981 <dd style="display: none; "> 982 <div></div> 983 </dd> 984 985 </div> 986 </div><div> 987 <div> 988 <dt> 989 <var>focused</var> 990 <em> 991 992 <!-- TYPE --> 993 <div style="display:inline"> 994 ( 995 <span class="optional">optional</span> 996 <span class="enum" style="display: none; ">enumerated</span> 997 <span id="typeTemplate"> 998 <span style="display: none; "> 999 <a> Type</a> 1000 </span> 1001 <span> 1002 <span style="display: none; "> 1003 array of <span><span></span></span> 1004 </span> 1005 <span>boolean</span> 1006 <span style="display: none; "></span> 1007 </span> 1008 </span> 1009 ) 1010 </div> 1011 1012 </em> 1013 </dt> 1014 <dd class="todo" style="display: none; "> 1015 Undocumented. 1016 </dd> 1017 <dd>If true, opens an active window. If false, opens an inactive window.</dd> 1018 <dd style="display: none; "> 1019 This parameter was added in version 1020 <b><span></span></b>. 1021 You must omit this parameter in earlier versions, 1022 and you may omit it in any version. If you require this 1023 parameter, the manifest key 1024 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 1025 can ensure that your extension won't be run in an earlier browser version. 1026 </dd> 1027 1028 <!-- OBJECT PROPERTIES --> 1029 <dd style="display: none; "> 1030 <dl> 1031 <div> 1032 <div> 1033 </div> 1034 </div> 1035 </dl> 1036 </dd> 1037 1038 <!-- OBJECT METHODS --> 1039 <dd style="display: none; "> 1040 <div></div> 1041 </dd> 1042 1043 <!-- OBJECT EVENT FIELDS --> 1044 <dd style="display: none; "> 1045 <div></div> 1046 </dd> 1047 1048 <!-- FUNCTION PARAMETERS --> 1049 <dd style="display: none; "> 1050 <div></div> 1051 </dd> 1052 1053 </div> 1054 </div><div> 1055 <div> 1056 <dt> 1057 <var>incognito</var> 1058 <em> 1059 1060 <!-- TYPE --> 1061 <div style="display:inline"> 1062 ( 1063 <span class="optional">optional</span> 1064 <span class="enum" style="display: none; ">enumerated</span> 1065 <span id="typeTemplate"> 1066 <span style="display: none; "> 1067 <a> Type</a> 1068 </span> 1069 <span> 1070 <span style="display: none; "> 1071 array of <span><span></span></span> 1072 </span> 1073 <span>boolean</span> 1074 <span style="display: none; "></span> 1075 </span> 1076 </span> 1077 ) 1078 </div> 1079 1080 </em> 1081 </dt> 1082 <dd class="todo" style="display: none; "> 1083 Undocumented. 1084 </dd> 1085 <dd>Whether the new window should be an incognito window.</dd> 1086 <dd style="display: none; "> 1087 This parameter was added in version 1088 <b><span></span></b>. 1089 You must omit this parameter in earlier versions, 1090 and you may omit it in any version. If you require this 1091 parameter, the manifest key 1092 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 1093 can ensure that your extension won't be run in an earlier browser version. 1094 </dd> 1095 1096 <!-- OBJECT PROPERTIES --> 1097 <dd style="display: none; "> 1098 <dl> 1099 <div> 1100 <div> 1101 </div> 1102 </div> 1103 </dl> 1104 </dd> 1105 1106 <!-- OBJECT METHODS --> 1107 <dd style="display: none; "> 1108 <div></div> 1109 </dd> 1110 1111 <!-- OBJECT EVENT FIELDS --> 1112 <dd style="display: none; "> 1113 <div></div> 1114 </dd> 1115 1116 <!-- FUNCTION PARAMETERS --> 1117 <dd style="display: none; "> 1118 <div></div> 1119 </dd> 1120 1121 </div> 1122 </div><div> 1123 <div> 1124 <dt> 1125 <var>type</var> 1126 <em> 1127 1128 <!-- TYPE --> 1129 <div style="display:inline"> 1130 ( 1131 <span class="optional">optional</span> 1132 <span class="enum">enumerated</span> 1133 <span id="typeTemplate"> 1134 <span style="display: none; "> 1135 <a> Type</a> 1136 </span> 1137 <span> 1138 <span style="display: none; "> 1139 array of <span><span></span></span> 1140 </span> 1141 <span>string</span> 1142 <span>["normal", "popup", "panel"]</span> 1143 </span> 1144 </span> 1145 ) 1146 </div> 1147 1148 </em> 1149 </dt> 1150 <dd class="todo" style="display: none; "> 1151 Undocumented. 1152 </dd> 1153 <dd>Specifies what type of browser window to create. The 'panel' type requires the 'experimental' permission.</dd> 1154 <dd style="display: none; "> 1155 This parameter was added in version 1156 <b><span></span></b>. 1157 You must omit this parameter in earlier versions, 1158 and you may omit it in any version. If you require this 1159 parameter, the manifest key 1160 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 1161 can ensure that your extension won't be run in an earlier browser version. 1162 </dd> 1163 1164 <!-- OBJECT PROPERTIES --> 1165 <dd style="display: none; "> 1166 <dl> 1167 <div> 1168 <div> 1169 </div> 1170 </div> 1171 </dl> 1172 </dd> 1173 1174 <!-- OBJECT METHODS --> 1175 <dd style="display: none; "> 1176 <div></div> 1177 </dd> 1178 1179 <!-- OBJECT EVENT FIELDS --> 1180 <dd style="display: none; "> 1181 <div></div> 1182 </dd> 1183 1184 <!-- FUNCTION PARAMETERS --> 1185 <dd style="display: none; "> 1186 <div></div> 1187 </dd> 1188 1189 </div> 1190 </div> 1191 </dl> 1192 </dd> 1193 1194 <!-- OBJECT METHODS --> 1195 <dd style="display: none; "> 1196 <div></div> 1197 </dd> 1198 1199 <!-- OBJECT EVENT FIELDS --> 1200 <dd style="display: none; "> 1201 <div></div> 1202 </dd> 1203 1204 <!-- FUNCTION PARAMETERS --> 1205 <dd style="display: none; "> 1206 <div></div> 1207 </dd> 1208 1209 </div> 1210 </div><div> 1211 <div> 1212 <dt> 1213 <var>callback</var> 1214 <em> 1215 1216 <!-- TYPE --> 1217 <div style="display:inline"> 1218 ( 1219 <span class="optional">optional</span> 1220 <span class="enum" style="display: none; ">enumerated</span> 1221 <span id="typeTemplate"> 1222 <span style="display: none; "> 1223 <a> Type</a> 1224 </span> 1225 <span> 1226 <span style="display: none; "> 1227 array of <span><span></span></span> 1228 </span> 1229 <span>function</span> 1230 <span style="display: none; "></span> 1231 </span> 1232 </span> 1233 ) 1234 </div> 1235 1236 </em> 1237 </dt> 1238 <dd class="todo"> 1239 Undocumented. 1240 </dd> 1241 <dd style="display: none; "> 1242 Description of this parameter from the json schema. 1243 </dd> 1244 <dd style="display: none; "> 1245 This parameter was added in version 1246 <b><span></span></b>. 1247 You must omit this parameter in earlier versions, 1248 and you may omit it in any version. If you require this 1249 parameter, the manifest key 1250 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 1251 can ensure that your extension won't be run in an earlier browser version. 1252 </dd> 1253 1254 <!-- OBJECT PROPERTIES --> 1255 <dd style="display: none; "> 1256 <dl> 1257 <div> 1258 <div> 1259 </div> 1260 </div> 1261 </dl> 1262 </dd> 1263 1264 <!-- OBJECT METHODS --> 1265 <dd style="display: none; "> 1266 <div></div> 1267 </dd> 1268 1269 <!-- OBJECT EVENT FIELDS --> 1270 <dd style="display: none; "> 1271 <div></div> 1272 </dd> 1273 1274 <!-- FUNCTION PARAMETERS --> 1275 <dd style="display: none; "> 1276 <div></div> 1277 </dd> 1278 1279 </div> 1280 </div> 1281 </dl> 1282 1283 <!-- RETURNS --> 1284 <h4 style="display: none; ">Returns</h4> 1285 <dl> 1286 <div style="display: none; "> 1287 <div> 1288 </div> 1289 </div> 1290 </dl> 1291 1292 <!-- CALLBACK --> 1293 <div> 1294 <div> 1295 <h4>Callback function</h4> 1296 <p style="display: none; "> 1297 The callback <em>parameter</em> should specify a function 1298 that looks like this: 1299 </p> 1300 <p> 1301 If you specify the <em>callback</em> parameter, it should 1302 specify a function that looks like this: 1303 </p> 1304 1305 <!-- Note: intentionally longer 80 columns --> 1306 <pre>function(<span>Window window</span>) <span class="subdued">{...}</span>;</pre> 1307 <dl> 1308 <div> 1309 <div> 1310 <dt> 1311 <var>window</var> 1312 <em> 1313 1314 <!-- TYPE --> 1315 <div style="display:inline"> 1316 ( 1317 <span class="optional">optional</span> 1318 <span class="enum" style="display: none; ">enumerated</span> 1319 <span id="typeTemplate"> 1320 <span> 1321 <a href="windows.html#type-Window">Window</a> 1322 </span> 1323 <span style="display: none; "> 1324 <span> 1325 array of <span><span></span></span> 1326 </span> 1327 <span>paramType</span> 1328 <span></span> 1329 </span> 1330 </span> 1331 ) 1332 </div> 1333 1334 </em> 1335 </dt> 1336 <dd class="todo" style="display: none; "> 1337 Undocumented. 1338 </dd> 1339 <dd>Contains details about the created window.</dd> 1340 <dd style="display: none; "> 1341 This parameter was added in version 1342 <b><span></span></b>. 1343 You must omit this parameter in earlier versions, 1344 and you may omit it in any version. If you require this 1345 parameter, the manifest key 1346 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 1347 can ensure that your extension won't be run in an earlier browser version. 1348 </dd> 1349 1350 <!-- OBJECT PROPERTIES --> 1351 <dd style="display: none; "> 1352 <dl> 1353 <div> 1354 <div> 1355 </div> 1356 </div> 1357 </dl> 1358 </dd> 1359 1360 <!-- OBJECT METHODS --> 1361 <dd style="display: none; "> 1362 <div></div> 1363 </dd> 1364 1365 <!-- OBJECT EVENT FIELDS --> 1366 <dd style="display: none; "> 1367 <div></div> 1368 </dd> 1369 1370 <!-- FUNCTION PARAMETERS --> 1371 <dd style="display: none; "> 1372 <div></div> 1373 </dd> 1374 1375 </div> 1376 </div> 1377 </dl> 1378 </div> 1379 </div> 1380 1381 <!-- MIN_VERSION --> 1382 <p style="display: none; "> 1383 This function was added in version <b><span></span></b>. 1384 If you require this function, the manifest key 1385 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 1386 can ensure that your extension won't be run in an earlier browser version. 1387 </p> 1388 </div> <!-- /description --> 1389 1390 </div><div class="apiItem"> 1391 <a name="method-get"></a> <!-- method-anchor --> 1392 <h4>get</h4> 1393 1394 <div class="summary"><span style="display: none; ">void</span> 1395 <!-- Note: intentionally longer 80 columns --> 1396 <span>chrome.windows.get</span>(<span class="null"><span style="display: none; ">, </span><span>integer</span> 1397 <var><span>windowId</span></var></span><span class="null"><span>, </span><span>function</span> 1398 <var><span>callback</span></var></span>)</div> 1399 1400 <div class="description"> 1401 <p class="todo" style="display: none; ">Undocumented.</p> 1402 <p>Gets details about a window.</p> 1403 1404 <!-- PARAMETERS --> 1405 <h4>Parameters</h4> 1406 <dl> 1407 <div> 1408 <div> 1409 <dt> 1410 <var>windowId</var> 1411 <em> 1412 1413 <!-- TYPE --> 1414 <div style="display:inline"> 1415 ( 1416 <span class="optional" style="display: none; ">optional</span> 1417 <span class="enum" style="display: none; ">enumerated</span> 1418 <span id="typeTemplate"> 1419 <span style="display: none; "> 1420 <a> Type</a> 1421 </span> 1422 <span> 1423 <span style="display: none; "> 1424 array of <span><span></span></span> 1425 </span> 1426 <span>integer</span> 1427 <span style="display: none; "></span> 1428 </span> 1429 </span> 1430 ) 1431 </div> 1432 1433 </em> 1434 </dt> 1435 <dd class="todo"> 1436 Undocumented. 1437 </dd> 1438 <dd style="display: none; "> 1439 Description of this parameter from the json schema. 1440 </dd> 1441 <dd style="display: none; "> 1442 This parameter was added in version 1443 <b><span></span></b>. 1444 You must omit this parameter in earlier versions, 1445 and you may omit it in any version. If you require this 1446 parameter, the manifest key 1447 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 1448 can ensure that your extension won't be run in an earlier browser version. 1449 </dd> 1450 1451 <!-- OBJECT PROPERTIES --> 1452 <dd style="display: none; "> 1453 <dl> 1454 <div> 1455 <div> 1456 </div> 1457 </div> 1458 </dl> 1459 </dd> 1460 1461 <!-- OBJECT METHODS --> 1462 <dd style="display: none; "> 1463 <div></div> 1464 </dd> 1465 1466 <!-- OBJECT EVENT FIELDS --> 1467 <dd style="display: none; "> 1468 <div></div> 1469 </dd> 1470 1471 <!-- FUNCTION PARAMETERS --> 1472 <dd style="display: none; "> 1473 <div></div> 1474 </dd> 1475 1476 </div> 1477 </div><div> 1478 <div> 1479 <dt> 1480 <var>callback</var> 1481 <em> 1482 1483 <!-- TYPE --> 1484 <div style="display:inline"> 1485 ( 1486 <span class="optional" style="display: none; ">optional</span> 1487 <span class="enum" style="display: none; ">enumerated</span> 1488 <span id="typeTemplate"> 1489 <span style="display: none; "> 1490 <a> Type</a> 1491 </span> 1492 <span> 1493 <span style="display: none; "> 1494 array of <span><span></span></span> 1495 </span> 1496 <span>function</span> 1497 <span style="display: none; "></span> 1498 </span> 1499 </span> 1500 ) 1501 </div> 1502 1503 </em> 1504 </dt> 1505 <dd class="todo"> 1506 Undocumented. 1507 </dd> 1508 <dd style="display: none; "> 1509 Description of this parameter from the json schema. 1510 </dd> 1511 <dd style="display: none; "> 1512 This parameter was added in version 1513 <b><span></span></b>. 1514 You must omit this parameter in earlier versions, 1515 and you may omit it in any version. If you require this 1516 parameter, the manifest key 1517 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 1518 can ensure that your extension won't be run in an earlier browser version. 1519 </dd> 1520 1521 <!-- OBJECT PROPERTIES --> 1522 <dd style="display: none; "> 1523 <dl> 1524 <div> 1525 <div> 1526 </div> 1527 </div> 1528 </dl> 1529 </dd> 1530 1531 <!-- OBJECT METHODS --> 1532 <dd style="display: none; "> 1533 <div></div> 1534 </dd> 1535 1536 <!-- OBJECT EVENT FIELDS --> 1537 <dd style="display: none; "> 1538 <div></div> 1539 </dd> 1540 1541 <!-- FUNCTION PARAMETERS --> 1542 <dd style="display: none; "> 1543 <div></div> 1544 </dd> 1545 1546 </div> 1547 </div> 1548 </dl> 1549 1550 <!-- RETURNS --> 1551 <h4 style="display: none; ">Returns</h4> 1552 <dl> 1553 <div style="display: none; "> 1554 <div> 1555 </div> 1556 </div> 1557 </dl> 1558 1559 <!-- CALLBACK --> 1560 <div> 1561 <div> 1562 <h4>Callback function</h4> 1563 <p> 1564 The callback <em>parameter</em> should specify a function 1565 that looks like this: 1566 </p> 1567 <p style="display: none; "> 1568 If you specify the <em>callback</em> parameter, it should 1569 specify a function that looks like this: 1570 </p> 1571 1572 <!-- Note: intentionally longer 80 columns --> 1573 <pre>function(<span>Window window</span>) <span class="subdued">{...}</span>;</pre> 1574 <dl> 1575 <div> 1576 <div> 1577 <dt> 1578 <var>window</var> 1579 <em> 1580 1581 <!-- TYPE --> 1582 <div style="display:inline"> 1583 ( 1584 <span class="optional" style="display: none; ">optional</span> 1585 <span class="enum" style="display: none; ">enumerated</span> 1586 <span id="typeTemplate"> 1587 <span> 1588 <a href="windows.html#type-Window">Window</a> 1589 </span> 1590 <span style="display: none; "> 1591 <span> 1592 array of <span><span></span></span> 1593 </span> 1594 <span>paramType</span> 1595 <span></span> 1596 </span> 1597 </span> 1598 ) 1599 </div> 1600 1601 </em> 1602 </dt> 1603 <dd class="todo"> 1604 Undocumented. 1605 </dd> 1606 <dd style="display: none; "> 1607 Description of this parameter from the json schema. 1608 </dd> 1609 <dd style="display: none; "> 1610 This parameter was added in version 1611 <b><span></span></b>. 1612 You must omit this parameter in earlier versions, 1613 and you may omit it in any version. If you require this 1614 parameter, the manifest key 1615 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 1616 can ensure that your extension won't be run in an earlier browser version. 1617 </dd> 1618 1619 <!-- OBJECT PROPERTIES --> 1620 <dd style="display: none; "> 1621 <dl> 1622 <div> 1623 <div> 1624 </div> 1625 </div> 1626 </dl> 1627 </dd> 1628 1629 <!-- OBJECT METHODS --> 1630 <dd style="display: none; "> 1631 <div></div> 1632 </dd> 1633 1634 <!-- OBJECT EVENT FIELDS --> 1635 <dd style="display: none; "> 1636 <div></div> 1637 </dd> 1638 1639 <!-- FUNCTION PARAMETERS --> 1640 <dd style="display: none; "> 1641 <div></div> 1642 </dd> 1643 1644 </div> 1645 </div> 1646 </dl> 1647 </div> 1648 </div> 1649 1650 <!-- MIN_VERSION --> 1651 <p style="display: none; "> 1652 This function was added in version <b><span></span></b>. 1653 If you require this function, the manifest key 1654 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 1655 can ensure that your extension won't be run in an earlier browser version. 1656 </p> 1657 </div> <!-- /description --> 1658 1659 </div><div class="apiItem"> 1660 <a name="method-getAll"></a> <!-- method-anchor --> 1661 <h4>getAll</h4> 1662 1663 <div class="summary"><span style="display: none; ">void</span> 1664 <!-- Note: intentionally longer 80 columns --> 1665 <span>chrome.windows.getAll</span>(<span class="optional"><span style="display: none; ">, </span><span>object</span> 1666 <var><span>getInfo</span></var></span><span class="null"><span>, </span><span>function</span> 1667 <var><span>callback</span></var></span>)</div> 1668 1669 <div class="description"> 1670 <p class="todo" style="display: none; ">Undocumented.</p> 1671 <p>Gets all windows.</p> 1672 1673 <!-- PARAMETERS --> 1674 <h4>Parameters</h4> 1675 <dl> 1676 <div> 1677 <div> 1678 <dt> 1679 <var>getInfo</var> 1680 <em> 1681 1682 <!-- TYPE --> 1683 <div style="display:inline"> 1684 ( 1685 <span class="optional">optional</span> 1686 <span class="enum" style="display: none; ">enumerated</span> 1687 <span id="typeTemplate"> 1688 <span style="display: none; "> 1689 <a> Type</a> 1690 </span> 1691 <span> 1692 <span style="display: none; "> 1693 array of <span><span></span></span> 1694 </span> 1695 <span>object</span> 1696 <span style="display: none; "></span> 1697 </span> 1698 </span> 1699 ) 1700 </div> 1701 1702 </em> 1703 </dt> 1704 <dd class="todo"> 1705 Undocumented. 1706 </dd> 1707 <dd style="display: none; "> 1708 Description of this parameter from the json schema. 1709 </dd> 1710 <dd style="display: none; "> 1711 This parameter was added in version 1712 <b><span></span></b>. 1713 You must omit this parameter in earlier versions, 1714 and you may omit it in any version. If you require this 1715 parameter, the manifest key 1716 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 1717 can ensure that your extension won't be run in an earlier browser version. 1718 </dd> 1719 1720 <!-- OBJECT PROPERTIES --> 1721 <dd> 1722 <dl> 1723 <div> 1724 <div> 1725 <dt> 1726 <var>populate</var> 1727 <em> 1728 1729 <!-- TYPE --> 1730 <div style="display:inline"> 1731 ( 1732 <span class="optional">optional</span> 1733 <span class="enum" style="display: none; ">enumerated</span> 1734 <span id="typeTemplate"> 1735 <span style="display: none; "> 1736 <a> Type</a> 1737 </span> 1738 <span> 1739 <span style="display: none; "> 1740 array of <span><span></span></span> 1741 </span> 1742 <span>boolean</span> 1743 <span style="display: none; "></span> 1744 </span> 1745 </span> 1746 ) 1747 </div> 1748 1749 </em> 1750 </dt> 1751 <dd class="todo" style="display: none; "> 1752 Undocumented. 1753 </dd> 1754 <dd>If true, each window object will have a <var>tabs</var> property that contains a list of the <a href="tabs.html#type-Tab">Tab</a> objects for that window.</dd> 1755 <dd style="display: none; "> 1756 This parameter was added in version 1757 <b><span></span></b>. 1758 You must omit this parameter in earlier versions, 1759 and you may omit it in any version. If you require this 1760 parameter, the manifest key 1761 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 1762 can ensure that your extension won't be run in an earlier browser version. 1763 </dd> 1764 1765 <!-- OBJECT PROPERTIES --> 1766 <dd style="display: none; "> 1767 <dl> 1768 <div> 1769 <div> 1770 </div> 1771 </div> 1772 </dl> 1773 </dd> 1774 1775 <!-- OBJECT METHODS --> 1776 <dd style="display: none; "> 1777 <div></div> 1778 </dd> 1779 1780 <!-- OBJECT EVENT FIELDS --> 1781 <dd style="display: none; "> 1782 <div></div> 1783 </dd> 1784 1785 <!-- FUNCTION PARAMETERS --> 1786 <dd style="display: none; "> 1787 <div></div> 1788 </dd> 1789 1790 </div> 1791 </div> 1792 </dl> 1793 </dd> 1794 1795 <!-- OBJECT METHODS --> 1796 <dd style="display: none; "> 1797 <div></div> 1798 </dd> 1799 1800 <!-- OBJECT EVENT FIELDS --> 1801 <dd style="display: none; "> 1802 <div></div> 1803 </dd> 1804 1805 <!-- FUNCTION PARAMETERS --> 1806 <dd style="display: none; "> 1807 <div></div> 1808 </dd> 1809 1810 </div> 1811 </div><div> 1812 <div> 1813 <dt> 1814 <var>callback</var> 1815 <em> 1816 1817 <!-- TYPE --> 1818 <div style="display:inline"> 1819 ( 1820 <span class="optional" style="display: none; ">optional</span> 1821 <span class="enum" style="display: none; ">enumerated</span> 1822 <span id="typeTemplate"> 1823 <span style="display: none; "> 1824 <a> Type</a> 1825 </span> 1826 <span> 1827 <span style="display: none; "> 1828 array of <span><span></span></span> 1829 </span> 1830 <span>function</span> 1831 <span style="display: none; "></span> 1832 </span> 1833 </span> 1834 ) 1835 </div> 1836 1837 </em> 1838 </dt> 1839 <dd class="todo"> 1840 Undocumented. 1841 </dd> 1842 <dd style="display: none; "> 1843 Description of this parameter from the json schema. 1844 </dd> 1845 <dd style="display: none; "> 1846 This parameter was added in version 1847 <b><span></span></b>. 1848 You must omit this parameter in earlier versions, 1849 and you may omit it in any version. If you require this 1850 parameter, the manifest key 1851 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 1852 can ensure that your extension won't be run in an earlier browser version. 1853 </dd> 1854 1855 <!-- OBJECT PROPERTIES --> 1856 <dd style="display: none; "> 1857 <dl> 1858 <div> 1859 <div> 1860 </div> 1861 </div> 1862 </dl> 1863 </dd> 1864 1865 <!-- OBJECT METHODS --> 1866 <dd style="display: none; "> 1867 <div></div> 1868 </dd> 1869 1870 <!-- OBJECT EVENT FIELDS --> 1871 <dd style="display: none; "> 1872 <div></div> 1873 </dd> 1874 1875 <!-- FUNCTION PARAMETERS --> 1876 <dd style="display: none; "> 1877 <div></div> 1878 </dd> 1879 1880 </div> 1881 </div> 1882 </dl> 1883 1884 <!-- RETURNS --> 1885 <h4 style="display: none; ">Returns</h4> 1886 <dl> 1887 <div style="display: none; "> 1888 <div> 1889 </div> 1890 </div> 1891 </dl> 1892 1893 <!-- CALLBACK --> 1894 <div> 1895 <div> 1896 <h4>Callback function</h4> 1897 <p> 1898 The callback <em>parameter</em> should specify a function 1899 that looks like this: 1900 </p> 1901 <p style="display: none; "> 1902 If you specify the <em>callback</em> parameter, it should 1903 specify a function that looks like this: 1904 </p> 1905 1906 <!-- Note: intentionally longer 80 columns --> 1907 <pre>function(<span>array of Window windows</span>) <span class="subdued">{...}</span>;</pre> 1908 <dl> 1909 <div> 1910 <div> 1911 <dt> 1912 <var>windows</var> 1913 <em> 1914 1915 <!-- TYPE --> 1916 <div style="display:inline"> 1917 ( 1918 <span class="optional" style="display: none; ">optional</span> 1919 <span class="enum" style="display: none; ">enumerated</span> 1920 <span id="typeTemplate"> 1921 <span style="display: none; "> 1922 <a> Type</a> 1923 </span> 1924 <span> 1925 <span> 1926 array of <span><span> 1927 <span> 1928 <a href="windows.html#type-Window">Window</a> 1929 </span> 1930 <span style="display: none; "> 1931 <span> 1932 array of <span><span></span></span> 1933 </span> 1934 <span>paramType</span> 1935 <span></span> 1936 </span> 1937 </span></span> 1938 </span> 1939 <span style="display: none; ">paramType</span> 1940 <span style="display: none; "></span> 1941 </span> 1942 </span> 1943 ) 1944 </div> 1945 1946 </em> 1947 </dt> 1948 <dd class="todo"> 1949 Undocumented. 1950 </dd> 1951 <dd style="display: none; "> 1952 Description of this parameter from the json schema. 1953 </dd> 1954 <dd style="display: none; "> 1955 This parameter was added in version 1956 <b><span></span></b>. 1957 You must omit this parameter in earlier versions, 1958 and you may omit it in any version. If you require this 1959 parameter, the manifest key 1960 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 1961 can ensure that your extension won't be run in an earlier browser version. 1962 </dd> 1963 1964 <!-- OBJECT PROPERTIES --> 1965 <dd style="display: none; "> 1966 <dl> 1967 <div> 1968 <div> 1969 </div> 1970 </div> 1971 </dl> 1972 </dd> 1973 1974 <!-- OBJECT METHODS --> 1975 <dd style="display: none; "> 1976 <div></div> 1977 </dd> 1978 1979 <!-- OBJECT EVENT FIELDS --> 1980 <dd style="display: none; "> 1981 <div></div> 1982 </dd> 1983 1984 <!-- FUNCTION PARAMETERS --> 1985 <dd style="display: none; "> 1986 <div></div> 1987 </dd> 1988 1989 </div> 1990 </div> 1991 </dl> 1992 </div> 1993 </div> 1994 1995 <!-- MIN_VERSION --> 1996 <p style="display: none; "> 1997 This function was added in version <b><span></span></b>. 1998 If you require this function, the manifest key 1999 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 2000 can ensure that your extension won't be run in an earlier browser version. 2001 </p> 2002 </div> <!-- /description --> 2003 2004 </div><div class="apiItem"> 2005 <a name="method-getCurrent"></a> <!-- method-anchor --> 2006 <h4>getCurrent</h4> 2007 2008 <div class="summary"><span style="display: none; ">void</span> 2009 <!-- Note: intentionally longer 80 columns --> 2010 <span>chrome.windows.getCurrent</span>(<span class="null"><span style="display: none; ">, </span><span>function</span> 2011 <var><span>callback</span></var></span>)</div> 2012 2013 <div class="description"> 2014 <p class="todo" style="display: none; ">Undocumented.</p> 2015 <p>Gets the <a href="#current-window">current window</a>.</p> 2016 2017 <!-- PARAMETERS --> 2018 <h4>Parameters</h4> 2019 <dl> 2020 <div> 2021 <div> 2022 <dt> 2023 <var>callback</var> 2024 <em> 2025 2026 <!-- TYPE --> 2027 <div style="display:inline"> 2028 ( 2029 <span class="optional" style="display: none; ">optional</span> 2030 <span class="enum" style="display: none; ">enumerated</span> 2031 <span id="typeTemplate"> 2032 <span style="display: none; "> 2033 <a> Type</a> 2034 </span> 2035 <span> 2036 <span style="display: none; "> 2037 array of <span><span></span></span> 2038 </span> 2039 <span>function</span> 2040 <span style="display: none; "></span> 2041 </span> 2042 </span> 2043 ) 2044 </div> 2045 2046 </em> 2047 </dt> 2048 <dd class="todo"> 2049 Undocumented. 2050 </dd> 2051 <dd style="display: none; "> 2052 Description of this parameter from the json schema. 2053 </dd> 2054 <dd style="display: none; "> 2055 This parameter was added in version 2056 <b><span></span></b>. 2057 You must omit this parameter in earlier versions, 2058 and you may omit it in any version. If you require this 2059 parameter, the manifest key 2060 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 2061 can ensure that your extension won't be run in an earlier browser version. 2062 </dd> 2063 2064 <!-- OBJECT PROPERTIES --> 2065 <dd style="display: none; "> 2066 <dl> 2067 <div> 2068 <div> 2069 </div> 2070 </div> 2071 </dl> 2072 </dd> 2073 2074 <!-- OBJECT METHODS --> 2075 <dd style="display: none; "> 2076 <div></div> 2077 </dd> 2078 2079 <!-- OBJECT EVENT FIELDS --> 2080 <dd style="display: none; "> 2081 <div></div> 2082 </dd> 2083 2084 <!-- FUNCTION PARAMETERS --> 2085 <dd style="display: none; "> 2086 <div></div> 2087 </dd> 2088 2089 </div> 2090 </div> 2091 </dl> 2092 2093 <!-- RETURNS --> 2094 <h4 style="display: none; ">Returns</h4> 2095 <dl> 2096 <div style="display: none; "> 2097 <div> 2098 </div> 2099 </div> 2100 </dl> 2101 2102 <!-- CALLBACK --> 2103 <div> 2104 <div> 2105 <h4>Callback function</h4> 2106 <p> 2107 The callback <em>parameter</em> should specify a function 2108 that looks like this: 2109 </p> 2110 <p style="display: none; "> 2111 If you specify the <em>callback</em> parameter, it should 2112 specify a function that looks like this: 2113 </p> 2114 2115 <!-- Note: intentionally longer 80 columns --> 2116 <pre>function(<span>Window window</span>) <span class="subdued">{...}</span>;</pre> 2117 <dl> 2118 <div> 2119 <div> 2120 <dt> 2121 <var>window</var> 2122 <em> 2123 2124 <!-- TYPE --> 2125 <div style="display:inline"> 2126 ( 2127 <span class="optional" style="display: none; ">optional</span> 2128 <span class="enum" style="display: none; ">enumerated</span> 2129 <span id="typeTemplate"> 2130 <span> 2131 <a href="windows.html#type-Window">Window</a> 2132 </span> 2133 <span style="display: none; "> 2134 <span> 2135 array of <span><span></span></span> 2136 </span> 2137 <span>paramType</span> 2138 <span></span> 2139 </span> 2140 </span> 2141 ) 2142 </div> 2143 2144 </em> 2145 </dt> 2146 <dd class="todo"> 2147 Undocumented. 2148 </dd> 2149 <dd style="display: none; "> 2150 Description of this parameter from the json schema. 2151 </dd> 2152 <dd style="display: none; "> 2153 This parameter was added in version 2154 <b><span></span></b>. 2155 You must omit this parameter in earlier versions, 2156 and you may omit it in any version. If you require this 2157 parameter, the manifest key 2158 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 2159 can ensure that your extension won't be run in an earlier browser version. 2160 </dd> 2161 2162 <!-- OBJECT PROPERTIES --> 2163 <dd style="display: none; "> 2164 <dl> 2165 <div> 2166 <div> 2167 </div> 2168 </div> 2169 </dl> 2170 </dd> 2171 2172 <!-- OBJECT METHODS --> 2173 <dd style="display: none; "> 2174 <div></div> 2175 </dd> 2176 2177 <!-- OBJECT EVENT FIELDS --> 2178 <dd style="display: none; "> 2179 <div></div> 2180 </dd> 2181 2182 <!-- FUNCTION PARAMETERS --> 2183 <dd style="display: none; "> 2184 <div></div> 2185 </dd> 2186 2187 </div> 2188 </div> 2189 </dl> 2190 </div> 2191 </div> 2192 2193 <!-- MIN_VERSION --> 2194 <p style="display: none; "> 2195 This function was added in version <b><span></span></b>. 2196 If you require this function, the manifest key 2197 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 2198 can ensure that your extension won't be run in an earlier browser version. 2199 </p> 2200 </div> <!-- /description --> 2201 2202 </div><div class="apiItem"> 2203 <a name="method-getLastFocused"></a> <!-- method-anchor --> 2204 <h4>getLastFocused</h4> 2205 2206 <div class="summary"><span style="display: none; ">void</span> 2207 <!-- Note: intentionally longer 80 columns --> 2208 <span>chrome.windows.getLastFocused</span>(<span class="null"><span style="display: none; ">, </span><span>function</span> 2209 <var><span>callback</span></var></span>)</div> 2210 2211 <div class="description"> 2212 <p class="todo" style="display: none; ">Undocumented.</p> 2213 <p>Gets the window that was most recently focused — typically the window 'on top'.</p> 2214 2215 <!-- PARAMETERS --> 2216 <h4>Parameters</h4> 2217 <dl> 2218 <div> 2219 <div> 2220 <dt> 2221 <var>callback</var> 2222 <em> 2223 2224 <!-- TYPE --> 2225 <div style="display:inline"> 2226 ( 2227 <span class="optional" style="display: none; ">optional</span> 2228 <span class="enum" style="display: none; ">enumerated</span> 2229 <span id="typeTemplate"> 2230 <span style="display: none; "> 2231 <a> Type</a> 2232 </span> 2233 <span> 2234 <span style="display: none; "> 2235 array of <span><span></span></span> 2236 </span> 2237 <span>function</span> 2238 <span style="display: none; "></span> 2239 </span> 2240 </span> 2241 ) 2242 </div> 2243 2244 </em> 2245 </dt> 2246 <dd class="todo"> 2247 Undocumented. 2248 </dd> 2249 <dd style="display: none; "> 2250 Description of this parameter from the json schema. 2251 </dd> 2252 <dd style="display: none; "> 2253 This parameter was added in version 2254 <b><span></span></b>. 2255 You must omit this parameter in earlier versions, 2256 and you may omit it in any version. If you require this 2257 parameter, the manifest key 2258 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 2259 can ensure that your extension won't be run in an earlier browser version. 2260 </dd> 2261 2262 <!-- OBJECT PROPERTIES --> 2263 <dd style="display: none; "> 2264 <dl> 2265 <div> 2266 <div> 2267 </div> 2268 </div> 2269 </dl> 2270 </dd> 2271 2272 <!-- OBJECT METHODS --> 2273 <dd style="display: none; "> 2274 <div></div> 2275 </dd> 2276 2277 <!-- OBJECT EVENT FIELDS --> 2278 <dd style="display: none; "> 2279 <div></div> 2280 </dd> 2281 2282 <!-- FUNCTION PARAMETERS --> 2283 <dd style="display: none; "> 2284 <div></div> 2285 </dd> 2286 2287 </div> 2288 </div> 2289 </dl> 2290 2291 <!-- RETURNS --> 2292 <h4 style="display: none; ">Returns</h4> 2293 <dl> 2294 <div style="display: none; "> 2295 <div> 2296 </div> 2297 </div> 2298 </dl> 2299 2300 <!-- CALLBACK --> 2301 <div> 2302 <div> 2303 <h4>Callback function</h4> 2304 <p> 2305 The callback <em>parameter</em> should specify a function 2306 that looks like this: 2307 </p> 2308 <p style="display: none; "> 2309 If you specify the <em>callback</em> parameter, it should 2310 specify a function that looks like this: 2311 </p> 2312 2313 <!-- Note: intentionally longer 80 columns --> 2314 <pre>function(<span>Window window</span>) <span class="subdued">{...}</span>;</pre> 2315 <dl> 2316 <div> 2317 <div> 2318 <dt> 2319 <var>window</var> 2320 <em> 2321 2322 <!-- TYPE --> 2323 <div style="display:inline"> 2324 ( 2325 <span class="optional" style="display: none; ">optional</span> 2326 <span class="enum" style="display: none; ">enumerated</span> 2327 <span id="typeTemplate"> 2328 <span> 2329 <a href="windows.html#type-Window">Window</a> 2330 </span> 2331 <span style="display: none; "> 2332 <span> 2333 array of <span><span></span></span> 2334 </span> 2335 <span>paramType</span> 2336 <span></span> 2337 </span> 2338 </span> 2339 ) 2340 </div> 2341 2342 </em> 2343 </dt> 2344 <dd class="todo"> 2345 Undocumented. 2346 </dd> 2347 <dd style="display: none; "> 2348 Description of this parameter from the json schema. 2349 </dd> 2350 <dd style="display: none; "> 2351 This parameter was added in version 2352 <b><span></span></b>. 2353 You must omit this parameter in earlier versions, 2354 and you may omit it in any version. If you require this 2355 parameter, the manifest key 2356 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 2357 can ensure that your extension won't be run in an earlier browser version. 2358 </dd> 2359 2360 <!-- OBJECT PROPERTIES --> 2361 <dd style="display: none; "> 2362 <dl> 2363 <div> 2364 <div> 2365 </div> 2366 </div> 2367 </dl> 2368 </dd> 2369 2370 <!-- OBJECT METHODS --> 2371 <dd style="display: none; "> 2372 <div></div> 2373 </dd> 2374 2375 <!-- OBJECT EVENT FIELDS --> 2376 <dd style="display: none; "> 2377 <div></div> 2378 </dd> 2379 2380 <!-- FUNCTION PARAMETERS --> 2381 <dd style="display: none; "> 2382 <div></div> 2383 </dd> 2384 2385 </div> 2386 </div> 2387 </dl> 2388 </div> 2389 </div> 2390 2391 <!-- MIN_VERSION --> 2392 <p style="display: none; "> 2393 This function was added in version <b><span></span></b>. 2394 If you require this function, the manifest key 2395 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 2396 can ensure that your extension won't be run in an earlier browser version. 2397 </p> 2398 </div> <!-- /description --> 2399 2400 </div><div class="apiItem"> 2401 <a name="method-remove"></a> <!-- method-anchor --> 2402 <h4>remove</h4> 2403 2404 <div class="summary"><span style="display: none; ">void</span> 2405 <!-- Note: intentionally longer 80 columns --> 2406 <span>chrome.windows.remove</span>(<span class="null"><span style="display: none; ">, </span><span>integer</span> 2407 <var><span>windowId</span></var></span><span class="optional"><span>, </span><span>function</span> 2408 <var><span>callback</span></var></span>)</div> 2409 2410 <div class="description"> 2411 <p class="todo" style="display: none; ">Undocumented.</p> 2412 <p>Removes (closes) a window, and all the tabs inside it.</p> 2413 2414 <!-- PARAMETERS --> 2415 <h4>Parameters</h4> 2416 <dl> 2417 <div> 2418 <div> 2419 <dt> 2420 <var>windowId</var> 2421 <em> 2422 2423 <!-- TYPE --> 2424 <div style="display:inline"> 2425 ( 2426 <span class="optional" style="display: none; ">optional</span> 2427 <span class="enum" style="display: none; ">enumerated</span> 2428 <span id="typeTemplate"> 2429 <span style="display: none; "> 2430 <a> Type</a> 2431 </span> 2432 <span> 2433 <span style="display: none; "> 2434 array of <span><span></span></span> 2435 </span> 2436 <span>integer</span> 2437 <span style="display: none; "></span> 2438 </span> 2439 </span> 2440 ) 2441 </div> 2442 2443 </em> 2444 </dt> 2445 <dd class="todo"> 2446 Undocumented. 2447 </dd> 2448 <dd style="display: none; "> 2449 Description of this parameter from the json schema. 2450 </dd> 2451 <dd style="display: none; "> 2452 This parameter was added in version 2453 <b><span></span></b>. 2454 You must omit this parameter in earlier versions, 2455 and you may omit it in any version. If you require this 2456 parameter, the manifest key 2457 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 2458 can ensure that your extension won't be run in an earlier browser version. 2459 </dd> 2460 2461 <!-- OBJECT PROPERTIES --> 2462 <dd style="display: none; "> 2463 <dl> 2464 <div> 2465 <div> 2466 </div> 2467 </div> 2468 </dl> 2469 </dd> 2470 2471 <!-- OBJECT METHODS --> 2472 <dd style="display: none; "> 2473 <div></div> 2474 </dd> 2475 2476 <!-- OBJECT EVENT FIELDS --> 2477 <dd style="display: none; "> 2478 <div></div> 2479 </dd> 2480 2481 <!-- FUNCTION PARAMETERS --> 2482 <dd style="display: none; "> 2483 <div></div> 2484 </dd> 2485 2486 </div> 2487 </div><div> 2488 <div> 2489 <dt> 2490 <var>callback</var> 2491 <em> 2492 2493 <!-- TYPE --> 2494 <div style="display:inline"> 2495 ( 2496 <span class="optional">optional</span> 2497 <span class="enum" style="display: none; ">enumerated</span> 2498 <span id="typeTemplate"> 2499 <span style="display: none; "> 2500 <a> Type</a> 2501 </span> 2502 <span> 2503 <span style="display: none; "> 2504 array of <span><span></span></span> 2505 </span> 2506 <span>function</span> 2507 <span style="display: none; "></span> 2508 </span> 2509 </span> 2510 ) 2511 </div> 2512 2513 </em> 2514 </dt> 2515 <dd class="todo"> 2516 Undocumented. 2517 </dd> 2518 <dd style="display: none; "> 2519 Description of this parameter from the json schema. 2520 </dd> 2521 <dd style="display: none; "> 2522 This parameter was added in version 2523 <b><span></span></b>. 2524 You must omit this parameter in earlier versions, 2525 and you may omit it in any version. If you require this 2526 parameter, the manifest key 2527 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 2528 can ensure that your extension won't be run in an earlier browser version. 2529 </dd> 2530 2531 <!-- OBJECT PROPERTIES --> 2532 <dd style="display: none; "> 2533 <dl> 2534 <div> 2535 <div> 2536 </div> 2537 </div> 2538 </dl> 2539 </dd> 2540 2541 <!-- OBJECT METHODS --> 2542 <dd style="display: none; "> 2543 <div></div> 2544 </dd> 2545 2546 <!-- OBJECT EVENT FIELDS --> 2547 <dd style="display: none; "> 2548 <div></div> 2549 </dd> 2550 2551 <!-- FUNCTION PARAMETERS --> 2552 <dd style="display: none; "> 2553 <div></div> 2554 </dd> 2555 2556 </div> 2557 </div> 2558 </dl> 2559 2560 <!-- RETURNS --> 2561 <h4 style="display: none; ">Returns</h4> 2562 <dl> 2563 <div style="display: none; "> 2564 <div> 2565 </div> 2566 </div> 2567 </dl> 2568 2569 <!-- CALLBACK --> 2570 <div> 2571 <div> 2572 <h4>Callback function</h4> 2573 <p style="display: none; "> 2574 The callback <em>parameter</em> should specify a function 2575 that looks like this: 2576 </p> 2577 <p> 2578 If you specify the <em>callback</em> parameter, it should 2579 specify a function that looks like this: 2580 </p> 2581 2582 <!-- Note: intentionally longer 80 columns --> 2583 <pre>function(<span></span>) <span class="subdued">{...}</span>;</pre> 2584 <dl> 2585 <div style="display: none; "> 2586 <div> 2587 </div> 2588 </div> 2589 </dl> 2590 </div> 2591 </div> 2592 2593 <!-- MIN_VERSION --> 2594 <p style="display: none; "> 2595 This function was added in version <b><span></span></b>. 2596 If you require this function, the manifest key 2597 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 2598 can ensure that your extension won't be run in an earlier browser version. 2599 </p> 2600 </div> <!-- /description --> 2601 2602 </div><div class="apiItem"> 2603 <a name="method-update"></a> <!-- method-anchor --> 2604 <h4>update</h4> 2605 2606 <div class="summary"><span style="display: none; ">void</span> 2607 <!-- Note: intentionally longer 80 columns --> 2608 <span>chrome.windows.update</span>(<span class="null"><span style="display: none; ">, </span><span>integer</span> 2609 <var><span>windowId</span></var></span><span class="null"><span>, </span><span>object</span> 2610 <var><span>updateInfo</span></var></span><span class="optional"><span>, </span><span>function</span> 2611 <var><span>callback</span></var></span>)</div> 2612 2613 <div class="description"> 2614 <p class="todo" style="display: none; ">Undocumented.</p> 2615 <p>Updates the properties of a window. Specify only the properties that you want to change; unspecified properties will be left unchanged.</p> 2616 2617 <!-- PARAMETERS --> 2618 <h4>Parameters</h4> 2619 <dl> 2620 <div> 2621 <div> 2622 <dt> 2623 <var>windowId</var> 2624 <em> 2625 2626 <!-- TYPE --> 2627 <div style="display:inline"> 2628 ( 2629 <span class="optional" style="display: none; ">optional</span> 2630 <span class="enum" style="display: none; ">enumerated</span> 2631 <span id="typeTemplate"> 2632 <span style="display: none; "> 2633 <a> Type</a> 2634 </span> 2635 <span> 2636 <span style="display: none; "> 2637 array of <span><span></span></span> 2638 </span> 2639 <span>integer</span> 2640 <span style="display: none; "></span> 2641 </span> 2642 </span> 2643 ) 2644 </div> 2645 2646 </em> 2647 </dt> 2648 <dd class="todo"> 2649 Undocumented. 2650 </dd> 2651 <dd style="display: none; "> 2652 Description of this parameter from the json schema. 2653 </dd> 2654 <dd style="display: none; "> 2655 This parameter was added in version 2656 <b><span></span></b>. 2657 You must omit this parameter in earlier versions, 2658 and you may omit it in any version. If you require this 2659 parameter, the manifest key 2660 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 2661 can ensure that your extension won't be run in an earlier browser version. 2662 </dd> 2663 2664 <!-- OBJECT PROPERTIES --> 2665 <dd style="display: none; "> 2666 <dl> 2667 <div> 2668 <div> 2669 </div> 2670 </div> 2671 </dl> 2672 </dd> 2673 2674 <!-- OBJECT METHODS --> 2675 <dd style="display: none; "> 2676 <div></div> 2677 </dd> 2678 2679 <!-- OBJECT EVENT FIELDS --> 2680 <dd style="display: none; "> 2681 <div></div> 2682 </dd> 2683 2684 <!-- FUNCTION PARAMETERS --> 2685 <dd style="display: none; "> 2686 <div></div> 2687 </dd> 2688 2689 </div> 2690 </div><div> 2691 <div> 2692 <dt> 2693 <var>updateInfo</var> 2694 <em> 2695 2696 <!-- TYPE --> 2697 <div style="display:inline"> 2698 ( 2699 <span class="optional" style="display: none; ">optional</span> 2700 <span class="enum" style="display: none; ">enumerated</span> 2701 <span id="typeTemplate"> 2702 <span style="display: none; "> 2703 <a> Type</a> 2704 </span> 2705 <span> 2706 <span style="display: none; "> 2707 array of <span><span></span></span> 2708 </span> 2709 <span>object</span> 2710 <span style="display: none; "></span> 2711 </span> 2712 </span> 2713 ) 2714 </div> 2715 2716 </em> 2717 </dt> 2718 <dd class="todo"> 2719 Undocumented. 2720 </dd> 2721 <dd style="display: none; "> 2722 Description of this parameter from the json schema. 2723 </dd> 2724 <dd style="display: none; "> 2725 This parameter was added in version 2726 <b><span></span></b>. 2727 You must omit this parameter in earlier versions, 2728 and you may omit it in any version. If you require this 2729 parameter, the manifest key 2730 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 2731 can ensure that your extension won't be run in an earlier browser version. 2732 </dd> 2733 2734 <!-- OBJECT PROPERTIES --> 2735 <dd> 2736 <dl> 2737 <div> 2738 <div> 2739 <dt> 2740 <var>left</var> 2741 <em> 2742 2743 <!-- TYPE --> 2744 <div style="display:inline"> 2745 ( 2746 <span class="optional">optional</span> 2747 <span class="enum" style="display: none; ">enumerated</span> 2748 <span id="typeTemplate"> 2749 <span style="display: none; "> 2750 <a> Type</a> 2751 </span> 2752 <span> 2753 <span style="display: none; "> 2754 array of <span><span></span></span> 2755 </span> 2756 <span>integer</span> 2757 <span style="display: none; "></span> 2758 </span> 2759 </span> 2760 ) 2761 </div> 2762 2763 </em> 2764 </dt> 2765 <dd class="todo" style="display: none; "> 2766 Undocumented. 2767 </dd> 2768 <dd>The offset from the left edge of the screen to move the window to in pixels.</dd> 2769 <dd style="display: none; "> 2770 This parameter was added in version 2771 <b><span></span></b>. 2772 You must omit this parameter in earlier versions, 2773 and you may omit it in any version. If you require this 2774 parameter, the manifest key 2775 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 2776 can ensure that your extension won't be run in an earlier browser version. 2777 </dd> 2778 2779 <!-- OBJECT PROPERTIES --> 2780 <dd style="display: none; "> 2781 <dl> 2782 <div> 2783 <div> 2784 </div> 2785 </div> 2786 </dl> 2787 </dd> 2788 2789 <!-- OBJECT METHODS --> 2790 <dd style="display: none; "> 2791 <div></div> 2792 </dd> 2793 2794 <!-- OBJECT EVENT FIELDS --> 2795 <dd style="display: none; "> 2796 <div></div> 2797 </dd> 2798 2799 <!-- FUNCTION PARAMETERS --> 2800 <dd style="display: none; "> 2801 <div></div> 2802 </dd> 2803 2804 </div> 2805 </div><div> 2806 <div> 2807 <dt> 2808 <var>top</var> 2809 <em> 2810 2811 <!-- TYPE --> 2812 <div style="display:inline"> 2813 ( 2814 <span class="optional">optional</span> 2815 <span class="enum" style="display: none; ">enumerated</span> 2816 <span id="typeTemplate"> 2817 <span style="display: none; "> 2818 <a> Type</a> 2819 </span> 2820 <span> 2821 <span style="display: none; "> 2822 array of <span><span></span></span> 2823 </span> 2824 <span>integer</span> 2825 <span style="display: none; "></span> 2826 </span> 2827 </span> 2828 ) 2829 </div> 2830 2831 </em> 2832 </dt> 2833 <dd class="todo" style="display: none; "> 2834 Undocumented. 2835 </dd> 2836 <dd>The offset from the top edge of the screen to move the window to in pixels.</dd> 2837 <dd style="display: none; "> 2838 This parameter was added in version 2839 <b><span></span></b>. 2840 You must omit this parameter in earlier versions, 2841 and you may omit it in any version. If you require this 2842 parameter, the manifest key 2843 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 2844 can ensure that your extension won't be run in an earlier browser version. 2845 </dd> 2846 2847 <!-- OBJECT PROPERTIES --> 2848 <dd style="display: none; "> 2849 <dl> 2850 <div> 2851 <div> 2852 </div> 2853 </div> 2854 </dl> 2855 </dd> 2856 2857 <!-- OBJECT METHODS --> 2858 <dd style="display: none; "> 2859 <div></div> 2860 </dd> 2861 2862 <!-- OBJECT EVENT FIELDS --> 2863 <dd style="display: none; "> 2864 <div></div> 2865 </dd> 2866 2867 <!-- FUNCTION PARAMETERS --> 2868 <dd style="display: none; "> 2869 <div></div> 2870 </dd> 2871 2872 </div> 2873 </div><div> 2874 <div> 2875 <dt> 2876 <var>width</var> 2877 <em> 2878 2879 <!-- TYPE --> 2880 <div style="display:inline"> 2881 ( 2882 <span class="optional">optional</span> 2883 <span class="enum" style="display: none; ">enumerated</span> 2884 <span id="typeTemplate"> 2885 <span style="display: none; "> 2886 <a> Type</a> 2887 </span> 2888 <span> 2889 <span style="display: none; "> 2890 array of <span><span></span></span> 2891 </span> 2892 <span>integer</span> 2893 <span style="display: none; "></span> 2894 </span> 2895 </span> 2896 ) 2897 </div> 2898 2899 </em> 2900 </dt> 2901 <dd class="todo" style="display: none; "> 2902 Undocumented. 2903 </dd> 2904 <dd>The width to resize the window to in pixels.</dd> 2905 <dd style="display: none; "> 2906 This parameter was added in version 2907 <b><span></span></b>. 2908 You must omit this parameter in earlier versions, 2909 and you may omit it in any version. If you require this 2910 parameter, the manifest key 2911 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 2912 can ensure that your extension won't be run in an earlier browser version. 2913 </dd> 2914 2915 <!-- OBJECT PROPERTIES --> 2916 <dd style="display: none; "> 2917 <dl> 2918 <div> 2919 <div> 2920 </div> 2921 </div> 2922 </dl> 2923 </dd> 2924 2925 <!-- OBJECT METHODS --> 2926 <dd style="display: none; "> 2927 <div></div> 2928 </dd> 2929 2930 <!-- OBJECT EVENT FIELDS --> 2931 <dd style="display: none; "> 2932 <div></div> 2933 </dd> 2934 2935 <!-- FUNCTION PARAMETERS --> 2936 <dd style="display: none; "> 2937 <div></div> 2938 </dd> 2939 2940 </div> 2941 </div><div> 2942 <div> 2943 <dt> 2944 <var>height</var> 2945 <em> 2946 2947 <!-- TYPE --> 2948 <div style="display:inline"> 2949 ( 2950 <span class="optional">optional</span> 2951 <span class="enum" style="display: none; ">enumerated</span> 2952 <span id="typeTemplate"> 2953 <span style="display: none; "> 2954 <a> Type</a> 2955 </span> 2956 <span> 2957 <span style="display: none; "> 2958 array of <span><span></span></span> 2959 </span> 2960 <span>integer</span> 2961 <span style="display: none; "></span> 2962 </span> 2963 </span> 2964 ) 2965 </div> 2966 2967 </em> 2968 </dt> 2969 <dd class="todo" style="display: none; "> 2970 Undocumented. 2971 </dd> 2972 <dd>The height to resize the window to in pixels.</dd> 2973 <dd style="display: none; "> 2974 This parameter was added in version 2975 <b><span></span></b>. 2976 You must omit this parameter in earlier versions, 2977 and you may omit it in any version. If you require this 2978 parameter, the manifest key 2979 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 2980 can ensure that your extension won't be run in an earlier browser version. 2981 </dd> 2982 2983 <!-- OBJECT PROPERTIES --> 2984 <dd style="display: none; "> 2985 <dl> 2986 <div> 2987 <div> 2988 </div> 2989 </div> 2990 </dl> 2991 </dd> 2992 2993 <!-- OBJECT METHODS --> 2994 <dd style="display: none; "> 2995 <div></div> 2996 </dd> 2997 2998 <!-- OBJECT EVENT FIELDS --> 2999 <dd style="display: none; "> 3000 <div></div> 3001 </dd> 3002 3003 <!-- FUNCTION PARAMETERS --> 3004 <dd style="display: none; "> 3005 <div></div> 3006 </dd> 3007 3008 </div> 3009 </div><div> 3010 <div> 3011 <dt> 3012 <var>focused</var> 3013 <em> 3014 3015 <!-- TYPE --> 3016 <div style="display:inline"> 3017 ( 3018 <span class="optional">optional</span> 3019 <span class="enum" style="display: none; ">enumerated</span> 3020 <span id="typeTemplate"> 3021 <span style="display: none; "> 3022 <a> Type</a> 3023 </span> 3024 <span> 3025 <span style="display: none; "> 3026 array of <span><span></span></span> 3027 </span> 3028 <span>boolean</span> 3029 <span style="display: none; "></span> 3030 </span> 3031 </span> 3032 ) 3033 </div> 3034 3035 </em> 3036 </dt> 3037 <dd class="todo" style="display: none; "> 3038 Undocumented. 3039 </dd> 3040 <dd>If true, brings the window to the front. If false, brings the next window in the z-order to the front.</dd> 3041 <dd style="display: none; "> 3042 This parameter was added in version 3043 <b><span></span></b>. 3044 You must omit this parameter in earlier versions, 3045 and you may omit it in any version. If you require this 3046 parameter, the manifest key 3047 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 3048 can ensure that your extension won't be run in an earlier browser version. 3049 </dd> 3050 3051 <!-- OBJECT PROPERTIES --> 3052 <dd style="display: none; "> 3053 <dl> 3054 <div> 3055 <div> 3056 </div> 3057 </div> 3058 </dl> 3059 </dd> 3060 3061 <!-- OBJECT METHODS --> 3062 <dd style="display: none; "> 3063 <div></div> 3064 </dd> 3065 3066 <!-- OBJECT EVENT FIELDS --> 3067 <dd style="display: none; "> 3068 <div></div> 3069 </dd> 3070 3071 <!-- FUNCTION PARAMETERS --> 3072 <dd style="display: none; "> 3073 <div></div> 3074 </dd> 3075 3076 </div> 3077 </div> 3078 </dl> 3079 </dd> 3080 3081 <!-- OBJECT METHODS --> 3082 <dd style="display: none; "> 3083 <div></div> 3084 </dd> 3085 3086 <!-- OBJECT EVENT FIELDS --> 3087 <dd style="display: none; "> 3088 <div></div> 3089 </dd> 3090 3091 <!-- FUNCTION PARAMETERS --> 3092 <dd style="display: none; "> 3093 <div></div> 3094 </dd> 3095 3096 </div> 3097 </div><div> 3098 <div> 3099 <dt> 3100 <var>callback</var> 3101 <em> 3102 3103 <!-- TYPE --> 3104 <div style="display:inline"> 3105 ( 3106 <span class="optional">optional</span> 3107 <span class="enum" style="display: none; ">enumerated</span> 3108 <span id="typeTemplate"> 3109 <span style="display: none; "> 3110 <a> Type</a> 3111 </span> 3112 <span> 3113 <span style="display: none; "> 3114 array of <span><span></span></span> 3115 </span> 3116 <span>function</span> 3117 <span style="display: none; "></span> 3118 </span> 3119 </span> 3120 ) 3121 </div> 3122 3123 </em> 3124 </dt> 3125 <dd class="todo"> 3126 Undocumented. 3127 </dd> 3128 <dd style="display: none; "> 3129 Description of this parameter from the json schema. 3130 </dd> 3131 <dd style="display: none; "> 3132 This parameter was added in version 3133 <b><span></span></b>. 3134 You must omit this parameter in earlier versions, 3135 and you may omit it in any version. If you require this 3136 parameter, the manifest key 3137 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 3138 can ensure that your extension won't be run in an earlier browser version. 3139 </dd> 3140 3141 <!-- OBJECT PROPERTIES --> 3142 <dd style="display: none; "> 3143 <dl> 3144 <div> 3145 <div> 3146 </div> 3147 </div> 3148 </dl> 3149 </dd> 3150 3151 <!-- OBJECT METHODS --> 3152 <dd style="display: none; "> 3153 <div></div> 3154 </dd> 3155 3156 <!-- OBJECT EVENT FIELDS --> 3157 <dd style="display: none; "> 3158 <div></div> 3159 </dd> 3160 3161 <!-- FUNCTION PARAMETERS --> 3162 <dd style="display: none; "> 3163 <div></div> 3164 </dd> 3165 3166 </div> 3167 </div> 3168 </dl> 3169 3170 <!-- RETURNS --> 3171 <h4 style="display: none; ">Returns</h4> 3172 <dl> 3173 <div style="display: none; "> 3174 <div> 3175 </div> 3176 </div> 3177 </dl> 3178 3179 <!-- CALLBACK --> 3180 <div> 3181 <div> 3182 <h4>Callback function</h4> 3183 <p style="display: none; "> 3184 The callback <em>parameter</em> should specify a function 3185 that looks like this: 3186 </p> 3187 <p> 3188 If you specify the <em>callback</em> parameter, it should 3189 specify a function that looks like this: 3190 </p> 3191 3192 <!-- Note: intentionally longer 80 columns --> 3193 <pre>function(<span>Window window</span>) <span class="subdued">{...}</span>;</pre> 3194 <dl> 3195 <div> 3196 <div> 3197 <dt> 3198 <var>window</var> 3199 <em> 3200 3201 <!-- TYPE --> 3202 <div style="display:inline"> 3203 ( 3204 <span class="optional" style="display: none; ">optional</span> 3205 <span class="enum" style="display: none; ">enumerated</span> 3206 <span id="typeTemplate"> 3207 <span> 3208 <a href="windows.html#type-Window">Window</a> 3209 </span> 3210 <span style="display: none; "> 3211 <span> 3212 array of <span><span></span></span> 3213 </span> 3214 <span>paramType</span> 3215 <span></span> 3216 </span> 3217 </span> 3218 ) 3219 </div> 3220 3221 </em> 3222 </dt> 3223 <dd class="todo"> 3224 Undocumented. 3225 </dd> 3226 <dd style="display: none; "> 3227 Description of this parameter from the json schema. 3228 </dd> 3229 <dd style="display: none; "> 3230 This parameter was added in version 3231 <b><span></span></b>. 3232 You must omit this parameter in earlier versions, 3233 and you may omit it in any version. If you require this 3234 parameter, the manifest key 3235 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 3236 can ensure that your extension won't be run in an earlier browser version. 3237 </dd> 3238 3239 <!-- OBJECT PROPERTIES --> 3240 <dd style="display: none; "> 3241 <dl> 3242 <div> 3243 <div> 3244 </div> 3245 </div> 3246 </dl> 3247 </dd> 3248 3249 <!-- OBJECT METHODS --> 3250 <dd style="display: none; "> 3251 <div></div> 3252 </dd> 3253 3254 <!-- OBJECT EVENT FIELDS --> 3255 <dd style="display: none; "> 3256 <div></div> 3257 </dd> 3258 3259 <!-- FUNCTION PARAMETERS --> 3260 <dd style="display: none; "> 3261 <div></div> 3262 </dd> 3263 3264 </div> 3265 </div> 3266 </dl> 3267 </div> 3268 </div> 3269 3270 <!-- MIN_VERSION --> 3271 <p style="display: none; "> 3272 This function was added in version <b><span></span></b>. 3273 If you require this function, the manifest key 3274 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 3275 can ensure that your extension won't be run in an earlier browser version. 3276 </p> 3277 </div> <!-- /description --> 3278 3279 </div> <!-- /apiItem --> 3280 3281 </div> <!-- /apiGroup --> 3282 3283 <!-- EVENTS --> 3284 <div id="eventsTemplate" class="apiGroup"> 3285 <a name="global-events"></a> 3286 <h3>Events</h3> 3287 <!-- iterates over all events --> 3288 <div class="apiItem"> 3289 <a name="event-onCreated"></a> 3290 <h4>onCreated</h4> 3291 3292 <div class="summary"> 3293 <!-- Note: intentionally longer 80 columns --> 3294 <span class="subdued">chrome.windows.</span><span>onCreated</span><span class="subdued">.addListener</span>(function(<span>Window window</span>) <span class="subdued">{...}</span>); 3295 </div> 3296 3297 <div class="description"> 3298 <p class="todo" style="display: none; ">Undocumented.</p> 3299 <p>Fired when a window is created.</p> 3300 3301 <!-- PARAMETERS --> 3302 <div> 3303 <h4>Parameters</h4> 3304 <dl> 3305 <div> 3306 <div> 3307 <dt> 3308 <var>window</var> 3309 <em> 3310 3311 <!-- TYPE --> 3312 <div style="display:inline"> 3313 ( 3314 <span class="optional" style="display: none; ">optional</span> 3315 <span class="enum" style="display: none; ">enumerated</span> 3316 <span id="typeTemplate"> 3317 <span> 3318 <a href="windows.html#type-Window">Window</a> 3319 </span> 3320 <span style="display: none; "> 3321 <span> 3322 array of <span><span></span></span> 3323 </span> 3324 <span>paramType</span> 3325 <span></span> 3326 </span> 3327 </span> 3328 ) 3329 </div> 3330 3331 </em> 3332 </dt> 3333 <dd class="todo" style="display: none; "> 3334 Undocumented. 3335 </dd> 3336 <dd>Details of the window that was created.</dd> 3337 <dd style="display: none; "> 3338 This parameter was added in version 3339 <b><span></span></b>. 3340 You must omit this parameter in earlier versions, 3341 and you may omit it in any version. If you require this 3342 parameter, the manifest key 3343 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 3344 can ensure that your extension won't be run in an earlier browser version. 3345 </dd> 3346 3347 <!-- OBJECT PROPERTIES --> 3348 <dd style="display: none; "> 3349 <dl> 3350 <div> 3351 <div> 3352 </div> 3353 </div> 3354 </dl> 3355 </dd> 3356 3357 <!-- OBJECT METHODS --> 3358 <dd style="display: none; "> 3359 <div></div> 3360 </dd> 3361 3362 <!-- OBJECT EVENT FIELDS --> 3363 <dd style="display: none; "> 3364 <div></div> 3365 </dd> 3366 3367 <!-- FUNCTION PARAMETERS --> 3368 <dd style="display: none; "> 3369 <div></div> 3370 </dd> 3371 3372 </div> 3373 </div> 3374 </dl> 3375 </div> 3376 </div> <!-- /decription --> 3377 3378 </div><div class="apiItem"> 3379 <a name="event-onFocusChanged"></a> 3380 <h4>onFocusChanged</h4> 3381 3382 <div class="summary"> 3383 <!-- Note: intentionally longer 80 columns --> 3384 <span class="subdued">chrome.windows.</span><span>onFocusChanged</span><span class="subdued">.addListener</span>(function(<span>integer windowId</span>) <span class="subdued">{...}</span>); 3385 </div> 3386 3387 <div class="description"> 3388 <p class="todo" style="display: none; ">Undocumented.</p> 3389 <p>Fired when the currently focused window changes. Will be chrome.windows.WINDOW_ID_NONE if all chrome windows have lost focus. Note: On some Linux window managers, WINDOW_ID_NONE will always be sent immediately preceding a switch from one chrome window to another.</p> 3390 3391 <!-- PARAMETERS --> 3392 <div> 3393 <h4>Parameters</h4> 3394 <dl> 3395 <div> 3396 <div> 3397 <dt> 3398 <var>windowId</var> 3399 <em> 3400 3401 <!-- TYPE --> 3402 <div style="display:inline"> 3403 ( 3404 <span class="optional" style="display: none; ">optional</span> 3405 <span class="enum" style="display: none; ">enumerated</span> 3406 <span id="typeTemplate"> 3407 <span style="display: none; "> 3408 <a> Type</a> 3409 </span> 3410 <span> 3411 <span style="display: none; "> 3412 array of <span><span></span></span> 3413 </span> 3414 <span>integer</span> 3415 <span style="display: none; "></span> 3416 </span> 3417 </span> 3418 ) 3419 </div> 3420 3421 </em> 3422 </dt> 3423 <dd class="todo" style="display: none; "> 3424 Undocumented. 3425 </dd> 3426 <dd>ID of the newly focused window.</dd> 3427 <dd style="display: none; "> 3428 This parameter was added in version 3429 <b><span></span></b>. 3430 You must omit this parameter in earlier versions, 3431 and you may omit it in any version. If you require this 3432 parameter, the manifest key 3433 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 3434 can ensure that your extension won't be run in an earlier browser version. 3435 </dd> 3436 3437 <!-- OBJECT PROPERTIES --> 3438 <dd style="display: none; "> 3439 <dl> 3440 <div> 3441 <div> 3442 </div> 3443 </div> 3444 </dl> 3445 </dd> 3446 3447 <!-- OBJECT METHODS --> 3448 <dd style="display: none; "> 3449 <div></div> 3450 </dd> 3451 3452 <!-- OBJECT EVENT FIELDS --> 3453 <dd style="display: none; "> 3454 <div></div> 3455 </dd> 3456 3457 <!-- FUNCTION PARAMETERS --> 3458 <dd style="display: none; "> 3459 <div></div> 3460 </dd> 3461 3462 </div> 3463 </div> 3464 </dl> 3465 </div> 3466 </div> <!-- /decription --> 3467 3468 </div><div class="apiItem"> 3469 <a name="event-onRemoved"></a> 3470 <h4>onRemoved</h4> 3471 3472 <div class="summary"> 3473 <!-- Note: intentionally longer 80 columns --> 3474 <span class="subdued">chrome.windows.</span><span>onRemoved</span><span class="subdued">.addListener</span>(function(<span>integer windowId</span>) <span class="subdued">{...}</span>); 3475 </div> 3476 3477 <div class="description"> 3478 <p class="todo" style="display: none; ">Undocumented.</p> 3479 <p>Fired when a window is removed (closed).</p> 3480 3481 <!-- PARAMETERS --> 3482 <div> 3483 <h4>Parameters</h4> 3484 <dl> 3485 <div> 3486 <div> 3487 <dt> 3488 <var>windowId</var> 3489 <em> 3490 3491 <!-- TYPE --> 3492 <div style="display:inline"> 3493 ( 3494 <span class="optional" style="display: none; ">optional</span> 3495 <span class="enum" style="display: none; ">enumerated</span> 3496 <span id="typeTemplate"> 3497 <span style="display: none; "> 3498 <a> Type</a> 3499 </span> 3500 <span> 3501 <span style="display: none; "> 3502 array of <span><span></span></span> 3503 </span> 3504 <span>integer</span> 3505 <span style="display: none; "></span> 3506 </span> 3507 </span> 3508 ) 3509 </div> 3510 3511 </em> 3512 </dt> 3513 <dd class="todo" style="display: none; "> 3514 Undocumented. 3515 </dd> 3516 <dd>ID of the removed window.</dd> 3517 <dd style="display: none; "> 3518 This parameter was added in version 3519 <b><span></span></b>. 3520 You must omit this parameter in earlier versions, 3521 and you may omit it in any version. If you require this 3522 parameter, the manifest key 3523 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 3524 can ensure that your extension won't be run in an earlier browser version. 3525 </dd> 3526 3527 <!-- OBJECT PROPERTIES --> 3528 <dd style="display: none; "> 3529 <dl> 3530 <div> 3531 <div> 3532 </div> 3533 </div> 3534 </dl> 3535 </dd> 3536 3537 <!-- OBJECT METHODS --> 3538 <dd style="display: none; "> 3539 <div></div> 3540 </dd> 3541 3542 <!-- OBJECT EVENT FIELDS --> 3543 <dd style="display: none; "> 3544 <div></div> 3545 </dd> 3546 3547 <!-- FUNCTION PARAMETERS --> 3548 <dd style="display: none; "> 3549 <div></div> 3550 </dd> 3551 3552 </div> 3553 </div> 3554 </dl> 3555 </div> 3556 </div> <!-- /decription --> 3557 3558 </div> <!-- /apiItem --> 3559 3560 </div> <!-- /apiGroup --> 3561 3562 <!-- TYPES --> 3563 <div class="apiGroup"> 3564 <a name="types"></a> 3565 <h3 id="types">Types</h3> 3566 3567 <!-- iterates over all types --> 3568 <div class="apiItem"> 3569 <a name="type-Window"></a> 3570 <h4>Window</h4> 3571 3572 <div> 3573 <dt> 3574 <var style="display: none; ">paramName</var> 3575 <em> 3576 3577 <!-- TYPE --> 3578 <div style="display:inline"> 3579 ( 3580 <span class="optional" style="display: none; ">optional</span> 3581 <span class="enum" style="display: none; ">enumerated</span> 3582 <span id="typeTemplate"> 3583 <span style="display: none; "> 3584 <a> Type</a> 3585 </span> 3586 <span> 3587 <span style="display: none; "> 3588 array of <span><span></span></span> 3589 </span> 3590 <span>object</span> 3591 <span style="display: none; "></span> 3592 </span> 3593 </span> 3594 ) 3595 </div> 3596 3597 </em> 3598 </dt> 3599 <dd class="todo"> 3600 Undocumented. 3601 </dd> 3602 <dd style="display: none; "> 3603 Description of this parameter from the json schema. 3604 </dd> 3605 <dd style="display: none; "> 3606 This parameter was added in version 3607 <b><span></span></b>. 3608 You must omit this parameter in earlier versions, 3609 and you may omit it in any version. If you require this 3610 parameter, the manifest key 3611 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 3612 can ensure that your extension won't be run in an earlier browser version. 3613 </dd> 3614 3615 <!-- OBJECT PROPERTIES --> 3616 <dd> 3617 <dl> 3618 <div> 3619 <div> 3620 <dt> 3621 <var>id</var> 3622 <em> 3623 3624 <!-- TYPE --> 3625 <div style="display:inline"> 3626 ( 3627 <span class="optional" style="display: none; ">optional</span> 3628 <span class="enum" style="display: none; ">enumerated</span> 3629 <span id="typeTemplate"> 3630 <span style="display: none; "> 3631 <a> Type</a> 3632 </span> 3633 <span> 3634 <span style="display: none; "> 3635 array of <span><span></span></span> 3636 </span> 3637 <span>integer</span> 3638 <span style="display: none; "></span> 3639 </span> 3640 </span> 3641 ) 3642 </div> 3643 3644 </em> 3645 </dt> 3646 <dd class="todo" style="display: none; "> 3647 Undocumented. 3648 </dd> 3649 <dd>The ID of the window. Window IDs are unique within a browser session.</dd> 3650 <dd style="display: none; "> 3651 This parameter was added in version 3652 <b><span></span></b>. 3653 You must omit this parameter in earlier versions, 3654 and you may omit it in any version. If you require this 3655 parameter, the manifest key 3656 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 3657 can ensure that your extension won't be run in an earlier browser version. 3658 </dd> 3659 3660 <!-- OBJECT PROPERTIES --> 3661 <dd style="display: none; "> 3662 <dl> 3663 <div> 3664 <div> 3665 </div> 3666 </div> 3667 </dl> 3668 </dd> 3669 3670 <!-- OBJECT METHODS --> 3671 <dd style="display: none; "> 3672 <div></div> 3673 </dd> 3674 3675 <!-- OBJECT EVENT FIELDS --> 3676 <dd style="display: none; "> 3677 <div></div> 3678 </dd> 3679 3680 <!-- FUNCTION PARAMETERS --> 3681 <dd style="display: none; "> 3682 <div></div> 3683 </dd> 3684 3685 </div> 3686 </div><div> 3687 <div> 3688 <dt> 3689 <var>focused</var> 3690 <em> 3691 3692 <!-- TYPE --> 3693 <div style="display:inline"> 3694 ( 3695 <span class="optional" style="display: none; ">optional</span> 3696 <span class="enum" style="display: none; ">enumerated</span> 3697 <span id="typeTemplate"> 3698 <span style="display: none; "> 3699 <a> Type</a> 3700 </span> 3701 <span> 3702 <span style="display: none; "> 3703 array of <span><span></span></span> 3704 </span> 3705 <span>boolean</span> 3706 <span style="display: none; "></span> 3707 </span> 3708 </span> 3709 ) 3710 </div> 3711 3712 </em> 3713 </dt> 3714 <dd class="todo" style="display: none; "> 3715 Undocumented. 3716 </dd> 3717 <dd>Whether the window is currently the focused window.</dd> 3718 <dd style="display: none; "> 3719 This parameter was added in version 3720 <b><span></span></b>. 3721 You must omit this parameter in earlier versions, 3722 and you may omit it in any version. If you require this 3723 parameter, the manifest key 3724 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 3725 can ensure that your extension won't be run in an earlier browser version. 3726 </dd> 3727 3728 <!-- OBJECT PROPERTIES --> 3729 <dd style="display: none; "> 3730 <dl> 3731 <div> 3732 <div> 3733 </div> 3734 </div> 3735 </dl> 3736 </dd> 3737 3738 <!-- OBJECT METHODS --> 3739 <dd style="display: none; "> 3740 <div></div> 3741 </dd> 3742 3743 <!-- OBJECT EVENT FIELDS --> 3744 <dd style="display: none; "> 3745 <div></div> 3746 </dd> 3747 3748 <!-- FUNCTION PARAMETERS --> 3749 <dd style="display: none; "> 3750 <div></div> 3751 </dd> 3752 3753 </div> 3754 </div><div> 3755 <div> 3756 <dt> 3757 <var>top</var> 3758 <em> 3759 3760 <!-- TYPE --> 3761 <div style="display:inline"> 3762 ( 3763 <span class="optional" style="display: none; ">optional</span> 3764 <span class="enum" style="display: none; ">enumerated</span> 3765 <span id="typeTemplate"> 3766 <span style="display: none; "> 3767 <a> Type</a> 3768 </span> 3769 <span> 3770 <span style="display: none; "> 3771 array of <span><span></span></span> 3772 </span> 3773 <span>integer</span> 3774 <span style="display: none; "></span> 3775 </span> 3776 </span> 3777 ) 3778 </div> 3779 3780 </em> 3781 </dt> 3782 <dd class="todo" style="display: none; "> 3783 Undocumented. 3784 </dd> 3785 <dd>The offset of the window from the top edge of the screen in pixels.</dd> 3786 <dd style="display: none; "> 3787 This parameter was added in version 3788 <b><span></span></b>. 3789 You must omit this parameter in earlier versions, 3790 and you may omit it in any version. If you require this 3791 parameter, the manifest key 3792 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 3793 can ensure that your extension won't be run in an earlier browser version. 3794 </dd> 3795 3796 <!-- OBJECT PROPERTIES --> 3797 <dd style="display: none; "> 3798 <dl> 3799 <div> 3800 <div> 3801 </div> 3802 </div> 3803 </dl> 3804 </dd> 3805 3806 <!-- OBJECT METHODS --> 3807 <dd style="display: none; "> 3808 <div></div> 3809 </dd> 3810 3811 <!-- OBJECT EVENT FIELDS --> 3812 <dd style="display: none; "> 3813 <div></div> 3814 </dd> 3815 3816 <!-- FUNCTION PARAMETERS --> 3817 <dd style="display: none; "> 3818 <div></div> 3819 </dd> 3820 3821 </div> 3822 </div><div> 3823 <div> 3824 <dt> 3825 <var>left</var> 3826 <em> 3827 3828 <!-- TYPE --> 3829 <div style="display:inline"> 3830 ( 3831 <span class="optional" style="display: none; ">optional</span> 3832 <span class="enum" style="display: none; ">enumerated</span> 3833 <span id="typeTemplate"> 3834 <span style="display: none; "> 3835 <a> Type</a> 3836 </span> 3837 <span> 3838 <span style="display: none; "> 3839 array of <span><span></span></span> 3840 </span> 3841 <span>integer</span> 3842 <span style="display: none; "></span> 3843 </span> 3844 </span> 3845 ) 3846 </div> 3847 3848 </em> 3849 </dt> 3850 <dd class="todo" style="display: none; "> 3851 Undocumented. 3852 </dd> 3853 <dd>The offset of the window from the left edge of the screen in pixels.</dd> 3854 <dd style="display: none; "> 3855 This parameter was added in version 3856 <b><span></span></b>. 3857 You must omit this parameter in earlier versions, 3858 and you may omit it in any version. If you require this 3859 parameter, the manifest key 3860 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 3861 can ensure that your extension won't be run in an earlier browser version. 3862 </dd> 3863 3864 <!-- OBJECT PROPERTIES --> 3865 <dd style="display: none; "> 3866 <dl> 3867 <div> 3868 <div> 3869 </div> 3870 </div> 3871 </dl> 3872 </dd> 3873 3874 <!-- OBJECT METHODS --> 3875 <dd style="display: none; "> 3876 <div></div> 3877 </dd> 3878 3879 <!-- OBJECT EVENT FIELDS --> 3880 <dd style="display: none; "> 3881 <div></div> 3882 </dd> 3883 3884 <!-- FUNCTION PARAMETERS --> 3885 <dd style="display: none; "> 3886 <div></div> 3887 </dd> 3888 3889 </div> 3890 </div><div> 3891 <div> 3892 <dt> 3893 <var>width</var> 3894 <em> 3895 3896 <!-- TYPE --> 3897 <div style="display:inline"> 3898 ( 3899 <span class="optional" style="display: none; ">optional</span> 3900 <span class="enum" style="display: none; ">enumerated</span> 3901 <span id="typeTemplate"> 3902 <span style="display: none; "> 3903 <a> Type</a> 3904 </span> 3905 <span> 3906 <span style="display: none; "> 3907 array of <span><span></span></span> 3908 </span> 3909 <span>integer</span> 3910 <span style="display: none; "></span> 3911 </span> 3912 </span> 3913 ) 3914 </div> 3915 3916 </em> 3917 </dt> 3918 <dd class="todo" style="display: none; "> 3919 Undocumented. 3920 </dd> 3921 <dd>The width of the window in pixels.</dd> 3922 <dd style="display: none; "> 3923 This parameter was added in version 3924 <b><span></span></b>. 3925 You must omit this parameter in earlier versions, 3926 and you may omit it in any version. If you require this 3927 parameter, the manifest key 3928 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 3929 can ensure that your extension won't be run in an earlier browser version. 3930 </dd> 3931 3932 <!-- OBJECT PROPERTIES --> 3933 <dd style="display: none; "> 3934 <dl> 3935 <div> 3936 <div> 3937 </div> 3938 </div> 3939 </dl> 3940 </dd> 3941 3942 <!-- OBJECT METHODS --> 3943 <dd style="display: none; "> 3944 <div></div> 3945 </dd> 3946 3947 <!-- OBJECT EVENT FIELDS --> 3948 <dd style="display: none; "> 3949 <div></div> 3950 </dd> 3951 3952 <!-- FUNCTION PARAMETERS --> 3953 <dd style="display: none; "> 3954 <div></div> 3955 </dd> 3956 3957 </div> 3958 </div><div> 3959 <div> 3960 <dt> 3961 <var>height</var> 3962 <em> 3963 3964 <!-- TYPE --> 3965 <div style="display:inline"> 3966 ( 3967 <span class="optional" style="display: none; ">optional</span> 3968 <span class="enum" style="display: none; ">enumerated</span> 3969 <span id="typeTemplate"> 3970 <span style="display: none; "> 3971 <a> Type</a> 3972 </span> 3973 <span> 3974 <span style="display: none; "> 3975 array of <span><span></span></span> 3976 </span> 3977 <span>integer</span> 3978 <span style="display: none; "></span> 3979 </span> 3980 </span> 3981 ) 3982 </div> 3983 3984 </em> 3985 </dt> 3986 <dd class="todo" style="display: none; "> 3987 Undocumented. 3988 </dd> 3989 <dd>The height of the window in pixels.</dd> 3990 <dd style="display: none; "> 3991 This parameter was added in version 3992 <b><span></span></b>. 3993 You must omit this parameter in earlier versions, 3994 and you may omit it in any version. If you require this 3995 parameter, the manifest key 3996 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 3997 can ensure that your extension won't be run in an earlier browser version. 3998 </dd> 3999 4000 <!-- OBJECT PROPERTIES --> 4001 <dd style="display: none; "> 4002 <dl> 4003 <div> 4004 <div> 4005 </div> 4006 </div> 4007 </dl> 4008 </dd> 4009 4010 <!-- OBJECT METHODS --> 4011 <dd style="display: none; "> 4012 <div></div> 4013 </dd> 4014 4015 <!-- OBJECT EVENT FIELDS --> 4016 <dd style="display: none; "> 4017 <div></div> 4018 </dd> 4019 4020 <!-- FUNCTION PARAMETERS --> 4021 <dd style="display: none; "> 4022 <div></div> 4023 </dd> 4024 4025 </div> 4026 </div><div> 4027 <div> 4028 <dt> 4029 <var>tabs</var> 4030 <em> 4031 4032 <!-- TYPE --> 4033 <div style="display:inline"> 4034 ( 4035 <span class="optional">optional</span> 4036 <span class="enum" style="display: none; ">enumerated</span> 4037 <span id="typeTemplate"> 4038 <span style="display: none; "> 4039 <a> Type</a> 4040 </span> 4041 <span> 4042 <span> 4043 array of <span><span> 4044 <span> 4045 <a href="tabs.html#type-Tab">Tab</a> 4046 </span> 4047 <span style="display: none; "> 4048 <span> 4049 array of <span><span></span></span> 4050 </span> 4051 <span>paramType</span> 4052 <span></span> 4053 </span> 4054 </span></span> 4055 </span> 4056 <span style="display: none; ">paramType</span> 4057 <span style="display: none; "></span> 4058 </span> 4059 </span> 4060 ) 4061 </div> 4062 4063 </em> 4064 </dt> 4065 <dd class="todo" style="display: none; "> 4066 Undocumented. 4067 </dd> 4068 <dd>Array of <a href="tabs.html#type-Tab">Tab</a> objects representing the current tabs in the window.</dd> 4069 <dd style="display: none; "> 4070 This parameter was added in version 4071 <b><span></span></b>. 4072 You must omit this parameter in earlier versions, 4073 and you may omit it in any version. If you require this 4074 parameter, the manifest key 4075 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 4076 can ensure that your extension won't be run in an earlier browser version. 4077 </dd> 4078 4079 <!-- OBJECT PROPERTIES --> 4080 <dd style="display: none; "> 4081 <dl> 4082 <div> 4083 <div> 4084 </div> 4085 </div> 4086 </dl> 4087 </dd> 4088 4089 <!-- OBJECT METHODS --> 4090 <dd style="display: none; "> 4091 <div></div> 4092 </dd> 4093 4094 <!-- OBJECT EVENT FIELDS --> 4095 <dd style="display: none; "> 4096 <div></div> 4097 </dd> 4098 4099 <!-- FUNCTION PARAMETERS --> 4100 <dd style="display: none; "> 4101 <div></div> 4102 </dd> 4103 4104 </div> 4105 </div><div> 4106 <div> 4107 <dt> 4108 <var>incognito</var> 4109 <em> 4110 4111 <!-- TYPE --> 4112 <div style="display:inline"> 4113 ( 4114 <span class="optional" style="display: none; ">optional</span> 4115 <span class="enum" style="display: none; ">enumerated</span> 4116 <span id="typeTemplate"> 4117 <span style="display: none; "> 4118 <a> Type</a> 4119 </span> 4120 <span> 4121 <span style="display: none; "> 4122 array of <span><span></span></span> 4123 </span> 4124 <span>boolean</span> 4125 <span style="display: none; "></span> 4126 </span> 4127 </span> 4128 ) 4129 </div> 4130 4131 </em> 4132 </dt> 4133 <dd class="todo" style="display: none; "> 4134 Undocumented. 4135 </dd> 4136 <dd>Whether the window is incognito.</dd> 4137 <dd style="display: none; "> 4138 This parameter was added in version 4139 <b><span></span></b>. 4140 You must omit this parameter in earlier versions, 4141 and you may omit it in any version. If you require this 4142 parameter, the manifest key 4143 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 4144 can ensure that your extension won't be run in an earlier browser version. 4145 </dd> 4146 4147 <!-- OBJECT PROPERTIES --> 4148 <dd style="display: none; "> 4149 <dl> 4150 <div> 4151 <div> 4152 </div> 4153 </div> 4154 </dl> 4155 </dd> 4156 4157 <!-- OBJECT METHODS --> 4158 <dd style="display: none; "> 4159 <div></div> 4160 </dd> 4161 4162 <!-- OBJECT EVENT FIELDS --> 4163 <dd style="display: none; "> 4164 <div></div> 4165 </dd> 4166 4167 <!-- FUNCTION PARAMETERS --> 4168 <dd style="display: none; "> 4169 <div></div> 4170 </dd> 4171 4172 </div> 4173 </div><div> 4174 <div> 4175 <dt> 4176 <var>type</var> 4177 <em> 4178 4179 <!-- TYPE --> 4180 <div style="display:inline"> 4181 ( 4182 <span class="optional" style="display: none; ">optional</span> 4183 <span class="enum">enumerated</span> 4184 <span id="typeTemplate"> 4185 <span style="display: none; "> 4186 <a> Type</a> 4187 </span> 4188 <span> 4189 <span style="display: none; "> 4190 array of <span><span></span></span> 4191 </span> 4192 <span>string</span> 4193 <span>["normal", "popup", "panel", "app"]</span> 4194 </span> 4195 </span> 4196 ) 4197 </div> 4198 4199 </em> 4200 </dt> 4201 <dd class="todo" style="display: none; "> 4202 Undocumented. 4203 </dd> 4204 <dd>The type of browser window this is. The 'panel' type requires the 'experimental' permission.</dd> 4205 <dd style="display: none; "> 4206 This parameter was added in version 4207 <b><span></span></b>. 4208 You must omit this parameter in earlier versions, 4209 and you may omit it in any version. If you require this 4210 parameter, the manifest key 4211 <a href="manifest.html#minimum_chrome_version">minimum_chrome_version</a> 4212 can ensure that your extension won't be run in an earlier browser version. 4213 </dd> 4214 4215 <!-- OBJECT PROPERTIES --> 4216 <dd style="display: none; "> 4217 <dl> 4218 <div> 4219 <div> 4220 </div> 4221 </div> 4222 </dl> 4223 </dd> 4224 4225 <!-- OBJECT METHODS --> 4226 <dd style="display: none; "> 4227 <div></div> 4228 </dd> 4229 4230 <!-- OBJECT EVENT FIELDS --> 4231 <dd style="display: none; "> 4232 <div></div> 4233 </dd> 4234 4235 <!-- FUNCTION PARAMETERS --> 4236 <dd style="display: none; "> 4237 <div></div> 4238 </dd> 4239 4240 </div> 4241 </div> 4242 </dl> 4243 </dd> 4244 4245 <!-- OBJECT METHODS --> 4246 <dd style="display: none; "> 4247 <div></div> 4248 </dd> 4249 4250 <!-- OBJECT EVENT FIELDS --> 4251 <dd style="display: none; "> 4252 <div></div> 4253 </dd> 4254 4255 <!-- FUNCTION PARAMETERS --> 4256 <dd style="display: none; "> 4257 <div></div> 4258 </dd> 4259 4260 </div> 4261 4262 </div> <!-- /apiItem --> 4263 4264 </div> <!-- /apiGroup --> 4265 4266 </div> <!-- /apiPage --> 4267 </div> <!-- /gc-pagecontent --> 4268 </div> <!-- /g-section --> 4269 </div> <!-- /codesiteContent --> 4270 <div id="gc-footer" --=""> 4271 <div class="text"> 4272 <p> 4273 Except as otherwise <a href="http://code.google.com/policies.html#restrictions">noted</a>, 4274 the content of this page is licensed under the <a rel="license" href="http://creativecommons.org/licenses/by/3.0/">Creative Commons 4275 Attribution 3.0 License</a>, and code samples are licensed under the 4276 <a rel="license" href="http://code.google.com/google_bsd_license.html">BSD License</a>. 4277 </p> 4278 <p> 4279 ©2011 Google 4280 </p> 4281 4282<!-- begin analytics --> 4283<script src="http://www.google-analytics.com/urchin.js" type="text/javascript"></script> 4284<script src="http://www.google-analytics.com/ga.js" type="text/javascript"></script> 4285 4286<script type="text/javascript"> 4287 // chrome doc tracking 4288 try { 4289 var engdocs = _gat._getTracker("YT-10763712-2"); 4290 engdocs._trackPageview(); 4291 } catch(err) {} 4292 4293 // code.google.com site-wide tracking 4294 try { 4295 _uacct="UA-18071-1"; 4296 _uanchor=1; 4297 _uff=0; 4298 urchinTracker(); 4299 } 4300 catch(e) {/* urchinTracker not available. */} 4301</script> 4302<!-- end analytics --> 4303 </div> 4304 </div> <!-- /gc-footer --> 4305 </div> <!-- /gc-container --> 4306</body></html> 4307
