mirror of
https://github.com/mozilla/gecko-dev.git
synced 2024-11-07 12:15:51 +00:00
142 lines
3.7 KiB
C++
142 lines
3.7 KiB
C++
/* -*- Mode: C++; tab-width: 2; indent-tabs-mode: nil; c-basic-offset: 2 -*-
|
|
*
|
|
* The contents of this file are subject to the Netscape Public
|
|
* License Version 1.1 (the "License"); you may not use this file
|
|
* except in compliance with the License. You may obtain a copy of
|
|
* the License at http://www.mozilla.org/NPL/
|
|
*
|
|
* Software distributed under the License is distributed on an "AS
|
|
* IS" basis, WITHOUT WARRANTY OF ANY KIND, either express or
|
|
* implied. See the License for the specific language governing
|
|
* rights and limitations under the License.
|
|
*
|
|
* The Original Code is mozilla.org code.
|
|
*
|
|
* The Initial Developer of the Original Code is Netscape
|
|
* Communications Corporation. Portions created by Netscape are
|
|
* Copyright (C) 1998 Netscape Communications Corporation. All
|
|
* Rights Reserved.
|
|
*
|
|
* Contributor(s):
|
|
*/
|
|
|
|
#ifndef nsIComboBox_h__
|
|
#define nsIComboBox_h__
|
|
|
|
#include "nsIListWidget.h"
|
|
#include "nsString.h"
|
|
|
|
// {961085F6-BD28-11d1-97EF-00609703C14E}
|
|
#define NS_ICOMBOBOX_IID \
|
|
{ 0x961085f6, 0xbd28, 0x11d1, { 0x97, 0xef, 0x0, 0x60, 0x97, 0x3, 0xc1, 0x4e } }
|
|
|
|
|
|
/**
|
|
* Initialize combobox data
|
|
*/
|
|
|
|
struct nsComboBoxInitData : public nsWidgetInitData {
|
|
nsComboBoxInitData()
|
|
: mDropDownHeight(0)
|
|
{
|
|
}
|
|
|
|
PRUint32 mDropDownHeight; // in pixels
|
|
};
|
|
|
|
/**
|
|
* Single selection drop down list. See nsIListWidget for capabilities
|
|
*/
|
|
|
|
class nsIComboBox : public nsISupports {
|
|
public:
|
|
NS_DEFINE_STATIC_IID_ACCESSOR(NS_ICOMBOBOX_IID);
|
|
|
|
/**
|
|
* Set an item at the specific position
|
|
*
|
|
* @param aItem the item name. The item has to be null terminated
|
|
* @param aPosition the position the item should be inserted at
|
|
* 0 is at the top of the list
|
|
* -1 is at the end of the list
|
|
*/
|
|
NS_IMETHOD AddItemAt(nsString &aItem, PRInt32 aPosition) = 0;
|
|
|
|
/**
|
|
* Finds the first occurrence of the specified item
|
|
*
|
|
* @param aItem the string to be filled
|
|
* @param aStartPos the starting position (index)
|
|
* @return PR_TRUE if successful, PR_FALSE otherwise
|
|
*
|
|
*/
|
|
virtual PRInt32 FindItem(nsString &aItem, PRInt32 aStartPos) = 0;
|
|
|
|
/**
|
|
* Returns the number of items in the list
|
|
*
|
|
* @return the number of items
|
|
*
|
|
*/
|
|
virtual PRInt32 GetItemCount() = 0;
|
|
|
|
/**
|
|
* Remove the first occurrence of the specified item
|
|
*
|
|
* @param aPosition the item position
|
|
* 0 is at the top of the list
|
|
* -1 is at the end of the list
|
|
*
|
|
* @return PR_TRUE if successful, PR_FALSE otherwise
|
|
*
|
|
*/
|
|
virtual PRBool RemoveItemAt(PRInt32 aPosition) = 0;
|
|
|
|
/**
|
|
* Gets an item at a specific location
|
|
*
|
|
* @param anItem on return contains the string of the item at that position
|
|
* @param aPosition the Position of the item
|
|
*
|
|
*/
|
|
virtual PRBool GetItemAt(nsString& anItem, PRInt32 aPosition) = 0;
|
|
|
|
/**
|
|
* Gets the selected item for a single selection list
|
|
*
|
|
* @param aItem on return contains the string of the selected item
|
|
*
|
|
*/
|
|
NS_IMETHOD GetSelectedItem(nsString &aItem) = 0;
|
|
|
|
/**
|
|
* Returns with the index of the selected item
|
|
*
|
|
* @return PRInt32, index of selected item
|
|
*
|
|
*/
|
|
virtual PRInt32 GetSelectedIndex() = 0;
|
|
|
|
/**
|
|
* Select the item at the specified position
|
|
*
|
|
* @param PRInt32, the item position
|
|
* 0 is at the top of the list
|
|
* -1 is at the end of the list
|
|
*
|
|
*/
|
|
NS_IMETHOD SelectItem(PRInt32 aPosition) = 0;
|
|
|
|
/**
|
|
* Deselects all the items in the list
|
|
*
|
|
*/
|
|
NS_IMETHOD Deselect() = 0;
|
|
};
|
|
|
|
|
|
#endif // nsIComboBox_h__
|
|
|
|
|
|
|