# ProgramGroupHandle

Import: `import com.install4j.api.test.formcomponents.ProgramGroupHandle;`

```java
interface ProgramGroupHandle extends FormComponentHandle
```

Handle for the "Program group selector" form component. The principal Swing widget is the
program-group name `JTextField`. Used on Windows installations to pick the start menu group.

Reach this handle via [`ScreenHandle.programGroup`](../ui/ScreenHandle.md#programgroup).

## Inherited from

- [FormComponentHandle](FormComponentHandle.md) — 7 methods

## Methods

| Signature | Returns | Description |
|---|---|---|
| [`getProgramGroup()`](#getprogramgroup) | `String` | The currently entered program group name. |
| [`setProgramGroup(String)`](#setprogramgroup-string) | `ProgramGroupHandle` | Set the program group name. |
| [`isAllUsers()`](#isallusers) | `boolean` | Whether the form component creates the group for all users or just the current user. |
| [`assertProgramGroup(String)`](#assertprogramgroup-string) | `ProgramGroupHandle` | Assert the current program group name equals the expected value. |
| [`assertEnabled()`](#assertenabled) | `ProgramGroupHandle` |  |
| [`assertDisabled()`](#assertdisabled) | `ProgramGroupHandle` |  |
| [`assertVisible()`](#assertvisible) | `ProgramGroupHandle` |  |
| [`assertInvisible()`](#assertinvisible) | `ProgramGroupHandle` |  |

### getProgramGroup()

```java
String getProgramGroup()
```

The currently entered program group name.

### setProgramGroup(String)

```java
ProgramGroupHandle setProgramGroup(String name)
```

Set the program group name.

### isAllUsers()

```java
boolean isAllUsers()
```

Whether the form component creates the group for all users or just the current user.

### assertProgramGroup(String)

```java
ProgramGroupHandle assertProgramGroup(String expected)
```

Assert the current program group name equals the expected value.

### assertEnabled()

```java
ProgramGroupHandle assertEnabled()
```

### assertDisabled()

```java
ProgramGroupHandle assertDisabled()
```

### assertVisible()

```java
ProgramGroupHandle assertVisible()
```

### assertInvisible()

```java
ProgramGroupHandle assertInvisible()
```

