Fluent-Qt

Scrollen

ImageViewer Bildbetrachter

Ermöglicht das Zoomen um den Zeiger und das Schwenken eines einzelnen Bildes, einschließlich Einpass- und Originalgrößenansicht.

Beispiel

ImageViewer Bildbetrachter: Bild schwenken und zoomen

Verwendung

Bild schwenken und zoomen

Mausrad, Pinch-Geste oder Strg/Command + Mausrad zoomen um den Zeiger, Ziehen schwenkt das Bild und die Symbolleiste erscheint beim Überfahren.

#include <FluentQt/Scrolling.h>
using namespace fluent::scrolling;

auto* viewer = new ImageViewer(this);
viewer->setMaximumWidth(460);
viewer->setFixedHeight(290);
viewer->setSizePolicy(QSizePolicy::Expanding, QSizePolicy::Fixed);
viewer->setAccessibleName(QStringLiteral("Harbor at dusk"));
viewer->setPixmap(imageViewerScene(QSize(1600, 1000), 0));

// Double-click toggles 100%; after focus, + - 0 1 and the
// arrow keys zoom, reset and pan.
auto updateStatus = [viewer, status] {
    status->setText(imageViewerStatusText(viewer));
};
connect(viewer, &ImageViewer::zoomFactorChanged, status, updateStatus);
connect(viewer, &ImageViewer::fitModeChanged, status, updateStatus);

fluent::scrolling::ImageViewer

Erbt von QWidget · FluentElement · QMLPlus

Schwenk- und Zoom-Ansicht für ein einzelnes Bild. Unterstützt Mausrad-/Pinch-Zoom, Ziehen zum Schwenken und Tastenkombinationen; gibt Mausradeingaben an einen umschließenden Container weiter, wenn kein Schwenkbereich mehr vorhanden ist.

Konstruktoren

Destruktoren

Enumerationen

enum class FitMode

Einpassungsregel der Ansicht.

  • Manual Behält den Zoomfaktor und das Ansichtszentrum bei.
  • Contain Passt das gesamte Bild ein und vergrößert dabei kleine Bilder.
  • ScaleDown Passt große Bilder ein und belässt kleine bei 100 %.
enum class WheelAction

Aktion eines Mausrads ohne Modifikatortaste.

  • Zoom Zoomt um den Zeiger.
  • Pan Schwenkt oder gibt das Mausrad ohne Bereich an das übergeordnete Element weiter.
enum class ControlsVisibility

Sichtbarkeitsrichtlinie der Zoom-Steuerelemente.

  • Hidden Nie angezeigt.
  • Auto Wird beim Überfahren, Fokussieren oder Ziehen angezeigt.
  • Visible Wird immer angezeigt, solange ein Bild gesetzt ist.

Methoden

QPixmap pixmap() const

Vom Betrachter angezeigtes Bild; das Setzen eines neuen Bildes setzt die Ansicht zurück.

void setPixmap(const QPixmap& pixmap)

Vom Betrachter angezeigtes Bild; das Setzen eines neuen Bildes setzt die Ansicht zurück.

void setImage(const QImage& image)

Wandelt ein Bild in ein Pixmap um und zeigt es an.

QSizeF imageSize() const

Gibt die geräteunabhängige Größe des Bildes zurück, oder eine leere Größe, wenn kein Bild vorhanden ist.

qreal fitZoomFactor() const

Gibt den Skalierungsfaktor zurück, mit dem das gesamte Bild in den aktuellen Viewport passt.

qreal zoomFactor() const

Aktueller Zoomfaktor; 1.0 entspricht der geräteunabhängigen Bildgröße.

void setZoomFactor(qreal factor)

Aktueller Zoomfaktor; 1.0 entspricht der geräteunabhängigen Bildgröße.

qreal minZoomFactor() const

Kleinster Zoomfaktor; der Einpassungsfaktor bleibt darunter erreichbar.

void setMinZoomFactor(qreal factor)

Kleinster Zoomfaktor; der Einpassungsfaktor bleibt darunter erreichbar.

qreal maxZoomFactor() const

Größter Zoomfaktor; der Einpassungsfaktor bleibt darüber erreichbar.

void setMaxZoomFactor(qreal factor)

