Přehled vykreslování grafiky WPF

Článek
12/17/2024

Toto téma obsahuje přehled vizuální vrstvy WPF. Zaměřuje se na roli třídy Visual pro podporu vykreslování v modelu WPF.

Role vizuálního objektu

Třída Visual je základní abstrakce, ze které je každý objekt FrameworkElement odvozen. Slouží také jako vstupní bod pro psaní nových ovládacích prvků ve WPF a v mnoha ohledech je považován za popisovač oken (HWND) v aplikačním modelu Win32.

Objekt Visual je základní objekt WPF, jehož primární rolí je poskytovat podporu vykreslování. Ovládací prvky uživatelského rozhraní, jako jsou Button a TextBox, jsou odvozeny od třídy Visual a používají je k zachování jejich vykreslovacích dat. Objekt Visual poskytuje podporu pro:

Zobrazení výstupu: Vykreslení trvalého serializovaného výkresového obsahu vizuálu
Transformace: Provádění transformací ve vizuálu
Výřez: Poskytování podpory pro definování oblastí výřezu vizuálu.
Testování hitů: Určení, zda je souřadnice nebo geometrie obsažena v mezích vizuálu.
Výpočty ohraničujícího rámečku: Určení ohraničujícího obdélníku vizuálu

Objekt Visual však nezahrnuje podporu pro funkce, které se nevykreslují, například:

Zpracování událostí
Rozložení
Styly
Datová vazba
Globalizace

Visual je vystavena jako veřejná abstraktní třída, ze které musí být odvozeny podřízené třídy. Následující obrázek znázorňuje hierarchii objektů vizuálů, které jsou vystaveny ve WPF.

diagram tříd odvozených z objektu Visual

třída DrawingVisual

DrawingVisual je jednoduchá třída výkresu, která slouží k vykreslení obrazců, obrázků nebo textu. Tato třída je považována za zjednodušenou, protože neposkytuje rozložení ani zpracování událostí, což zlepšuje výkon modulu runtime. Z tohoto důvodu jsou kresby ideální pro pozadí a klipart. DrawingVisual lze použít k vytvoření vlastního objektu vizuálu. Další informace naleznete v tématu Použití objektů DrawingVisual.

Třída Viewport3DVisual

Viewport3DVisual poskytuje most mezi 2D Visual a Visual3D objekty. Třída Visual3D je základní třídou pro všechny 3D vizuální prvky. Viewport3DVisual vyžaduje, abyste definovali hodnotu Camera a hodnotu Viewport. Kamera umožňuje zobrazit scénu. Oblast zobrazení určuje, kde se projekce mapuje na 2D povrch. Další informace o 3D ve WPF naleznete v Přehled 3D grafiky.

třída ContainerVisual

Třída ContainerVisual se používá jako kontejner pro kolekci objektů Visual. Třída DrawingVisual je odvozena z ContainerVisual třídy, což jí umožňuje obsahovat kolekci vizuálních objektů.

Kreslení obsahu ve vizuálních objektech

Objekt Visual ukládá data vykreslení jako instrukční seznam vektorové grafiky. Každá položka v seznamu instrukcí představuje sadu grafických dat nízké úrovně a přidružené prostředky v serializovaném formátu. Existují čtyři různé typy vykreslovaných dat, které můžou obsahovat obsah výkresu.

Typ obsahu výkresu	Popis
Vektorová grafika	Představuje vektorová grafická data a veškeré související informace Brush a Pen.
Obrázek	Představuje obrázek v rámci oblasti definované Rect.
Glyf	Představuje kresbu, která zobrazuje GlyphRun, což je posloupnost glyfů ze zadaného fontového zdroje. Takto je text reprezentován.
Video	Představuje výkres, který vykresluje video.

DrawingContext umožňuje naplnit Visual vizuálním obsahem. Když použijete příkazy kreslení objektu DrawingContext, ve skutečnosti ukládáte sadu vykreslovacích dat, která později využije grafický systém; nekreslíte na obrazovku v reálném čase.

