/* -*- Mode: IDL; tab-width: 2; indent-tabs-mode: nil; c-basic-offset: 2 -*- */
/* This Source Code Form is subject to the terms of the Mozilla Public
 * License, v. 2.0. If a copy of the MPL was not distributed with this
 * file, You can obtain one at http://mozilla.org/MPL/2.0/. */

#include "nsIDOMXULSelectCntrlEl.idl"

webidl Element;
webidl NodeList;

[scriptable, uuid(40654a10-8204-4f06-9f21-7baa31c7b1dd)]
interface nsIDOMXULMultiSelectControlElement : nsIDOMXULSelectControlElement
{
  attribute AString selType;

  attribute Element currentItem;
  attribute long currentIndex;

  readonly attribute NodeList selectedItems;

  void addItemToSelection(in nsIDOMXULSelectControlItemElement item);
  void removeItemFromSelection(in nsIDOMXULSelectControlItemElement item);
  void toggleItemSelection(in nsIDOMXULSelectControlItemElement item);

  void selectItem(in nsIDOMXULSelectControlItemElement item);
  void selectItemRange(in nsIDOMXULSelectControlItemElement startItem, in nsIDOMXULSelectControlItemElement item);

  void selectAll();
  void clearSelection();

  // XXX - temporary, pending implementation of scriptable,
  //       mutable NodeList for selectedItems
  readonly attribute long selectedCount;
  [binaryname(MultiGetSelectedItem)]
  Element getSelectedItem(in long index);
};