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

Определение

При переопределении в производном классе предоставляет логику измерений для правильного определения размеров данного элемента, с учетом размера каждого из содержащихся в нем дочерних элементов.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

Параметры

availableSize
Size Size Size Size

Доступный размер, который может быть выделен родительским элементом для дочернего.The available size that the parent element can allocate for the child.

Возвраты

Желательный размер этого элемента в макете.The desired size of this element in layout.

Примеры

Типичный переопределение метода MeasureCore приблизительное шаблону (не встроенные коллекции с именем VisualChildren; VisualChildren заполнитель, который представляет ту коллекцию дочерних поддерживает данный элемент).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
  • Необходимо вызвать метод Measure для каждого дочернего элемента.You must call Measure on each child element.

  • Как правило, реализация должна кэшировать сведения измерения между MeasureCore и ArrangeCore вызовы методов в том же элементе.Generally, your implementation should cache measurement information between the MeasureCore and ArrangeCore method calls in the same element.

  • Вызов базовой реализацией MeasureCore не является обязательным, но может быть целесообразным, если базовая реализация обеспечивает возможность формирования нужного макета.Calling base implementations of MeasureCore is not required, but might be appropriate if the base implementation provides a desired layout capability.

  • Вызовы Measure на дочерние элементы должны передавать того же availableSize как родительский, или подмножество области, в зависимости от типа макета родительского элемента поддерживает.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. Например было бы допустимым, чтобы удалить область, для конкретного элемента границы или заполнение, полосы прокрутки или пользовательского элемента управления.For example, it would be valid to remove the area for an element-specific border or padding, a scrollbar, or a custom control.

Комментарии

Чаще всего для получения элемента из FrameworkElement вместо UIElement.It is more common to derive an element from FrameworkElement rather than UIElement. Если при наследовании от FrameworkElement, обратите внимание, что переопределение MeasureCore на FrameworkElement пломбы MeasureCore метод.If you are deriving from FrameworkElement, note that an override of MeasureCore on FrameworkElement seals the MeasureCore method. Таким образом, только переопределить MeasureCore как средство для изменения измерения характеристики разметки при наследовании от UIElement через наследование, который не поддерживает 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. Это может случиться, если вы пытаетесь создать собственную реализацию на WPFWPF уровня ядра.This might be the case if you are attempting to build your own implementation on the WPFWPF core-level. В противном случае, если при наследовании от FrameworkElement, то шаблон реализации мер поведение — FrameworkElement реализация.MeasureOverride.Otherwise, if you are deriving from FrameworkElement, then the implementation template for Measure behavior is the FrameworkElement implementation of .MeasureOverride.

Родительский элемент с дочерними элементами необходимо вызвать Measure на каждый дочерний элемент, в противном случае эти дочерние элементы не размера и не упорядочены и фактически исчезнут из макета.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.

Примечания для тех, кто наследует этот метод

Реализации должны поддерживать обработку значения для availableSize , бесконечна.Implementations must be able to process a value provided for availableSize that is infinite. Бесконечное значение означает отсутствие запрошенных ограничений и фактически перекладывает выбор измерений к родительскому элементу, через рекурсивных вызовов метода Measure.An infinite value indicates no requested constraints, and effectively defers measurement choice to the parent element, through recursive Measure calls.

Реализации могут учитывать значение availableSize быть гибкое ограничение.Implementations can consider the value provided for availableSize to be a soft constraint. Дочерний элемент может указать больший размер, даже если другие аспекты кода приложения были возможность определить текущий фактический размер родительского элемента.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. Запрос большого размера — это соглашение, указывающее, что дочерний элемент запрашивает, поддерживает ли родительский элемент прокрутки содержимого в пределах региона отображение содержимого.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.

Применяется к