FrameworkElement.ArrangeOverride(Size) Méthode

Définition

Espace de noms:

Microsoft.UI.Xaml

Fournit le comportement de la passe « Arranger » de la disposition. Les classes peuvent remplacer cette méthode pour définir leur propre comportement de passe « Arrange ».

protected:
 virtual Size ArrangeOverride(Size finalSize) = ArrangeOverride;

Size ArrangeOverride(Size const& finalSize);

protected virtual Size ArrangeOverride(Size finalSize);

function arrangeOverride(finalSize)

Protected Overridable Function ArrangeOverride (finalSize As Size) As Size

Paramètres

finalSize

Size

Zone finale dans le parent que cet objet doit utiliser pour s’organiser lui-même et ses enfants.

Retours

Size

Taille réelle utilisée après la disposition de l’élément.

Exemples

Cet exemple implémente ArrangeOverride pour personnaliser la logique de passe « Arranger » pour une implémentation de panneau personnalisé. Notez en particulier ces aspects du code :

• Itère sur les enfants.
• Pour chaque enfant, appelle Arrange, à l’aide d’un rect où Height et Width sont basés sur DesiredSize, et X et Y sont basés sur la logique propre au panneau.
• Retourne sa taille (dans ce cas, ce panneau simple renvoie une taille fixe plutôt qu’une taille calculée sur l’accumulation des mesures de valeur Rect organisées).

// 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);
}

Remarques

Cette méthode a une implémentation par défaut qui effectue la disposition intégrée pour la plupart des classes dérivées de FrameworkElement . ArrangeOverride fournit le comportement pour Arrange, chaque fois que Arrange est appelé par la logique de disposition interne ou le code de votre propre application, y compris les méthodes ArrangeOverride de vos propres classes pour d’autres classes. Si vous produisez un contrôle avec modèle, la logique ArrangeOverride définit la logique de disposition de passe « Arrange » spécifique de votre contrôle.

La conception générale de la façon dont les éléments passent par un processus de disposition lors de l’exécution de votre application est divisée en deux étapes : une passe « Mesure », puis une passe « Organiser ». Les auteurs de contrôles (ou les auteurs de panneaux) qui souhaitent personnaliser la passe « Arranger » du traitement de la disposition doivent remplacer ArrangeOverride. Le modèle d’implémentation doit appeler Arrange sur chaque objet enfant visible et passer la taille finale souhaitée pour chaque objet enfant en tant que paramètre finalRect . Si Arrange n’est pas appelé, l’objet enfant n’est pas rendu.

Plusieurs classes non scellées existantes fournissent des implémentations de substitution de cette méthode. Parmi les principaux, citons StackPanel et Grid. En règle générale, le comportement de ArrangeOverride produit un finalSize qui ne viole aucune valeur définie par l’utilisateur qui est placée sur le conteneur de disposition lui-même. Par exemple, finalSize n’est généralement pas plus grand que la hauteur et la largeur du conteneur, prenant en compte les valeurs Margin ou Padding qui affectent la zone de contenu. Les contrôles qui ont spécifiquement un scénario de dépassement de la taille du conteneur peuvent retourner une valeur plus élevée, mais toute personne utilisant ce contrôle doit tenir compte des problèmes de découpage et de positionnement qui en résultent. La valeur qu’une implémentation ArrangeOverride passe à Arrange pour chaque objet enfant est généralement la valeur définie dans DesiredSize par l’appel Measure précédent.

Voir aussi

• Arrange(Rect)
• MeasureOverride(Size)
• Définir des dispositions avec XAML