UIElement.DesiredSize Properti
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
public:
property Size DesiredSize { Size get(); };
Size DesiredSize();
public Size DesiredSize { get; }
var size = uIElement.desiredSize;
Public ReadOnly Property DesiredSize As Size
Nilai Properti
Ukuran yang dihitung UIElement ini selama pengukuran lulus dari proses tata letak.
Contoh
Contoh ini mengkueri DesiredSize sebagai bagian dari iterasi anak untuk implementasi ArrangeOverride .
// Second arrange all children and return final size of panel
protected override Size ArrangeOverride(Size finalSize)
{
// Get the collection of children
UIElementCollection mychildren = Children;
// Get total number of children
int count = mychildren.Count;
// Arrange children
// We're only allowing 9 children in this panel. More children will get a 0x0 layout slot.
int i;
for (i = 0; i < 9; i++)
{
// Get (left, top) origin point for the element in the 3x3 block
Point cellOrigin = GetOrigin(i, 3, new Size(100, 100));
// Arrange child
// Get desired height and width. This will not be larger than 100x100 as set in MeasureOverride.
double dw = mychildren[i].DesiredSize.Width;
double dh = mychildren[i].DesiredSize.Height;
mychildren[i].Arrange(new Rect(cellOrigin.X, cellOrigin.Y, dw, dh));
}
// Give the remaining children a 0x0 layout slot
for (i = 9; i < count; i++)
{
mychildren[i].Arrange(new Rect(0, 0, 0, 0));
}
// Return final size of the panel
return new Size(300, 300);
}
'Second arrange all children and return final size of panel
Protected Overrides Function ArrangeOverride(ByVal finalSize As Size) As Size
'Get the collection of children
Dim mychildren As UIElementCollection = Children
'Get total number of children
Dim count As Integer = mychildren.Count
'Arrange children
'only allowing 9 children in this panel. More children will get a 0x0 layout slot.
Dim i As Integer
For i = 0 To 8
'Get (left, top) origin point for the element in the 3x3 block
Dim cellOrigin As Point = GetOrigin(i, 3, New Size(100, 100))
'Arrange child
'Get desired height and width. This will not be larger than 100x100 as set in MeasureOverride.
Dim dw As Double = mychildren(i).DesiredSize.Width
Dim dh As Double = mychildren(i).DesiredSize.Height
mychildren(i).Arrange(New Rect(cellOrigin.X, cellOrigin.Y, dw, dh))
Next
For i = 9 To count - 1
'Give the remaining children a 0x0 layout slot
mychildren(i).Arrange(New Rect(0, 0, 0, 0))
Next
'Return final size of the panel
Return New Size(300, 300)
End Function
'Calculate point origin of the Block you are in
Protected Function GetOrigin(ByVal blockNum As Integer, ByVal blocksPerRow As Integer, ByVal itemSize As Size) As Point
'Get row number (zero-based)
Dim row As Integer = CInt(Math.Floor(blockNum / blocksPerRow))
'Get column number (zero-based)
Dim column As Integer = blockNum - blocksPerRow * row
'Calculate origin
Dim origin As New Point(itemSize.Width * column, itemSize.Height * row)
Return origin
End Function
Keterangan
DesiredSize biasanya diperiksa sebagai salah satu faktor pengukuran saat Anda menerapkan penimpaan perilaku tata letak seperti ArrangeOverride atau MeasureOverride. Bergantung pada logika tata letak kontainer induk, DesiredSize mungkin sepenuhnya dihormati, batasan pada DesiredSize mungkin diterapkan, dan batasan tersebut mungkin juga mengubah karakteristik lain dari elemen induk atau elemen turunan. Misalnya, kontrol yang mendukung wilayah yang dapat digulir (tetapi memilih untuk tidak berasal dari kontrol yang sudah mengaktifkan wilayah yang dapat digulir) dapat membandingkan ukuran yang tersedia dengan DesiredSize. Kontrol kemudian dapat mengatur status internal yang mengaktifkan bilah gulir di UI untuk kontrol tersebut. Atau, DesiredSize dapat diabaikan dan elemen selalu mendapatkan tata letak yang berukuran dengan pertimbangan lain seperti memeriksa nilai properti terlampir.
DesiredSize tidak akan berisi nilai yang berguna kecuali setidaknya satu pass tata letak "Pengukuran" telah berjalan pada elemen .
DesiredSize benar-benar hanya ditujukan untuk digunakan ketika Anda menentukan metode penimpaan tata letak Anda sendiri. Jika Anda hanya tertarik pada ukuran elemen di UI aplikasi Anda pada durasi, maka Anda harus menggunakan properti ActualWidth dan ActualHeight sebagai gantinya. Anda mungkin memeriksa ukuran dengan cara ini jika elemen dipengaruhi oleh teknik tata letak dinamis seperti star ukuran sel Kisi. Mengandalkan nilai ActualWidth dan ActualHeight hanya dalam situasi yang pasti setelah tata letak berjalan: misalnya, dalam Peristiwa yang dimuat , atau dipicu oleh tindakan pengguna yang hanya dimungkinkan setelah UI dirender pada awalnya.
Berlaku untuk
Lihat juga
- ArrangeOverride(Size)
- MeasureOverride(Size)
- Arrange(Rect)
- <xref:Windows.UI.Xaml.UIElement.Measure(Windows.Foundation.Size)%0a>
- Measure(Size)