svnno****@sourc*****
svnno****@sourc*****
2009年 3月 18日 (水) 23:49:25 JST
Revision: 2906
http://svn.sourceforge.jp/view?root=jiemamy&view=rev&rev=2906
Author: daisuke_m
Date: 2009-03-18 23:49:25 +0900 (Wed, 18 Mar 2009)
Log Message:
-----------
javadoc
Modified Paths:
--------------
vesta/trunk/org.jiemamy.eclipse.ui/src/main/java/org/jiemamy/eclipse/editor/dialog/TypeOptionManager.java
-------------- next part --------------
Modified: vesta/trunk/org.jiemamy.eclipse.ui/src/main/java/org/jiemamy/eclipse/editor/dialog/TypeOptionManager.java
===================================================================
--- vesta/trunk/org.jiemamy.eclipse.ui/src/main/java/org/jiemamy/eclipse/editor/dialog/TypeOptionManager.java 2009-03-18 14:37:06 UTC (rev 2905)
+++ vesta/trunk/org.jiemamy.eclipse.ui/src/main/java/org/jiemamy/eclipse/editor/dialog/TypeOptionManager.java 2009-03-18 14:49:25 UTC (rev 2906)
@@ -37,32 +37,38 @@
import org.jiemamy.utils.LogMarker;
/**
- * TODO for daisuke
+ * データ型変更時における、オプションコントロール（サイズ・精度・位取り等）の再構築を担うクラス。
*
* @author daisuke
*/
public class TypeOptionManager {
+ private static Logger logger = LoggerFactory.getLogger(TypeOptionManager.class);
+
+ /** オプションコントロール描画対象の親 */
private final Composite composite;
+ /** コントロールの操作を検知するリスナ */
private final EditListener editListener;
+ /** サイズコントロール */
private Text txtColumnSize;
+ /** 精度コントロール */
private Text txtPrecision;
+ /** 位取りコントロール */
private Text txtScale;
+ /** タイムゾーンコントロール */
private Button chkWithTimezone;
- private static Logger logger = LoggerFactory.getLogger(TypeOptionManager.class);
-
/**
* インスタンスを生成する。
*
- * @param composite
- * @param editListener
+ * @param composite オプションコントロール描画対象の親
+ * @param editListener コントロールの操作を検知するリスナ
* @throws IllegalArgumentException 引数に{@code null}を与えた場合
*/
public TypeOptionManager(Composite composite, EditListener editListener) {
@@ -73,7 +79,7 @@
}
/**
- * TODO for daisuke
+ * オプションコントロールを全て破棄する。
*/
public void clearTypeOptionControl() {
Control[] children = composite.getChildren();
@@ -83,9 +89,11 @@
}
/**
- * TODO for daisuke
+ * データ型装飾アダプタに適したコントロールを生成する。
*
- * @param adapterClasses
+ * <p>元から存在したコントロールはすべて破棄される。</p>
+ *
+ * @param adapterClasses データ型装飾アダプタの集合
*/
public void createTypeOptionControl(Collection<Class<?>> adapterClasses) {
clearTypeOptionControl();
@@ -123,6 +131,9 @@
composite.redraw();
}
+ /**
+ * オプションコントロールをすべて無効にする。
+ */
public void disable() {
setEnabledIfAlive(txtColumnSize, false);
setEnabledIfAlive(txtPrecision, false);
@@ -130,6 +141,9 @@
setEnabledIfAlive(chkWithTimezone, false);
}
+ /**
+ * オプションコントロールをすべて有効にする。
+ */
public void enable() {
setEnabledIfAlive(txtColumnSize, true);
setEnabledIfAlive(txtPrecision, true);
@@ -138,10 +152,12 @@
}
/**
- * TODO for daisuke
+ * オプションコントロールが生きていれば、enableの値を設定する。
*
- * @param control
- * @param enabled
+ * <p>死んでいる（存在しない or 破棄済み）場合は何もしない。</p>
+ *
+ * @param control 対象コントロール
+ * @param enabled enableの値
*/
private void setEnabledIfAlive(Control control, boolean enabled) {
if (control != null && control.isDisposed() == false) {