FrameworkElement.LayoutTransform FrameworkElement.LayoutTransform FrameworkElement.LayoutTransform FrameworkElement.LayoutTransform Property

정의

레이아웃을 수행할 때 이 요소에 적용해야 하는 그래픽 변환을 가져오거나 설정합니다.Gets or sets a graphics transformation that should apply to this element when layout is performed.

public:
 property System::Windows::Media::Transform ^ LayoutTransform { System::Windows::Media::Transform ^ get(); void set(System::Windows::Media::Transform ^ value); };
public System.Windows.Media.Transform LayoutTransform { get; set; }
member this.LayoutTransform : System.Windows.Media.Transform with get, set
Public Property LayoutTransform As Transform

속성 값

이 요소가 사용해야 하는 변환입니다.The transform this element should use. 기본값은 Identity입니다.The default is Identity.

예제

다음 예제에 적용 하는 방법을 보여 줍니다는 LayoutTransform 요소입니다.The following example shows how to apply a LayoutTransform to an element. 이 예에서는 인스턴스를 만듭니다 Button 부모 내에서 호스트 및 Grid합니다.The example creates an instance of Button and hosts it within a parent Grid. 또한 사용 하 여는 LayoutTransform 적용할 속성을 RotateTransformButton합니다.It also uses the LayoutTransform property to apply a RotateTransform to the Button.


Button^ btn2 = gcnew Button();
btn2->Background = Brushes::LightCoral;
btn2->Content = "RotateTransform";
btn2->LayoutTransform = gcnew RotateTransform(45, 25, 25);
Grid::SetRow(btn2, 0);
Grid::SetColumn(btn2, 1);
grid1->Children->Add(btn2);


Button btn2 = new Button();
btn2.Background = Brushes.LightCoral;
btn2.Content = "RotateTransform";
btn2.LayoutTransform = new RotateTransform(45, 25, 25);
Grid.SetRow(btn2, 0);
Grid.SetColumn(btn2, 1);
grid1.Children.Add(btn2);


Dim btn2 As New Button()
btn2.Background = Brushes.LightCoral
btn2.Content = "RotateTransform"
btn2.LayoutTransform = New RotateTransform(45, 25, 25)
Grid.SetRow(btn2, 0)
Grid.SetColumn(btn2, 1)
grid1.Children.Add(btn2)


<Button Grid.Row="0" Grid.Column="1" Background="LightCoral" Content="RotateTransform Applied">
  <Button.LayoutTransform>
    <RotateTransform CenterX="25" CenterY="25" Angle="45" />
  </Button.LayoutTransform>
</Button>

설명

와 달리 RenderTransform, LayoutTransform 레이아웃의 결과는 영향이 있습니다.In contrast to RenderTransform, LayoutTransform will affect results of layout.

변환 설정 크기 조정 및 회전의 강력한 기능을 제공 합니다.Setting a transform provides powerful capabilities of scaling and rotating. 그러나 LayoutTransform 무시 TranslateTransform 작업 합니다.However, LayoutTransform ignores TranslateTransform operations. 왜냐하면 자식 요소에 대 한 레이아웃 시스템 동작을 FrameworkElement 레이아웃에 확장 또는 회전 요소의 위치와 부모 요소의 좌표 시스템에 있는 오프셋을 자동으로 수정 합니다.This is because the layout system behavior for child elements of a FrameworkElement auto-corrects any offsets to the position of a scaled or rotated element into the layout and coordinate system of the parent element.

LayoutTransform 레이아웃 시스템 전체 패스를 필요 하지 않은 시나리오에서 호출 하면 애플리케이션 성능 저하 시킬 수 있습니다.LayoutTransform can lead to poor application performance if you invoke it in a scenario that does not require a full pass by the layout system. 적용 하는 경우를 LayoutTransformChildren 의 컬렉션을 Panel레이아웃 시스템에 의해 새로운 단계가 트리거하는, 및 모든 화면 트리거되고 되어 다시 정렬 개체가.When you apply a LayoutTransform to the Children collection of the Panel, it triggers a new pass by the layout system and forces all on-screen objects to be remeasured and rearranged. 전체 애플리케이션을 업데이트 하는 경우 UI(사용자 인터페이스)user interface (UI),이 기능은 수 있습니다 정확 하 게 해야 합니다.If you are updating the complete application UI(사용자 인터페이스)user interface (UI), this functionality might be exactly what you need. 그러나 전체 레이아웃 단계에 필요 하지 않은 경우 사용 하 여는 RenderTransform 속성 레이아웃 시스템을 호출 하지 않습니다 하 고, 되므로 일반적으로이 시나리오에 더 적합 합니다.However, if you do not need a full layout pass, use the RenderTransform property, which does not invoke the layout system, and therefore, is typically a better choice for this scenario.

예제 시나리오는 LayoutTransform 유용한 포함: 포커스를 편집 동작 등을 제공 (확대) 요소 크기를 조정 하는 가로에서 세로로 또는 반대로 메뉴 구성 요소 같은 요소를 회전 합니다.Example scenarios where LayoutTransform would be useful include: rotating elements such as menu components from horizontal to vertical or vice versa, scaling elements (zooming in) on focus, providing editing behavior, etc.

종속성 속성 정보Dependency Property Information

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

적용 대상

추가 정보