ShortMessage (Java Platform SE 8)

java.lang.Object
- javax.sound.midi.MidiMessage
- - javax.sound.midi.ShortMessage

すべての実装されたインタフェース:

Cloneable
```
public class ShortMessage
extends MidiMessage
```
ShortMessageには、ステータス・バイトのあとに2バイトまでのデータ・バイトが続くMIDIメッセージが格納されます。これの基準を満たすMIDIメッセージには、チャネル・ボイス、チャネル・モード、システム・コモン、システム・リアルタイムの各形式、つまりシステム・エクスクルーシブとメタイベントを除くすべてが含まれます。ShortMessageクラスでは、MIDIメッセージの内容を取得および設定するメソッドが提供されます。
ShortMessageのいくつかのメソッドには、MIDIのステータス・バイトまたはデータ・バイトを指定するための整数型パラメータがあります。数値がわかっている場合は、それを直接指定できます。システム・コモン・メッセージおよびシステム・リアルタイム・メッセージでは、多くの場合SYSTEM_RESETなどの、対応するShortMessageのフィールドを使用できます。チャネル・メッセージでは、ステータス・バイトの上位4ビットをコマンド値によって指定し、下位4ビットをMIDIチャネル番号によって指定します。Javaの符号付きバイト形式で受信されたMIDIデータ・バイトを変換するには、MidiMessageクラスの説明にある変換コードを使用できます。

関連項目:

SysexMessage、MetaMessage

フィールドのサマリー

フィールド
修飾子と型	フィールドと説明
`static int`	`ACTIVE_SENSING` アクティブ・センシング・メッセージのステータス・バイト(0xFEまたは254)です。
`static int`	`CHANNEL_PRESSURE` チャネル・プレッシャ(アフタータッチ)メッセージのコマンド値(0xD0または208)です。
`static int`	`CONTINUE` コンティニュー・メッセージのステータス・バイト(0xFBまたは251)です。
`static int`	`CONTROL_CHANGE` コントロール・チェンジ・メッセージのコマンド値(0xB0または176)です。
`static int`	`END_OF_EXCLUSIVE` エンド・オブ・システム・エクスクルーシブ・メッセージのステータス・バイト(0xF7または247)です。
`static int`	`MIDI_TIME_CODE` MIDIタイム・コード・クォータ・フレーム・メッセージのステータス・バイト(0xF1または241)です。
`static int`	`NOTE_OFF` ノート・オフメッセージのコマンド値(0x80または128)です。
`static int`	`NOTE_ON` ノート・オンメッセージのコマンド値(0x90または144)です。
`static int`	`PITCH_BEND` ピッチ・ベンド・メッセージのコマンド値(0xE0または224)です。
`static int`	`POLY_PRESSURE` ポリフォニック・キー・プレッシャ(アフタータッチ)メッセージのコマンド値(0xA0または160)です。
`static int`	`PROGRAM_CHANGE` プログラム・チェンジ・メッセージのコマンド値(0xC0または192)です。
`static int`	`SONG_POSITION_POINTER` ソング・ポジション・ポインタ・メッセージのステータス・バイト(0xF2または242)です。
`static int`	`SONG_SELECT` MIDIソング・セレクト・メッセージのステータス・バイト(0xF3または243)です。
`static int`	`START` スタート・メッセージのステータス・バイト(0xFAまたは250)です。
`static int`	`STOP` ストップ・メッセージのステータス・バイト(0xFCまたは252)です。
`static int`	`SYSTEM_RESET` システム・リセット・メッセージのステータス・バイト(0xFFまたは255)です。
`static int`	`TIMING_CLOCK` タイミング・クロック・メッセージのステータス・バイト(0xF8または248)です。
`static int`	`TUNE_REQUEST` チューン・リクエスト・メッセージのステータス・バイト(0xF6または246)です。

クラス javax.sound.midi.MidiMessageから継承されたフィールド
data, length

コンストラクタのサマリー

コンストラクタ
修飾子	コンストラクタと説明
	`ShortMessage()` 新しい`ShortMessage`を構築します。
`protected`	`ShortMessage(byte[] data)` 新しい`ShortMessage`を構築します。
	`ShortMessage(int status)` データ・バイトを必要としないMIDIメッセージを表す`ShortMessage`を新しく構築します。
	`ShortMessage(int status, int data1, int data2)` データ・バイト2つで構成されるMIDIメッセージを表す`ShortMessage`を新しく構築します。
	`ShortMessage(int command, int channel, int data1, int data2)` データ・バイト2つで構成されるチャネルMIDIメッセージを表す`ShortMessage`を新しく構築します。

メソッドのサマリー

