다음을 통해 공유

FrameworkElement.ActualWidth 속성

  • 참조

정의

네임스페이스:
Microsoft.UI.Xaml
편집

FrameworkElement의 렌더링된 너비를 가져옵니다. 설명 부분을 참조하세요.

public:
 property double ActualWidth { double get(); };
double ActualWidth();
public double ActualWidth { get; }
var double = frameworkElement.actualWidth;
Public ReadOnly Property ActualWidth As Double

속성 값

Double

double

개체의 너비(픽셀)입니다. 기본값은 0입니다. 개체가 로드되지 않았고 UI를 렌더링하는 레이아웃 패스에 아직 관여하지 않은 경우 기본값이 발생할 수 있습니다.

설명

참고

ActualWidthProperty 지원 필드가 있지만 ActualWidth는 속성 변경 알림을 발생시키지 않으며 종속성 속성이 아닌 일반 CLR 속성으로 간주되어야 합니다.

ActualWidth는 계산된 속성입니다. 계산은 레이아웃 단계의 결과이며, 개체는 연속 레이아웃 부모의 논리에 따라 레이아웃 크기가 조정됩니다. 자세한 내용은 XAML을 사용하여 레이아웃 정의를 참조하세요.

ActualWidth는 레이아웃 시스템의 작업으로 인해 값에 대해 여러 또는 증분으로 보고된 변경 내용을 가질 수 있습니다. 레이아웃이 계속 반복되는 동안 값을 가져오면 레이아웃 시스템에서 자식 개체에 필요한 공간 측정값, 부모 개체의 제약 조건 등을 계산할 수 있습니다. 값은 실제 렌더링 패스를 기반으로 하므로 입력 변경의 기초가 될 수 있는 Width와 같은 속성의 설정된 값보다 약간 뒤쳐질 수 있습니다.

ElementName 바인딩을 위해 ActualWidth는 변경 시(비동기 및 런타임 계산 특성으로 인해) 업데이트를 게시하지 않습니다. ElementName 바인딩에 대한 바인딩 원본으로 ActualWidth를 사용하지 마세요. ActualWidth를 기반으로 업데이트가 필요한 시나리오가 있는 경우 SizeChanged 처리기를 사용합니다.

적용 대상

추가 정보