Při vytváření ovládacího prvku WPF, například Button, ovládací prvek implicitně generuje vykreslovací data pro samotný výkres. Například nastavení Content vlastnosti Button způsobí, že ovládací prvek uloží vykreslení reprezentace glyfu.

Visual popisuje jeho obsah jako jeden nebo více Drawing objektů obsažených v DrawingGroup. DrawingGroup také popisuje neprůhledné masky, transformace, rastrové efekty a další operace použité na jeho obsah. DrawingGroup operace se použijí v následujícím pořadí při vykreslení obsahu: OpacityMask, Opacity, BitmapEffect, ClipGeometry, GuidelineSeta pak Transform.

Následující obrázek znázorňuje pořadí, ve kterém se během vykreslování použijí operace DrawingGroup.

DrawingGroup pořadí operací
Pořadí operací DrawingGroup

Další informace naleznete v tématu Přehled nakreslených objektů.

Kreslení obsahu ve vizuální vrstvě

Nikdy přímo nevytvoříte instanci DrawingContext; můžete však získat grafický kontext z určitých metod, jako jsou DrawingGroup.Open a DrawingVisual.RenderOpen. Následující příklad načte DrawingContext z DrawingVisual a použije ho k vykreslení obdélníku.

// Create a DrawingVisual that contains a rectangle.
private DrawingVisual CreateDrawingVisualRectangle()
{
    DrawingVisual drawingVisual = new DrawingVisual();

    // Retrieve the DrawingContext in order to create new drawing content.
    DrawingContext drawingContext = drawingVisual.RenderOpen();

    // Create a rectangle and draw it in the DrawingContext.
    Rect rect = new Rect(new System.Windows.Point(160, 100), new System.Windows.Size(320, 80));
    drawingContext.DrawRectangle(System.Windows.Media.Brushes.LightBlue, (System.Windows.Media.Pen)null, rect);

    // Persist the drawing content.
    drawingContext.Close();

    return drawingVisual;
}

' Create a DrawingVisual that contains a rectangle.
Private Function CreateDrawingVisualRectangle() As DrawingVisual
    Dim drawingVisual As New DrawingVisual()

    ' Retrieve the DrawingContext in order to create new drawing content.
    Dim drawingContext As DrawingContext = drawingVisual.RenderOpen()

    ' Create a rectangle and draw it in the DrawingContext.
    Dim rect As New Rect(New Point(160, 100), New Size(320, 80))
    drawingContext.DrawRectangle(Brushes.LightBlue, CType(Nothing, Pen), rect)

    ' Persist the drawing content.
    drawingContext.Close()

    Return drawingVisual
End Function

Vytvoření výčtu obsahu výkresu ve vizuální vrstvě

Kromě jejich jiných použití Drawing objekty také poskytují objektový model pro výčet obsahu Visual.

Poznámka

Při vytváření výčtu obsahu vizuálu načítáte Drawing objekty, nikoli podkladovou reprezentaci vykreslovaných dat jako seznam instrukcí vektorové grafiky.

Následující příklad používá metodu GetDrawing k získání hodnoty DrawingGroup z Visual a jejímu výčtu.

public void RetrieveDrawing(Visual v)
{
    DrawingGroup drawingGroup = VisualTreeHelper.GetDrawing(v);
    EnumDrawingGroup(drawingGroup);
}

// Enumerate the drawings in the DrawingGroup.
public void EnumDrawingGroup(DrawingGroup drawingGroup)
{
    DrawingCollection dc = drawingGroup.Children;

    // Enumerate the drawings in the DrawingCollection.
    foreach (Drawing drawing in dc)
    {
        // If the drawing is a DrawingGroup, call the function recursively.
        if (drawing is DrawingGroup group)
        {
            EnumDrawingGroup(group);
        }
        else if (drawing is GeometryDrawing)
        {
            // Perform action based on drawing type.
        }
        else if (drawing is ImageDrawing)
        {
            // Perform action based on drawing type.
        }
        else if (drawing is GlyphRunDrawing)
        {
            // Perform action based on drawing type.
        }
        else if (drawing is VideoDrawing)
        {
            // Perform action based on drawing type.
        }
    }
}

