FrameworkElement.Width 속성

정의

의 너비 FrameworkElement를 가져오거나 설정합니다.

public:
 property double Width { double get(); void set(double value); };
double Width();

void Width(double value);
public double Width { get; set; }
var double = frameworkElement.width;
frameworkElement.width = double;
Public Property Width As Double
<frameworkElement Width="double"/>
-or-
<frameworkElement Width="Auto"/>

속성 값

Double

double

개체의 너비(픽셀)입니다. 기본값은 NaN입니다. 특수 NaN 값을 제외하고 이 값은 0보다 크거나 같아야 합니다.

예제

이 예제에서는 런타임에 만들어지고 해당 콘텐츠 및 기본 표시 속성(예: Height Width Background및 )의 초기화가 필요한 UI 요소의 간단한 속성 집합을 보여줍니다. (Background 은(는) 실제로 Control .로 정의 FrameworkElement되지 않은 속성입니다.

Button button2 = new Button();
button2.Height = 50;
button2.Width = 100;
button2.Background = new SolidColorBrush(Colors.Blue);
button2.Content = "Click Me";
Dim button2 As Button = New Button
button2.Height = 50
button2.Width = 100
button2.Background = New SolidColorBrush(Colors.Blue)
button2.Content = "Click Me"

설명

Width는 너비 정보를 지정하는 쓰기 가능한 세 가지 속성 FrameworkElement 중 하나입니다. 다른 두 가지는 다음과 같습니다 MinWidth MaxWidth. 이러한 값 간에 충돌이 있는 경우 실제 너비 결정에 대한 애플리케이션 순서는 먼저 MinWidth 적용되어야 하고, 그런 다음 MaxWidth, 마지막으로 범위 내에 있는 경우 Width를 적용해야 한다는 것입니다.

파생된 형식 중 FrameworkElement 몇 가지도 .에서 Shape파생됩니다. 모든 클래스가 Shape 모양 또는 Width를 사용하여 Height 모양을 지정하는 대신 점 집합을 정의할 수 있는 특정 속성을 사용하는 것은 아닙니다. 이 경우 A Height 또는 Width가 계산되지만 일반적으로 직접 설정되지는 않습니다.

사용자 지정 클래스는 클래스에 차원을 지정하는 데 더 의미 있는 속성이 있거나 Width보다 Height 더 의미 있는 속성을 가질 수 있는 비슷한 고려 사항이 있을 수 있습니다. Height 또는 Width는 멤버로 계속 사용할 수 있으며 설정할 수 있습니다.

또는 Width 속성이 Height 설정된 개체는 거의 항상 다른 부모의 자식 컬렉션에 있는 자식 개체이며 값으로 설정 Height 하거나 Width는 레이아웃 프로세스에 대해 제안된 값일 뿐입니다. 레이아웃 시스템뿐만 아니라 부모 클래스의 특정 레이아웃 논리는 레이아웃 프로세스 중에 값을 바인딩되지 않는 입력으로 사용하며, 레이아웃의 여러 참여 개체에 걸쳐 있는 이러한 동작을 클립, 크기 조정, 컨테이너 크기 조정 또는 이러한 동작의 일부 조합으로 사용해야 할 수 있습니다. 여백과 안쪽 여백은 사용 가능한 크기에도 영향을 줍니다. 자세한 내용은 맞춤, 여백 및 안쪽 여백을 참조하세요.

이 속성의 반환 값은 설정된 값과 항상 동일합니다. 반면 속성 값은 ActualWidth 다를 수 있습니다. 레이아웃이 제안된 크기를 거부했기 때문에 정적으로 또는 일시적으로 분산이 발생할 수 있습니다. 레이아웃 시스템 자체는 속성 시스템의 Width 집합을 기준으로 비동기적으로 작동하며 레이아웃 시스템에서 해당 크기 조정 속성이 아직 변경되지 않았을 수 있습니다.

Width에 대한 음수 값은 허용되지 않습니다.

또한 너비를 가능한 시각적 표시의 최대 크기보다 훨씬 큰 값으로 설정하지 마세요.

"Auto" 및 NaN

기본값 Height 과 Width는 NaN으로 표현되는 "Auto"입니다. XAML 태그에서 문자열 "Auto"를 사용하여 값을 NaN으로 설정할 수 있습니다.

참고

C#에서는 Double.NaN에서 NaN을 가져올 수 있습니다.

C++에서는 매크로 또는 std::numeric_limits<double>::quiet_NaN().를 사용하여 NaN을 NAN 가져올 수 있습니다.

연산자를 == 사용하여 NaN을 테스트하지 마세요.

C#에서 Double.IsNaN() 을 사용하여 NaN을 테스트합니다.

C++에서 isnan() 을 사용하여 NaN을 테스트합니다.

레이아웃 시스템은 "자동" 값을 해석하여 일반적으로 개체의 크기를 특정 픽셀 값이 아닌 레이아웃에서 사용 가능한 크기로 조정해야 임을 의미합니다.

적용 대상

추가 정보