Signatur
Beschreibung
UI\Size ist ein einfaches Wertobjekt aus der PHP-UI-Erweiterung (php-ui / libui), das eine zweidimensionale Größenangabe in Form von Breite (width) und Höhe (height) kapselt. Es wird überall dort verwendet, wo Abmessungen benötigt werden – z. B. beim Erstellen oder Anpassen von Fenstern, Controls und Zeichenflächen.
Objekte dieses Typs werden typischerweise an Methoden wie UI\Window::setSize() oder UI\Draw\Pen-bezogene APIs übergeben, um die Abmessungen eines Elements programmatisch zu steuern. Ebenso liefert UI\Window::getSize() ein UI\Size-Objekt zurück.
Die Klasse bietet öffentliche Eigenschaften width und height, die direkt gelesen und gesetzt werden können. Es handelt sich um einen einfachen Daten-Container ohne komplexe Logik, was eine direkte und intuitive Nutzung ermöglicht.
- width: Breite in Pixeln (Ganzzahl).
- height: Höhe in Pixeln (Ganzzahl).
Parameter
| Name | Typ | Default | Beschreibung |
|---|---|---|---|
| $width Pflicht | float | Die Breite in Pixeln, die das Objekt repräsentieren soll. | |
| $height Pflicht | float | Die Höhe in Pixeln, die das Objekt repräsentieren soll. |
Beispiele
Fenstergröße mit UI\Size setzen und auslesen
<?php
use UI\Window;
use UI\Size;
use UI\Point;
$window = new Window('Mein Fenster', new Size(800, 600), false);
// Aktuelle Größe auslesen
$currentSize = $window->getSize();
echo 'Breite: ' . $currentSize->width . ', Höhe: ' . $currentSize->height . PHP_EOL;
// Neue Größe setzen
$window->setSize(new Size(1024, 768));
$newSize = $window->getSize();
echo 'Neue Breite: ' . $newSize->width . ', Neue Höhe: ' . $newSize->height . PHP_EOL;UI\Size-Objekt direkt erstellen und Eigenschaften nutzen
<?php
use UI\Size;
$size = new Size(320, 240);
echo 'Breite: ' . $size->width . PHP_EOL;
echo 'Höhe: ' . $size->height . PHP_EOL;
// Eigenschaften können direkt verändert werden
$size->width = 640;
$size->height = 480;
echo 'Geänderte Breite: ' . $size->width . PHP_EOL;
echo 'Geänderte Höhe: ' . $size->height . PHP_EOL;// Wichtig · Fallstricke
Hinweis zur Verfügbarkeit: UI\Size gehört zur experimentellen php-ui-Erweiterung, die separat installiert werden muss (z. B. via PECL: pecl install ui). Sie ist nicht Teil der PHP-Standardinstallation und wird nicht mit jedem System mitgeliefert.
Die Erweiterung befindet sich noch in aktiver Entwicklung; API-Änderungen zwischen Minor-Versionen sind möglich. Für Produktionsumgebungen sollte die Stabilität der verwendeten Version geprüft werden. Die Klasse ist primär für Desktop-GUI-Anwendungen konzipiert und nicht für webbasierte PHP-Projekte gedacht.