Größter Zoomfaktor; der Einpassungsfaktor bleibt darüber erreichbar.

QPointF viewCenter() const

Bildpunkt in geräteunabhängigen Bildpixeln, der in der Mitte des Viewports angezeigt wird.

void setViewCenter(const QPointF& center)

Bildpunkt in geräteunabhängigen Bildpixeln, der in der Mitte des Viewports angezeigt wird.

FitMode fitMode() const

Ob die Ansicht bei Größenänderung des Viewports einer Anpassungsregel folgt.

void setFitMode(FitMode mode)

Ob die Ansicht bei Größenänderung des Viewports einer Anpassungsregel folgt.

WheelAction wheelAction() const

Was das Mausrad ohne Modifikatortaste bewirkt.

void setWheelAction(WheelAction action)

Was das Mausrad ohne Modifikatortaste bewirkt.

ControlsVisibility controlsVisibility() const

Sichtbarkeitsrichtlinie der integrierten Zoom-Steuerelemente.

void setControlsVisibility(ControlsVisibility visibility)

Sichtbarkeitsrichtlinie der integrierten Zoom-Steuerelemente.

bool isZoomIndicatorEnabled() const

Ob eine direkte Zoomeingabe bei ausgeblendeten Steuerelementen kurz den Zoom-Prozentsatz anzeigt.

void setZoomIndicatorEnabled(bool enabled)

Ob eine direkte Zoomeingabe bei ausgeblendeten Steuerelementen kurz den Zoom-Prozentsatz anzeigt.

bool isFrameVisible() const

Ob der Viewer seinen abgerundeten Hintergrund und Rahmen zeichnet.

void setFrameVisible(bool visible)

Ob der Viewer seinen abgerundeten Hintergrund und Rahmen zeichnet.

Qt::TransformationMode transformationMode() const

Beim Skalieren des Bildes verwendetes Sampling; Fast hält einzelne Pixel scharf.

void setTransformationMode(Qt::TransformationMode mode)

Beim Skalieren des Bildes verwendetes Sampling; Fast hält einzelne Pixel scharf.

void zoomIn(bool animated = false)

Vergrößert um die Viewport-Mitte auf die nächste voreingestellte Stufe.

void zoomOut(bool animated = false)

Verkleinert um die Viewport-Mitte auf die vorherige voreingestellte Stufe.

void zoomTo(qreal factor, bool animated = false)

Zoomt um die Viewport-Mitte auf einen Faktor.

void zoomTo(qreal factor, const QPointF& viewportAnchor, bool animated = false)

Zoomt auf einen Faktor und hält dabei den Bildpunkt unter einer Viewport-Position fixiert.

void zoomToActualSize(bool animated = false)

Zeigt das Bild mit 100 % um die Mitte des Viewports an.

void fitToView(bool animated = false)

Passt das gesamte Bild in den Viewport ein und passt es bei Größenänderungen weiterhin an.

void resetView(bool animated = false)

Kehrt zur Ausgangsansicht zurück: Große Bilder werden eingepasst, kleine bleiben bei 100 %.

void panBy(qreal dx, qreal dy)

Verschiebt den sichtbaren Bereich um Viewport-Pixel; positive Werte zeigen Bereiche weiter rechts und unten.

QPointF mapToImage(const QPointF& viewportPoint) const

Bildet eine Viewport-Position auf geräteunabhängige Bildkoordinaten ab.

QPointF mapFromImage(const QPointF& imagePoint) const

Bildet geräteunabhängige Bildkoordinaten auf eine Viewport-Position ab.

Eigenschaften

QPixmap pixmap

Vom Betrachter angezeigtes Bild; das Setzen eines neuen Bildes setzt die Ansicht zurück.

Lesen pixmap()Schreiben setPixmap()Benachrichtigung pixmapChanged()
qreal zoomFactor

Aktueller Zoomfaktor; 1.0 entspricht der geräteunabhängigen Bildgröße.

Lesen zoomFactor()Schreiben setZoomFactor()Benachrichtigung zoomFactorChanged()
qreal minZoomFactor

Kleinster Zoomfaktor; der Einpassungsfaktor bleibt darunter erreichbar.