Způsob použití vizuálních objektů k sestavení ovládacích prvků

Mnoho objektů v WPF se skládá z jiných vizuálních objektů, což znamená, že mohou obsahovat různé hierarchie následnických objektů. Mnoho prvků uživatelského rozhraní ve WPF, jako jsou ovládací prvky, se skládají z více vizuálních objektů, které představují různé typy vykreslovacích prvků. Například ovládací prvek Button může obsahovat řadu dalších objektů, včetně ClassicBorderDecorator, ContentPresentera TextBlock.

Následující kód ukazuje Button ovládací prvek definovaný v kódu.

<Button Click="OnClick">OK</Button>

Pokud byste chtěli vytvořit výčet objektů vizuálů, které tvoří výchozí ovládací prvek Button, našli byste hierarchii objektů vizuálů znázorněnou níže:

diagram hierarchie vizuální stromové struktury

Ovládací prvek Button obsahuje prvek ClassicBorderDecorator, který zase obsahuje prvek ContentPresenter. Prvek ClassicBorderDecorator zodpovídá za vykreslení ohraničení a pozadí Button. Prvek ContentPresenter zodpovídá za zobrazení obsahu Button. V tomto případě, protože zobrazujete text, ContentPresenter element obsahuje prvek TextBlock. Skutečnost, že ovládací prvek Button používá ContentPresenter znamená, že obsah může být reprezentován jinými prvky, například Image nebo geometrií, například EllipseGeometry.

Šablony ovládacích prvků

Klíčem k rozšíření ovládacího prvku do hierarchie ovládacích prvků je ControlTemplate. Šablona ovládacího prvku určuje výchozí hierarchii vizuálů ovládacího prvku. Když explicitně odkazujete na ovládací prvek, implicitně odkazujete na jeho vizuální hierarchii. Výchozí hodnoty šablony ovládacího prvku můžete přepsat a vytvořit tak přizpůsobený vzhled vizuálu pro ovládací prvek. Můžete například upravit hodnotu barvy pozadí ovládacího prvku Button tak, aby místo hodnoty plné barvy používala lineární hodnotu barvy přechodu. Další informace najdete v tématu Styly tlačítek a šablony.

Prvek uživatelského rozhraní, například ovládací prvek Button, obsahuje několik seznamů instrukcí vektorové grafiky, které popisují celou definici vykreslování ovládacího prvku. Následující kód ukazuje ovládací prvek Button definovaný v značkovacím jazyce.

<Button Click="OnClick">
  <Image Source="images\greenlight.jpg"></Image>
</Button>

Pokud byste chtěli vytvořit výčet vizuálních objektů a seznamů instrukcí vektorové grafiky, které tvoří ovládací prvek Button, najdete hierarchii objektů znázorněnou níže:

Diagram vizuálního stromu a vykreslovacích dat

Ovládací prvek Button obsahuje prvek ClassicBorderDecorator, který zase obsahuje prvek ContentPresenter. Prvek ClassicBorderDecorator zodpovídá za vykreslení všech diskrétních grafických prvků, které tvoří ohraničení a pozadí tlačítka. Prvek ContentPresenter zodpovídá za zobrazení obsahu Button. V tomto případě, protože zobrazujete obrázek, ContentPresenter element obsahuje prvek Image.

Existuje několik bodů, které je potřeba poznamenat o hierarchii vizuálních objektů a seznamů instrukcí vektorové grafiky:

Pořadí v hierarchii představuje pořadí vykreslování informací výkresu. Z kořenového vizuálního prvku se podřízené prvky procházejí, zleva doprava, shora dolů. Pokud má prvek vizuální podřízené prvky, ty se procházejí před sourozenci prvku.
Ne-listové uzlové prvky v hierarchii, jako například ContentPresenter, se používají k obsahování podřízených prvků – neobsahují seznamy instrukcí.
Pokud vizuální prvek obsahuje seznam instrukcí vektorové grafiky i podřízené vizuály, seznam instrukcí v nadřazeném vizuálním prvku se vykresluje před výkresy v podřízených vizuálních objektech.
Položky v seznamu instrukcí vektorové grafiky se vykreslují zleva doprava.

