GVUpdater(3U)

💖 GVUpdater — ok bestie, let's talk 💖

InterViews Reference Manual · section 3U · yeah we're in the library pages now, buckle up 🎀

✨ NAME ✨

GVUpdater — she updates the GraphicViews structure so it matches its subject. glow-up service, basically 💅

🦋 SYNOPSIS 🦋

#include <Unidraw/Components/gvupdater.h>

🌸 DESCRIPTION 🌸

okay so. GVUpdater is an implementation class that GraphicViews uses to keep its state and structure consistent with its GraphicComps subject. no cap, she's the behind-the-scenes bestie making sure nobody's out here looking mismatched 😭

here's what she guarantees:

• the subject's immediate children are identical to the view's — same number, same graphics state attributes. fr fr, exactly matching.
• the root GraphicViews and GraphicComps themselves have the same graphics state. slay.

and here's the thing she does not do, and this matters:

GVUpdater does not ensure that it will detect and update changes made to deeper child nodes. like, she's not doing a full deep dive, bestie. immediate children only. deeper nodes are on their own 💀

👑 PUBLIC OPERATIONS 👑

• GVUpdater(GraphicView*) — the constructor takes the GraphicView that it will be updating as a parameter and stores it in the protected member _gv. normally, GraphicViews are the only objects that will instantiate GVUpdater — so if that's you, bestie, you're special ✨
• virtual void Update() — Update the GraphicView to make it consistent with its subject. that's the whole assignment. go make them match 🫶

🧚 PROTECTED OPERATIONS 🧚

• void UpdateStructure()
• void UpdateState()

The Update procedure takes place in two stages, and the order is not vibes-based, it's real:

1. the subject's and view's structures are reconciled first by UpdateStructure
2. and then the view's graphic state is changed to match the subjects with UpdateState.

structure first, then state. periodt 🌈

• void AddDamage(Graphic*)
• void IncurDamage(Graphic*)
• void Unselect(GraphicView*)
• virtual void Add(GraphicView*)
• virtual void Append(GraphicView*)
• virtual void InsertBefore(Iterator, GraphicView*)
• virtual void Remove(Iterator&)
• virtual void DeleteView(Iterator&)

GVUpdater is a friend of GraphicViews — yes, actual friend privileges, main character energy 👑 these convenience operations provide an interface to the corresponding protected GraphicViews operations. iykyk 🎀

• virtual ClassId ViewCategory() — Returns the view category (see classes(3U)) that GVUpdater will use to instantiate views of subjects. ViewCategory returns COMPONENT_VIEW by default. that's the default, don't forget it 💜

🔥 SEE ALSO 🔥

GraphicComp(3U), GraphicView(3U), classes(3U)

that's the whole page bestie, go forth and keep your views consistent 💖✨

with love from the Unidraw girlies — 19 January 1991 — yeah we've been iconic since then 💅🎀