FrameworkElement.LayoutTransform 屬性

定義

命名空間:

System.Windows

組件:

PresentationFramework.dll

取得或設定一個圖形轉換，當執行版面配置時，該轉換應該套用到這個元素。

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

屬性值

Transform

這個元素應該使用的變形。 預設值為 Identity。

範例

以下範例說明如何將 a LayoutTransform 套用到元素上。 範例建立一個 的 Button 實例，並將其置於父 Grid中。 它也利用該 LayoutTransform 性質將 a RotateTransform 套用到 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 將影響版面的結果。

設定轉換提供了強大的縮放與旋轉功能。 但 忽略 LayoutTransform 操作 TranslateTransform 。 這是因為 的 FrameworkElement 子元素的佈局系統行為會自動校正縮放或旋轉元素位置的偏移，並調整到父元素的佈局與座標系中。

LayoutTransform 若在不需要版面系統完整通過的情況下呼叫，可能會導致應用程式效能不佳。 當你對 Children 的集合Panel套用 a LayoutTransform 時，佈局系統會觸發新的一次掃描，並強制所有螢幕上的物件重新測量和重新排列。 如果你要更新完整的應用程式使用者介面（UI），這個功能可能正是你需要的。 不過，如果你不需要完整的版面通行證，可以使用 RenderTransform 這個屬性，因為它不會調用版面系統，因此通常在這種情況下會是更好的選擇。

有用的範例情境 LayoutTransform 包括：將選單元件從水平旋轉到垂直或反之，調整元素縮放（放大）聚焦、提供編輯行為等。

相依財產資訊

項目	價值
識別碼欄位	LayoutTransformProperty
元資料屬性設為 true	AffectsMeasure