FrameworkElement.Height FrameworkElement.Height FrameworkElement.Height FrameworkElement.Height Property

정의

제안된 요소 높이를 가져오거나 설정합니다.Gets or sets the suggested height of the element.

public:
 property double Height { double get(); void set(double value); };
[System.ComponentModel.TypeConverter(typeof(System.Windows.LengthConverter))]
[System.Windows.Localizability(System.Windows.LocalizationCategory.None, Readability=System.Windows.Readability.Unreadable)]
public double Height { get; set; }
member this.Height : double with get, set
Public Property Height As Double

속성 값

요소의 높이(디바이스 독립적 단위(단위당 1/96인치)device-independent units (1/96th inch per unit))입니다.The height of the element, in 디바이스 독립적 단위(단위당 1/96인치)device-independent units (1/96th inch per unit). 기본값은 NaN입니다.The default value is NaN. 이 값은 0.0보다 크거나 같아야 합니다.This value must be equal to or greater than 0.0.

설명

Height 쓰기 가능한 세 가지 속성 중 하나인 FrameworkElement 높이 정보를 지정 하는 합니다.Height is one of three writable properties on FrameworkElement that specify height information. 다른 두 가지 MinHeightMaxHeight입니다.The other two are MinHeight and MaxHeight. 간에 충돌이 발생 하는 경우 이러한 값을 실제 높이 결정에 대 한 애플리케이션의 순서는 첫 번째 MinHeight 다음을 적용할 수 해야 MaxHeight, 마지막으로, 범위 안에 있으면 Height합니다.If there is a conflict between these values, the order of application for actual height determination is that first MinHeight must be honored, then MaxHeight, and finally, if it is within bounds, Height.

이 요소가 다른 요소 내에서 자식 요소 이면이 속성 값으로 설정한 실제로 제안 된 값입니다.If this element is a child element within some other element, then setting this property to a value is really only a suggested value. 레이아웃 시스템 뿐만 아니라 부모 요소의 특정 레이아웃 논리 값 입력으로 사용 된 바인딩이 아닌 레이아웃 과정입니다.The layout system as well as the particular layout logic of the parent element will use the value as a nonbinding input during the layout process. 실질적으로 FrameworkElement 는 거의 항상 다른; 자식 요소가 설정 하는 경우에 합니다 Height 에서 Window합니다.In practical terms, a FrameworkElement is almost always the child element of something else; even when you set the Height on Window. (에 대 한 Window, 애플리케이션을 호스트 하는 값이 기본 애플리케이션 모델의 기본 렌더링 가정은 Hwnd를 만드는 하는 경우 사용 됩니다.)(For Window, that value is used when the underlying application model establishes the basic rendering assumptions that create the Hwnd that hosts the application.)

또한 허용 가능한 Double 값이이 속성 일 수도 있습니다 Double.NaN합니다.In addition to acceptable Double values, this property can also be Double.NaN. 코드에서 자동 크기 조정 동작을 지정 하는 방법입니다.This is how you specify auto sizing behavior in code. XAMLXAML 는 값을 설정 하면 문자열 "Auto" (대/소문자 구분) 자동 크기 조정 동작을 사용 하도록 설정 합니다.In XAMLXAML you set the value to the string "Auto" (case insensitive) to enable the auto sizing behavior. 자동 크기 조정 동작 요소를 사용할 수 있는 높이 맞게 채워짐을 나타냅니다.Auto sizing behavior implies that the element will fill the height available to it. 그러나 특정 컨트롤 크기 조정 동작은 특히 다시 사용 하도록 설정 하지 않은 자동 사용 하지 않도록 설정 됩니다는 기본 테마 스타일을 통해 기본 값 제공 하는 자주 note 합니다.Note however that specific controls frequently supply default values through their default theme styles that will disable the auto sizing behavior unless it is specifically re-enabled.

