UIElement.Measure(Size) Metod

Definition

DesiredSize Uppdaterar en UIElement. Överordnade element anropar den här metoden från sina egna MeasureCore(Size) implementeringar för att skapa en rekursiv layoutuppdatering. Att anropa den här metoden utgör det första passet ("Mått"-passet) för en layoutuppdatering.

public:
 void Measure(System::Windows::Size availableSize);
public void Measure(System.Windows.Size availableSize);
member this.Measure : System.Windows.Size -> unit
Public Sub Measure (availableSize As Size)

Parametrar

availableSize
Size

Det tillgängliga utrymme som ett överordnat element kan allokera ett underordnat element. Ett underordnat element kan begära ett större utrymme än det som är tillgängligt. den angivna storleken kan anpassas om rullning är möjlig i innehållsmodellen för det aktuella elementet.

Kommentarer

Beräkningen av layoutplacering i Windows Presentation Foundation (WPF) består av ett Measure-anrop och ett Arrange-anrop. Under anropet Measure avgör ett element dess storlekskrav med hjälp av en availableSize indata. Under anropet Arrange slutförs elementstorleken.

availableSize kan vara valfritt tal från noll till oändligt. Element som deltar i layouten bör returnera det minimum Size som krävs för en viss availableSize.

När en layout först instansieras får den alltid ett Measure anrop före Arrange. Men efter det första layoutpasset kan det ta emot ett Arrange anrop utan ett Measure. Detta kan inträffa när en egenskap som endast Arrange påverkar ändras (till exempel justering) eller när den överordnade tar emot ett Arrange utan Measure. Ett Measure anrop ogiltigförklarar automatiskt ett Arrange anrop.

Layoutuppdateringar sker asynkront, så att huvudtråden inte väntar på alla möjliga layoutändringar. Att köra frågor mot ett element via kod bakom kontroll av egenskapsvärden kanske inte omedelbart återspeglar ändringar i egenskaper som interagerar med storleks- eller layoutegenskaperna ( Width egenskapen, till exempel).

Note

Layoutuppdateringar kan tvingas med hjälp UpdateLayout av metoden . Att anropa den här metoden är dock vanligtvis onödigt och kan orsaka dåliga prestanda.

Layoutsystemet behåller två separata köer med ogiltiga layouter, en för Measure och en för Arrange. Layoutkön sorteras baserat på ordningen på elementen i det visuella trädet i elementet som utför layouten. element högre upp i trädet finns överst i kön för att undvika redundanta layouter som orsakas av upprepade ändringar hos överordnade. Duplicerade poster tas automatiskt bort från kön och element tas automatiskt bort från kön om de redan är layout-verifierade.

När du uppdaterar layouten Measure töms kön först, följt av Arrange kön. Ett element i Arrange kön ordnas aldrig om det finns ett element i Measure kön.

Gäller för