UIElement.MeasureCore(Size) UIElement.MeasureCore(Size) UIElement.MeasureCore(Size) UIElement.MeasureCore(Size) Method

Definition

Stellt beim Überschreiben in einer abgeleiteten Klasse die Maßlogik für das ordnungsgemäße Festlegen der Größe dieses Elements bereit, wobei die Größe des Inhalts sämtlicher untergeordneter Elemente berücksichtigt wird.When overridden in a derived class, provides measurement logic for sizing this element properly, with consideration of the size of any child element content.

protected:
 virtual System::Windows::Size MeasureCore(System::Windows::Size availableSize);
protected virtual System.Windows.Size MeasureCore (System.Windows.Size availableSize);
abstract member MeasureCore : System.Windows.Size -> System.Windows.Size
override this.MeasureCore : System.Windows.Size -> System.Windows.Size
Protected Overridable Function MeasureCore (availableSize As Size) As Size

Parameter

availableSize
Size Size Size Size

Die verfügbare Größe, die das übergeordnete Element für das untergeordnete Element reservieren kann.The available size that the parent element can allocate for the child.

Gibt zurück

Die gewünschte Größe dieses Elements im Layout.The desired size of this element in layout.

Beispiele

Eine typische Überschreibung MeasureCore folgt diesem Muster ungefähre (es ist keine integrierte Auflistung aufgerufen VisualChildren; VisualChildren ist ein Platzhalter, der beliebige untergeordnete Auflistung darstellt, das-Element behält).A typical override of MeasureCore follows this approximate pattern (there is not a built-in collection called VisualChildren; VisualChildren is a placeholder that represents whatever child collection your element maintains).

protected override Size MeasureCore(Size availableSize)
{
    foreach (UIElement child in VisualChildren)
    {
        child.Measure(availableSize);
        // call some method on child that adjusts child size if needed
        _cache.StoreInfoAboutChild(child);
    }
    Size desired = CalculateBasedOnCache(_cache);
    return desired;
}
Protected Overrides Function MeasureCore(ByVal availableSize As Size) As Size
	For Each child As UIElement In VisualChildren
		child.Measure(availableSize)
		' call some method on child that adjusts child size if needed
		_cache.StoreInfoAboutChild(child)
	Next child
	Dim desired As Size = CalculateBasedOnCache(_cache)
	Return desired
End Function
  • Rufen Sie Measure für jedes untergeordnete Element.You must call Measure on each child element.

  • Im Allgemeinen sollte Ihre Implementierung Messung Informationen zwischen Zwischenspeichern der MeasureCore und ArrangeCore Methodenaufrufe in demselben Element.Generally, your implementation should cache measurement information between the MeasureCore and ArrangeCore method calls in the same element.

  • Aufrufen von Implementierungen der MeasureCore ist nicht erforderlich, aber möglicherweise angemessen, wenn die basisimplementierung eine gewünschte Layout-Funktion enthält.Calling base implementations of MeasureCore is not required, but might be appropriate if the base implementation provides a desired layout capability.

  • Aufrufe von Measure für untergeordnete Elemente sollten übergeben Sie entweder den gleichen availableSize als das übergeordnete Element oder eine Teilmenge des Bereichs, je nach Art des Layouts des übergeordneten Elements unterstützt.Calls to Measure on child elements should pass either the same availableSize as the parent, or a subset of the area, depending on the type of layout the parent element supports. Beispielsweise wäre es zulässig, die den Bereich ein Rahmen elementspezifischen oder Auffüllung einer Bildlaufleiste oder ein benutzerdefiniertes Steuerelement zu entfernen.For example, it would be valid to remove the area for an element-specific border or padding, a scrollbar, or a custom control.

Hinweise

Es ist eher üblich, dass ein Element aus abgeleitet FrameworkElement statt UIElement.It is more common to derive an element from FrameworkElement rather than UIElement. Wenn beim Ableiten von FrameworkElement, beachten Sie, dass eine Überschreibung der MeasureCore auf FrameworkElement Siegel der MeasureCore Methode.If you are deriving from FrameworkElement, note that an override of MeasureCore on FrameworkElement seals the MeasureCore method. Aus diesem Grund nur überschreiben MeasureCore als Mittel zum Layoutmerkmale-Measure zu ändern, wenn Sie eine Ableitung aus UIElement über eine Vererbung an, das nicht FrameworkElement.Therefore, you only override MeasureCore as a means to alter layout measure characteristics if you derive from UIElement through an inheritance that does not include FrameworkElement. Dies kann der Fall sein, wenn Sie versuchen, eine eigene Implementierung zu erstellen, auf die WPFWPF Kernebene.This might be the case if you are attempting to build your own implementation on the WPFWPF core-level. Andernfalls, wenn beim Ableiten von FrameworkElement, und klicken Sie dann die Implementierungsvorlage für die Measure-Verhalten ist das FrameworkElement Implementierung.MeasureOverride.Otherwise, if you are deriving from FrameworkElement, then the implementation template for Measure behavior is the FrameworkElement implementation of .MeasureOverride.

Ein übergeordnetes Element mit untergeordneten Elementen muss Aufrufen Measure für jedes untergeordnete Element ist, andernfalls diese untergeordneten Elemente nicht die Größe oder angeordnet und effektiv aus dem Layout entfernt wird.A parent element with child elements must call Measure on each child, otherwise these child elements are not sized or arranged and will effectively disappear from layout.

Hinweise für Vererber

Implementierungen müssen in der Lage, einen Wert, der zur Verarbeitung availableSize unendlich ist.Implementations must be able to process a value provided for availableSize that is infinite. Ein unendlichen Wert gibt keine Einschränkungen der angeforderten und effektiv verzögert Messung Wahl zum übergeordneten Element, über der rekursiven Aufrufe Measure.An infinite value indicates no requested constraints, and effectively defers measurement choice to the parent element, through recursive Measure calls.

Implementierungen können für angegeben Wert in Betracht ziehen availableSize eine weiche Einschränkung sein.Implementations can consider the value provided for availableSize to be a soft constraint. Das untergeordnete Element kann eine größere Größe angeben, auch wenn andere Aspekte der Anwendungscode die aktuelle tatsächliche Größe des übergeordneten Elements zu bestimmen.The child element might specify a larger size, even if other aspects of application code were able to determine the current actual size of the parent element. Die Größe-Anforderung ist eine Konvention, die angibt, dass das untergeordnete Element an, ob Ihr übergeordnetes Element Inhalt einen Bildlauf innerhalb einer Region Inhaltsanzeige unterstützen kann abgefragt wird.The large size request is a convention that indicates that the child element is querying whether your parent element can support content scrolling within a content display region.

Gilt für: