|
@@ -1,76 +1,76 @@ |
1 |
|
- |
// This Source Code is in the Public Domain per: http://unlicense.org |
2 |
|
- |
package org.litesoft.GWT.forms.client.components; |
3 |
|
- |
|
4 |
|
- |
import org.litesoft.GWT.client.widgets.*; |
5 |
|
- |
|
6 |
|
- |
import com.google.gwt.event.dom.client.*; |
7 |
|
- |
import com.google.gwt.event.shared.*; |
8 |
|
- |
import com.google.gwt.user.client.ui.*; |
9 |
|
- |
|
10 |
|
- |
public interface FormComboBoxFocusWidget extends IFocusWidget { |
11 |
|
- |
/** |
12 |
|
- |
* Adds a listener interface to receive change events. |
13 |
|
- |
* |
14 |
|
- |
* @param listener the listener interface to add |
15 |
|
- |
*/ |
16 |
|
- |
@Deprecated |
17 |
|
- |
public void addChangeListener( ChangeListener listener ); |
18 |
|
- |
|
19 |
|
- |
public HandlerRegistration addChangeHandler( ChangeHandler handler ); |
20 |
|
- |
|
21 |
|
- |
/** |
22 |
|
- |
* Gets the number of items present in the list box. |
23 |
|
- |
* |
24 |
|
- |
* @return the number of items |
25 |
|
- |
*/ |
26 |
|
- |
public int getItemCount(); |
27 |
|
- |
|
28 |
|
- |
/** |
29 |
|
- |
* Adds an item to the list box, specifying an initial value for the item. |
30 |
|
- |
* |
31 |
|
- |
* @param item the text of the item to be added |
32 |
|
- |
* @param value the item's value, to be submitted if it is part of a |
33 |
|
- |
* {@link FormPanel}; cannot be <code>null</code> |
34 |
|
- |
*/ |
35 |
|
- |
public void addItem( String item, String value ); |
36 |
|
- |
|
37 |
|
- |
/** |
38 |
|
- |
* Removes the item at the specified index. |
39 |
|
- |
* |
40 |
|
- |
* @param index the index of the item to be removed |
41 |
|
- |
* |
42 |
|
- |
* @throws IndexOutOfBoundsException if the index is out of range |
43 |
|
- |
*/ |
44 |
|
- |
public void removeItem( int index ); |
45 |
|
- |
|
46 |
|
- |
/** |
47 |
|
- |
* Gets the currently-selected item. If multiple items are selected, this |
48 |
|
- |
* method will return the first selected item. |
49 |
|
- |
* |
50 |
|
- |
* @return the selected index, or <code>-1</code> if none is selected |
51 |
|
- |
*/ |
52 |
|
- |
public int getSelectedIndex(); |
53 |
|
- |
|
54 |
|
- |
/** |
55 |
|
- |
* Sets the currently selected index. |
56 |
|
- |
* <p/> |
57 |
|
- |
* <p/> |
58 |
|
- |
* Note that setting the selected index programmatically does <em>not</em> |
59 |
|
- |
* cause the {@link ChangeListener#onChange(Widget)} event to be fired. |
60 |
|
- |
* </p> |
61 |
|
- |
* |
62 |
|
- |
* @param index the index of the item to be selected |
63 |
|
- |
*/ |
64 |
|
- |
public void setSelectedIndex( int index ); |
65 |
|
- |
|
66 |
|
- |
/** |
67 |
|
- |
* Gets the value associated with the item at a given index. |
68 |
|
- |
* |
69 |
|
- |
* @param index the index of the item to be retrieved |
70 |
|
- |
* |
71 |
|
- |
* @return the item's associated value |
72 |
|
- |
* |
73 |
|
- |
* @throws IndexOutOfBoundsException if the index is out of range |
74 |
|
- |
*/ |
75 |
|
- |
public String getValue( int index ); |
76 |
|
- |
} |
|
1 |
+ |
// This Source Code is in the Public Domain per: http://unlicense.org |
|
2 |
+ |
package org.litesoft.GWT.forms.client.components; |
|
3 |
+ |
|
|
4 |
+ |
import org.litesoft.GWT.client.widgets.*; |
|
5 |
+ |
|
|
6 |
+ |
import com.google.gwt.event.dom.client.*; |
|
7 |
+ |
import com.google.gwt.event.shared.*; |
|
8 |
+ |
import com.google.gwt.user.client.ui.*; |
|
9 |
+ |
|
|
10 |
+ |
public interface FormComboBoxFocusWidget extends IFocusWidget { |
|
11 |
+ |
/** |
|
12 |
+ |
* Adds a listener interface to receive change events. |
|
13 |
+ |
* |
|
14 |
+ |
* @param listener the listener interface to add |
|
15 |
+ |
*/ |
|
16 |
+ |
@Deprecated |
|
17 |
+ |
public void addChangeListener( ChangeListener listener ); |
|
18 |
+ |
|
|
19 |
+ |
public HandlerRegistration addChangeHandler( ChangeHandler handler ); |
|
20 |
+ |
|
|
21 |
+ |
/** |
|
22 |
+ |
* Gets the number of items present in the list box. |
|
23 |
+ |
* |
|
24 |
+ |
* @return the number of items |
|
25 |
+ |
*/ |
|
26 |
+ |
public int getItemCount(); |
|
27 |
+ |
|
|
28 |
+ |
/** |
|
29 |
+ |
* Adds an item to the list box, specifying an initial value for the item. |
|
30 |
+ |
* |
|
31 |
+ |
* @param item the text of the item to be added |
|
32 |
+ |
* @param value the item's value, to be submitted if it is part of a |
|
33 |
+ |
* {@link FormPanel}; cannot be <code>null</code> |
|
34 |
+ |
*/ |
|
35 |
+ |
public void addItem( String item, String value ); |
|
36 |
+ |
|
|
37 |
+ |
/** |
|
38 |
+ |
* Removes the item at the specified index. |
|
39 |
+ |
* |
|
40 |
+ |
* @param index the index of the item to be removed |
|
41 |
+ |
* |
|
42 |
+ |
* @throws IndexOutOfBoundsException if the index is out of range |
|
43 |
+ |
*/ |
|
44 |
+ |
public void removeItem( int index ); |
|
45 |
+ |
|
|
46 |
+ |
/** |
|
47 |
+ |
* Gets the currently-selected item. If multiple items are selected, this |
|
48 |
+ |
* method will return the first selected item. |
|
49 |
+ |
* |
|
50 |
+ |
* @return the selected index, or <code>-1</code> if none is selected |
|
51 |
+ |
*/ |
|
52 |
+ |
public int getSelectedIndex(); |
|
53 |
+ |
|
|
54 |
+ |
/** |
|
55 |
+ |
* Sets the currently selected index. |
|
56 |
+ |
* <p/> |
|
57 |
+ |
* <p/> |
|
58 |
+ |
* Note that setting the selected index programmatically does <em>not</em> |
|
59 |
+ |
* cause the {@link ChangeListener#onChange(Widget)} event to be fired. |
|
60 |
+ |
* </p> |
|
61 |
+ |
* |
|
62 |
+ |
* @param index the index of the item to be selected |
|
63 |
+ |
*/ |
|
64 |
+ |
public void setSelectedIndex( int index ); |
|
65 |
+ |
|
|
66 |
+ |
/** |
|
67 |
+ |
* Gets the value associated with the item at a given index. |
|
68 |
+ |
* |
|
69 |
+ |
* @param index the index of the item to be retrieved |
|
70 |
+ |
* |
|
71 |
+ |
* @return the item's associated value |
|
72 |
+ |
* |
|
73 |
+ |
* @throws IndexOutOfBoundsException if the index is out of range |
|
74 |
+ |
*/ |
|
75 |
+ |
public String getValue( int index ); |
|
76 |
+ |
} |