> ## 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.

# SynthesizeBusinessCardEx Method of the FRPage Object

This method tries to find business card fields in the specified recognized region using the synthesis parameters. The method returns [BusinessCard](/fine-reader/engine/api-reference/document-related-objects/businesscard) object.

<Warning>
  The region you specify must contain recognized blocks. Therefore, one of the analysis and recognition methods must be called before this method call.
</Warning>

## Syntax

### C++

```cpp theme={null}
HRESULT SynthesizeBusinessCardEx(
  IRegion*                      Region,
  IBusinessCardSynthesisParams* Params,
  IBusinessCard**               Result
);
```

### C\#

```csharp theme={null}
IBusinessCard SynthesizeBusinessCardEx( 
  IRegion                       Region, 
  IBusinessCardSynthesisParams  Params
);
```

### Visual Basic .NET

```vb theme={null}
Function SynthesizeBusinessCardEx(_
  Region As IRegion, _
  [Params As IBusinessCardSynthesisParams = Nothing] _
) As IBusinessCard
```

## Parameters

Region

\[in] Refers to the [Region](/fine-reader/engine/api-reference/supplementary-objects-and-methods/region) object that specifies the area on image which should be interpreted as a business card. It should be set in coordinates of the deskewed black-and-white plane of the [ImageDocument](/fine-reader/engine/api-reference/image-related-objects/imagedocument). This parameter may be 0, in which case the whole image is processed.

Params

\[in] The [BusinessCardSynthesisParams](/fine-reader/engine/api-reference/parameter-objects/preprocessing-analysis-recognition-and-synthesis-parameters/businesscardsynthesisparams) object that stores parameters of business card synthesis. This parameter may be 0. In this case, the business card is synthesized with default parameters, or, if a [profile](/fine-reader/engine/guided-tour/advanced-techniques/working-with-profiles) has been loaded, the parameters set by this profile are used.

<Warning>
  This parameter must be specified when creating a recognition language in any way except the [SetPredefinedTextLanguage](/fine-reader/engine/api-reference/parameter-objects/preprocessing-analysis-recognition-and-synthesis-parameters/recognizerparams/setpredefinedtextlanguage-method) method of the [RecognizerParams](/fine-reader/engine/api-reference/parameter-objects/preprocessing-analysis-recognition-and-synthesis-parameters/recognizerparams) object.
</Warning>

Result

\[out, retval] A pointer to IBusinessCard\* pointer variable that receives the interface pointer of the [BusinessCard](/fine-reader/engine/api-reference/document-related-objects/businesscard) output object. This object provides access to the synthesized business card. Result\* may be NULL after the call to this method, if no business card is synthesized.

## 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

[FRPage](/fine-reader/engine/api-reference/document-related-objects/frpage)

[Business Card Recognition](/fine-reader/engine/guided-tour/basic-usage-scenarios-implementation/business-card-recognition)

[Working with Profiles](/fine-reader/engine/guided-tour/advanced-techniques/working-with-profiles)