Vizuální strom

Strom vizuálu obsahuje všechny vizuální prvky používané v uživatelském rozhraní aplikace. Vzhledem k tomu, že vizuální prvek obsahuje trvalé informace o výkresu, můžete si vizuální strom představit jako graf scény, který obsahuje všechny vykreslovací informace potřebné k vytvoření výstupu do zobrazovacího zařízení. Tento strom je shromáždění všech vizuálních prvků vytvořených přímo aplikací, ať už v kódu nebo ve značkách. Vizuální strom obsahuje také všechny vizuální prvky vytvořené rozšířením šablony prvků, jako jsou ovládací prvky a datové objekty.

Následující kód ukazuje prvek StackPanel definovaný ve značkovacím jazyce.

<StackPanel>
  <Label>User name:</Label>
  <TextBox />
  <Button Click="OnClick">OK</Button>
</StackPanel>

Pokud byste chtěli vytvořit výčet vizuálních objektů, které tvoří prvek StackPanel v příkladu revizí, našli byste hierarchii vizuálních objektů znázorněnou níže:

Diagram hierarchie vizuální stromové struktury ovládacího prvku StackPanel.

Pořadí vykreslování

Strom vizuálu určuje pořadí vykreslování vizuálů WPF a nakreslených objektů. Pořadí procházení začíná kořenovým vizuálem, což je nejvyšší uzel ve stromu vizuálu. Podřízené prvky kořenového vizuálu (potomci) se pak procházejí zleva doprava. Pokud má vizuální prvek podřízené položky, ty se procházejí před sourozenci vizuálního prvku. To znamená, že obsah podřízeného vizuálu se vykreslí před jeho vlastním obsahem.

diagram pořadí vykreslování vizuálního stromu

Kořenový vizuál

Kořenový vizuál je nejvyšší prvek v hierarchii vizuálního stromu. Ve většině aplikací je základní třída kořenového vizuálu buď Window, nebo NavigationWindow. Pokud byste však hostovali objekty vizuálů v aplikaci Win32, kořenový vizuál by byl nejvýraznější vizuál, který jste hostovali v okně Win32. Další informace naleznete v tématu Kurz: Hostování vizuálních objektů v aplikaci Win32.

Vztah k logickému stromu

Logický strom ve WPF představuje prvky aplikace za běhu. Přestože tímto stromem nemanipulujete přímo, toto zobrazení aplikace je užitečné pro pochopení dědičnosti vlastností a směrování událostí. Na rozdíl od vizuálního stromu může logický strom představovat objekty dat, které nejsou vizuální, například ListItem. V mnoha případech se logický strom velmi blízce mapuje na definice značek v aplikaci. Následující kód ukazuje DockPanel prvek definovaný v kódu.

<DockPanel>
  <ListBox>
    <ListBoxItem>Dog</ListBoxItem>
    <ListBoxItem>Cat</ListBoxItem>
    <ListBoxItem>Fish</ListBoxItem>
  </ListBox>
  <Button Click="OnClick">OK</Button>
</DockPanel>

Pokud byste chtěli vytvořit výčet logických objektů, které tvoří prvek DockPanel v příkladu revizí, našli byste hierarchii logických objektů znázorněnou níže:

stromový diagram
Diagram logického stromu

Vizuální strom i logický strom se synchronizují s aktuální sadou prvků aplikace, které odrážejí přidání, odstranění nebo úpravy prvků. Stromy ale představují různá zobrazení aplikace. Na rozdíl od vizuálního stromu, logický strom nerozbalí prvek ContentPresenter daného ovládacího prvku. To znamená, že neexistuje přímá korespondence 1:1 mezi logickým stromem a vizuálním stromem pro stejnou sadu objektů. Ve skutečnosti, vyvolání LogicalTreeHelper objektu GetChildren metoda a VisualTreeHelper objektu GetChild metoda pomocí stejného prvku jako parametr přináší odlišné výsledky.

