UIElement.ArrangeCore(Rect) UIElement.ArrangeCore(Rect) UIElement.ArrangeCore(Rect) UIElement.ArrangeCore(Rect) Method

Определение

Определяет шаблон для определения макета упорядочивания WPF уровня ядра.Defines the template for WPF core-level arrange layout definition.

protected:
 virtual void ArrangeCore(System::Windows::Rect finalRect);
protected virtual void ArrangeCore (System.Windows.Rect finalRect);
abstract member ArrangeCore : System.Windows.Rect -> unit
override this.ArrangeCore : System.Windows.Rect -> unit
Protected Overridable Sub ArrangeCore (finalRect As Rect)

Параметры

finalRect
Rect Rect Rect Rect

Итоговая область в родительском элементе, которую элемент должен использовать для размещения себя и своих дочерних элементов.The final area within the parent that element should use to arrange itself and its child elements.

Примеры

ArrangeCoreреализации должны вызывать базовую реализацию для возврата размера, затем вызывать Arrange метод каждого видимого дочернего элемента и согласовать размеры, возвращенные этими Arrange вызовами, с размером базовой реализации.ArrangeCore implementations should call the base implementation to return a size, then call the Arrange method of each visible child element, and reconcile the sizes returned by these Arrange calls with the size of the base implementation. Логика для аспекта ArrangeCore сверки реализации может быть различной в зависимости от характеристик макета элемента.The logic for the reconciliation aspect of a ArrangeCore implementation might vary, depending on the layout characteristics of your element. В следующем примере шаблона VisualChildren является гипотетическым свойством, которое элемент может определить для помощи в перечислении его содержимого. UIElement не определяет коллекции содержимого на этом уровне, архитектура на уровне платформы WPF откладывает поведение содержимого на производные элементы, такие как определенные элементы управления или базовые классы элементов управления.In the following example template, VisualChildren is a hypothetical property that your element might define to help enumerate its content; UIElement does not define content collections at this level, the WPF framework-level architecture defers content behavior to derived elements such as specific controls or control base classes.

protected override void ArrangeCore(Rect finalRect)
{
     //Call base, it will set offset and RenderBounds to the finalRect:
     base.ArrangeCore(finalRect);
     foreach (UIElement child in VisualChildren)
     {
         child.Arrange(new Rect(childX, childY, childWidth, childHeight));
     }
 }
Protected Overrides Sub ArrangeCore(ByVal finalRect As Rect)
     'Call base, it will set offset and RenderBounds to the finalRect:
     MyBase.ArrangeCore(finalRect)
     For Each child As UIElement In VisualChildren
         child.Arrange(New Rect(childX, childY, childWidth, childHeight))
     Next child
End Sub

Комментарии

Примечание

Переопределение этого метода уместно, только если вы наследуете на уровне ядра WPF и не используете систему макета уровня платформы WPF и FrameworkElement производный класс, так как FrameworkElement запечатывает ArrangeCore.Overriding this method is only appropriate if you are deriving at the WPF core-level, and you are not using the WPF framework-level layout system and FrameworkElement derived class, because FrameworkElement seals ArrangeCore. Если используется система макета уровня платформы WPF, то для поведения ArrangeOverrideкомпоновки макета, зависящего от класса, необходимо переопределить соответствующий метод.If you are using the WPF framework-level layout system, the appropriate method to override for class-specific layout arrange behavior is ArrangeOverride.

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

Если вы разрабатываете элементы на уровне ядра WPF, следует переопределить этот метод, чтобы предоставить элементу уровня ядра WPF уникальное поведение макета или для принятия правильных макетов о дочерних элементах элементов.If you are developing elements at the WPF core level,you should override this method to give your WPF core-level element a unique arrange layout behavior, or to make proper layout decisions about the child elements of your elements. Переопределение может быть необходимым, если эти дочерние элементы не распознаются из определенного шаблона, ItemCollectionтакого как.An override might be necessary if those child elements are not recognizable from a defined pattern such as an ItemCollection.

Родительский элемент должен вызывать зависящий Arrange(Rect) от класса для каждого дочернего элемента, в противном случае эти дочерние элементы не подготавливаются к просмотру.A parent element must call the class-specific Arrange(Rect) on each child element, otherwise those child elements are not rendered.

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