すべてのメソッドインスタンス・メソッド具象メソッド
修飾子と型	メソッドと説明
`Object`	`clone()` このオブジェクトと同じクラスで、同じ内容の新しいオブジェクトを作成します。
`int`	`getChannel()` このイベントに関連したMIDIチャネルを取得します。
`int`	`getCommand()` このイベントに関連したMIDIコマンドを取得します。
`int`	`getData1()` メッセージの第1データ・バイトを取得します。
`int`	`getData2()` メッセージの第2データ・バイトを取得します。
`protected int`	`getDataLength(int status)` 特定のステータス・バイト値に関連したデータ・バイト数を取得します。
`void`	`setMessage(int status)` データ・バイトを必要としないMIDIメッセージのパラメータを設定します。
`void`	`setMessage(int status, int data1, int data2)` データ・バイト1つまたは2つで構成されるMIDIメッセージのパラメータを設定します。
`void`	`setMessage(int command, int channel, int data1, int data2)` データ・バイト2つで構成されるチャネル・メッセージにショート・メッセージ・パラメータを設定します。

クラス javax.sound.midi.MidiMessageから継承されたメソッド
getLength, getMessage, getStatus, setMessage

クラス java.lang.Objectから継承されたメソッド
equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- フィールドの詳細
  - MIDI_TIME_CODE
```
public static final int MIDI_TIME_CODE
```
    MIDIタイム・コード・クォータ・フレーム・メッセージのステータス・バイト(0xF1または241)です。
    
    関連項目:
    
    MidiMessage.getStatus()、定数フィールド値
  - SONG_POSITION_POINTER
```
public static final int SONG_POSITION_POINTER
```
    ソング・ポジション・ポインタ・メッセージのステータス・バイト(0xF2または242)です。
    
    関連項目:
    
    MidiMessage.getStatus()、定数フィールド値
  - SONG_SELECT
```
public static final int SONG_SELECT
```
    MIDIソング・セレクト・メッセージのステータス・バイト(0xF3または243)です。
    
    関連項目:
    
    MidiMessage.getStatus()、定数フィールド値
  - TUNE_REQUEST
```
public static final int TUNE_REQUEST
```
    チューン・リクエスト・メッセージのステータス・バイト(0xF6または246)です。
    
    関連項目:
    
    MidiMessage.getStatus()、定数フィールド値
  - END_OF_EXCLUSIVE
```
public static final int END_OF_EXCLUSIVE
```
    エンド・オブ・システム・エクスクルーシブ・メッセージのステータス・バイト(0xF7または247)です。
    
    関連項目:
    
    MidiMessage.getStatus()、定数フィールド値
  - TIMING_CLOCK
```
public static final int TIMING_CLOCK
```
    タイミング・クロック・メッセージのステータス・バイト(0xF8または248)です。
    
    関連項目:
    
    MidiMessage.getStatus()、定数フィールド値
  - START
```
public static final int START
```
    スタート・メッセージのステータス・バイト(0xFAまたは250)です。
    
    関連項目:
    
    MidiMessage.getStatus()、定数フィールド値
  - CONTINUE
```
public static final int CONTINUE
```
    コンティニュー・メッセージのステータス・バイト(0xFBまたは251)です。
    
    関連項目:
    
    MidiMessage.getStatus()、定数フィールド値
  - STOP
```
public static final int STOP
```
    ストップ・メッセージのステータス・バイト(0xFCまたは252)です。
    
    関連項目:
    
    MidiMessage.getStatus()、定数フィールド値
  - ACTIVE_SENSING
```
public static final int ACTIVE_SENSING
```
    アクティブ・センシング・メッセージのステータス・バイト(0xFEまたは254)です。
    
    関連項目:
    
    MidiMessage.getStatus()、定数フィールド値
  - SYSTEM_RESET
```
public static final int SYSTEM_RESET
```
    システム・リセット・メッセージのステータス・バイト(0xFFまたは255)です。
    
    関連項目:
    
    MidiMessage.getStatus()、定数フィールド値
  - NOTE_OFF
```
public static final int NOTE_OFF
```
    ノート・オフメッセージのコマンド値(0x80または128)です。
    
    関連項目:
    
    定数フィールド値
  - NOTE_ON
```
public static final int NOTE_ON
```
    ノート・オンメッセージのコマンド値(0x90または144)です。
    
    関連項目:
    
    定数フィールド値
  - POLY_PRESSURE
```
public static final int POLY_PRESSURE
```
    ポリフォニック・キー・プレッシャ(アフタータッチ)メッセージのコマンド値(0xA0または160)です。
    
    関連項目:
    
    定数フィールド値
  - CONTROL_CHANGE
```
public static final int CONTROL_CHANGE
```
    コントロール・チェンジ・メッセージのコマンド値(0xB0または176)です。
    
    関連項目:
    
    定数フィールド値
  - PROGRAM_CHANGE
