ScaleTransform 클래스

참조

정의

네임스페이스:: Windows.UI.Xaml.Media

중요

일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.

편집

2차원 x-y 좌표계의 개체 크기를 조정합니다.

UWP에 해당하는 WinUI 2 API: Microsoft.UI.Xaml.Media.ScaleTransform(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조).

public ref class ScaleTransform sealed : Transform

/// [Windows.Foundation.Metadata.Activatable(65536, Windows.Foundation.UniversalApiContract)]
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class ScaleTransform final : Transform

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
class ScaleTransform final : Transform

[Windows.Foundation.Metadata.Activatable(65536, typeof(Windows.Foundation.UniversalApiContract))]
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class ScaleTransform : Transform

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
public sealed class ScaleTransform : Transform

Public NotInheritable Class ScaleTransform
Inherits Transform

<ScaleTransform .../>

상속: Object IInspectable DependencyObject GeneralTransform Transform ScaleTransform

특성: ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Windows 요구 사항

디바이스 패밀리	Windows 10 (10.0.10240.0에서 도입되었습니다.)
API contract	Windows.Foundation.UniversalApiContract (v1.0에서 도입되었습니다.)

예제

이 XAML 예제에서는 ScaleTransform을 사용하여 원래 크기에서 텍스트의 크기를 조정합니다.

<StackPanel>
    <TextBlock FontFamily="Verdana"
               FontSize="32"
               FontWeight="Bold" 
               Foreground="SteelBlue"
               Text="Scaled Text" />

    <!-- Scale the text width using a ScaleTransform. -->
    <TextBlock FontFamily="Verdana"
               FontSize="32"
               FontWeight="Bold"
               Foreground="SteelBlue"
               Text="Scaled Text">
        <TextBlock.RenderTransform>
            <ScaleTransform ScaleX="1.5" ScaleY="1.0" />
        </TextBlock.RenderTransform>
    </TextBlock>

    <!-- Scale the text height using a ScaleTransform. -->
    <TextBlock FontFamily="Verdana"
               FontSize="32"
               FontWeight="Bold" 
               Foreground="SteelBlue"
               Text="Scaled Text">
        <TextBlock.RenderTransform>
            <ScaleTransform ScaleX="1.0" ScaleY="2.0" />
        </TextBlock.RenderTransform>
    </TextBlock>
</StackPanel>

변환이 적용된 후 텍스트는 다음과 같습니다.

배율 변환이 적용된 텍스트

이 예제에서는 런타임에 코드에서 변환에 액세스하고 수정하는 방법을 보여줍니다. 사각형을 누를 때마다 배율도 증가합니다.

<StackPanel>
  <Rectangle PointerPressed="HandlePointerPressed"
    Width="50" Height="50" Fill="RoyalBlue">
    <Rectangle.RenderTransform>

      <!-- If you give the transform a name you can 
        access it easily from code. -->
      <ScaleTransform x:Name="myScaleTransform" />
    </Rectangle.RenderTransform>
  </Rectangle>
</StackPanel>

private void HandlePointerPressed(object sender, PointerRoutedEventArgs e)
{
    // Increase ScaleX and ScaleY by 25%.
    myScaleTransform.ScaleX = myScaleTransform.ScaleX * 1.25;
    myScaleTransform.ScaleY = myScaleTransform.ScaleY * 1.25;
}

Private Sub HandlePointerPressed(ByVal sender As Object, ByVal e As PointerRoutedEventArgs)
    ' Increase ScaleX and ScaleY by 25%.
    myScaleTransform.ScaleX = (myScaleTransform.ScaleX * 1.25)
    myScaleTransform.ScaleY = (myScaleTransform.ScaleY * 1.25)
End Sub

생성자

ScaleTransform()

ScaleTransform 클래스의 새 인스턴스를 초기화합니다.

속성