이 속성의 반환 값에 설정 된 값과 항상 동일 합니다.The return value of this property is always the same as any value that was set to it. 반대로, 값은 ActualHeight 다를 수 있습니다.In contrast, the value of the ActualHeight may vary. 이 발생할 수 있습니다 하거나 정적으로 몇 가지 이유로 권장 되는 크기를 거부 하는 레이아웃 또는 일시적으로 합니다.This can happen either statically because the layout rejected the suggested size for some reason, or momentarily. 속성 시스템의 집합을 기준으로 레이아웃 시스템 자체적으로 비동기적으로 작동 Height 한 특정 크기 조정 속성 변경 내용을 아직 처리 되지 않을 수 있습니다.The layout system itself works asynchronously relative to the property system's set of Height and may not have processed that particular sizing property change yet.

에 대 한 값 제한 합니다 Double 값에 의해 적용 되는 ValidateValueCallback 메커니즘입니다.The value restrictions on the Double value are enforced by a ValidateValueCallback mechanism. 잘못 된 값을 설정 하려고 하면 런타임 예외가 throw 됩니다.If you attempt to set an invalid value, a run-time exception is thrown.

유효성 검사 외에도 비결 정적 상한 값에 바인딩된 Height 레이아웃 시스템에 적용 되는 (이 매우 큰 숫자로 보다 큰 Single.MaxValue 하지만 미만의 Double.MaxValue).In addition to the validation check, there is a nondeterministic upper value bound for Height that is enforced by the layout system (this is a very large number, larger than Single.MaxValue but smaller than Double.MaxValue). 이 경계를 초과 하는 경우 요소는 렌더링 되지 않으며, 예외가 throw 되지 않습니다.If you exceed this bound, the element will not render, and no exception is thrown. 설정 하지 않으면 Height 비결 정적 상한 값이 초과 가능한 시각적 표시, 또는 사용자의 최대 크기 보다 훨씬 큰 값으로.Do not set Height to a value that is significantly larger than the maximum size of any possible visual display, or you may exceed this nondeterministic upper bound.

XAML 특성 사용XAML Attribute Usage

<object Height="double"/>  
- or -  
<object Height="qualifiedDouble"/>  
- or -  
<object Height="Auto"/>  

XAML 값XAML Values

doubledouble
Double

문자열 표현 된 Double 0.0 보다 크거나 같은 값입니다.String representation of a Double value equal to or greater than 0.0. 상한 정보에 대한 설명을 참조하세요.See Remarks for upper bound information. 이 값으로 해석 되는 디바이스 독립적 단위(1/96인치)device-independent unit (1/96th inch) 측정 합니다.This value is interpreted as a 디바이스 독립적 단위(1/96인치)device-independent unit (1/96th inch) measurement. 문자열 소수점이 하를 명시적으로 포함 되지 해야 합니다.Strings need not explicitly include decimal points. 예를 들어 값 1 허용 됩니다.For instance a value of 1 is acceptable.

qualifiedDoublequalifiedDouble
A 이중 단위 선언 문자열 중 하나에서 다음 위에서 설명한 대로 값: px, in, cm, pt합니다.A double value as described above, followed by one of the following unit declaration strings: px, in, cm, pt.

px (기본값) 디바이스 독립적 단위(단위당 1/96인치)device-independent units (1/96th inch per unit)px (default) is 디바이스 독립적 단위(단위당 1/96인치)device-independent units (1/96th inch per unit)

in 인치; 1에서 96px = =in is inches; 1in==96px

cm 센티미터; 1cm==(96/2.54) pxcm is centimeters; 1cm==(96/2.54) px

pt 포인트; 1pt==(96/72) pxpt is points; 1pt==(96/72) px

자동Auto
자동 크기 조정 동작을 사용 하도록 설정 합니다.Enables autosizing behavior. 설명 부분을 참조하세요.See Remarks.

종속성 속성 정보Dependency Property Information

식별자 필드Identifier field HeightProperty
메타 데이터 속성 설정 trueMetadata properties set to true AffectsMeasure

적용 대상

추가 정보