Table of Contents

TTMSFNCGraphics.DrawBitmapWithName Method

Looks up a bitmap by name in the assigned BitmapContainer and draws it into the double-coordinate bounding box.

API unit family: TMSFNCGraphics Declaring type: TTMSFNCGraphics

Overloads

Overload 1

Looks up a bitmap by name in the assigned BitmapContainer and draws it into the double-coordinate bounding box.

procedure DrawBitmapWithName;

Parameters

Name Description
ALeft Left edge of the destination bounding box in floating-point pixels.
ATop Top edge of the destination bounding box in floating-point pixels.
ARight Right edge of the destination bounding box in floating-point pixels.
ABottom Bottom edge of the destination bounding box in floating-point pixels.
ABitmapName Name of the bitmap to look up in the BitmapContainer.
AApplyScale When True, selects a DPI-scaled variant from the container. Default is False.
AScale DPI scale factor used when AApplyScale is True. Pass 0 to use the screen scale. Default is 0.
AAspectRatio When True, preserves the bitmap's aspect ratio. Default is True.
AStretch When True, stretches the bitmap to fill the bounding box. Default is False.
ACenter When True, centers the bitmap within the bounding box. Default is True.
ACropping When True, crops the bitmap to fill the bounding box entirely. Default is False.

Overload 2

Looks up a bitmap by name in the assigned BitmapContainer and draws it into a TRectF bounding box.

procedure DrawBitmapWithName;

Parameters

Name Description
ARect Destination bounding box on the canvas.
ABitmapName Name of the bitmap to look up in the BitmapContainer.
AApplyScale When True, selects a DPI-scaled variant from the container. Default is False.
AScale DPI scale factor used when AApplyScale is True. Pass 0 to use the screen scale. Default is 0.
AAspectRatio When True, preserves the bitmap's aspect ratio. Default is True.
AStretch When True, stretches the bitmap to fill the bounding box. Default is False.
ACenter When True, centers the bitmap within the bounding box. Default is True.
ACropping When True, crops the bitmap to fill the bounding box entirely. Default is False.

Overload 3

Looks up a bitmap by name in the assigned BitmapContainer and draws it into the integer-coordinate bounding box.

procedure DrawBitmapWithName;

Parameters

Name Description
ALeft Left edge of the destination bounding box in integer pixels.
ATop Top edge of the destination bounding box in integer pixels.
ARight Right edge of the destination bounding box in integer pixels.
ABottom Bottom edge of the destination bounding box in integer pixels.
ABitmapName Name of the bitmap to look up in the BitmapContainer.
AApplyScale When True, selects a DPI-scaled variant from the container. Default is False.
AScale DPI scale factor used when AApplyScale is True. Pass 0 to use the screen scale. Default is 0.
AAspectRatio When True, preserves the bitmap's aspect ratio. Default is True.
AStretch When True, stretches the bitmap to fill the bounding box. Default is False.
ACenter When True, centers the bitmap within the bounding box. Default is True.
ACropping When True, crops the bitmap to fill the bounding box entirely. Default is False.

Overload 4

Looks up a bitmap by name in the assigned BitmapContainer and draws it into a TRect bounding box.

procedure DrawBitmapWithName;

Parameters

Name Description
ARect Destination bounding box on the canvas, in integer pixels.
ABitmapName Name of the bitmap to look up in the BitmapContainer.
AApplyScale When True, selects a DPI-scaled variant from the container. Default is False.
AScale DPI scale factor used when AApplyScale is True. Default is 0.
AAspectRatio When True, preserves the bitmap's aspect ratio. Default is True.
AStretch When True, stretches the bitmap to fill the bounding box. Default is False.
ACenter When True, centers the bitmap within the bounding box. Default is True.
ACropping When True, crops the bitmap to fill the bounding box entirely. Default is False.