QSvgRenderer Class Reference · PyQt4 中文文檔

# QSvgRenderer Class Reference ## [[QtSvg](index.htm) module] 該QSvgRenderer類用于繪制SVG文件的內容復制到繪圖設備。[More...](#details) 繼承[QObject](qobject.html)。 ### Methods * `__init__ (self, QObject?parent?=?None)` * `__init__ (self, QString?filename, QObject?parent?=?None)` * `__init__ (self, QByteArray?contents, QObject?parent?=?None)` * `__init__ (self, QXmlStreamReader?contents, QObject?parent?=?None)` * `bool animated (self)` * `int animationDuration (self)` * `QRectF boundsOnElement (self, QString?id)` * `int currentFrame (self)` * `QSize defaultSize (self)` * `bool elementExists (self, QString?id)` * `int framesPerSecond (self)` * `bool isValid (self)` * `bool load (self, QString?filename)` * `bool load (self, QByteArray?contents)` * `bool load (self, QXmlStreamReader?contents)` * `QMatrix matrixForElement (self, QString?id)` * `render (self, QPainter?p)` * `render (self, QPainter?p, QRectF?bounds)` * `render (self, QPainter?painter, QString?elementId, QRectF?bounds?=?QRectF())` * `setCurrentFrame (self, int)` * `setFramesPerSecond (self, int?num)` * `setViewBox (self, QRect?viewbox)` * `setViewBox (self, QRectF?viewbox)` * `QRect viewBox (self)` * `QRectF viewBoxF (self)` ### Qt Signals * `void repaintNeeded ()` * * * ## Detailed Description 該QSvgRenderer類用于繪制SVG文件的內容復制到繪圖設備。使用QSvgRenderer ，可伸縮矢量圖形（SVG ）可以渲染到任何[QPaintDevice](qpaintdevice.html)子類，包括[QWidget](qwidget.html)，[QImage](qimage.html)和[QGLWidget](qglwidget.html)。 QSvgRenderer提供了一個支持SVG渲染的基本功能，如加載和渲染靜態的圖紙，和喜歡動漫的更多互動功能的API。由于使用所執行的渲染[QPainter](qpainter.html)， SVG圖形可以在任意子類被渲染[QPaintDevice](qpaintdevice.html)。 SVG繪圖要么加載時QSvgRenderer構造，或加載后使用[load](qsvgrenderer.html#load)（）函數。數據是提供直接作為序列化的XML ，或間接使用文件名。如果一個有效的文件已經被加載，或者當渲染器構造或在一段時間后，[isValid](qsvgrenderer.html#isValid)（）返回True ，否則返回False 。 QSvgRenderer提供[render](qsvgrenderer.html#render)（）槽呈現當前文件或動畫文件的當前幀中，使用給定的畫家。該[defaultSize](qsvgrenderer.html#defaultSize)（）函數，提供了有關的空間來呈現當前加載的SVG文件所需要的量的信息。這是用于涂料的設備，如可使用[QWidget](qwidget.html)，往往需要提供尺寸暗示給其父布局。圖形的默認大小可以從它的可視面積，發現使用不同的[viewBox](qsvgrenderer.html#viewBox-prop)屬性。動畫SVG圖形的支持，并且可以用函數和屬性的簡單集合進行控制： * The [animated](qsvgrenderer.html#animated)() function indicates whether a drawing contains animation information. * The [framesPerSecond](qsvgrenderer.html#framesPerSecond-prop) property contains the rate at which the animation plays. 最后， QSvgRenderer類提供了[repaintNeeded](qsvgrenderer.html#repaintNeeded)（），它被發射每當需要更新的文件的再現信號。 * * * ## Method Documentation ``` QSvgRenderer.__init__ (self, QObject?parent?=?None) ``` 該_parent_的說法，如果不是沒有，原因_self_通過Qt的，而不是PyQt的擁有。構造一個新的渲染器給定的_parent_。 ``` QSvgRenderer.__init__ (self, QString?filename, QObject?parent?=?None) ``` 該_parent_的說法，如果不是沒有，原因_self_通過Qt的，而不是PyQt的擁有。構造一個新的渲染器給定的_parent_并載入SVG文件中的內容與指定_filename_。 ``` QSvgRenderer.__init__ (self, QByteArray?contents, QObject?parent?=?None) ``` 該_parent_的說法，如果不是沒有，原因_self_通過Qt的，而不是PyQt的擁有。構造一個新的渲染器給定的_parent_并加載從指定的字節數組中的SVG數據_contents_。 ``` QSvgRenderer.__init__ (self, QXmlStreamReader?contents, QObject?parent?=?None) ``` 該_parent_的說法，如果不是沒有，原因_self_通過Qt的，而不是PyQt的擁有。構造一個新的渲染器給定的_parent_并且通過使用指定的流讀取器加載SVG數據_contents_。此功能被引入Qt的4.5 。 ``` bool QSvgRenderer.animated (self) ``` 返回True如果當前文檔包含動畫元素，否則返回False 。 **See also** [framesPerSecond](qsvgrenderer.html#framesPerSecond-prop)（）。 ``` int QSvgRenderer.animationDuration (self) ``` ``` QRectF QSvgRenderer.boundsOnElement (self, QString?id) ``` [ 返回邊界項目的矩形與給定_id_。父元素的變換矩陣是不影響該元素的邊界。這個函數中引入了Qt 4.2中。 ](qrectf.html) [**See also**](qrectf.html) [matrixForElement](qsvgrenderer.html#matrixForElement)（）。 ``` int QSvgRenderer.currentFrame (self) ``` ``` QSize QSvgRenderer.defaultSize (self) ``` [ 返回的文檔內容的默認大小。 ``` bool QSvgRenderer.elementExists (self, QString?id) ``` 返回True如果與元素給定的_id_存在于當前解析SVG文件，是一個可渲染的元素。注意：此方法僅適用于可渲染的元素返回True 。這意味著被視為填充/描邊樣式屬性的一部分元素，例如：甚至強硬的標有“身份證” radialGradients屬性不會用這種方法發現。這個函數中引入了Qt 4.2中。 ``` int QSvgRenderer.framesPerSecond (self) ``` ``` bool QSvgRenderer.isValid (self) ``` 返回True如果有一個有效的當前文檔，否則返回False 。 ``` bool QSvgRenderer.load (self, QString?filename) ``` 這種方法也是一個Qt槽與C + +的簽名`bool load(const QString&)`。通過加載指定的SVG文件_filename_，返回True，如果內容被成功解析，否則返回False 。 ``` bool QSvgRenderer.load (self, QByteArray?contents) ``` 這種方法也是一個Qt槽與C + +的簽名`bool load(const QByteArray&)`。加載指定的SVG格式_contents_，返回True，如果內容被成功解析，否則返回False 。 ``` bool QSvgRenderer.load (self, QXmlStreamReader?contents) ``` 這種方法也是一個Qt槽與C + +的簽名`bool load(QXmlStreamReader *)`。加載指定的SVG中_contents_，返回True，如果內容被成功解析，否則返回False 。讀者將用于從那里它目前的位置。如果_contents_ is `null`，行為是未定義的。此功能被引入Qt的4.5 。 ](qsize.html) ``` QMatrix QSvgRenderer.matrixForElement (self, QString?id) ``` [ 返回該元素的變換矩陣與給定_id_。該矩陣元素的父母轉型的產物。不包括元素本身的轉型。 ](qmatrix.html) [要查找在邏輯坐標元素的邊框，你可以申請矩陣從返回的矩形](qmatrix.html)[boundsOnElement](qsvgrenderer.html#boundsOnElement)（）。這個函數中引入了Qt 4.2中。 **See also** [boundsOnElement](qsvgrenderer.html#boundsOnElement)（）。 ``` QSvgRenderer.render (self, QPainter?p) ``` 這種方法也是一個Qt槽與C + +的簽名`void render(QPainter *)`。呈現當前文檔或動畫文件的當前幀，使用給定的_painter_。 ``` QSvgRenderer.render (self, QPainter?p, QRectF?bounds) ``` 這種方法也是一個Qt槽與C + +的簽名`void render(QPainter *,const QRectF&)`。呈現當前文檔或動畫文件的當前幀，使用給定的_painter_在指定的_bounds_在畫家。如果未指定邊界矩形是SVG文件被映射到整個繪圖設備。 ``` QSvgRenderer.render (self, QPainter?painter, QString?elementId, QRectF?bounds?=?QRectF()) ``` 這種方法也是一個Qt槽與C + +的簽名`void render(QPainter *,const QString&,const QRectF& = QRectF())`。呈現給定的元素與_elementId_使用給定的_painter_在指定的_bounds_。如果未指定邊界矩形是SVG元素映射到整個繪圖設備。 ``` QSvgRenderer.setCurrentFrame (self, int) ``` ``` QSvgRenderer.setFramesPerSecond (self, int?num) ``` ``` QSvgRenderer.setViewBox (self, QRect?viewbox) ``` ``` QSvgRenderer.setViewBox (self, QRectF?viewbox) ``` ``` QRect QSvgRenderer.viewBox (self) ``` [](qrect.html) [Returns](qrect.html) [viewBoxF](qsvgrenderer.html#viewBox-prop)（）。 toRect （）。 **See also** [setViewBox](qsvgrenderer.html#viewBox-prop)（）和[viewBoxF](qsvgrenderer.html#viewBox-prop)（）。 ``` QRectF QSvgRenderer.viewBoxF (self) ``` [ * * * ## Qt Signal Documentation ``` void repaintNeeded () ``` 這是該信號的默認超載。這個信號被發射每當需要更新時，通常為動畫的目的文件的呈現。 ](qrectf.html)