滚动

ImageViewer 图片查看器

围绕指针缩放、拖动平移单张图片，可切换适应窗口与原始比例。

示例

用法

平移和缩放图片

setPixmap() 或 setImage() 设置图片，视图自动回到 ScaleDown；fitToView()、zoomToActualSize()、resetView() 切换视图，zoomFactorChanged 报告当前比例。

#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);

import fluentqt

from PySide6.QtCore import QSize
from PySide6.QtWidgets import QSizePolicy

viewer = fluentqt.ImageViewer()
viewer.setMaximumWidth(460)
viewer.setFixedHeight(290)
viewer.setSizePolicy(QSizePolicy.Policy.Expanding, QSizePolicy.Policy.Fixed)
viewer.setAccessibleName('Harbor at dusk')
viewer.setPixmap(image_viewer_scene(QSize(1600, 1000), 0))
def update_status(*_args):
    status.setText(image_viewer_status_text(viewer))
viewer.zoomFactorChanged.connect(update_status)
viewer.fitModeChanged.connect(update_status)

API

查看声明

`fluent::scrolling::ImageViewer`

继承自 QWidget · FluentElement · QMLPlus

单张图片的平移缩放查看器。

构造函数

explicit ImageViewer(QWidget* parent = nullptr)

属性

QPixmap pixmap: 查看器显示的图片；设置新图片会复位视图。
读取 pixmap()设置 setPixmap()通知 pixmapChanged()
qreal zoomFactor: 当前缩放因子；1.0 为图片的设备无关尺寸。
读取 zoomFactor()设置 setZoomFactor()通知 zoomFactorChanged()
qreal minZoomFactor: 最小缩放因子；低于它的适应比例仍然可以到达。
读取 minZoomFactor()设置 setMinZoomFactor()通知 minZoomFactorChanged()
qreal maxZoomFactor: 最大缩放因子；高于它的适应比例仍然可以到达。
读取 maxZoomFactor()设置 setMaxZoomFactor()通知 maxZoomFactorChanged()
QPointF viewCenter: 显示在视口中心的图片坐标点，单位为设备无关的图片像素。
读取 viewCenter()设置 setViewCenter()通知 viewCenterChanged()
FitMode fitMode: 视口尺寸变化时视图是否跟随适应规则。
读取 fitMode()设置 setFitMode()通知 fitModeChanged()
WheelAction wheelAction: 不按修饰键的鼠标滚轮执行的操作。
读取 wheelAction()设置 setWheelAction()通知 wheelActionChanged()
ControlsVisibility controlsVisibility: 内置缩放工具条的可见性策略。
读取 controlsVisibility()设置 setControlsVisibility()通知 controlsVisibilityChanged()
bool zoomIndicatorEnabled: 工具条隐藏时，直接缩放输入是否短暂显示缩放比例。
读取 isZoomIndicatorEnabled()设置 setZoomIndicatorEnabled()通知 zoomIndicatorEnabledChanged()
bool frameVisible: 查看器是否绘制圆角背景和边框。
读取 isFrameVisible()设置 setFrameVisible()通知 frameVisibleChanged()
Qt::TransformationMode transformationMode: 缩放图片时的采样方式；Fast 可保持单个像素清晰。
读取 transformationMode()设置 setTransformationMode()通知 transformationModeChanged()

方法

