> ## Documentation Index
> Fetch the complete documentation index at: https://docs.abbyy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# AddNew Method of the LayoutBlocks Object

This method creates a [Block](/fine-reader/engine/api-reference/layout-related-objects/block) object of the type specified and adds it into the collection of the layout blocks.

## Syntax

### C++

```cpp theme={null}
HRESULT AddNew(
  BlockTypeEnum BlockType,
  IRegion*      BlockRegion,
  int           Position,
  IBlock**      Result
);
```

### C\#

```csharp theme={null}
IBlock AddNew(
  BlockTypeEnum BlockType,
  Region        BlockRegion
  int           Position
);
```

### Visual Basic .NET

```vb theme={null}
Function AddNew( _
  BlockType As BlockTypeEnum, _
  BlockRegion As Region, _
  Position As Integer _
) As IBlock
```

## Parameters

BlockType

\[in] This variable of the [BlockTypeEnum](/fine-reader/engine/api-reference/enumerations/blocktypeenum) type specifies the type of the newly created block. It cannot be BT\_AutoAnalysis, BT\_Separator, BT\_SeparatorGroup.

BlockRegion

\[in] Refers to the [Region](/fine-reader/engine/api-reference/supplementary-objects-and-methods/region) object that specifies the region of the newly created block. It is optional and can be null, in which case the block is created of the dimensions [ILayout::Height](/fine-reader/engine/api-reference/layout-related-objects/layout#height), [ILayout::Width](/fine-reader/engine/api-reference/layout-related-objects/layout#width). If the width and height of the layout are equal to 0, the new block will be of the dimensions 1\*1 pixels.

Position

\[in] Specifies the position of the newly created block in the collection.

Result

\[out, retval] A pointer to [IBlock](/fine-reader/engine/api-reference/layout-related-objects/block)\* pointer variable that receives the interface pointer of the created block.

## Return values

This method has no specific return values. It returns the [standard return values of ABBYY FineReader Engine functions](/fine-reader/engine/api-reference/return-codes).

## See also

[LayoutBlocks](/fine-reader/engine/api-reference/layout-related-objects/layoutblocks)

[Block](/fine-reader/engine/api-reference/layout-related-objects/block)

[Working with Collections](/fine-reader/engine/guided-tour/advanced-techniques/programming-aspects/working-with-collections)