Další informace o logickém stromu naleznete v tématu Stromy ve WPF.

Zobrazení vizuálního stromu pomocí XamlPadu

Nástroj WPF XamlPad poskytuje možnost zobrazení a zkoumání stromu vizuálu, který odpovídá aktuálně definovanému obsahu XAML. Kliknutím na tlačítko Zobrazit vizuální strom na nabídkové liště zobrazte vizuální strom. Následující příklad znázorňuje rozšíření obsahu XAML do uzlů vizuálního stromu v Prohlížeči vizuálního stromu XamlPad.

panel Průzkumníka vizuálního stromu v XamlPadu

Všimněte si, jak ovládací prvky Label, TextBoxa Button každý zobrazují samostatnou hierarchii vizuálních objektů v panelu Průzkumník vizuálních stromů aplikace XamlPad. Je to proto, že ovládací prvky WPF mají ControlTemplate, který obsahuje vizuální strom tohoto ovládacího prvku. Když explicitně odkazujete na ovládací prvek, implicitně odkazujete na jeho vizuální hierarchii.

Monitorování vizuálního výkonu

WPF poskytuje sadu nástrojů pro profilaci výkonu, které umožňují analyzovat chování vaší aplikace za běhu a určit typy optimalizací výkonu, které můžete použít. Nástroj Visual Profiler poskytuje bohaté grafické zobrazení dat o výkonu namapováním přímo na vizuální strom aplikace. Na tomto snímku obrazovky poskytuje část vizuálního profileru Využití CPU přesný rozpis používání služeb WPF objektem, jako je vykreslování a rozložení.

výstupu vizuálního profileru
Zobrazený výstup vizuálního profileru

Chování vizuálního vykreslování

WPF zavádí několik funkcí, které ovlivňují chování vykreslování vizuálních objektů: grafika v režimu zachování, vektorová grafika a na zařízení nezávislá grafika.

Grafika v zachovaném režimu

Jedním z klíčů k pochopení role objektu Vizuál je pochopení rozdílu mezi okamžitým módem a zachovaným módem grafických systémů. Standardní aplikace Win32 založená na GDI nebo GDI+ používá grafický systém okamžitého režimu. To znamená, že aplikace je zodpovědná za překreslení části klientské oblasti, která se stala neplatnou v důsledku akce, jako je změna velikosti okna nebo změna vizuálního vzhledu objektu.

diagram sekvence vykreslování Win32

Naproti tomu WPF používá systém zachovaného režimu. To znamená, že objekty aplikace, které mají vizuální vzhled, definují sadu serializovaných výkresových dat. Po definování dat výkresu je systém zodpovědný za reakci na všechny žádosti o překreslení objektů aplikace. I v době běhu můžete upravovat nebo vytvářet objekty aplikace a stále spoléhat na systém pro reakci na žádosti o malování. Výhoda grafického systému v zachovaném režimu spočívá v tom, že informace o kreslení jsou vždy uchovány ve serializovaném stavu aplikace, ale zodpovědnost za vykreslování je ponechána systému. Následující diagram znázorňuje, jak aplikace spoléhá na WPF při odpovídání na požadavky na malování.

diagram sekvence vykreslování WPF

Inteligentní překreslení

Jednou z největších výhod používání grafiky v režimu uchování je, že WPF dokáže efektivně optimalizovat, co je potřeba překreslit. I když máte složitou scénu s různými úrovněmi neprůhlednosti, obvykle nemusíte psát speciální kód pro optimalizaci překreslení. Porovnejte to s programováním ve Win32, kde můžete vyvinout značné úsilí na optimalizaci vaší aplikace tím, že minimalizujete množství překreslení v oblasti aktualizace. Příklad typu složitosti při optimalizaci překreslení v aplikacích Win32 najdete v tématu Překreslení v oblasti aktualizace.

Vektorová grafika

