# QBitmap Class Reference ## [[QtGui](index.htm) module] 該QBitmap類提供單色（ 1位深度）的像素圖。[More...](#details) 繼承[QPixmap](qpixmap.html)。 ### Methods * `__init__ (self)` * `__init__ (self, QPixmap)` * `__init__ (self, int?w, int?h)` * `__init__ (self, QSize)` * `__init__ (self, QString?fileName, str?format?=?None)` * `__init__ (self, QVariant?variant)` * `__init__ (self, QBitmap)` * `clear (self)` * `swap (self, QBitmap?other)` * `QBitmap transformed (self, QMatrix)` * `QBitmap transformed (self, QTransform?matrix)` ### Static Methods * `QBitmap fromData (QSize?size, str?bits, QImage.Format?format?=?QImage.Format_MonoLSB)` * `QBitmap fromImage (QImage?image, Qt.ImageConversionFlags?flags?=?Qt.AutoColor)` * * * ## Detailed Description 該QBitmap類提供單色（ 1位深度）的像素圖。 該QBitmap類是單色主要用于創建自定義屏幕外漆設備[QCursor](qcursor.html)和[QBrush](qbrush.html)對象，構建[QRegion](qregion.html)對象，并設置口罩像素圖和部件。 QBitmap是[QPixmap](qpixmap.html)子類確保一個深度為1 ，除了它具有為0的深度空對象。如果用深度大于1的像素圖被分配給一個位圖，該位圖將被自動抖動。 使用[QColor](qcolor.html)對象[Qt.color0](qt.html#GlobalColor-enum)和[Qt.color1](qt.html#GlobalColor-enum)在QBitmap對象（或繪圖時[QPixmap](qpixmap.html)隨著深度的1反對） 。 與繪畫[Qt.color0](qt.html#GlobalColor-enum)設置位圖位為0，并用繪畫[Qt.color1](qt.html#GlobalColor-enum)設置位為1位。為位圖， 0位表示背景（或透明的像素）和1 - 位指示前景（或不透明像素）。使用[clear](qbitmap.html#clear)（ ）函數來設置所有位[Qt.color0](qt.html#GlobalColor-enum)。注意，使用[Qt.black](qt.html#GlobalColor-enum)和[Qt.white](qt.html#GlobalColor-enum)顏色沒有任何意義，因為[QColor.pixel](index.htm#pixel)（ ）值不一定是0和黑1白。 該QBitmap類提供[transformed](qbitmap.html#transformed)（ ）函數返回的位圖的轉化副本;使用[QTransform](qtransform.html)參數平移，縮放，剪切，旋轉位圖。此外， QBitmap提供靜態[fromData](qbitmap.html#fromData)（ ）函數，它返回從給定的構造位圖`uchar`數據，并且將靜態[fromImage](qbitmap.html#fromImage)（ ）函數返回的轉換副本[QImage](qimage.html)對象。 就像[QPixmap](qpixmap.html)類， QBitmap通過使用隱式數據共享進行了優化。欲了解更多信息，請參閱[Implicit Data Sharing](index.htm#implicit-data-sharing)文檔。 * * * ## Method Documentation ``` QBitmap.__init__ (self) ``` 構造一個空的位圖。 **See also** [QPixmap.isNull](qpixmap.html#isNull)（ ） 。 ``` QBitmap.__init__ (self, QPixmap) ``` 構造一個位圖，它是給定的一個副本_pixmap_。 如果該像素圖的深度大于1時，所得到的位圖將被自動抖動。 **See also** [QPixmap.depth](qpixmap.html#depth)（ ）[fromImage](qbitmap.html#fromImage)（）和[fromData](qbitmap.html#fromData)（ ） 。 ``` QBitmap.__init__ (self, int?w, int?h) ``` 構造一個位圖與給定_width_和_height_。像素內是未初始化的。 **See also** [clear](qbitmap.html#clear)（ ） 。 ``` QBitmap.__init__ (self, QSize) ``` 構造一個位圖與給定_size_。位圖中的像素被初始化。 **See also** [clear](qbitmap.html#clear)（ ） 。 ``` QBitmap.__init__ (self, QString?fileName, str?format?=?None) ``` 構造一個位圖從給定的指定的文件_fileName_。如果文件不存在，或者有未知格式，位圖變成一個空的位圖。 該_fileName_和_format_參數上傳遞[QPixmap.load](qpixmap.html#load)（）函數。如果文件格式使用每像素1位以上，由此產生的位圖將被自動抖動。 **See also** [QPixmap.isNull](qpixmap.html#isNull)（）和[QImageReader.imageFormat](qimagereader.html#imageFormat)（ ） 。 ``` QBitmap.__init__ (self, QVariant?variant) ``` ``` QBitmap.__init__ (self, QBitmap) ``` ``` QBitmap.clear (self) ``` 清除該位圖，它的所有位設置為[Qt.color0](qt.html#GlobalColor-enum)。 ``` QBitmap QBitmap.fromData (QSize?size, str?bits, QImage.Format?format?=?QImage.Format_MonoLSB) ``` [ 構造一個位圖與給定_size_，并且將內容發送到_bits_提供。 ](qbitmap.html) [位圖數據必須字節對齊的，由指定的位順序提供_monoFormat_。單格式必須是](qbitmap.html)[QImage.Format_Mono](qimage.html#Format-enum) or [QImage.Format_MonoLSB](qimage.html#Format-enum)。使用[QImage.Format_Mono](qimage.html#Format-enum)指定的XBM格式的數據。 **See also** [fromImage](qbitmap.html#fromImage)（ ） 。 ``` QBitmap QBitmap.fromImage (QImage?image, Qt.ImageConversionFlags?flags?=?Qt.AutoColor) ``` [ 返回給定的一個副本_image_使用指定的圖像變換轉換為位圖_flags_。 ](qbitmap.html) [**See also**](qbitmap.html) [fromData](qbitmap.html#fromData)（ ） 。 ``` QBitmap.swap (self, QBitmap?other) ``` 掉期的位圖_other_與此位圖。這個操作是非常快的，而且永遠不會。 此功能被引入Qt的4.8 。 ``` QBitmap QBitmap.transformed (self, QMatrix) ``` [ 根據給定返回此位圖的副本，轉化_matrix_。 ](qbitmap.html) [**See also**](qbitmap.html) [QPixmap.transformed](qpixmap.html#transformed)（ ） 。 ``` QBitmap QBitmap.transformed (self, QTransform?matrix) ``` [](qbitmap.html)