Public class Liste d'IlxWList étend IlxWComponent
Le modèle de données IlxWList est une instance de javax.swing.ListModel. Son état de sélection est géré par une instance de javax.swing.ListSelectionModel.
Par défaut, IlxWList est rendu dans le navigateur sous la forme d'un élément HTML <select> . Ses cellules sont affichées sous forme d'éléments <option> dont les valeurs sont le résultat de la méthode toString() exécutée sur les données de la cellule. Toutefois, vous pouvez fournir un présentateur de cellule personnalisé via la méthode setCellRenderer . Vous pouvez sous-classer le présentateur de cellule par défaut (IlxWDefaultListCellRenderer) ou implémenter l'interface IlxWListCellRenderer . Le présentateur de rendu de cellule par défaut utilise un composant IlxWLabel pour rendre la valeur de chaîne de chaque composant. Vous pouvez remplacer votre propre rendu de cellule à l'aide du code suivant:
// Afficher une icône et une chaîne pour chaque objet de la liste. Class MyCellRenderer extends IlxWLabel implémente IlxWListCellRenderer { Public IlxWComponent getListCellRenderComponent ( Liste IlxWList, Valeur d'objet, Indice int, Booléen isSélectionné) { SetText (value.toString ()) ; If (isSelected) { GetStyle ().set ("backgroundColor", "red") ; GetStyle ().set ("couleur", "blanc") ; } else { GetStyle ().set ("backgroundColor", "white") ; GetStyle ().set ("couleur", "noir") ; } Retourner ceci ; } } String [ ] data = {"one", "two", "three", "four"}; IlxWList dataList = new IlxWList (données) ; DataList.setCellRenderer (nouveau MyCellRenderer ()) ;
, IlxWListCellRenderer, IlxWDefaultListCellRenderer, Formulaire sérialisé
IlxWComponent.DynamicStyleMap| Modificateur et type | Zone et description |
|---|---|
static java.lang.String |
ACTION_PROPERTYNom de la propriété d'action.
|
static java.lang.String |
CELL_RENDERER_PROPERTYNom de la propriété cellRenderer.
|
static java.lang.String |
CSS_RESOURCE_NAMEChemin d'accès aux ressources du CSS de l'agent utilisateur.
|
static java.lang.String |
MODEL_PROPERTYNom de la propriété de modèle.
|
static java.lang.String |
SELECTION_MODEL_PROPERTYNom de la propriété selectionModel.
|
static java.lang.String |
UI_PROPERTYNom de la propriété de l'interface utilisateur.
|
listenerList| Constructeur et description |
|---|
IlxWList()Construit un
IlxWList avec un modèle vide. |
IlxWList(javax.swing.ListModel model)Construit un
IlxWList qui affiche les éléments dans le modèle spécifié, non nul. |
IlxWList(java.lang.Object[] listData)Construit un
IlxWList qui affiche les éléments dans le tableau spécifié. |
| Modificateur et type | Méthode et description |
|---|---|
void |
addListSelectionListener(javax.swing.event.ListSelectionListener listener)Ajoute un programme d'écoute à la liste qui est notifiée chaque fois qu'une modification de la sélection se produit.
|
void |
addSelectionInterval(int anchor,
int lead)Définit la sélection comme l'union de l'intervalle spécifié avec la sélection en cours.
|
void |
clearSelection()Efface la sélection-après avoir appelé cette méthode,
isSelectionEmpty renvoie la valeur true. |
protected javax.swing.ListSelectionModel |
createSelectionModel()Renvoie une instance de
DefaultListSelectionModel. |
protected void |
fireSelectionValueChanged(int firstIndex,
int lastIndex,
boolean isAdjusting)Avertit
IlxWList ListSelectionListenerque le modèle de sélection a changé. |
IlxWAction |
getAction()Extrait l'action qui sera appelée lorsque l'utilisateur sélectionne un élément dans la liste.
|
int |
getAnchorSelectionIndex()Renvoie le premier argument d'index à partir de l'appel
addSelectionModel ou setSelectionInterval le plus récent. |
IlxWComponent |
getCellAt(int index)Extrait le composant représentant la cellule à l'index indiqué.
|
IlxWListCellRenderer |
getCellRenderer()Renvoie l'objet qui affiche les éléments de liste.
|
int |
getColumnWidth()Retourne la largeur du composant en pixels.
|
int |
getLeadSelectionIndex()Renvoie le deuxième argument d'index à partir de l'appel
addSelectionInterval ou setSelectionInterval le plus récent. |
javax.swing.event.ListSelectionListener[] |
getListSelectionListeners() |
int |
getMaxSelectionIndex()Renvoie le plus grand index de cellule sélectionné.
|
int |
getMinSelectionIndex()Renvoie le plus petit index de cellule sélectionné.
|
javax.swing.ListModel |
getModel()Renvoie le modèle de données qui contient la liste des éléments affichés par le composant
IlxWList . |
int |
getRowHeight()Renvoie la hauteur du composant.
|
int |
getSelectedIndex()Renvoie le premier index sélectionné.
|
java.lang.Object |
getSelectedValue()Renvoie la première valeur sélectionnée, ou
null si la sélection est vide. |
int |
getSelectionMode()Retourne si des sélections à un ou plusieurs articles sont autorisées.
|
javax.swing.ListSelectionModel |
getSelectionModel()Renvoie la valeur du modèle de sélection en cours.
|
protected IlxWCSSRuleset |
getUserAgentRules()Extrait les règles CSS "user-agent".
|
boolean |
isEnabled()Détermine si ce composant est activé.
|
boolean |
isSelectedIndex(int index)Renvoie la valeur true si l'index spécifié est sélectionné.
|
boolean |
isSelectionEmpty()Renvoie true si rien n'est sélectionné.
|
void |
notifyDependencies(IlxWPort port) |
protected void |
printComponent(IlxWPort port)Imprime le code HTML qui affichera la représentation graphique de ce composant.
|
void |
removeListSelectionListener(javax.swing.event.ListSelectionListener listener)Supprime un programme d'écoute de la liste qui est notifié chaque fois qu'une modification de la sélection se produit.
|
void |
removeSelectionInterval(int index0,
int index1)Définit la sélection comme la différence définie pour l'intervalle spécifié et la sélection en cours.
|
void |
setAction(IlxWAction action)Définit l'action qui sera appelée lorsque l'utilisateur sélectionne un élément dans la liste.
|
void |
setCellRenderer(IlxWListCellRenderer cellRenderer)Définit le délégué utilisé pour afficher chaque cellule de la liste.
|
void |
setColumnWidth(int columnWidth)Définit la largeur du composant en pixels.
|
void |
setEnabled(boolean enabled)Active ou désactive ce composant.
|
void |
setListData(java.lang.Object[] listData)Construit un
ListModel à partir d'un tableau d'objets, puis lui applique setModel . |
void |
setModel(javax.swing.ListModel model)Définit le modèle qui représente le contenu ou la "valeur" de la liste et efface la sélection de liste après avoir notifié
PropertyChangeListeners. |
void |
setRowHeight(int rowHeight)Définit la hauteur du composant, c'est-à-dire le nombre d'éléments affichés dans la liste déroulante sans défilement.
|
void |
setSelectedIndex(int index)Sélectionne une cellule unique.
|
void |
setSelectedValue(java.lang.Object element)Sélectionne l'objet spécifié dans la liste.
|
void |
setSelectionInterval(int anchor,
int lead)Sélectionne l'intervalle spécifié.
|
void |
setSelectionMode(int selectionMode)Détermine si les sélections à un ou plusieurs articles sont autorisées.
|
void |
setSelectionModel(javax.swing.ListSelectionModel selectionModel)Définit
selectionModel pour la liste sur une implémentation nonnull ListSelectionModel . |
addPropertyChangeListener, addPropertyChangeListener, detach, doPrint, firePropertyChange, firePropertyChange, getName, getRealHtmlTagName, getStyle, invalidate, isInvalidated, print, removePropertyChangeListener, removePropertyChangeListener, setName, validateadd, add, getAttribute, getAttributeNames, getComponent, getComponentCount, getComponentNamed, getComponents, getManager, getParent, indexOf, isAncestorOf, remove, remove, removeAll, removeAttribute, setAttribute, setAuthorRules, setFinalizerPublic static final java.lang.String MODEL_PROPERTY
Public static final java.lang.String SELECTION_MODEL_PROPERTY
Public static final java.lang.String CELL_RENDERER_PROPERTY
Public static final java.lang.String ACTION_PROPERTY
Public static final java.lang.String UI_PROPERTY
Public static final java.lang.String CSS_RESOURCE_NAME
Public IlxWList (modèle javax.swing.ListModel)
IlxWList qui affiche les éléments dans le modèle spécifié, non nul.Tous les constructeurs IlxWList délèguent à celui-ci.
java.lang.IllegalArgumentException -Si dataModel est nullmodel -Modèle de données pour cette liste.Public IlxWList (java.lang.Object [ ] listData)
IlxWList qui affiche les éléments dans le tableau spécifié.Ce constructeur délègue simplement au constructeur ListModel .
listData -Tableau d'objets à charger dans le modèle de données.Public IlxWList ()
IlxWList avec un modèle vide.Public int getColumnWidth ()
Public void setColumnWidth (int columnWidth)
columnWidth -Largeur du composant en pixels.Public int getRowHeight ()
Public void setRowHeight (int rowHeight)
rowHeight -Hauteur du composant dans les éléments de liste.public IlxWListCellRenderer getCellRenderer ()
IlxWListCellRenderer.setCellRenderer(ilog.webui.dhtml.components.IlxWListCellRenderer)public void setCellRenderer (IlxWListCellRenderer cellRenderer)
Par défaut, cette propriété est null et la liste est affichée sous la forme d'un élément HTML < select> dans lequel les cellules sont représentées par un élément < option> dont les valeurs sont les valeurs de chaîne du modèle de données. Pour voir un exemple qui définit le présentateur de cellule, voir la description de classe ci-dessus.
cellRenderer - IlxWListCellRenderer qui affiche les cellules de liste.getCellRenderer()Public javax.swing.ListModel getModel ()
IlxWList .setModel(javax.swing.ListModel)Public void setModel (modèle javax.swing.ListModel)
PropertyChangeListeners.java.lang.IllegalArgumentException -Si model est null.model - ListModel qui fournit la liste des éléments à afficher.getModel()Public void setListData (java.lang.Object [ ] listData)
ListModel à partir d'un tableau d'objets, puis lui applique setModel .listData -Tableau d'objets contenant les éléments à afficher dans la liste.setModel(javax.swing.ListModel)Protégée javax.swing.ListSelectionModel createSelectionModel ()
DefaultListSelectionModel.Cette méthode est utilisée par le constructeur pour initialiser la propriété selectionModel .
ListSelectionModel utilisé par cette liste.setSelectionModel(javax.swing.ListSelectionModel), DefaultListSelectionModelPublic javax.swing.ListSelectionModel getSelectionModel ()
Le modèle de sélection gère la tâche consistant à effectuer des sélections uniques, des sélections de plages contiguës et des sélections non contiguës.
setSelectionModel(javax.swing.ListSelectionModel), ListSelectionModelProtected void fireSelectionValueChanged (int firstIndex,
Int lastIndex,
Valeur booléenne isAdjusting)
IlxWList ListSelectionListenerque le modèle de sélection a changé.Il est utilisé pour transférer ListSelectionEvents du selectionModel vers les ListSelectionListenerajoutés directement au IlxWList.
firstIndex -Premier index sélectionné.lastIndex -Dernier index sélectionné.isAdjusting -True si plusieurs modifications sont apportées.addListSelectionListener(javax.swing.event.ListSelectionListener), removeListSelectionListener(javax.swing.event.ListSelectionListener)Public javax.swing.event.ListSelectionListener [ ] getListSelectionListeners ()
Public void addListSelectionListener (programme d'écoute javax.swing.event.ListSelectionListener)
Les programmes d'écoute ajoutés directement au IlxWList auront leur ListSelectionEvent.getSource() ==
this IlxWList (à la place de ListSelectionModel).
listener - ListSelectionListener à ajouter.getSelectionModel()Public void removeListSelectionListener (javax.swing.event.ListSelectionListener)
listener - ListSelectionListener à supprimer.addListSelectionListener(javax.swing.event.ListSelectionListener), getSelectionModel()Public void setSelectionModel (javax.swing.ListSelectionModel selectionModel)
selectionModel pour la liste sur une implémentation nonnull ListSelectionModel .Le modèle de sélection gère la tâche consistant à effectuer des sélections uniques, des sélections de plages contiguës et des sélections non contiguës.
java.lang.IllegalArgumentException -Si selectionModel est null.selectionModel - ListSelectionModel qui implémente les sélections.getSelectionModel()Public void setSelectionMode (int selectionMode)
Les valeurs selectionMode suivantes sont autorisées:
SINGLE_SELECTION Un seul index de liste peut être sélectionné à la fois. Dans ce mode, les méthodes setSelectionInterval et addSelectionInterval sont équivalentes et seul le deuxième argument d'index est utilisé.SINGLE_INTERVAL_SELECTION Un intervalle d'index contigu peut être sélectionné à la fois. Dans ce mode, setSelectionInterval et addSelectionInterval sont équivalents.MULTIPLE_INTERVAL_SELECTION Dans ce mode, il n'y a aucune restriction quant à ce qui peut être sélectionné. Il s'agit de la valeur par défaut.selectionMode -Entier spécifiant le type de sélection autorisé.getSelectionMode()Public int getSelectionMode ()
setSelectionMode(int)Public int getAnchorSelectionIndex ()
addSelectionModel ou setSelectionInterval le plus récent.Il s'agit d'une méthode pratique qui ne fait que déléguer à selectionModel.
ListSelectionModel.getAnchorSelectionIndex(), addSelectionInterval(int, int), setSelectionInterval(int, int), addListSelectionListener(javax.swing.event.ListSelectionListener)Public int getLeadSelectionIndex ()
addSelectionInterval ou setSelectionInterval le plus récent.Il s'agit d'une méthode pratique qui ne fait que déléguer à selectionModel.
ListSelectionModel.getLeadSelectionIndex(), addSelectionInterval(int, int), setSelectionInterval(int, int), addListSelectionListener(javax.swing.event.ListSelectionListener)Public int getMinSelectionIndex ()
Il s'agit d'une méthode pratique qui ne fait que déléguer à selectionModel.
ListSelectionModel.getMinSelectionIndex(), addListSelectionListener(javax.swing.event.ListSelectionListener)Public int getMaxSelectionIndex ()
Il s'agit d'une méthode pratique qui ne fait que déléguer à selectionModel.
ListSelectionModel.getMaxSelectionIndex(), addListSelectionListener(javax.swing.event.ListSelectionListener)Public boolean isSelectedIndex (int index)
Il s'agit d'une méthode pratique qui ne fait que déléguer à selectionModel.
index -Index à interroger pour l'état de la sélection.ListSelectionModel.isSelectedIndex(int), setSelectedIndex(int), addListSelectionListener(javax.swing.event.ListSelectionListener)Public boolean isSelectionEmpty ()
Il s'agit d'une méthode pratique qui ne fait que déléguer à selectionModel.
true si rien n'est sélectionné.ListSelectionModel.isSelectionEmpty(), clearSelection(), addListSelectionListener(javax.swing.event.ListSelectionListener)Public void clearSelection ()
isSelectionEmpty renvoie la valeur true.Il s'agit d'une méthode pratique qui ne fait que déléguer à selectionModel.
ListSelectionModel.clearSelection(), isSelectionEmpty(), addListSelectionListener(javax.swing.event.ListSelectionListener)Public void setSelectionInterval (int ancrage,
Int. Int)
Il n'est pas nécessaire que l'ancre soit moins que le plomb. Il s'agit d'une méthode pratique qui ne fait que déléguer à selectionModel.
anchor -Premier index à sélectionner.lead -Dernier index à sélectionner.ListSelectionModel.setSelectionInterval(int, int), addSelectionInterval(int, int), removeSelectionInterval(int, int), addListSelectionListener(javax.swing.event.ListSelectionListener)Public void addSelectionInterval (int ancrage,
Int. Int)
Les indices d'ancrage et de plomb sont tous deux inclus. Il n'est pas nécessaire que l'ancre soit moins que le plomb. Il s'agit d'une méthode pratique qui ne fait que déléguer à selectionModel.
anchor -Premier index à ajouter à la sélection.lead -Dernier index à ajouter à la sélection.ListSelectionModel.addSelectionInterval(int, int), setSelectionInterval(int, int), removeSelectionInterval(int, int), addListSelectionListener(javax.swing.event.ListSelectionListener)Public void removeSelectionInterval (int index0,
Int index1)
Les indices d'ancrage et de plomb sont tous deux enlevés. Il n'est pas nécessaire que l'ancre soit moins que le plomb. Il s'agit d'une méthode pratique qui ne fait que déléguer à selectionModel.
index0 -Premier index à supprimer de la sélection.index1 -Dernier index à supprimer de la sélection.ListSelectionModel.removeSelectionInterval(int, int), setSelectionInterval(int, int), addSelectionInterval(int, int), addListSelectionListener(javax.swing.event.ListSelectionListener)Public void setSelectedIndex (int index)
index -Index de la cellule à sélectionner.ListSelectionModel.setSelectionInterval(int, int), isSelectedIndex(int), addListSelectionListener(javax.swing.event.ListSelectionListener)Public int getSelectedIndex ()
Retourne -1 s'il n'y a pas d'élément sélectionné.
getMinSelectionIndex.getMinSelectionIndex(), addListSelectionListener(javax.swing.event.ListSelectionListener)Public java.lang.Object getSelectedValue ()
null si la sélection est vide.getMinSelectionIndex(), getModel(), addListSelectionListener(javax.swing.event.ListSelectionListener)Public void setSelectedValue (élément java.lang.Object)
La liste défilera pour afficher l'objet sélectionné.
element -Objet à sélectionner.Public boolean isEnabled ()
true si le composant est activé ; false dans le cas contraire.setEnabled(boolean)Public void setEnabled (boolean enabled)
enabled -Si la valeur est true, ce composant est activé ; sinon, il est désactivé.isEnabled()public IlxWAction getAction ()
Par défaut, cette action est une action Java (IlxWJavaAction) dont la méthode perform appelle setSelectedIndex dans la liste.
Si l'action donnée est une action Java (IlxWJavaAction) ou une action JavaScript (IlxWJSAction), le tableau d'arguments transmis à la méthode perform est un tableau de longueur 1 contenant la représentation de chaîne de l'index sélectionné.
setAction(ilog.webui.dhtml.components.IlxWAction)public void setAction (actionIlxWAction )
action -Action à effectuer lorsque l'utilisateur sélectionne un élément dans la liste.getAction()protégé IlxWCSSRuleset getUserAgentRules ()
IlxWContainersetAuthorRules .Cette méthode renvoie null par défaut, mais elle est destinée à être redéfinie par des sous-classes.
getUserAgentRules dans la classe IlxWContainerIlxWContainer.setAuthorRules(ilog.webui.dhtml.IlxWCSSRuleset)Protected void printComponent (portIlxWPort ) Throws java.io.IOException
IlxWComponentIlxWComponent.print(ilog.webui.dhtml.IlxWPort) .printComponent dans la classe IlxWComponentjava.io.IOExceptionport -Port sur lequel le composant sera imprimé.IlxWComponent.print(ilog.webui.dhtml.IlxWPort)public IlxWComponent getCellAt (index int)
IlxWListCellRenderer.getListCellComponent.Dans certaines circonstances, vous pouvez avoir besoin d'accéder au composant de cellule, afin, par exemple, de définir dynamiquement la couleur d'arrière-plan de la cellule entière.
Ce composant n'est pas persistant et peut être supprimé / créé à tout moment pendant la phase de rendu. Par conséquent, vous devez appeler cette méthode uniquement à partir de la portée de IlxWListCellRenderer.getListCellComponentet ne jamais conserver de référence sur le composant renvoyé en dehors de cette portée.
public void notifyDependencies (portIlxWPort )
notifyDependencies dans l'interface IlxWDependencyProvidernotifyDependencies dans la classe IlxWComponent© Copyright IBM Corp. 1987, 2022