- java.lang.Object
-
- javafx.scene.layout.Border
-
public final class Border extends Object
Region
のボーダー。 ボーダーは、リージョンのボーダーのレンダリングに必要な一連のデータ全体をカプセル化する不変のオブジェクトです。 このクラスは不変のため、複数の異なるリージョンで同じボーダーを自由に再使用できます。 リージョンのボーダーをスタイリングするCSSルールの詳細については、「JavaFX CSSリファレンス・ガイド」を参照してください。すべてのボーダーは
strokes
またはimages
、あるいはその両方で構成されます。 どちらのリストもnullにはなりませんが、一方または両方を空にできます。 レンダリング時に、イメージが指定されていないまたはイメージのロードに失敗した場合は、すべてのストロークが順番にレンダリングされます。 イメージが指定され、ロードに成功した場合は、ストロークは描画されませんが、ボーダーのinsets
およびoutsets
には影響します。ボーダーの
outsets
は、すべてのボーダーの描画および配置に対応するために必要なリージョンの描画領域の拡大を定義します。 これらのアウトセットは、このボーダーに指定されているBorderStroke
とBorderImage
の両方で定義されます。 アウトセットは厳密に負でない数値となります。getInsets()
は、すべてのボーダーの最も内側の端の定義に使用されます。 また、常に厳密に負でない数値となります。 リージョンは、Background
およびボーダーの枠、およびRegion's padding
を使用して、リージョンのinsets
を決定し、リージョンの子のコンテンツ領域を定義します。 ボーダーのアウトセット、背景のアウトセット、およびリージョンの幅と高さによって、リージョンの幾何学的境界が定義されます(layoutBounds
、boundsInLocal
およびboundsInParent
に順に影響します)。ボーダーは、イメージを持つリージョンをスキップする場合に最もよく使用され、多くの場合、9パッチ・スケーリング手法とともに使用されます。 そのような場合、ストロークされるボーダーを指定することもできますが、これは、なんらかの理由でイメージのロードに失敗した場合にのみ使用されます。
- 導入されたバージョン:
- JavaFX 8.0
-
-
コンストラクタのサマリー
コンストラクタ コンストラクタ 説明 Border(List<BorderStroke> strokes, List<BorderImage> images)
BorderStrokesおよびBorderImagesのリストを指定して、新しいBorderを作成します。Border(BorderImage... images)
BorderImagesの配列を指定して、新しいBorderを作成します。Border(BorderStroke... strokes)
BorderStrokesの配列を指定して、新しいBorderを作成します。Border(BorderStroke[] strokes, BorderImage[] images)
BorderStrokesとBorderImagesの配列を指定して、新しいBorderを作成します。
-
メソッドのサマリー
すべてのメソッド 静的メソッド インスタンス・メソッド 具象メソッド 修飾子と型 メソッド 説明 boolean
equals(Object o)
このオブジェクトと他のオブジェクトが等しいかどうかを示します。static List<CssMetaData<? extends Styleable,?>>
getClassCssMetaData()
List<BorderImage>
getImages()
このボーダーのストロークのかわりに使用するイメージをともに定義するBorderImageのリスト。Insets
getInsets()
枠は、リージョンの端から枠線の最も内側の端までの距離を定義します(その距離が負でない場合)。Insets
getOutsets()
枠線のアウトセットは、描画される枠線の最も外側の端を定義します。List<BorderStroke>
getStrokes()
このボーダーのストロークされる部分をともに定義するBorderStrokeのリスト。int
hashCode()
オブジェクトのハッシュ・コード値を返します。boolean
isEmpty()
ボーダーが空かどうかを取得します。
-
-
-
フィールドの詳細
-
EMPTY
public static final Border EMPTY
空のボーダーで、nullのかわりに使用するのに役立ちます。
-
-
コンストラクタの詳細
-
Border
public Border(BorderStroke... strokes)
BorderStrokesの配列を指定して、新しいBorderを作成します。 この配列はnullか、null値が含まれている可能性があります。 null値はすべて無視され、strokes
またはoutsets
またはinsets
には影響しません。- パラメータ:
strokes
- ストローク。 これはnullか、nullが含まれている可能性があります。 含まれているnullはすべてフィルタで除外され、ストロークの最終的なリストには含められません。 nullの配列は空のリストになります。 ストロークおよびイメージの両方が指定され、指定されたイメージのいずれかのロードに成功した場合は、ストロークは表示されません。 このように、イメージのロードに失敗した場合は、フォールバックとしてストロークを定義できます。
-
Border
public Border(BorderImage... images)
BorderImagesの配列を指定して、新しいBorderを作成します。 この配列はnullか、null値が含まれている可能性があります。 null値はすべて無視され、images
またはoutsets
またはinsets
には影響しません。- パラメータ:
images
- イメージ。 これはnullか、nullが含まれている可能性があります。 含まれているnullはすべてフィルタで除外され、イメージの最終的なリストには含められません。 nullの配列は空のリストになります。
-
Border
public Border(List<BorderStroke> strokes, List<BorderImage> images)
BorderStrokesおよびBorderImagesのリストを指定して、新しいBorderを作成します。 これらのリストはnullか、null値が含まれている可能性があります。 null値はすべて無視され、strokes
またはimages
、outsets
またはinsets
には影響しません。- パラメータ:
strokes
- ストローク。 これはnullか、nullが含まれている可能性があります。 含まれているnullはすべてフィルタで除外され、ストロークの最終的なリストには含められません。 nullの配列は空のリストになります。 ストロークおよびイメージの両方が指定され、指定されたイメージのいずれかのロードに成功した場合は、ストロークは表示されません。 このように、イメージのロードに失敗した場合は、フォールバックとしてストロークを定義できます。images
- イメージ。 これはnullか、nullが含まれている可能性があります。 含まれているnullはすべてフィルタで除外され、イメージの最終的なリストには含められません。 nullの配列は空のリストになります。
-
Border
public Border(BorderStroke[] strokes, BorderImage[] images)
BorderStrokesとBorderImagesの配列を指定して、新しいBorderを作成します。 これらの配列はnullか、null値が含まれている可能性があります。 null値はすべて無視され、strokes
またはimages
、outsets
またはinsets
には影響しません。- パラメータ:
strokes
- ストローク。 これはnullか、nullが含まれている可能性があります。 含まれているnullはすべてフィルタで除外され、ストロークの最終的なリストには含められません。 nullの配列は空のリストになります。 ストロークおよびイメージの両方が指定され、指定されたイメージのいずれかのロードに成功した場合は、ストロークは表示されません。 このように、イメージのロードに失敗した場合は、フォールバックとしてストロークを定義できます。images
- イメージ。 これはnullか、nullが含まれている可能性があります。 含まれているnullはすべてフィルタで除外され、イメージの最終的なリストには含められません。 nullの配列は空のリストになります。
-
-
メソッドの詳細
-
getClassCssMetaData
public static List<CssMetaData<? extends Styleable,?>> getClassCssMetaData()
- 戻り値:
- このクラスに関連付けられたCssMetaData。スーパークラスのCssMetaDataを含むことがあります。
-
getStrokes
public final List<BorderStroke> getStrokes()
このボーダーのストロークされる部分をともに定義するBorderStrokeのリスト。 このリストは変更不可能で、不変です。 nullにはなりません。 null要素は含まれません。- 戻り値:
- このBorderのストローク部分を一緒に定義するBorderStrokesのリスト
-
getImages
public final List<BorderImage> getImages()
このボーダーのストロークのかわりに使用するイメージをともに定義するBorderImageのリスト。 このリストが指定され、リスト内の1つ以上のイメージのロードに成功した場合は、指定されたstrokes
は描画されません。 このリストがnull、またはイメージのロードに失敗した場合は、指定されたstrokes
が描画されます。このリストは変更不可能で、不変です。 nullにはなりません。 null要素は含まれません。
- 戻り値:
- このBorderのストロークの代わりに使用するイメージを定義するBorderImagesのリスト
-
getOutsets
public final Insets getOutsets()
枠線のアウトセットは、描画される枠線の最も外側の端を定義します。 これらのアウトセットの値は厳密に負でない数値となります。- 戻り値:
- 境界のアウト・セットは、描画されるボーダーの最も外側のエッジを定義
-
getInsets
public final Insets getInsets()
枠は、リージョンの端から枠線の最も内側の端までの距離を定義します(その距離が負でない場合)。 これらのアウトセットの値は厳密に負でない数値となります。- 戻り値:
- インセットは、リージョンの端からボーダーの最も内側の端までの距離を定義
-
isEmpty
public final boolean isEmpty()
ボーダーが空かどうかを取得します。 ストロークまたはイメージがない場合は空になります。- 戻り値:
- ボーダーが空の場合はtrue、そうでない場合はfalse。
-
equals
public boolean equals(Object o)
このオブジェクトと他のオブジェクトが等しいかどうかを示します。equals
メソッドは、null以外のオブジェクト参照での同値関係を実装します。- 反射性(reflexive): null以外の参照値
x
について、x.equals(x)
はtrue
を返します。 - 対称性(symmetric): null以外の参照値
x
およびy
について、y.equals(x)
がtrue
を返す場合に限り、x.equals(y)
はtrue
を返します。 - 推移性(transitive): null以外の参照値
x
、y
、およびz
について、x.equals(y)
がtrue
を返し、y.equals(z)
がtrue
を返す場合、x.equals(z)
はtrue
を返します。 - 一貫性(consistent): null以外の参照値
x
およびy
について、x.equals(y)
の複数の呼出しは、このオブジェクトに対するequals
による比較で使われた情報が変更されていなければ、一貫してtrue
を返すか、一貫してfalse
を返します。 - null以外の参照値
x
について、x.equals(null)
はfalse
を返します。
Object
クラスのequals
メソッドは、もっとも比較しやすいオブジェクトの同値関係を実装します。つまり、null以外の参照値x
とy
について、このメソッドはx
とy
が同じオブジェクトを参照する(x == y
がtrue
)場合にだけtrue
を返します。通常、このメソッドをオーバーライドする場合は、
hashCode
メソッドを常にオーバーライドして、等価なオブジェクトは等価なハッシュ・コードを保持する必要があるというhashCode
メソッドの汎用規約に従う必要があることに留意してください。- オーバーライド:
equals
、クラス:Object
- パラメータ:
o
- 比較対象の参照オブジェクト。- 戻り値:
- このオブジェクトがobj引数と同じである場合は
true
、それ以外の場合はfalse
。 - 関連項目:
Object.hashCode()
、HashMap
- 反射性(reflexive): null以外の参照値
-
hashCode
public int hashCode()
オブジェクトのハッシュ・コード値を返します。 このメソッドは、HashMap
によって提供されるハッシュ表などの、ハッシュ表の利点のためにサポートされています。hashCode
の一般的な規則は次のとおりです。- Javaアプリケーションの実行中に同じオブジェクトに対して複数回呼び出された場合は常に、このオブジェクトに対する
equals
の比較で使用される情報が変更されていなければ、hashCode
メソッドは常に同じ整数を返す必要があります。 ただし、この整数は同じアプリケーションの実行ごとに同じである必要はありません。 equals(Object)
メソッドに従って2つのオブジェクトが等しい場合は、2つの各オブジェクトに対するhashCode
メソッドの呼出しによって同じ整数の結果が生成される必要があります。Object.equals(java.lang.Object)
メソッドに従って2つのオブジェクトが等しくない場合は、2つの各オブジェクトに対するhashCode
メソッドの呼出しによって異なる整数の結果が生成される必要はありません。 ただし、プログラマは、等しくないオブジェクトに対して異なる整数の結果を生成すると、ハッシュ表のパフォーマンスが向上する可能性があることに注意するようにしてください。
クラス
Object
によって定義されたhashCodeメソッドは、可能なかぎり、異なるオブジェクトに対して異なる整数を返します。 (hashCodeは、ある時点におけるオブジェクト・メモリー・アドレスの関数として実装されても実装されなくてもよい。)- オーバーライド:
hashCode
、クラス:Object
- 戻り値:
- このオブジェクトのハッシュ・コード値。
- 関連項目:
Object.equals(java.lang.Object)
,System.identityHashCode(java.lang.Object)
- Javaアプリケーションの実行中に同じオブジェクトに対して複数回呼び出された場合は常に、このオブジェクトに対する
-
-