WPF používá vektorové grafiky jako formát vykreslovacích dat. Vektorová grafika , která zahrnuje formát SVG (Scalable Vector Graphics), metasoubory Windows (.wmf) a písma TrueType, ukládají vykreslovací data a přenášejí je jako seznam pokynů, které popisují, jak vytvořit obrázek pomocí grafických primitiv. Například písma TrueType jsou obrysová písma, která popisují čáry, křivky a příkazy, namísto pole pixelů. Jednou z klíčových výhod vektorové grafiky je schopnost škálovat na libovolnou velikost a rozlišení.

Na rozdíl od vektorové grafiky rastrová grafika ukládá vykreslovací data jako reprezentaci obrázku po pixelech předem vykreslenou pro konkrétní rozlišení. Jedním z klíčových rozdílů mezi rastrovými a vektorovými grafickými formáty je věrnost původnímu zdrojovému obrázku. Například při změně velikosti zdrojového obrázku rastrové grafické systémy roztáhnou obrázek, zatímco vektorové grafické systémy škálují obrázek a zachová věrnost obrázku.

Následující obrázek znázorňuje zdrojový obrázek, který byl změněn velikostí 300%. Všimněte si zkreslení, které se zobrazí, když je zdrojový obrázek roztažen jako rastrový grafický obrázek, a ne jako vektorový grafický obrázek.

rozdíly mezi rastrovými a vektorovými grafikami

Následující značkování ukazuje dva definované prvky Path. Druhý prvek používá ScaleTransform ke změně velikosti pokynů kreslení prvního prvku o 300%. Všimněte si, že pokyny k výkresu v Path prvků zůstávají beze změny.

<Path
  Data="M10,100 C 60,0 100,200 150,100 z"
  Fill="{StaticResource linearGradientBackground}"
  Stroke="Black"
  StrokeThickness="2" />

<Path
  Data="M10,100 C 60,0 100,200 150,100 z"
  Fill="{StaticResource linearGradientBackground}"
  Stroke="Black"
  StrokeThickness="2" >
  <Path.RenderTransform>
    <ScaleTransform ScaleX="3.0" ScaleY="3.0" />
  </Path.RenderTransform>
</Path>

O rozlišení a grafice Device-Independent

Existují dva systémové faktory, které určují velikost textu a grafiky na obrazovce: rozlišení a DPI. Rozlišení popisuje počet pixelů, které se zobrazují na obrazovce. Když se rozlišení zmenší, pixely se zmenší, což způsobí menší zobrazení grafiky a textu. Grafika zobrazená na monitoru nastaveném na 1024 x 768 se při změně rozlišení na 1600 x 1200 zobrazí mnohem menší.

Druhé nastavení systému DPI popisuje velikost palec obrazovky v pixelech. Většina systémů Windows má DPI 96, což znamená, že palec obrazovky je 96 pixelů. Zvětšením nastavení DPI zvětšíte obrazovku; zmenšení dpi zmenší obrazovku. To znamená, že palec na obrazovce není stejně velký jako skutečný palec; ve většině systémů tomu tak pravděpodobně není. Při zvětšení DPI se zvětší grafika a text s podporou DPI, protože jste zvětšili velikost obrazovky palcem. Zvýšení dpi může usnadnit čtení textu, zejména při vysokém rozlišení.

Ne všechny aplikace jsou pracující s DPI: některé používají hardwarové pixely jako primární měrnou jednotku; změna rozlišení DPI systému nemá na tyto aplikace žádný vliv. Mnoho dalších aplikací používá jednotky podporující DPI k popisu velikostí písma, ale k popisu všeho ostatního použijte pixely. Nastavení DPI příliš malé nebo příliš velké může způsobit problémy s rozložením těchto aplikací, protože text aplikace se škáluje s nastavením DPI systému, ale uživatelské rozhraní aplikací ne. Tento problém byl odstraněn pro aplikace vyvinuté pomocí WPF.

WPF podporuje automatické škálování pomocí nezávislého pixelu zařízení jako primární měrné jednotky místo hardwarových pixelů; grafické objekty a text se správně škáluje bez další práce od vývojáře aplikace. Následující obrázek ukazuje příklad zobrazení textu a grafiky WPF v různých nastaveních DPI.

