FrameworkElement.HorizontalAlignment FrameworkElement.HorizontalAlignment FrameworkElement.HorizontalAlignment FrameworkElement.HorizontalAlignment Property


この要素が、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.


要素HeightWidth対しておよびプロパティが明示的に設定されている場合、これらの測定値の方がレイアウト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 .NETHorizontalAlignment 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 "既定" は、からFrameworkElement直接Label継承HorizontalAlignmentLeftれる場合でも、になります。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
メタデータプロパティがに設定されるtrueMetadata properties set to true AffectsArrange