Admin Production ni-theme
Current Publication

DuplicateBitmap

LabWindows/CVI

DuplicateBitmap

int DuplicateBitmap (int bitmapID, int *newBitmapID);

Purpose

Creates an exact copy of a bitmap created using functions that return a bitmap ID, such as NewBitmapEx and GetCtrlBitmap.

Parameters

Input
Name Type Description
bitmapID int ID of the bitmap object that contains the image. You can obtain the ID from functions such as NewBitmapEx and GetCtrlBitmap.
Output
Name Type Description
newBitmapID int ID that serves as a handle to the bitmap object.

You can pass the ID to CanvasDrawBitmap, ClipboardPutBitmap, or any other function that accepts a bitmap.

To discard the bitmap, pass the ID to DiscardBitmap.

Zero is not a valid bitmap ID.

Return Value

Name Type Description
status int Return value indicating whether the function was successful. A negative number indicates that an error occurred.

Additional Information

Library: User Interface Library

Include file: userint.h

LabWindows/CVI compatibility: LabWindows/CVI 8.0 and later