EnumControl - Java 11中文版 - API参考文档

API Reference Document

java.lang.Object
- javax.sound.sampled.Control
- - javax.sound.sampled.EnumControl

```
public abstract class EnumControl
extends Control
```
EnumControl提供对一组离散可能值的控制，每个值由对象表示。在图形用户界面中，这样的控件可以由一组按钮表示，每个按钮选择一个值或设置。例如，混响控件可能提供多个预设混响设置，而不是提供由FloatControl对象表示的连续可调参数。
仅在两个设置之间进行选择的控件通常可以实现为BooleanControl ，而沿某些可量化维度提供一组值的控件可以实现为具有粗分辨率的FloatControl 。但是， EnumControl一个关键特性是返回的值是任意对象，而不是数值或布尔值。这意味着每个返回的对象都可以提供更多信息。作为一个例子，一个的设置REVERB控制是实例ReverbType可以查询对用于每个设置的参数值。

从以下版本开始：

1.3

嵌套类汇总

嵌套类
变量和类型	类	描述
`static class`	`EnumControl.Type`	`EnumControl.Type`内部类的实例标识一种枚举控件。

构造方法摘要

构造方法
变量	构造器	描述
`protected`	`EnumControl(EnumControl.Type type, Object[] values, Object value)`	使用给定参数构造一个新的枚举控件对象。

方法摘要

所有方法实例方法具体的方法
变量和类型	方法	描述
`Object`	`getValue()`	获得此控件的当前值。
`Object[]`	`getValues()`	返回此控件的可能值集。
`void`	`setValue(Object value)`	设置控件的当前值。
`String`	`toString()`	提供控件的字符串表示形式。

声明方法的类 javax.sound.sampled.Control
getType

声明方法的类 java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

- 构造方法详细信息
  - EnumControl
```
protected EnumControl(EnumControl.Type type,
                      Object[] values,
                      Object value)
```
    使用给定参数构造一个新的枚举控件对象。
    
    参数
    
    type - 表示此枚举控制对象的控件类型
    
    values - 控件的可能值集
    
    value - 初始控制值
- 方法详细信息
  - setValue
```
public void setValue(Object value)
```
    设置控件的当前值。默认实现只是按指示设置值。如果不支持指示的值，则抛出IllegalArgumentException 。某些控件要求在通过设置值来影响它们之前打开它们的线。
    
    参数
    
    value - 所需的新值
    
    异常
    
    IllegalArgumentException - 如果指示的值不在允许范围内
  - getValue
```
public Object getValue()
```
    获得此控件的当前值。
    
    结果
    
    当前的价值
  - getValues
```
public Object[] getValues()
```
    返回此控件的可能值集。
    
    结果
    
    可能值的集合
  - toString
```
public String toString()
```
    提供控件的字符串表示形式。
    
    重写：
    
    toString ，类 Control
    
    结果
    
    字符串描述