Lesen minZoomFactor()Schreiben setMinZoomFactor()Benachrichtigung minZoomFactorChanged()
qreal maxZoomFactor

Größter Zoomfaktor; der Einpassungsfaktor bleibt darüber erreichbar.

Lesen maxZoomFactor()Schreiben setMaxZoomFactor()Benachrichtigung maxZoomFactorChanged()
QPointF viewCenter

Bildpunkt in geräteunabhängigen Bildpixeln, der in der Mitte des Viewports angezeigt wird.

Lesen viewCenter()Schreiben setViewCenter()Benachrichtigung viewCenterChanged()
FitMode fitMode

Ob die Ansicht bei Größenänderung des Viewports einer Anpassungsregel folgt.

Lesen fitMode()Schreiben setFitMode()Benachrichtigung fitModeChanged()
WheelAction wheelAction

Was das Mausrad ohne Modifikatortaste bewirkt.

Lesen wheelAction()Schreiben setWheelAction()Benachrichtigung wheelActionChanged()
ControlsVisibility controlsVisibility

Sichtbarkeitsrichtlinie der integrierten Zoom-Steuerelemente.

Lesen controlsVisibility()Schreiben setControlsVisibility()Benachrichtigung controlsVisibilityChanged()
bool zoomIndicatorEnabled

Ob eine direkte Zoomeingabe bei ausgeblendeten Steuerelementen kurz den Zoom-Prozentsatz anzeigt.

Lesen isZoomIndicatorEnabled()Schreiben setZoomIndicatorEnabled()Benachrichtigung zoomIndicatorEnabledChanged()
bool frameVisible

Ob der Viewer seinen abgerundeten Hintergrund und Rahmen zeichnet.

Lesen isFrameVisible()Schreiben setFrameVisible()Benachrichtigung frameVisibleChanged()
Qt::TransformationMode transformationMode

Beim Skalieren des Bildes verwendetes Sampling; Fast hält einzelne Pixel scharf.

Lesen transformationMode()Schreiben setTransformationMode()Benachrichtigung transformationModeChanged()

Signale

void pixmapChanged()

Vom Betrachter angezeigtes Bild; das Setzen eines neuen Bildes setzt die Ansicht zurück.

void zoomFactorChanged(qreal factor)

Aktueller Zoomfaktor; 1.0 entspricht der geräteunabhängigen Bildgröße.

void minZoomFactorChanged(qreal factor)

Kleinster Zoomfaktor; der Einpassungsfaktor bleibt darunter erreichbar.

void maxZoomFactorChanged(qreal factor)

Größter Zoomfaktor; der Einpassungsfaktor bleibt darüber erreichbar.

void viewCenterChanged(const QPointF& center)

Bildpunkt in geräteunabhängigen Bildpixeln, der in der Mitte des Viewports angezeigt wird.

void fitModeChanged(fluent::scrolling::ImageViewer::FitMode mode)

Ob die Ansicht bei Größenänderung des Viewports einer Anpassungsregel folgt.

void zoomIndicatorEnabledChanged(bool enabled)

Ob eine direkte Zoomeingabe bei ausgeblendeten Steuerelementen kurz den Zoom-Prozentsatz anzeigt.

void frameVisibleChanged(bool visible)

Ob der Viewer seinen abgerundeten Hintergrund und Rahmen zeichnet.

void transformationModeChanged(Qt::TransformationMode mode)

Beim Skalieren des Bildes verwendetes Sampling; Fast hält einzelne Pixel scharf.

Geschützte Elemente

Methoden

Geerbt von fluent::FluentElement

Enumerationen

enum Theme

Globales visuelles Theme zum Auflösen von Design-Tokens.

  • Light = 0
  • Dark = 1
  • HighContrast = 2

Methoden

static void setTheme(Theme theme)

Aktualisiert das globale Theme und benachrichtigt aktive FluentElement-Instanzen.

static void setThemeDeferred(Theme theme)

Plant eine gebündelte Theme-Aktualisierung mit Priorität für sichtbare Elemente, ohne die aktuelle Interaktion zu blockieren.

static Theme currentTheme()

Gibt das aktuell aktive globale Design zurück.

static bool themeUsesDarkAppearance(Theme theme)