Grafika a text v různých nastaveních DPI

Třída VisualTreeHelper

Třída VisualTreeHelper je statická pomocná třída, která poskytuje funkce nízké úrovně pro programování na úrovni vizuálního objektu, což je užitečné ve velmi konkrétních scénářích, jako je vývoj vysoce výkonných vlastních ovládacích prvků. Ve většině případů nabízejí objekty architektury WPF vyšší úrovně, jako jsou Canvas a TextBlock, větší flexibilitu a snadné použití.

Testování hitů

Třída VisualTreeHelper poskytuje metody pro testování zásahu na vizuálních objektech, když výchozí podpora testování nesplňuje vaše potřeby. Pomocí HitTest metod ve třídě VisualTreeHelper můžete určit, zda je hodnota souřadnic geometrie nebo bodu v hranici daného objektu, například ovládací prvek nebo grafický prvek. Pomocí testování hitů můžete například určit, jestli kliknutí myší v ohraničující obdélník objektu spadá do geometrie kruhu. Můžete se také rozhodnout přepsat výchozí implementaci testování hitů a provést vlastní výpočty testů.

Další informace o testování zásahů naleznete v tématu Testování zásahů ve vizuální vrstvě.

Vytvoření výčtu vizuálního stromu

Třída VisualTreeHelper poskytuje funkce pro výčet členů vizuálního stromu. Pokud chcete načíst nadřazený objekt, zavolejte metodu GetParent. Chcete-li načíst podřízené nebo přímé potomky objektu vizuálu, zavolejte metodu GetChild. Tato metoda vrací potomka Visual rodičovského objektu na zadaném indexu.

Následující příklad ukazuje, jak vytvořit výčet všech potomků objektu vizuálu, což je technika, kterou můžete použít, pokud vás zajímá serializace všech vykreslovacích informací v hierarchii objektů vizuálu.

// Enumerate all the descendants of the visual object.
static public void EnumVisual(Visual myVisual)
{
    for (int i = 0; i < VisualTreeHelper.GetChildrenCount(myVisual); i++)
    {
        // Retrieve child visual at specified index value.
        Visual childVisual = (Visual)VisualTreeHelper.GetChild(myVisual, i);

        // Do processing of the child visual object.

        // Enumerate children of the child visual object.
        EnumVisual(childVisual);
    }
}

' Enumerate all the descendants of the visual object.
Public Shared Sub EnumVisual(ByVal myVisual As Visual)
    For i As Integer = 0 To VisualTreeHelper.GetChildrenCount(myVisual) - 1
        ' Retrieve child visual at specified index value.
        Dim childVisual As Visual = CType(VisualTreeHelper.GetChild(myVisual, i), Visual)

        ' Do processing of the child visual object.

        ' Enumerate children of the child visual object.
        EnumVisual(childVisual)
    Next i
End Sub

Ve většině případů je logický strom užitečnější reprezentací prvků v aplikaci WPF. I když logický strom neupravujete přímo, je toto zobrazení aplikace užitečné pro pochopení dědičnosti vlastností a směrování událostí. Na rozdíl od vizuálního stromu může logický strom představovat objekty dat, které nejsou vizuální, například ListItem. Další informace o logickém stromu naleznete v tématu Stromy ve WPF.

Třída VisualTreeHelper poskytuje metody pro vrácení ohraničujícího obdélníku vizuálních objektů. Ohraničující obdélník objektu vizuálu můžete vrátit voláním GetContentBounds. Ohraničující obdélník všech potomků vizuálního objektu, včetně samotného vizuálního objektu, můžete vrátit voláním GetDescendantBounds. Následující kód ukazuje, jak byste vypočítali ohraničující obdélník vizuálního objektu a všech jeho potomků.

// Return the bounding rectangle of the parent visual object and all of its descendants.
Rect rectBounds = VisualTreeHelper.GetDescendantBounds(parentVisual);

' Return the bounding rectangle of the parent visual object and all of its descendants.
Dim rectBounds As Rect = VisualTreeHelper.GetDescendantBounds(parentVisual)

Sdílet prostřednictvím