# TextControl.SignatureFieldLayoutDialog Method

> Invokes the built-in dialog box for alter the layout settings, the size and the text distances of a signature field. This dialog can only be invoked, if a signature field has been selected.

- **Product:** TX Text Control .NET for Windows Forms
- **Section:** Reference
- **Kind:** Method
- **Introduced:** 31.0
- **Namespace:** `TXTextControl`
- **Package:** `TXTextControl.TextControl.WinForms.SDK` (assembly `TXTextControl.Windows.Forms.dll`, from the private NuGet feed or Text Control Offline Packages)
- **.NET Framework:** reference `TXTextControl.Windows.Forms.dll` from the setup
- **Path:** TX Text Control .NET for Windows Forms > Reference > TXTextControl > TextControl.SignatureFieldLayoutDialog Method
- **674 words**
- **Web URL:** https://docs.textcontrol.com/tx-text-control-dotnet-winforms/reference/txtextcontrol/textcontrol/signaturefieldlayoutdialog-method/
- **LLMs URL:** https://docs.textcontrol.com/tx-text-control-dotnet-winforms/reference/txtextcontrol/textcontrol/signaturefieldlayoutdialog-method/llms.txt
- **LLMs-Full URL:** https://docs.textcontrol.com/tx-text-control-dotnet-winforms/reference/txtextcontrol/textcontrol/signaturefieldlayoutdialog-method/llms-full.txt

---

### Description

Invokes the built-in dialog box for alter the layout settings, the size and the text distances of a signature field. This dialog can only be invoked, if a signature field has been selected.

### Syntax

#### SignatureFieldLayoutDialog()

Opens the dialog box showing the last opened tab.

```csharp
public System.Windows.Forms.DialogResult SignatureFieldLayoutDialog();
```

```vbnet
Public Function SignatureFieldLayoutDialog() As System.Windows.Forms.DialogResult
```

#### SignatureFieldLayoutDialog(int)

Opens the dialog box showing the specified tab.

```csharp
public System.Windows.Forms.DialogResult SignatureFieldLayoutDialog(int activeTab);
```

```vbnet
Public Function SignatureFieldLayoutDialog(activeTab As Integer) As System.Windows.Forms.DialogResult
```

| Parameter | Description |
|---|---|
| activeTab | Specifies the index of the tab, zero-based, that is displayed when the tabbed dialog box is opened. If this parameter is 0, the dialog box shows the tab for setting text wrapping and layout attributes, if this parameter is 1, the dialog box shows the tab for setting size and distances and if it is 2, the dialog shows the tab for setting the signature image's saving attributes. 2 can only be used, if an signature image has been set. |

### Return Value

If the dialog has been left with the Cancel button the return value is DialogResult.Cancel. Otherwise, it is DialogResult.OK.

### Examples

The following example opens the signature field layout dialog for the text control.

```csharp
var result = textControl.SignatureFieldLayoutDialog(10);
Console.WriteLine($"Signature Field Layout Dialog result: {result}");
```

```vbnet
Dim result = textControl.SignatureFieldLayoutDialog(10)
Console.WriteLine($"Signature Field Layout Dialog result: {result}")
```

---

## Nearby

- **Previous:** [TextControl.SignatureFieldDeselected Event](https://docs.textcontrol.com/tx-text-control-dotnet-winforms/reference/txtextcontrol/textcontrol/signaturefielddeselected-event/llms-full.txt)
- **Next:** [TextControl.SignatureFields Property](https://docs.textcontrol.com/tx-text-control-dotnet-winforms/reference/txtextcontrol/textcontrol/signaturefields-property/llms-full.txt)