Gibt zurück, ob ein Theme Chrome und Material-Tokens auf dunklem Hintergrund verwendet.

static void refreshTheme()

Sendet das aktuelle Theme nach einer Änderung von Design-Tokens erneut, um ein Neuzeichnen auszulösen.

static int themeGeneration()

Monotoner Zähler zur Veraltungsprüfung, der bei jedem Designwechsel erhöht wird.

Theme effectiveTheme() const

Löst das von diesem Element verwendete Theme auf und berücksichtigt dabei eine geerbte QWidget-Überschreibung.

bool effectiveThemeUsesDarkAppearance() const

Gibt zurück, ob das effektive Theme dieses Elements Chrome auf dunklem Hintergrund verwendet.

bool setThemeOverrides(const QJsonObject& overrides)

Ersetzt die selektiven Farb-, Radius- und Schrift-Token-Überschreibungen dieses Elements.

QJsonObject themeOverrides() const

Gibt die festgelegten Überschreibungen dieses Elements zurück.

void clearThemeOverrides()

Setzt alle Token-Felder auf die Standardwerte des globalen Designs zurück.

const Colors& themeColorsRef() const

Kopiefreier Zugriff auf das aktive Farbset für kritische Zeichenpfade.

Material::AcrylicToken themeAcrylic() const

Material-, Höhenstufen- und adaptive Layout-Tokens.

QColor themeBackdrop(bool active) const

Backdrop-Farbe des Fenster-Chrome für den angegebenen Aktivierungszustand.

virtual void onThemeUpdated()

Wird nach einer Änderung des globalen Themes aufgerufen.

Typen und Aliase

struct Colors

An Komponenten zurückgegebene Design-Token-Snapshots.

Geerbt von fluent::QMLPlus

Methoden

AnchorLayout::Anchors* anchors()

Gibt veränderbare Anker für den QWidget-Host zurück.

void setState(const QString& name)

Wendet einen registrierten Zustand anhand seines Namens an oder stellt den Standardzustand wieder her, wenn @p name leer ist. Unbekannte Namen werden ignoriert, und bestehende Bindungen werden beim Verlassen des Zustands wieder aufgenommen.

void addState(const QMLState& state)

Registriert oder ersetzt eine benannte Zustandsdefinition; das Ersetzen des aktiven Zustands wendet diesen sofort an.

void evaluateStates()

Wertet Zustandsbedingungen in Registrierungsreihenfolge neu aus und aktiviert den ersten Treffer oder den Standardzustand, wenn keiner zutrifft. Wird auch automatisch bei Benachrichtigungen abhängiger Eigenschaften ausgeführt; abgeleitete Zustände mit extend erben Änderungen der Vorgänger, sofern keine Zyklen vorliegen oder Vorgänger fehlen.

QMLPlusRuntime* runtime()

Gibt den bei Bedarf erstellten Zustandsbeobachter im Besitz dieses Hosts zurück.

void setAnchors(const AnchorLayout::Anchors& anchors)

Ersetzt alle Host-Anker und macht das übergeordnete Layout ungültig.

void resetAnchors()

Löscht alle Host-Anker und invalidiert das übergeordnete Layout.

void bind(const char* targetProp, QObject* source, const char* sourceProp, PropertyBinder::Direction dir = PropertyBinder::OneWay)

Bindet @p sourceProp von @p source über PropertyBinder::bind() an @p targetProp dieses QWidget-Hosts.

void addTransition(const StateTransition& transition)

Registriert einen Zustandsübergang in Prioritätsreihenfolge.

void setBehavior(const char* propertyName, const PropertyAnimation& animation)

Setzt die Standardanimation, die beim Schreiben von @p propertyName über writeProperty() oder eine Bindung verwendet wird. Explizite StateTransition-Regeln haben Vorrang; direkte C++-Setter-Aufrufe werden nicht animiert.

void clearBehavior(const char* propertyName)

Entfernt die Standardanimation für zukünftige verwaltete Schreibvorgänge.

bool writeProperty(const char* propertyName, const QVariant& value)

Schreibt eine Host-Eigenschaft über Behavior, ohne deren Bindung zu entfernen.

Qt-Basisklassendokumentation: QWidget