/// <summary>
/// Vrátí instanci třídy <see cref="BoundsInfo"/> pro daný IInteractiveParent parent. Ten může být i <see cref="IAutoScrollContainer"/>!
/// </summary>
/// <param name="parent"></param>
/// <param name="layer">Vrstva grafiky. Ovlivňuje výběr Bounds z dodaného prvku: pro vrstvu <see cref="GInteractiveDrawLayer.Interactive"/>
/// akceptuje souřadnice <see cref="IInteractiveItem.BoundsInteractive"/>, jinak bere standardně <see cref="IInteractiveItem.Bounds"/>.</param>
/// <returns></returns>
public static BoundsInfo CreateForParent(IInteractiveParent parent, GInteractiveDrawLayer layer = GInteractiveDrawLayer.Standard)
{
Coordinates physicalCoordinates = Coordinates.FromSize(parent.ClientSize);
Coordinates virtualCoordinates = physicalCoordinates;
if (parent is IAutoScrollContainer)
{
IAutoScrollContainer autoScrollContainer = parent as IAutoScrollContainer;
if (autoScrollContainer.AutoScrollActive)
{
Point virtualOrigin = autoScrollContainer.VirtualOrigin;
Rectangle virtualBounds = physicalCoordinates.GetVisibleBounds(autoScrollContainer.VirtualBounds);
virtualCoordinates = Coordinates.FromOrigin(virtualOrigin, virtualBounds);
}
}
return(new BoundsInfo(physicalCoordinates, virtualCoordinates, true, true, layer));
}
/*
* 1. ÚČEL
* POZICE
* Kreslící systém ve třídách ControlBuffered a ControlLayered (a následně interaktivní control InteractiveControl)
* je postaven na vykreslování jednotlivých prvků (child itemů) do globální grafiky celého WinForm Controlu.
* K tomu vykreslování je třeba znát absolutní pozici konkrétního child itemu vzhledem k WinForm Controlu.
* Přitom samozřejmě pozicování child itemů (=jejich Bounds) je relativní výhradně k jejich Parentu,
* kterým je jiný child item (=standardní vnořená hierarchie).
* Jinými slovy, pokud přemístím určitý item na jiné (relativní) souřadnice, pak nemusím měnit souřadnice jeho child itemů.
* A tyto child itemy se budou nacházet na stejné relativní souřadnici Bounds, ale fyzicky jsou na jiné absolutní souřadnici v rámci WinForm Controlu.
* (To samé, co platí o vykreslování, je platné i pro interaktivitu podmíněnou akcemi myši.)
*
* Účelem třídy BoundsInfo je tedy vypočítat absolutní souřadnice konkrétního child itemu vzhledem k fyzickému WinForm Controlu.
*
* VIDITELNOST
* Dalším úkolem je určit, jaká část itemu je fyzicky viditelná.
* Pokud určitý child item leží částečně mimo zobrazovanou oblast WinForm Controlu, anebo mimo souřadnice Bounds svého parent itemu,
* pak child item může být částečně nebo zcela neviditelný.
* To má vliv na vykreslování (nebudeme vykreslovat item, který je zcela mimo viditelnou oblast),
* i na interaktivitu (prvek item nemůže zachytávat akce myši v oblasti, kde není viditelný třeba proto, že leží mimo prostor svého parenta).
*
* 2. DALŠÍ FUNKCIONALITA = AutoScroll prvky
* Systém prvků dovoluje implementovat AutoScroll = postup, který detekuje rozmístění child itemů, určuje tak potřebný prostor,
* porovnává jej s disponibilním prostorem v parent prvku (ať je to WinForm Control nebo běžný parent item);
* a pokud je disponibilní prostor menší než je třeba, pak aktivuje AutoScroll režim (=zobrazí se ScrollBary).
* Tím se stává prostor hostitelského prvku "virtuálním" = jeho souřadnice se posouvají vlivem scrollování.
* I tuto věc řeší třída BoundsInfo.
*
* 3. POSTUP ŘEŠENÍ - pro směr Parent => Child
* a) Vstupem do souřadného systému je WinForm Control
* b) Souřadný systém zajišťuje přepočet relativní souřadnice určitého child itemu (jeho Bounds) do absolutní pozice v rámci WinForm Controlu
* (fyzicky jde o pozici bodu počátku, který se přičte k souřadnici počátku child itemu Bounds.Location,
* a výsledkem je fyzická souřadnice na Controlu)
* c) Kvůli AutoScrollu máme dva souřadné systémy: Fyzický souřadný systém (FSS) a Virtuální (VSS)
* d) Většina child itemů (běžné) má souřadnice vztažené k VSS, a tedy při AutoScrollu se pohybují ve svém Parentu
* e) Některé child itemy (ScrollBary od AutoScrollu) mají svoje souřadnice vztažené k FSS, při provádění AutoScrollu se ve svém parentu nepohybují
* f) Child itemy si tedy pro určení sých Absolute Bounds vyberou "svůj" souřadný systém, jeho bod počátku a podle něj určí svoje absolutní souřadnice;
* a podle něj určí i své AbsoluteVisibleBounds
* f) Při vytváření BoundsInfo pro vnořené child itemy se bude vycházet z aktuálních AbsoluteBounds prvku (containeru),
*
*
*
*
*
*
*
*
*
*
*
*
*
*
*
*
*
*
*
*/
#endregion
#region Metody pro směr Parent to Child
#region Konstruktory
/// <summary>
/// Vrátí instanci třídy <see cref="BoundsInfo"/> pro daný WinForm Control. Ten může být i <see cref="IAutoScrollContainer"/>!
/// </summary>
/// <param name="control"></param>
/// <param name="layer">Vrstva grafiky. Ovlivňuje výběr Bounds z dodaného prvku: pro vrstvu <see cref="GInteractiveDrawLayer.Interactive"/>
/// akceptuje souřadnice <see cref="IInteractiveItem.BoundsInteractive"/>, jinak bere standardně <see cref="IInteractiveItem.Bounds"/>.</param>
/// <returns></returns>
public static BoundsInfo CreateForControl(System.Windows.Forms.Control control, GInteractiveDrawLayer layer = GInteractiveDrawLayer.Standard)
{
Coordinates physicalCoordinates = Coordinates.FromSize(control.ClientSize);
Coordinates virtualCoordinates = physicalCoordinates;
if (control is IAutoScrollContainer)
{
IAutoScrollContainer autoScrollContainer = control as IAutoScrollContainer;
if (autoScrollContainer.AutoScrollActive)
{
Point virtualOrigin = autoScrollContainer.VirtualOrigin;
Rectangle virtualBounds = physicalCoordinates.GetVisibleBounds(autoScrollContainer.VirtualBounds);
virtualCoordinates = Coordinates.FromOrigin(virtualOrigin, virtualBounds);
}
}
return(new BoundsInfo(physicalCoordinates, virtualCoordinates, true, true, layer));
}
/// <summary>
/// Vrátí novou instanci <see cref="BoundsInfo"/> pro daný Child objekt, který od té chvíle bude Parent objektem pro další, v něm vnořené prvky.
/// Respektuje přitom, že daný Child objekt se může pohybovat ve virtuálních anebo ve fyzických souřadnicích aktuálního systému.
/// </summary>
/// <param name="item">Prvek</param>
/// <param name="layer">Vrstva, ovlivní výběr typu souřadnic</param>
/// <returns></returns>
protected BoundsInfo GetChildsBoundsInfo(IInteractiveItem item, GInteractiveDrawLayer layer)
{
// Child prvek je umístěn ve svých souřadnicích Bounds, a to buď ve fyzickém nebo ve virtuálním prostoru (koordinátech):
Coordinates parentCoordinates = (item.Is.OnPhysicalBounds ? this._PhysicalCoordinates : this._VirtualCoordinates);
// Určíme jeho absolutní souřadnice = jeho Bounds posunuté do odpovídajících (fyzické/virtuální) koordinátů:
Rectangle bounds = GetItemBounds(item, layer);
Rectangle absoluteBounds = parentCoordinates.GetAbsoluteBounds(bounds);
// Prvek může zmenšit tento prostor o své vnitřní okraje.
// Prostor okrajů patří do prvku (=prvek sám si je dokáže vykreslit), ale nepatří do prostoru, který prvek poskytuje svým child prvkům:
// Toto jsou tedy absolutní souřadnice prostoru, ve kterém budou zobrazovány Child prvky:
Rectangle clientBounds = absoluteBounds.Sub(item.ClientBorder);
// Určíme viditelnou oblast (průsečík z prostoru pro childs s prostorem dosud viditelné oblasti):
Rectangle visibleBounds = parentCoordinates.GetVisibleBounds(clientBounds);
// V rámci těchto souřadnic prvek item může poskytovat svůj souřadný systém standardní (fyzický) anebo i virtuální:
Coordinates physicalCoordinates = Coordinates.FromOrigin(clientBounds.Location, visibleBounds);
Coordinates virtualCoordinates = physicalCoordinates;
if (item is IAutoScrollContainer)
{ // Child prvek (item) je AutoScrollContainer:
IAutoScrollContainer autoScrollContainer = item as IAutoScrollContainer;
if (autoScrollContainer.AutoScrollActive)
{
Point virtualOrigin = parentCoordinates.GetAbsolutePoint(autoScrollContainer.VirtualOrigin);
Rectangle virtualBounds = parentCoordinates.GetVisibleBounds(parentCoordinates.GetAbsoluteBounds(autoScrollContainer.VirtualBounds));
virtualCoordinates = Coordinates.FromOrigin(virtualOrigin, virtualBounds);
}
}
bool isVisible = this.IsVisible && item.Is.Visible;
bool isEnabled = this.IsEnabled && item.Is.Enabled;
return(new BoundsInfo(physicalCoordinates, virtualCoordinates, isVisible, isEnabled, layer));
}
