The image block is a shape block that is a direct child of a shape and is used to display a raster or a vector image. As both the image block and the text block inherit from NShapeBlock they have a lot in common, for example they have the same properties related to block transform (PinX, PinY, LocPinX, LocPinY, etc.). For more information about these properties and how to configure shape block transform, check out the Text Block documentation topic.

The code below shows how to set an image to the image block of a shape:

shape.ImageBlock.Image = NImage.FromFileBytes(@"C:\MyImage.png");

The image block also provides the following properties:

• ResizeMode - defines the way the image block is resized. Can be one of the following:
  • None - the image block is not automatically resized.
  • ShapeSize - the image block is automatically resized to the size of the owner shape.
  • ImageSize - the image block is resized to its desired size.
  
  
• TextureMapping - defines how the image show be placed in the available area of the image block - stretched, fitted, aligned, centered and so on. For more information about texture mappings, check out the Texture Mapping documentation topic.