CenterX	이 ScaleTransform의 중심점의 x 좌표를 가져오거나 설정합니다. UWP에 해당하는 WinUI 2 API: Microsoft.UI.Xaml.Media.ScaleTransform.CenterX(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조).
CenterXProperty	CenterX 종속성 속성을 나타냅니다. UWP에 해당하는 WinUI 2 API: Microsoft.UI.Xaml.Media.ScaleTransform.CenterXProperty(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조).
CenterY	이 ScaleTransform 중심점의 y 좌표를 가져오거나 설정합니다. UWP에 해당하는 WinUI 2 API: Microsoft.UI.Xaml.Media.ScaleTransform.CenterY(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조).
CenterYProperty	CenterY 종속성 속성을 나타냅니다. UWP에 해당하는 WinUI 2 API: Microsoft.UI.Xaml.Media.ScaleTransform.CenterYProperty(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조).
Dispatcher	이 개체가 CoreDispatcher 연결된 개체를 가져옵니다. 코드 CoreDispatcher 가 비 UI 스레드에서 시작되는 경우에도 UI 스레드에 액세스할 DependencyObject 수 있는 기능을 나타냅니다. UWP에 해당하는 WinUI 2 API: Microsoft.UI.Xaml.DependencyObject.Dispatcher(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조). (다음에서 상속됨 DependencyObject)
Inverse	가능한 경우 이 GeneralTransform의 역변환을 가져옵니다. (다음에서 상속됨 GeneralTransform)
InverseCore	파생 또는 사용자 지정의 Inverse 반환 값에 대한 동작을 구현합니다 GeneralTransform. (다음에서 상속됨 GeneralTransform)
ScaleX	x-축 배율을 가져오거나 설정합니다. UWP에 해당하는 WinUI 2 API: Microsoft.UI.Xaml.Media.ScaleTransform.ScaleX(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조).
ScaleXProperty	ScaleX 종속성 속성을 나타냅니다. UWP에 해당하는 WinUI 2 API: Microsoft.UI.Xaml.Media.ScaleTransform.ScaleXProperty(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조).
ScaleY	y-축 배율 요소를 가져오거나 설정합니다. UWP에 해당하는 WinUI 2 API: Microsoft.UI.Xaml.Media.ScaleTransform.ScaleY(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조).
ScaleYProperty	ScaleY 종속성 속성을 나타냅니다. UWP에 해당하는 WinUI 2 API: Microsoft.UI.Xaml.Media.ScaleTransform.ScaleYProperty(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조).

메서드

ClearValue(DependencyProperty)	종속성 속성의 로컬 값을 지웁니다. UWP에 해당하는 WinUI 2 API: Microsoft.UI.Xaml.DependencyObject.ClearValue(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조). (다음에서 상속됨 DependencyObject)
GetAnimationBaseValue(DependencyProperty)	애니메이션이 활성화되지 않은 경우에 적용되는 종속성 속성에 대해 설정된 기본 값을 반환합니다. UWP에 해당하는 WinUI 2 API: Microsoft.UI.Xaml.DependencyObject.GetAnimationBaseValue(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조). (다음에서 상속됨 DependencyObject)
GetValue(DependencyProperty)	에서 종속성 속성 DependencyObject의 현재 유효 값을 반환합니다. UWP에 해당하는 WinUI 2 API: Microsoft.UI.Xaml.DependencyObject.GetValue(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조). (다음에서 상속됨 DependencyObject)
ReadLocalValue(DependencyProperty)	로컬 값이 설정된 경우 종속성 속성의 로컬 값을 반환합니다. UWP에 해당하는 WinUI 2 API: Microsoft.UI.Xaml.DependencyObject.ReadLocalValue(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조). (다음에서 상속됨 DependencyObject)
RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback)	이 DependencyObject 인스턴스의 특정 DependencyProperty 변경 내용을 수신 대기하기 위한 알림 함수를 등록합니다. UWP에 해당하는 WinUI 2 API: Microsoft.UI.Xaml.DependencyObject.RegisterPropertyChangedCallback(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조). (다음에서 상속됨 DependencyObject)
SetValue(DependencyProperty, Object)	에 종속성 속성 DependencyObject의 로컬 값을 설정합니다. UWP에 해당하는 WinUI 2 API: Microsoft.UI.Xaml.DependencyObject.SetValue(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조). (다음에서 상속됨 DependencyObject)
TransformBounds(Rect)	지정한 경계 상자를 변환한 다음 해당 경계 상자를 포함할 수 있는 크기의 축에 맞춰진 경계 상자를 반환합니다. (다음에서 상속됨 GeneralTransform)
TransformBoundsCore(Rect)	파생 변환 클래스의 동작을 재정의 TransformBounds 하는 방법을 제공합니다. (다음에서 상속됨 GeneralTransform)
TransformPoint(Point)	이 변환 개체의 논리를 사용하여 지정된 지점을 변환하고 결과를 반환합니다. (다음에서 상속됨 GeneralTransform)
TryTransform(Point, Point)	지정한 점의 변환을 시도한 후 변환의 성공 여부를 나타내는 값을 반환합니다. (다음에서 상속됨 GeneralTransform)
TryTransformCore(Point, Point)	파생 변환 클래스의 동작을 재정의 TryTransform 하는 방법을 제공합니다. (다음에서 상속됨 GeneralTransform)
UnregisterPropertyChangedCallback(DependencyProperty, Int64)	를 호출 RegisterPropertyChangedCallback하여 이전에 등록한 변경 알림을 취소합니다. UWP에 해당하는 WinUI 2 API: Microsoft.UI.Xaml.DependencyObject.UnregisterPropertyChangedCallback(Windows 앱 SDK WinUI의 경우 Windows 앱 SDK 네임스페이스 참조). (다음에서 상속됨 DependencyObject)

적용 대상

ScaleTransform 클래스

정의

Windows 요구 사항

예제

생성자

속성

메서드

적용 대상

추가 정보

피드백