跳轉到主要內容
此方法在 Windows 版 FRE 中實作
此方法會將影像的一部分以由上而下的 DIB (裝置獨立點陣圖) 形式傳回。對於灰階與黑白影像，會使用以 0 代表黑色的調色盤。 此方法會以 Handle 物件的形式傳回 DIB。此物件會管理記憶體配置，並在資源不再使用時將其釋放。

​
語法

​
C++

HRESULT GetBitmap(
  IImageModification* Modification,
  IHandle**           Result
);

​
C#

IHandle GetBitmap( IImageModification Modification );

​
Visual Basic .NET

Function GetBitmap(Modification As IImageModification) As IHandle

​
參數

Modification [in] 此 ImageModification 類型的參數定義要對影像執行的修改。它可包含裁剪矩形，此時只會傳遞影像的指定部分；也可包含拉伸比例、用於以色彩填滿影像部分區域的繪製矩形等。此參數也可以為 0，此時不會對影像頁面執行任何修改，而會按「原樣」傳遞。 Result [out, retval] 指向 IHandle* 指標變數的指標。該變數會接收結果 Handle 物件的介面指標，此物件表示相關點陣圖的控制代碼。

​
傳回值

​
備註

如果在 Linux 中將 Engine 載入為處理序外伺服器，或在 Windows 中使用 OutprocLoader 物件建立該物件，則此方法無法使用。

​
範例

FREngine.IEngine engine;
FREngine.IFRDocument frdoc;
// 假設文件已建立，且其中已新增影像
// 取得文件頁面彩色影像平面的點陣圖控制代碼
FREngine.IFRPage page = frDoc.Pages[0];
FREngine.IImageDocument imageDoc = page.ImageDocument;
FREngine.IImage image = imageDoc.ColorImage;
FREngine.IHandle hBitmap = image.GetBitmap( null );
// 使用此點陣圖
System.Drawing.Image preprocessedImage = System.Drawing.Image.FromHbitmap( hBitmap.Handle );
...
Gdi32.DeleteObject( hBitmap );
此方法可用於下列 Windows 示範工具：Engine Predefined Processing Profiles。

​
另請參見

ImageModification IImage::EstimateBitmapSize