001    /*
002     * Copyright (c) 2009 The openGion Project.
003     *
004     * Licensed under the Apache License, Version 2.0 (the "License");
005     * you may not use this file except in compliance with the License.
006     * You may obtain a copy of the License at
007     *
008     *     http://www.apache.org/licenses/LICENSE-2.0
009     *
010     * Unless required by applicable law or agreed to in writing, software
011     * distributed under the License is distributed on an "AS IS" BASIS,
012     * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND,
013     * either express or implied. See the License for the specific language
014     * governing permissions and limitations under the License.
015     */
016    package org.opengion.hayabusa.db;
017    
018    /**
019     * 繝??繧ｿ縺ｮ繧ｳ繝ｼ繝画ュ蝣ｱ繧貞叙繧頑桶縺??騾壹う繝ｳ繧ｿ繝ｼ繝輔ぉ繝ｼ繧ｹ縺ｧ縺吶?
020     *
021     * 繧ｳ繝ｼ繝峨?繧ｭ繝ｼ縺ｨ繝ｩ繝吶Ν縺ｮ諠??縺九ｉ縲？TML縺ｮ繝｡繝九Η繝ｼ繧?Μ繧ｹ繝医ｒ菴懈?縺吶ｋ縺溘ａ縺ｮ 繧ｪ繝励す繝ｧ繝ｳ
022     * 繧ｿ繧ｰ繧剃ｽ懈?縺励◆繧翫?荳弱∴繧峨ｌ縺溘く繝ｼ繧偵ｂ縺ｨ縺ｫ縲√メ繧ｧ繝?け貂医∩縺ｮ繧ｪ繝励す繝ｧ繝ｳ繧ｿ繧ｰ繧剃ｽ懈?縺励◆繧?
023     * 縺励∪縺吶?
024     *
025     * @og.group 驕ｸ謚槭ョ繝ｼ繧ｿ蛻ｶ蠕｡
026     *
027     * @version  4.0
028     * @author   Kazuhiko Hasegawa
029     * @since    JDK5.0,
030     */
031    public interface Selection {
032            static final String NO_VALUE_OPTION = "<option value=\"\" ></option>" ;     // 3.5.5.7 (2004/05/10)
033    
034            /**
035             * 蛻晄悄蛟､縺碁∈謚樊ｸ医∩縺ｮ 驕ｸ謚櫁い(繧ｪ繝励す繝ｧ繝ｳ)繧定ｿ斐＠縺ｾ縺吶?
036             * 縺薙?繧ｪ繝励す繝ｧ繝ｳ縺ｯ縲∝ｼ墓焚縺ｮ蛟､繧貞?譛溷?縺ｨ縺吶ｋ繧ｪ繝励す繝ｧ繝ｳ繧ｿ繧ｰ繧定ｿ斐＠縺ｾ縺吶?
037             * 縺薙?繝｡繧ｽ繝?ラ縺ｧ縺ｯ縲√Λ繝吶Ν(遏ｭ)縺瑚ｨｭ螳壹＆繧後※縺?ｋ蝣ｴ蜷医〒繧ゅ?縺薙ｌ繧剃ｽｿ逕ｨ縺帙★縺ｫ蠢?★繝ｩ繝吶Ν(髟ｷ)繧剃ｽｿ逕ｨ縺励∪縺吶?
038             *
039             * @og.rev 3.6.0.6 (2004/10/22) 繧ｷ繝ｼ繧ｱ繝ｳ繧ｹ繧｢繧ｯ繧ｻ繧ｹ讖溯?繧呈欠螳壹☆繧?seqFlag 繧貞ｰ主?
040             *
041             * @param   selectValue  驕ｸ謚槭＆繧後※縺?ｋ蛟､
042             * @param   seqFlag  繧ｷ繝ｼ繧ｱ繝ｳ繧ｹ繧｢繧ｯ繧ｻ繧ｹ讖溯? [true:ON/false:OFF]
043             *
044             * @return  繧ｪ繝励す繝ｧ繝ｳ繧ｿ繧ｰ
045             */
046            String getOption( String selectValue,boolean seqFlag ) ;
047    
048            /**
049             * 蛻晄悄蛟､縺碁∈謚樊ｸ医∩縺ｮ 驕ｸ謚櫁い(繧ｪ繝励す繝ｧ繝ｳ)繧定ｿ斐＠縺ｾ縺吶?
050             * 縺薙?繧ｪ繝励す繝ｧ繝ｳ縺ｯ縲∝ｼ墓焚縺ｮ蛟､繧貞?譛溷?縺ｨ縺吶ｋ繧ｪ繝励す繝ｧ繝ｳ繧ｿ繧ｰ繧定ｿ斐＠縺ｾ縺吶?
051             * 縺薙?繝｡繧ｽ繝?ラ縺ｧ縺ｯ縲∝ｼ墓焚縺ｮuseShortLabel縺荊rue縺ｫ謖?ｮ壹＆繧後◆蝣ｴ蜷医↓縲√Λ繝吶Ν(遏ｭ)繧偵?繝ｼ繧ｹ縺ｨ縺励◆
052             * 繝??繝ｫ繝√ャ繝苓｡ｨ遉ｺ繧定｡後＞縺ｾ縺吶?
053             *
054             * @og.rev 5.1.3.0 (2010/02/01) 霑ｽ蜉?
055             *
056             * @param   selectValue  驕ｸ謚槭＆繧後※縺?ｋ蛟､
057             * @param   seqFlag  繧ｷ繝ｼ繧ｱ繝ｳ繧ｹ繧｢繧ｯ繧ｻ繧ｹ讖溯? [true:ON/false:OFF]
058             * @param   useShortLabel 繝ｩ繝吶Ν(遏ｭ)繧偵?繝ｼ繧ｹ縺ｨ縺励◆繧ｪ繝励す繝ｧ繝ｳ陦ｨ遉ｺ繧定｡後≧縺九←縺?°縲?
059             *
060             * @return  繧ｪ繝励す繝ｧ繝ｳ繧ｿ繧ｰ
061             */
062            String getOption( String selectValue,boolean seqFlag, boolean useShortLabel ) ;
063    
064            /**
065             * 驕ｸ謚櫁い(value)縺ｫ蟇ｾ縺吶ｋ繝ｩ繝吶Ν繧定ｿ斐＠縺ｾ縺吶?
066             * 驕ｸ謚櫁い(value)縺後?蟄伜惠縺励↑縺九▲縺溷?蜷医?縲?∈謚櫁い縺昴?繧ゅ?繧定ｿ斐＠縺ｾ縺吶?
067             * getValueLabel( XX ) 縺ｯ縲“etValueLabel( XX,false ) 縺ｨ蜷後§縺ｧ縺吶?
068             *
069             * @param   selectValue 驕ｸ謚櫁い縺ｮ蛟､
070             *
071             * @return  驕ｸ謚櫁い縺ｮ繝ｩ繝吶Ν
072             * @see     #getValueLabel( String,boolean )
073             */
074            String getValueLabel( String selectValue ) ;
075    
076            /**
077             * 驕ｸ謚櫁い(value)縺ｫ蟇ｾ縺吶ｋ繝ｩ繝吶Ν繧定ｿ斐＠縺ｾ縺吶?
078             * 驕ｸ謚櫁い(value)縺後?蟄伜惠縺励↑縺九▲縺溷?蜷医?縲?∈謚櫁い縺昴?繧ゅ?繧定ｿ斐＠縺ｾ縺吶?
079             * 縺薙?繝｡繧ｽ繝?ラ縺ｧ縺ｯ縲∫洒邵ｮ繝ｩ繝吶Ν繧定ｿ斐☆縺九←縺?°繧呈欠螳壹☆繧九ヵ繝ｩ繧ｰ繧呈欠螳壹＠縺ｾ縺吶?
080             * getValueLabel( XX,false ) 縺ｯ縲“etValueLabel( XX ) 縺ｨ蜷後§縺ｧ縺吶?
081             *
082             * @og.rev 4.0.0.0 (2005/11/30) 繧定ｿｽ蜉?
083             *
084             * @param       selectValue     驕ｸ謚櫁い縺ｮ蛟､
085             * @param       flag    遏ｭ邵ｮ繝ｩ繝吶Ν菴ｿ逕ｨ譛臥┌ [true:菴ｿ逕ｨ縺吶ｋ/false:縺励↑縺Ь
086             *
087             * @return  驕ｸ謚櫁い縺ｮ繝ｩ繝吶Ν
088             * @see     #getValueLabel( String )
089             */
090            String getValueLabel( String selectValue,boolean flag ) ;
091    
092            /**
093             * 蛻晄悄蛟､縺碁∈謚樊ｸ医∩縺ｮ 驕ｸ謚櫁い(繝ｩ繧ｸ繧ｪ繝懊ち繝ｳ)繧定ｿ斐＠縺ｾ縺吶?
094             * 縺薙?繝ｩ繧ｸ繧ｪ繝懊ち繝ｳ縺ｯ縲∝ｼ墓焚縺ｮ蛟､繧貞?譛溷?縺ｨ縺吶ｋ繝ｩ繧ｸ繧ｪ繝懊ち繝ｳ繧ｿ繧ｰ繧定ｿ斐＠縺ｾ縺吶?
095             *
096             * @og.rev 3.5.1.0 (2003/10/03) 譁ｰ隕丈ｽ懈?
097             * @og.rev 3.8.6.0 (2006/09/29) useLabel 螻樊? 霑ｽ蜉?
098             *
099             * @param   name  name螻樊?縺ｫ縺ｪ繧九く繝ｼ譁?ｭ怜?
100             * @param   selectValue  驕ｸ謚槭＆繧後※縺?ｋ蛟､
101             * @param   useLabel     繝ｩ繝吶Ν陦ｨ遉ｺ縺ｮ譛臥┌ [true:譛?false:辟｡]
102             *
103             * @return  繝ｩ繧ｸ繧ｪ繝懊ち繝ｳ繧ｿ繧ｰ
104             */
105            String getRadio( String name, String selectValue, boolean useLabel ) ;
106    
107            /**
108             * 驕ｸ謚櫁い(value)縺ｫ蟇ｾ縺吶ｋ繝ｩ繝吶Ν繧定ｿ斐＠縺ｾ縺吶?
109             * 驕ｸ謚櫁い(value)縺後?蟄伜惠縺励↑縺九▲縺溷?蜷医?縲?∈謚櫁い縺昴?繧ゅ?繧定ｿ斐＠縺ｾ縺吶?
110             *
111             * @og.rev 3.8.6.0 (2006/09/29) 譁ｰ隕丈ｽ懈?
112             *
113             * @param   selectValue 驕ｸ謚櫁い縺ｮ蛟､
114             *
115             * @return  驕ｸ謚櫁い縺ｮ繝ｩ繝吶Ν
116             */
117            String getRadioLabel( String selectValue ) ;
118    
119            /**
120             * 繝槭Ν繝√?繧ｭ繝ｼ繧ｻ繝ｬ繧ｯ繝医ｒ菴ｿ逕ｨ縺吶ｋ縺九←縺?°繧定ｿ斐＠縺ｾ縺吶?
121             * true?壻ｽｿ逕ｨ縺吶ｋ縲Ｇalse:菴ｿ逕ｨ縺励↑縺?縺ｧ縺吶?
122             * 縺溘□縺励?螳滄圀縺ｫ菴ｿ逕ｨ縺吶ｋ縺九←縺?°縺ｯ縲？TML蜃ｺ蜉帶凾縺ｫ豎ｺ繧√ｋ縺薙→縺悟?譚･縺ｾ縺吶?
123             * 縺薙％縺ｧ縺ｯ縲ゞSE_MULTI_KEY_SELECT 縺?true 縺ｧ縲ゞSE_SIZE(=20)莉･荳翫?蝣ｴ蜷医↓
124             * true 繧定ｿ斐＠縺ｾ縺吶?
125             *
126             * @og.rev 3.5.5.7 (2004/05/10) 譁ｰ隕丈ｽ懈?
127             *
128             * @return  驕ｸ謚槭Μ繧ｹ繝医〒縲√?繝ｫ繝√?繧ｭ繝ｼ繧ｻ繝ｬ繧ｯ繝医ｒ菴ｿ逕ｨ縺吶ｋ縺九←縺?°(true:菴ｿ逕ｨ縺吶ｋ)
129             */
130            boolean useMultiSelect() ;
131    
132            /**
133             * 繧ｪ繝悶ず繧ｧ繧ｯ繝医?繧ｭ繝｣繝?す繝･縺梧凾髢灘?繧後°縺ｩ縺?°繧定ｿ斐＠縺ｾ縺吶?
134             * 繧ｭ繝｣繝?す繝･縺梧凾髢灘?繧?辟｡蜉ｹ)縺ｧ縺ゅｌ縺ｰ縲》rue 繧偵?譛牙柑縺ｧ縺ゅｌ縺ｰ縲?
135             * false 繧定ｿ斐＠縺ｾ縺吶?
136             *
137             * @og.rev 4.0.0.0 (2005/01/31) 譁ｰ隕丈ｽ懈?
138             *
139             * @return  繧ｭ繝｣繝?す繝･縺梧凾髢灘?繧後↑繧?true
140             */
141            boolean isTimeOver() ;
142    }