QPixmap pixmap() const: 查看器显示的图片；设置新图片会复位视图。
void setPixmap(const QPixmap& pixmap): 查看器显示的图片；设置新图片会复位视图。
void setImage(const QImage& image): 将图片转换为 pixmap 并显示。
QSizeF imageSize() const: 返回图片的设备无关尺寸；没有图片时返回空尺寸。
qreal fitZoomFactor() const: 返回在当前视口中完整显示图片所需的缩放因子。
qreal zoomFactor() const: 当前缩放因子；1.0 为图片的设备无关尺寸。
void setZoomFactor(qreal factor): 当前缩放因子；1.0 为图片的设备无关尺寸。
qreal minZoomFactor() const: 最小缩放因子；低于它的适应比例仍然可以到达。
void setMinZoomFactor(qreal factor): 最小缩放因子；低于它的适应比例仍然可以到达。
qreal maxZoomFactor() const: 最大缩放因子；高于它的适应比例仍然可以到达。
void setMaxZoomFactor(qreal factor): 最大缩放因子；高于它的适应比例仍然可以到达。
QPointF viewCenter() const: 显示在视口中心的图片坐标点，单位为设备无关的图片像素。
void setViewCenter(const QPointF& center): 显示在视口中心的图片坐标点，单位为设备无关的图片像素。
FitMode fitMode() const: 视口尺寸变化时视图是否跟随适应规则。
void setFitMode(FitMode mode): 视口尺寸变化时视图是否跟随适应规则。
WheelAction wheelAction() const: 不按修饰键的鼠标滚轮执行的操作。
void setWheelAction(WheelAction action): 不按修饰键的鼠标滚轮执行的操作。
ControlsVisibility controlsVisibility() const: 内置缩放工具条的可见性策略。
void setControlsVisibility(ControlsVisibility visibility): 内置缩放工具条的可见性策略。
bool isZoomIndicatorEnabled() const: 工具条隐藏时，直接缩放输入是否短暂显示缩放比例。
void setZoomIndicatorEnabled(bool enabled): 工具条隐藏时，直接缩放输入是否短暂显示缩放比例。
bool isFrameVisible() const: 查看器是否绘制圆角背景和边框。
void setFrameVisible(bool visible): 查看器是否绘制圆角背景和边框。
Qt::TransformationMode transformationMode() const: 缩放图片时的采样方式；Fast 可保持单个像素清晰。
void setTransformationMode(Qt::TransformationMode mode): 缩放图片时的采样方式；Fast 可保持单个像素清晰。
void zoomIn(bool animated = false): 以视口中心为锚点放大到下一个预设档位。
void zoomOut(bool animated = false): 以视口中心为锚点缩小到上一个预设档位。
void zoomTo(qreal factor, bool animated = false): 以视口中心为锚点缩放到指定因子。
void zoomTo(qreal factor, const QPointF& viewportAnchor, bool animated = false): 缩放到指定因子，并保持视口位置下的图片点不动。
void zoomToActualSize(bool animated = false): 以视口中心为锚点按 100% 显示图片。
void fitToView(bool animated = false): 让整张图片适应视口，并在尺寸变化时保持适应。
void resetView(bool animated = false): 回到初始视图：大图缩小适应，小图保持 100%。
void panBy(qreal dx, qreal dy): 按视口像素移动可见区域；正值显示更右侧和更下方的内容。
QPointF mapToImage(const QPointF& viewportPoint) const: 将视口坐标映射为设备无关的图片坐标。
QPointF mapFromImage(const QPointF& imagePoint) const: 将设备无关的图片坐标映射为视口坐标。
QSize sizeHint() const override
QSize minimumSizeHint() const override

信号

void pixmapChanged(): 查看器显示的图片；设置新图片会复位视图。
void zoomFactorChanged(qreal factor): 当前缩放因子；1.0 为图片的设备无关尺寸。
void minZoomFactorChanged(qreal factor): 最小缩放因子；低于它的适应比例仍然可以到达。
void maxZoomFactorChanged(qreal factor): 最大缩放因子；高于它的适应比例仍然可以到达。
void viewCenterChanged(const QPointF& center): 显示在视口中心的图片坐标点，单位为设备无关的图片像素。
void fitModeChanged(fluent::scrolling::ImageViewer::FitMode mode): 视口尺寸变化时视图是否跟随适应规则。
void wheelActionChanged(fluent::scrolling::ImageViewer::WheelAction action): 不按修饰键的鼠标滚轮执行的操作。
void controlsVisibilityChanged(fluent::scrolling::ImageViewer::ControlsVisibility visibility): 内置缩放工具条的可见性策略。
void zoomIndicatorEnabledChanged(bool enabled): 工具条隐藏时，直接缩放输入是否短暂显示缩放比例。
void frameVisibleChanged(bool visible): 查看器是否绘制圆角背景和边框。
void transformationModeChanged(Qt::TransformationMode mode): 缩放图片时的采样方式；Fast 可保持单个像素清晰。

枚举

enum class FitMode: 视图遵循的适应规则。
Manual 保持缩放因子和视图中心。
Contain 完整适应视口，小图也会放大。
ScaleDown 大图缩小适应，小图保持 100%。
enum class WheelAction: 不按修饰键的鼠标滚轮动作。
Zoom 围绕指针缩放。
Pan 平移；没有范围时交给父控件。
enum class ControlsVisibility: 缩放工具条的可见性策略。
Hidden 始终隐藏。
Auto 悬停、聚焦或拖动时显示。
Visible 设置图片后始终显示。