```
public static final int PROGRAM_CHANGE
```
    プログラム・チェンジ・メッセージのコマンド値(0xC0または192)です。
    
    関連項目:
    
    定数フィールド値
  - CHANNEL_PRESSURE
```
public static final int CHANNEL_PRESSURE
```
    チャネル・プレッシャ(アフタータッチ)メッセージのコマンド値(0xD0または208)です。
    
    関連項目:
    
    定数フィールド値
  - PITCH_BEND
```
public static final int PITCH_BEND
```
    ピッチ・ベンド・メッセージのコマンド値(0xE0または224)です。
    
    関連項目:
    
    定数フィールド値
- コンストラクタの詳細
  - ShortMessage
```
public ShortMessage()
```
    新しいShortMessageを構築します。新しいメッセージの内容には、有効なMIDIメッセージが指定されることが保証されます。構築後にメッセージの内容を設定するには、setMessageメソッドの1つを使用します。
    
    関連項目:
    
    setMessage(int)
  - ShortMessage
```
public ShortMessage(int status)
             throws InvalidMidiDataException
```
    データ・バイトを必要としないMIDIメッセージを表すShortMessageを新しく構築します。メッセージの内容は、setMessageメソッドの1つを使用して変更できます。
    
    パラメータ:
    
    status - MIDIステータス・バイト
    
    例外:
    
    InvalidMidiDataException - statusで、データ・バイトを必要としないメッセージに対して有効なMIDIステータス・バイトが指定されていない場合
    
    導入されたバージョン:
    
    1.7
    
    関連項目:
    
    setMessage(int), setMessage(int, int, int), setMessage(int, int, int, int), MidiMessage.getStatus()
  - ShortMessage
```
public ShortMessage(int status,
                    int data1,
                    int data2)
             throws InvalidMidiDataException
```
    データ・バイト2つで構成されるMIDIメッセージを表すShortMessageを新しく構築します。データ・バイト1つだけで構成されるメッセージの場合は、2番目のデータ・バイトが無視されます。データ・バイトなしのメッセージの場合は、両方のデータ・バイトが無視されます。メッセージの内容は、setMessageメソッドの1つを使用して変更できます。
    
    パラメータ:
    
    status - MIDIステータス・バイト
    
    data1 - 第1データ・バイト
    
    data2 - 第2データ・バイト
    
    例外:
    
    InvalidMidiDataException - メッセージを構成するステータス・バイトまたはすべてのデータ・バイトが有効なMIDIメッセージを指定していない場合
    
    導入されたバージョン:
    
    1.7
    
    関連項目:
    
    setMessage(int), setMessage(int, int, int), setMessage(int, int, int, int), MidiMessage.getStatus(), getData1(), getData2()
  - ShortMessage
```
public ShortMessage(int command,
                    int channel,
                    int data1,
                    int data2)
             throws InvalidMidiDataException
```
    データ・バイト2つで構成されるチャネルMIDIメッセージを表すShortMessageを新しく構築します。データ・バイト1つだけで構成されるメッセージの場合は、2番目のデータ・バイトが無視されます。データ・バイトなしのメッセージの場合は、両方のデータ・バイトが無視されます。メッセージの内容は、setMessageメソッドの1つを使用して変更できます。
    
    パラメータ:
    
    command - このメッセージで表されるMIDIコマンド
    
    channel - メッセージに関連したチャネル
    
    data1 - 第1データ・バイト
    
    data2 - 第2データ・バイト
    
    例外:
    
    InvalidMidiDataException - メッセージを構成するコマンド値、チャネル値、またはすべてのデータ・バイトが有効なMIDIメッセージを指定していない場合
    
    導入されたバージョン:
    
    1.7
    
    関連項目:
    
    setMessage(int), setMessage(int, int, int), setMessage(int, int, int, int), getCommand(), getChannel(), getData1(), getData2()
  - ShortMessage
```
protected ShortMessage(byte[] data)
```
    新しいShortMessageを構築します。
    
    パラメータ:
    
    data - 詳細なメッセージを含むバイトの配列。メッセージ・データはsetMessageメソッドを使って変更できる。
    
    関連項目:
    
    setMessage(int)
- メソッドの詳細
  - setMessage
```
public void setMessage(int status)
                throws InvalidMidiDataException
```
    データ・バイトを必要としないMIDIメッセージのパラメータを設定します。
    
    パラメータ:
    
    status - MIDIステータス・バイト
    
    例外:
    
    InvalidMidiDataException - statusで、データ・バイトを必要としないメッセージに対して有効なMIDIステータス・バイトが指定されていない場合。
    
    関連項目:
    
    setMessage(int, int, int), setMessage(int, int, int, int)
  - setMessage
