Język

UIElement.MeasureCore(Size) Metoda

Definicja

Po zastąpieniu w klasie pochodnej zapewnia logikę pomiaru prawidłowego określania rozmiaru tego elementu, z uwzględnieniem rozmiaru dowolnej zawartości elementu podrzędnego.

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

Parametry

availableSize
Size

Dostępny rozmiar, który element nadrzędny może przydzielić dla elementu podrzędnego.

Zwraca

Żądany rozmiar tego elementu w układzie.

Przykłady

Typowe przesłonięcia tego przybliżonego MeasureCore wzorca (nie ma wbudowanej kolekcji o nazwie VisualChildren; VisualChildren jest symbolem zastępczym reprezentującym dowolną kolekcję podrzędną, którą utrzymuje element).

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
  • Należy wywołać Measure dla każdego elementu podrzędnego.

  • Ogólnie rzecz biorąc, implementacja powinna buforować informacje o pomiarze między wywołaniami MeasureCore metody i ArrangeCore w tym samym elemecie.

  • Wywoływanie implementacji bazowych MeasureCore elementu nie jest wymagane, ale może być odpowiednie, jeśli implementacja podstawowa zapewnia odpowiednią możliwość układu.

  • Wywołania elementu Measure podrzędnego powinny być przekazywane tak samo availableSize jak element nadrzędny lub podzbiór obszaru w zależności od typu układu obsługiwanego przez element nadrzędny. Na przykład prawidłowe byłoby usunięcie obszaru dla obramowania lub wypełnienia specyficznego dla elementu, paska przewijania lub kontrolki niestandardowej.

Uwagi

Częściej element pochodzi z FrameworkElement elementu, a nie UIElement. Jeśli pochodzisz z FrameworkElementmetody , należy pamiętać, że zastąpienie MeasureCoreFrameworkElement metody przy uszczelnieniu MeasureCore metody . W związku z tym zastąpisz MeasureCore tylko metodę zmiany właściwości miary układu, jeśli pochodzisz z UIElement za pomocą dziedziczenia, które nie zawiera FrameworkElement. Może to być przypadek, jeśli próbujesz utworzyć własną implementację na poziomie podstawowym WPF. W przeciwnym razie, jeśli pochodzisz z FrameworkElementklasy , szablon implementacji dla zachowania Miara jest implementacją FrameworkElement .MeasureOverride.

Element nadrzędny z elementami podrzędnymi musi wywoływać Measure dla każdego elementu podrzędnego, w przeciwnym razie te elementy podrzędne nie mają rozmiaru ani ułożonego i skutecznie znikną z układu.

Notatki dotyczące dziedziczenia

Implementacje muszą być w stanie przetworzyć podaną availableSize wartość, która jest nieskończona. Nieskończona wartość nie wskazuje żadnych żądanych ograniczeń i skutecznie odchyli wybór pomiaru do elementu nadrzędnego za pomocą cyklicznych wywołań miary.

Implementacje mogą uwzględniać wartość podaną availableSize jako ograniczenie miękkie. Element podrzędny może określać większy rozmiar, nawet jeśli inne aspekty kodu aplikacji były w stanie określić bieżący rzeczywisty rozmiar elementu nadrzędnego. Żądanie o dużym rozmiarze to konwencja wskazująca, że element podrzędny wykonuje zapytanie o to, czy element nadrzędny może obsługiwać przewijanie zawartości w regionie wyświetlania zawartości.

Dotyczy