FrameworkElement.HorizontalAlignment プロパティ


この要素が、Panel またはアイテム コントロールのような親要素内に構成されるときに適用される水平方向の配置特性を取得または設定します。Gets or sets the horizontal alignment characteristics applied to this element when it is composed within a parent element, such as a panel or items control.

 property System::Windows::HorizontalAlignment HorizontalAlignment { System::Windows::HorizontalAlignment get(); void set(System::Windows::HorizontalAlignment value); };
public System.Windows.HorizontalAlignment HorizontalAlignment { get; set; }
member this.HorizontalAlignment : System.Windows.HorizontalAlignment with get, set
Public Property HorizontalAlignment As HorizontalAlignment



列挙体の値としての水平方向の配置設定。A horizontal alignment setting, as a value of the enumeration. 既定では、 Stretchです。The default is Stretch.


要素に対して Height および Width のプロパティが明示的に設定されている場合、これらの測定値はレイアウト中の方が高くなり、HorizontalAlignmentStretchに設定した場合の一般的な効果はキャンセルされます。When Height and Width properties are explicitly set on an element, these measurements take higher precedent during layout and will cancel the typical effects of setting HorizontalAlignment to Stretch.

HorizontalAlignment は、実際の依存関係プロパティに対する Microsoft .NETMicrosoft .NET プロパティアクセサーです。HorizontalAlignment is the Microsoft .NETMicrosoft .NET property accessor for what is in reality a dependency property. この特定の依存関係プロパティでは、サブクラス要素 (特にコントロール) では、明らかに "既定" 値が異なることがよくあります。This particular dependency property quite frequently has its apparent "default" value set differently in subclassed elements, particularly controls. これは通常、次の2つの方法のいずれかで発生します。依存関係プロパティは特定のサブクラスに再登録されますが、既定値を設定するために異なるメタデータを使用します。または、適用される既定のスタイルによって、その依存関係プロパティの値が異なるように設定されています。This generally occurs in one of two ways: the dependency property is re-registered to a particular subclass, but with different metadata for setting its defaults; or there is a default style being applied that sets that dependency property value differently. たとえば、Label コントロールの HorizontalAlignment の明らかな "既定" は、HorizontalAlignment から FrameworkElement直接継承され Label ている場合でも Leftされます。For example, the apparent "default" of HorizontalAlignment for a Label control will be Left, even though Label inherits HorizontalAlignment direct from FrameworkElement. これは、スタイルのコントロールテンプレート内で、Labelの既定のスタイルで値がリセットされたためです。This is because that value was reset within the default style of Label, within the style's control template.

Canvas は、レイアウトの作成時に HorizontalAlignment を使用しません。 Canvas は絶対配置に基づいているためです。Canvas does not use HorizontalAlignment when composing layout, because Canvas is based on absolute positioning.

Label または派生クラスによって継承される場合、Label この依存関係プロパティの既定値を Leftするように再定義します。When inherited by Label or derived classes, Label redefines the default value of this dependency property to be Left.

依存プロパティ情報Dependency Property Information

識別子フィールドIdentifier field HorizontalAlignmentProperty
メタデータプロパティが true に設定されるMetadata properties set to true AffectsArrange