```
public void setMessage(int status,
                       int data1,
                       int data2)
                throws InvalidMidiDataException
```
    データ・バイト1つまたは2つで構成されるMIDIメッセージのパラメータを設定します。データ・バイト1つで構成されるメッセージの場合は2番目のデータ・バイトが無視され、データ・バイトなしのメッセージの場合は両方のデータ・バイトが無視されます。
    
    パラメータ:
    
    status - MIDIステータス・バイト
    
    data1 - 第1データ・バイト
    
    data2 - 第2データ・バイト
    
    例外:
    
    InvalidMidiDataException - メッセージを構成するステータス・バイトまたはすべてのデータ・バイトが有効なMIDIメッセージを指定していない場合。
    
    関連項目:
    
    setMessage(int, int, int, int), setMessage(int)
  - setMessage
```
public void setMessage(int command,
                       int channel,
                       int data1,
                       int data2)
                throws InvalidMidiDataException
```
    データ・バイト2つで構成されるチャネル・メッセージにショート・メッセージ・パラメータを設定します。データ・バイト1つだけで構成されるメッセージの場合は2番目のデータ・バイトが無視され、データ・バイトなしのメッセージの場合は両方のデータ・バイトが無視されます。
    
    パラメータ:
    
    command - このメッセージで表されるMIDIコマンド
    
    channel - メッセージに関連したチャネル
    
    data1 - 第1データ・バイト
    
    data2 - 第2データ・バイト
    
    例外:
    
    InvalidMidiDataException - メッセージを構成するステータス・バイトまたはすべてのデータ・バイトが有効なMIDIメッセージを指定していない場合
    
    関連項目:
    
    setMessage(int, int, int), setMessage(int), getCommand(), getChannel(), getData1(), getData2()
  - getChannel
```
public int getChannel()
```
    このイベントに関連したMIDIチャネルを取得します。このメソッドでは、イベントがMIDIチャネル・メッセージであることが想定されています。イベントがMIDIチャネル・メッセージでない場合には、戻り値は意味のあるものにはなりません。
    
    戻り値:
    
    メッセージに関連したMIDIチャネル。
    
    関連項目:
    
    setMessage(int, int, int, int)
  - getCommand
```
public int getCommand()
```
    このイベントに関連したMIDIコマンドを取得します。このメソッドでは、イベントがMIDIチャネル・メッセージであることが想定されています。イベントがMIDIチャネル・メッセージでない場合には、戻り値は意味のあるものにはなりません。
    
    戻り値:
    
    このイベントに関連したMIDIコマンド
    
    関連項目:
    
    setMessage(int, int, int, int)
  - getData1
```
public int getData1()
```
    メッセージの第1データ・バイトを取得します。
    
    戻り値:
    
    data1フィールドの値
    
    関連項目:
    
    setMessage(int, int, int)
  - getData2
```
public int getData2()
```
    メッセージの第2データ・バイトを取得します。
    
    戻り値:
    
    data2フィールドの値
    
    関連項目:
    
    setMessage(int, int, int)
  - clone
```
public Object clone()
```
    このオブジェクトと同じクラスで、同じ内容の新しいオブジェクトを作成します。
    
    定義:
    
    clone、クラス: MidiMessage
    
    戻り値:
    
    このインスタンスの複製。
    
    関連項目:
    
    Cloneable
  - getDataLength
```
protected final int getDataLength(int status)
                           throws InvalidMidiDataException
```
    特定のステータス・バイト値に関連したデータ・バイト数を取得します。
    
    パラメータ:
    
    status - ショートMIDIメッセージを表すステータス・バイト値
    
    戻り値:
    
    バイト単位のデータ長(0、1、または2)
    
    例外:
    
    InvalidMidiDataException - status引数でショート・メッセージのステータス・バイトを指定していない場合

バグまたは機能を送信
詳細なAPIリファレンスおよび開発者ドキュメントについては、Java SEのドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright© 1993, 2014, Oracle and/or its affiliates. All rights reserved.

クラスShortMessage

フィールドのサマリー

クラス javax.sound.midi.MidiMessageから継承されたフィールド

コンストラクタのサマリー

メソッドのサマリー

クラス javax.sound.midi.MidiMessageから継承されたメソッド

クラス java.lang.Objectから継承されたメソッド

フィールドの詳細

MIDI_TIME_CODE

SONG_POSITION_POINTER

SONG_SELECT

TUNE_REQUEST

END_OF_EXCLUSIVE

TIMING_CLOCK

START

CONTINUE

STOP

ACTIVE_SENSING

SYSTEM_RESET

NOTE_OFF

NOTE_ON

POLY_PRESSURE

CONTROL_CHANGE

PROGRAM_CHANGE

CHANNEL_PRESSURE

PITCH_BEND

コンストラクタの詳細

ShortMessage

ShortMessage

ShortMessage

ShortMessage

ShortMessage

メソッドの詳細

setMessage

setMessage

setMessage

getChannel

getCommand

getData1

getData2

clone

getDataLength