uTools-Manuals/docs/java/javax/sound/midi/ShortMessage.html

1094 lines
45 KiB
HTML
Raw Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<div class="header">
<div class="subTitle">
javax.sound.midi
</div>
<h2 class="title" title="Class ShortMessage">Class ShortMessage</h2>
</div><div class="contentContainer">
<ul class="inheritance">
<li><a href="../../../java/lang/Object.html" title="class in java.lang">java.lang.Object</a></li>
<li>
<ul class="inheritance">
<li><a href="../../../javax/sound/midi/MidiMessage.html" title="class in javax.sound.midi">javax.sound.midi.MidiMessage</a></li>
<li>
<ul class="inheritance">
<li>javax.sound.midi.ShortMessage</li>
</ul> </li>
</ul> </li>
</ul>
<div class="description">
<ul class="blockList">
<li class="blockList">
<dl>
<dt>
All Implemented Interfaces:
</dt>
<dd>
<span><a href="../../../java/lang/Cloneable.html" title="java.lang中的接口">Cloneable</a></span>
</dd>
</dl>
<hr/> <br/> <pre>public class <span class="typeNameLabel">ShortMessage</span>
extends <a href="../../../javax/sound/midi/MidiMessage.html" title="class in javax.sound.midi">MidiMessage</a></pre>
<div class="block">
<span>A <code>ShortMessage</code>包含一个MIDI消息其状态字节后面最多有两个数据字节。</span>
<span>符合这一标准的MIDI消息的类型是信道语音信道模式系统常用和系统实时 - 换句话说,除了系统独占和元事件之外的所有内容。</span>
<span><code>ShortMessage</code>课程提供了获取和设置MIDI消息内容的方法。</span>
<p> <span>一些<code>ShortMessage</code>方法具有整数参数您可以通过该参数指定MIDI状态或数据字节。</span> <span>如果你知道数值,你可以直接表达。</span> <span>对于系统常见和系统实时消息,你可以经常使用的相应字段<code>ShortMessage</code> ,如<a href="../../../javax/sound/midi/ShortMessage.html#SYSTEM_RESET"><code>SYSTEM_RESET</code></a></span> <span>对于通道消息状态字节的高4位由命令值指定低4位由MIDI通道号指定。</span> <span>要转换在Java的符号字节的形式传入的MIDI数据字节则可以使用<a href="MidiMessage.html#integersVsBytes">conversion code</a>在给定<code><a href="../../../javax/sound/midi/MidiMessage.html" title="class in javax.sound.midi"><code>MidiMessage</code></a></code>类的描述。</span> </p>
</div>
<dl>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<span><a href="../../../javax/sound/midi/SysexMessage.html" title="javax.sound.midi中的类"><code>SysexMessage</code></a> <a href="../../../javax/sound/midi/MetaMessage.html" title="javax.sound.midi中的类"><code>MetaMessage</code></a></span>
</dd>
</dl> </li>
</ul>
</div>
<div class="summary">
<ul class="blockList">
<li class="blockList">
<!-- =========== FIELD SUMMARY =========== -->
<ul class="blockList">
<li class="blockList"><a name="field.summary">
<!-- --> </a> <h3>Field Summary</h3>
<table border="0" cellpadding="3" cellspacing="0" class="memberSummary" summary="Field Summary table, listing fields, and an explanation">
<caption>
<span>Fields</span>
<span class="tabEnd"> </span>
</caption>
<tbody>
<tr>
<th class="colFirst" scope="col">Modifier and Type</th>
<th class="colLast" scope="col">Field and Description</th>
</tr>
<tr class="altColor">
<td class="colFirst"><code>static int</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/sound/midi/ShortMessage.html#ACTIVE_SENSING">ACTIVE_SENSING</a></span></code>
<div class="block">
Active Sensing消息的状态字节0xFE或254
</div> </td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>static int</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/sound/midi/ShortMessage.html#CHANNEL_PRESSURE">CHANNEL_PRESSURE</a></span></code>
<div class="block">
通道压力触发消息0xD0或208的命令值
</div> </td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>static int</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/sound/midi/ShortMessage.html#CONTINUE">CONTINUE</a></span></code>
<div class="block">
继续消息的状态字节0xFB或251
</div> </td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>static int</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/sound/midi/ShortMessage.html#CONTROL_CHANGE">CONTROL_CHANGE</a></span></code>
<div class="block">
控制更改消息的命令值0xB0或176
</div> </td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>static int</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/sound/midi/ShortMessage.html#END_OF_EXCLUSIVE">END_OF_EXCLUSIVE</a></span></code>
<div class="block">
系统专用消息结束0xF7或247的状态字节。
</div> </td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>static int</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/sound/midi/ShortMessage.html#MIDI_TIME_CODE">MIDI_TIME_CODE</a></span></code>
<div class="block">
MIDI时间码四分之一帧消息0xF1或241的状态字节。
</div> </td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>static int</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/sound/midi/ShortMessage.html#NOTE_OFF">NOTE_OFF</a></span></code>
<div class="block">
注释消息0x80或128的命令值
</div> </td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>static int</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/sound/midi/ShortMessage.html#NOTE_ON">NOTE_ON</a></span></code>
<div class="block">
Note On消息的指令值0x90或144
</div> </td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>static int</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/sound/midi/ShortMessage.html#PITCH_BEND">PITCH_BEND</a></span></code>
<div class="block">
Pitch Bend消息的命令值0xE0或224
</div> </td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>static int</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/sound/midi/ShortMessage.html#POLY_PRESSURE">POLY_PRESSURE</a></span></code>
<div class="block">
复音键压力触发后消息0xA0或160的指令值
</div> </td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>static int</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/sound/midi/ShortMessage.html#PROGRAM_CHANGE">PROGRAM_CHANGE</a></span></code>
<div class="block">
程序更改消息的指令值0xC0或192
</div> </td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>static int</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/sound/midi/ShortMessage.html#SONG_POSITION_POINTER">SONG_POSITION_POINTER</a></span></code>
<div class="block">
歌曲位置指针讯息的状态字节0xF2或242
</div> </td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>static int</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/sound/midi/ShortMessage.html#SONG_SELECT">SONG_SELECT</a></span></code>
<div class="block">
MIDI乐曲的状态字节选择信息0xF3或243
</div> </td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>static int</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/sound/midi/ShortMessage.html#START">START</a></span></code>
<div class="block">
开始消息的状态字节0xFA或250
</div> </td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>static int</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/sound/midi/ShortMessage.html#STOP">STOP</a></span></code>
<div class="block">
停止消息的状态字节0xFC或252
</div> </td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>static int</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/sound/midi/ShortMessage.html#SYSTEM_RESET">SYSTEM_RESET</a></span></code>
<div class="block">
系统复位消息的状态字节0xFF或255
</div> </td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>static int</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/sound/midi/ShortMessage.html#TIMING_CLOCK">TIMING_CLOCK</a></span></code>
<div class="block">
定时时钟消息的状态字节0xF8或248
</div> </td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>static int</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/sound/midi/ShortMessage.html#TUNE_REQUEST">TUNE_REQUEST</a></span></code>
<div class="block">
Tune请求消息的状态字节0xF6或246
</div> </td>
</tr>
</tbody>
</table>
<ul class="blockList">
<li class="blockList"><a name="fields.inherited.from.class.javax.sound.midi.MidiMessage">
<!-- --> </a> <h3>Fields inherited from class javax.sound.midi.<a href="../../../javax/sound/midi/MidiMessage.html" title="class in javax.sound.midi">MidiMessage</a></h3> <code><a href="../../../javax/sound/midi/MidiMessage.html#data">data</a>, <a href="../../../javax/sound/midi/MidiMessage.html#length">length</a></code></li>
</ul> </li>
</ul>
<!-- ======== CONSTRUCTOR SUMMARY ======== -->
<ul class="blockList">
<li class="blockList"><a name="constructor.summary">
<!-- --> </a> <h3>构造方法摘要</h3>
<table border="0" cellpadding="3" cellspacing="0" class="memberSummary" summary="Constructor Summary table, listing constructors, and an explanation">
<caption>
<span>构造方法</span>
<span class="tabEnd"> </span>
</caption>
<tbody>
<tr>
<th class="colFirst" scope="col">Modifier</th>
<th class="colLast" scope="col">Constructor and Description</th>
</tr>
<tr class="altColor">
<td class="colFirst"><code> </code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/sound/midi/ShortMessage.html#ShortMessage--">ShortMessage</a></span>()</code>
<div class="block">
构造一个新的
<code>ShortMessage</code>
</div> </td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>protected </code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/sound/midi/ShortMessage.html#ShortMessage-byte:A-">ShortMessage</a></span>(byte[] data)</code>
<div class="block">
构建一个新的
<code>ShortMessage</code>
</div> </td>
</tr>
<tr class="altColor">
<td class="colFirst"><code> </code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/sound/midi/ShortMessage.html#ShortMessage-int-">ShortMessage</a></span>(int status)</code>
<div class="block">
构造一个新的
<code>ShortMessage</code> 它代表一个没有数据字节的MIDI消息。
</div> </td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code> </code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/sound/midi/ShortMessage.html#ShortMessage-int-int-int-">ShortMessage</a></span>(int status, int data1, int data2)</code>
<div class="block">
构造一个新的
<code>ShortMessage</code> 它代表一个最多可容纳两个数据字节的MIDI消息。
</div> </td>
</tr>
<tr class="altColor">
<td class="colFirst"><code> </code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/sound/midi/ShortMessage.html#ShortMessage-int-int-int-int-">ShortMessage</a></span>(int command, int channel, int data1, int data2)</code>
<div class="block">
构造一个新的
<code>ShortMessage</code> 代表一个通道MIDI消息最多可以占用两个数据字节。
</div> </td>
</tr>
</tbody>
</table> </li>
</ul>
<!-- ========== METHOD SUMMARY =========== -->
<ul class="blockList">
<li class="blockList"><a name="method.summary">
<!-- --> </a> <h3>方法摘要</h3>
<table border="0" cellpadding="3" cellspacing="0" class="memberSummary" summary="Method Summary table, listing methods, and an explanation">
<caption>
<span class="activeTableTab" id="t0"><span>所有方法</span><span class="tabEnd"> </span></span>
<span class="tableTab" id="t2"><span><a href="javascript:show(2);">接口方法</a></span><span class="tabEnd"> </span></span>
<span class="tableTab" id="t4"><span><a href="javascript:show(8);">具体的方法</a></span><span class="tabEnd"> </span></span>
</caption>
<tbody>
<tr>
<th class="colFirst" scope="col">Modifier and Type</th>
<th class="colLast" scope="col">Method and Description</th>
</tr>
<tr class="altColor" id="i0">
<td class="colFirst"><code><a href="../../../java/lang/Object.html" title="class in java.lang">Object</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/sound/midi/ShortMessage.html#clone--">clone</a></span>()</code>
<div class="block">
创建与该对象相同的类和新内容相同的新对象。
</div> </td>
</tr>
<tr class="rowColor" id="i1">
<td class="colFirst"><code>int</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/sound/midi/ShortMessage.html#getChannel--">getChannel</a></span>()</code>
<div class="block">
获取与此事件关联的MIDI通道。
</div> </td>
</tr>
<tr class="altColor" id="i2">
<td class="colFirst"><code>int</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/sound/midi/ShortMessage.html#getCommand--">getCommand</a></span>()</code>
<div class="block">
获取与此事件相关联的MIDI命令。
</div> </td>
</tr>
<tr class="rowColor" id="i3">
<td class="colFirst"><code>int</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/sound/midi/ShortMessage.html#getData1--">getData1</a></span>()</code>
<div class="block">
获取消息中的第一个数据字节。
</div> </td>
</tr>
<tr class="altColor" id="i4">
<td class="colFirst"><code>int</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/sound/midi/ShortMessage.html#getData2--">getData2</a></span>()</code>
<div class="block">
获取消息中的第二个数据字节。
</div> </td>
</tr>
<tr class="rowColor" id="i5">
<td class="colFirst"><code>protected int</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/sound/midi/ShortMessage.html#getDataLength-int-">getDataLength</a></span>(int status)</code>
<div class="block">
检索与特定状态字节值相关联的数据字节数。
</div> </td>
</tr>
<tr class="altColor" id="i6">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/sound/midi/ShortMessage.html#setMessage-int-">setMessage</a></span>(int status)</code>
<div class="block">
设置不含数据字节的MIDI消息的参数。
</div> </td>
</tr>
<tr class="rowColor" id="i7">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/sound/midi/ShortMessage.html#setMessage-int-int-int-">setMessage</a></span>(int status, int data1, int data2)</code>
<div class="block">
设置一个需要一个或两个数据字节的MIDI消息的参数。
</div> </td>
</tr>
<tr class="altColor" id="i8">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../../javax/sound/midi/ShortMessage.html#setMessage-int-int-int-int-">setMessage</a></span>(int command, int channel, int data1, int data2)</code>
<div class="block">
设置通道消息的短消息参数,最多可以包含两个数据字节。
</div> </td>
</tr>
</tbody>
</table>
<ul class="blockList">
<li class="blockList"><a name="methods.inherited.from.class.javax.sound.midi.MidiMessage">
<!-- --> </a> <h3>Methods inherited from class javax.sound.midi.<a href="../../../javax/sound/midi/MidiMessage.html" title="class in javax.sound.midi">MidiMessage</a></h3> <code><a href="../../../javax/sound/midi/MidiMessage.html#getLength--">getLength</a>, <a href="../../../javax/sound/midi/MidiMessage.html#getMessage--">getMessage</a>, <a href="../../../javax/sound/midi/MidiMessage.html#getStatus--">getStatus</a>, <a href="../../../javax/sound/midi/MidiMessage.html#setMessage-byte:A-int-">setMessage</a></code></li>
</ul>
<ul class="blockList">
<li class="blockList"><a name="methods.inherited.from.class.java.lang.Object">
<!-- --> </a> <h3>Methods inherited from class java.lang.<a href="../../../java/lang/Object.html" title="class in java.lang">Object</a></h3> <code><a href="../../../java/lang/Object.html#equals-java.lang.Object-">equals</a>, <a href="../../../java/lang/Object.html#finalize--">finalize</a>, <a href="../../../java/lang/Object.html#getClass--">getClass</a>, <a href="../../../java/lang/Object.html#hashCode--">hashCode</a>, <a href="../../../java/lang/Object.html#notify--">notify</a>, <a href="../../../java/lang/Object.html#notifyAll--">notifyAll</a>, <a href="../../../java/lang/Object.html#toString--">toString</a>, <a href="../../../java/lang/Object.html#wait--">wait</a>, <a href="../../../java/lang/Object.html#wait-long-">wait</a>, <a href="../../../java/lang/Object.html#wait-long-int-">wait</a></code></li>
</ul> </li>
</ul> </li>
</ul>
</div>
<div class="details">
<ul class="blockList">
<li class="blockList">
<!-- ============ FIELD DETAIL =========== -->
<ul class="blockList">
<li class="blockList"><a name="field.detail">
<!-- --> </a> <h3>字段详细信息</h3> <a name="MIDI_TIME_CODE">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>MIDI_TIME_CODE</h4> <pre>public static final int MIDI_TIME_CODE</pre>
<div class="block">
MIDI时间码四分之一帧消息0xF1或241的状态字节。
</div>
<dl>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../../javax/sound/midi/MidiMessage.html#getStatus--"><code>MidiMessage.getStatus()</code></a>
<a href="../../../constant-values.html#javax.sound.midi.ShortMessage.MIDI_TIME_CODE">Constant Field Values</a>
</dd>
</dl> </li>
</ul> <a name="SONG_POSITION_POINTER">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>SONG_POSITION_POINTER</h4> <pre>public static final int SONG_POSITION_POINTER</pre>
<div class="block">
歌曲位置指针讯息的状态字节0xF2或242
</div>
<dl>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../../javax/sound/midi/MidiMessage.html#getStatus--"><code>MidiMessage.getStatus()</code></a>
<a href="../../../constant-values.html#javax.sound.midi.ShortMessage.SONG_POSITION_POINTER">Constant Field Values</a>
</dd>
</dl> </li>
</ul> <a name="SONG_SELECT">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>SONG_SELECT</h4> <pre>public static final int SONG_SELECT</pre>
<div class="block">
MIDI乐曲的状态字节选择信息0xF3或243
</div>
<dl>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../../javax/sound/midi/MidiMessage.html#getStatus--"><code>MidiMessage.getStatus()</code></a>
<a href="../../../constant-values.html#javax.sound.midi.ShortMessage.SONG_SELECT">Constant Field Values</a>
</dd>
</dl> </li>
</ul> <a name="TUNE_REQUEST">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>TUNE_REQUEST</h4> <pre>public static final int TUNE_REQUEST</pre>
<div class="block">
Tune请求消息的状态字节0xF6或246
</div>
<dl>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../../javax/sound/midi/MidiMessage.html#getStatus--"><code>MidiMessage.getStatus()</code></a>
<a href="../../../constant-values.html#javax.sound.midi.ShortMessage.TUNE_REQUEST">Constant Field Values</a>
</dd>
</dl> </li>
</ul> <a name="END_OF_EXCLUSIVE">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>END_OF_EXCLUSIVE</h4> <pre>public static final int END_OF_EXCLUSIVE</pre>
<div class="block">
系统专用消息结束0xF7或247的状态字节。
</div>
<dl>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../../javax/sound/midi/MidiMessage.html#getStatus--"><code>MidiMessage.getStatus()</code></a>
<a href="../../../constant-values.html#javax.sound.midi.ShortMessage.END_OF_EXCLUSIVE">Constant Field Values</a>
</dd>
</dl> </li>
</ul> <a name="TIMING_CLOCK">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>TIMING_CLOCK</h4> <pre>public static final int TIMING_CLOCK</pre>
<div class="block">
定时时钟消息的状态字节0xF8或248
</div>
<dl>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../../javax/sound/midi/MidiMessage.html#getStatus--"><code>MidiMessage.getStatus()</code></a>
<a href="../../../constant-values.html#javax.sound.midi.ShortMessage.TIMING_CLOCK">Constant Field Values</a>
</dd>
</dl> </li>
</ul> <a name="START">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>START</h4> <pre>public static final int START</pre>
<div class="block">
开始消息的状态字节0xFA或250
</div>
<dl>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../../javax/sound/midi/MidiMessage.html#getStatus--"><code>MidiMessage.getStatus()</code></a>
<a href="../../../constant-values.html#javax.sound.midi.ShortMessage.START">Constant Field Values</a>
</dd>
</dl> </li>
</ul> <a name="CONTINUE">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>CONTINUE</h4> <pre>public static final int CONTINUE</pre>
<div class="block">
继续消息的状态字节0xFB或251
</div>
<dl>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../../javax/sound/midi/MidiMessage.html#getStatus--"><code>MidiMessage.getStatus()</code></a>
<a href="../../../constant-values.html#javax.sound.midi.ShortMessage.CONTINUE">Constant Field Values</a>
</dd>
</dl> </li>
</ul> <a name="STOP">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>STOP</h4> <pre>public static final int STOP</pre>
<div class="block">
停止消息的状态字节0xFC或252
</div>
<dl>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../../javax/sound/midi/MidiMessage.html#getStatus--"><code>MidiMessage.getStatus()</code></a>
<a href="../../../constant-values.html#javax.sound.midi.ShortMessage.STOP">Constant Field Values</a>
</dd>
</dl> </li>
</ul> <a name="ACTIVE_SENSING">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>ACTIVE_SENSING</h4> <pre>public static final int ACTIVE_SENSING</pre>
<div class="block">
Active Sensing消息的状态字节0xFE或254
</div>
<dl>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../../javax/sound/midi/MidiMessage.html#getStatus--"><code>MidiMessage.getStatus()</code></a>
<a href="../../../constant-values.html#javax.sound.midi.ShortMessage.ACTIVE_SENSING">Constant Field Values</a>
</dd>
</dl> </li>
</ul> <a name="SYSTEM_RESET">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>SYSTEM_RESET</h4> <pre>public static final int SYSTEM_RESET</pre>
<div class="block">
系统复位消息的状态字节0xFF或255
</div>
<dl>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../../javax/sound/midi/MidiMessage.html#getStatus--"><code>MidiMessage.getStatus()</code></a>
<a href="../../../constant-values.html#javax.sound.midi.ShortMessage.SYSTEM_RESET">Constant Field Values</a>
</dd>
</dl> </li>
</ul> <a name="NOTE_OFF">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>NOTE_OFF</h4> <pre>public static final int NOTE_OFF</pre>
<div class="block">
注释消息0x80或128的命令值
</div>
<dl>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../../constant-values.html#javax.sound.midi.ShortMessage.NOTE_OFF">Constant Field Values</a>
</dd>
</dl> </li>
</ul> <a name="NOTE_ON">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>NOTE_ON</h4> <pre>public static final int NOTE_ON</pre>
<div class="block">
Note On消息的指令值0x90或144
</div>
<dl>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../../constant-values.html#javax.sound.midi.ShortMessage.NOTE_ON">Constant Field Values</a>
</dd>
</dl> </li>
</ul> <a name="POLY_PRESSURE">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>POLY_PRESSURE</h4> <pre>public static final int POLY_PRESSURE</pre>
<div class="block">
复音键压力触发后消息0xA0或160的指令值
</div>
<dl>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../../constant-values.html#javax.sound.midi.ShortMessage.POLY_PRESSURE">Constant Field Values</a>
</dd>
</dl> </li>
</ul> <a name="CONTROL_CHANGE">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>CONTROL_CHANGE</h4> <pre>public static final int CONTROL_CHANGE</pre>
<div class="block">
控制更改消息的命令值0xB0或176
</div>
<dl>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../../constant-values.html#javax.sound.midi.ShortMessage.CONTROL_CHANGE">Constant Field Values</a>
</dd>
</dl> </li>
</ul> <a name="PROGRAM_CHANGE">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>PROGRAM_CHANGE</h4> <pre>public static final int PROGRAM_CHANGE</pre>
<div class="block">
程序更改消息的指令值0xC0或192
</div>
<dl>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../../constant-values.html#javax.sound.midi.ShortMessage.PROGRAM_CHANGE">Constant Field Values</a>
</dd>
</dl> </li>
</ul> <a name="CHANNEL_PRESSURE">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>CHANNEL_PRESSURE</h4> <pre>public static final int CHANNEL_PRESSURE</pre>
<div class="block">
通道压力触发消息0xD0或208的命令值
</div>
<dl>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../../constant-values.html#javax.sound.midi.ShortMessage.CHANNEL_PRESSURE">Constant Field Values</a>
</dd>
</dl> </li>
</ul> <a name="PITCH_BEND">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>PITCH_BEND</h4> <pre>public static final int PITCH_BEND</pre>
<div class="block">
Pitch Bend消息的命令值0xE0或224
</div>
<dl>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../../constant-values.html#javax.sound.midi.ShortMessage.PITCH_BEND">Constant Field Values</a>
</dd>
</dl> </li>
</ul> </li>
</ul>
<!-- ========= CONSTRUCTOR DETAIL ======== -->
<ul class="blockList">
<li class="blockList"><a name="constructor.detail">
<!-- --> </a> <h3>构造方法详细信息</h3> <a name="ShortMessage--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>ShortMessage</h4> <pre>public ShortMessage()</pre>
<div class="block">
<span>构建一个新的<code>ShortMessage</code></span>
<span>保证新消息的内容指定有效的MIDI消息。</span>
<span>随后,您可以使用<code>setMessage</code>方法之一设置消息的内容。</span>
</div>
<dl>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../../javax/sound/midi/ShortMessage.html#setMessage-int-"><code>setMessage(int)</code></a>
</dd>
</dl> </li>
</ul> <a name="ShortMessage-int-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>ShortMessage</h4> <pre>public ShortMessage(int status)
throws <a href="../../../javax/sound/midi/InvalidMidiDataException.html" title="class in javax.sound.midi">InvalidMidiDataException</a></pre>
<div class="block">
<span>构造一个新的<code>ShortMessage</code> 它代表一个没有数据字节的MIDI消息。</span>
<span>消息的内容可以通过使用<code>setMessage</code>之一来更改。</span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>status</code> - MIDI状态字节
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../javax/sound/midi/InvalidMidiDataException.html" title="class in javax.sound.midi">InvalidMidiDataException</a></code> - 如果
<code>status</code>没有为不需要数据字节的消息指定有效的MIDI状态字节
</dd>
<dt>
<span class="simpleTagLabel">从以下版本开始:</span>
</dt>
<dd>
1.7
</dd>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../../javax/sound/midi/ShortMessage.html#setMessage-int-"><code>setMessage(int)</code></a>
<a href="../../../javax/sound/midi/ShortMessage.html#setMessage-int-int-int-"><code>setMessage(int, int, int)</code></a>
<a href="../../../javax/sound/midi/ShortMessage.html#setMessage-int-int-int-int-"><code>setMessage(int, int, int, int)</code></a>
<a href="../../../javax/sound/midi/MidiMessage.html#getStatus--"><code>MidiMessage.getStatus()</code></a>
</dd>
</dl> </li>
</ul> <a name="ShortMessage-int-int-int-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>ShortMessage</h4> <pre>public ShortMessage(int status,
int data1,
int data2)
throws <a href="../../../javax/sound/midi/InvalidMidiDataException.html" title="class in javax.sound.midi">InvalidMidiDataException</a></pre>
<div class="block">
<span>构造一个新的<code>ShortMessage</code> 它代表一个最多可容纳两个数据字节的MIDI消息。</span>
<span>如果消息只有一个数据字节,则忽略第二个数据字节。</span>
<span>如果消息没有任何数据字节,则两个数据字节都将被忽略。</span>
<span>可以使用<code>setMessage</code>方法之一来更改消息的内容。</span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>status</code> - MIDI状态字节
</dd>
<dd>
<code>data1</code> - 第一个数据字节
</dd>
<dd>
<code>data2</code> - 第二个数据字节
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../javax/sound/midi/InvalidMidiDataException.html" title="class in javax.sound.midi">InvalidMidiDataException</a></code> - 如果属于该消息的状态字节或所有数据字节未指定有效的MIDI消息
</dd>
<dt>
<span class="simpleTagLabel">从以下版本开始:</span>
</dt>
<dd>
1.7
</dd>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../../javax/sound/midi/ShortMessage.html#setMessage-int-"><code>setMessage(int)</code></a>
<a href="../../../javax/sound/midi/ShortMessage.html#setMessage-int-int-int-"><code>setMessage(int, int, int)</code></a>
<a href="../../../javax/sound/midi/ShortMessage.html#setMessage-int-int-int-int-"><code>setMessage(int, int, int, int)</code></a>
<a href="../../../javax/sound/midi/MidiMessage.html#getStatus--"><code>MidiMessage.getStatus()</code></a>
<a href="../../../javax/sound/midi/ShortMessage.html#getData1--"><code>getData1()</code></a>
<a href="../../../javax/sound/midi/ShortMessage.html#getData2--"><code>getData2()</code></a>
</dd>
</dl> </li>
</ul> <a name="ShortMessage-int-int-int-int-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>ShortMessage</h4> <pre>public ShortMessage(int command,
int channel,
int data1,
int data2)
throws <a href="../../../javax/sound/midi/InvalidMidiDataException.html" title="class in javax.sound.midi">InvalidMidiDataException</a></pre>
<div class="block">
<span>构建一个新的<code>ShortMessage</code> 它代表一个通道MIDI消息最多可以占用两个数据字节。</span>
<span>如果消息只有一个数据字节,则忽略第二个数据字节。</span>
<span>如果消息没有任何数据字节,则两个数据字节都将被忽略。</span>
<span>可以使用<code>setMessage</code>方法之一来更改消息的内容。</span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>command</code> - 此消息表示的MIDI命令
</dd>
<dd>
<code>channel</code> - 与消息相关
<code>channel</code>的通道
</dd>
<dd>
<code>data1</code> - 第一个数据字节
</dd>
<dd>
<code>data2</code> - 第二个数据字节
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../javax/sound/midi/InvalidMidiDataException.html" title="class in javax.sound.midi">InvalidMidiDataException</a></code> - 如果命令值通道值或属于该消息的所有数据字节未指定有效的MIDI消息
</dd>
<dt>
<span class="simpleTagLabel">从以下版本开始:</span>
</dt>
<dd>
1.7
</dd>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../../javax/sound/midi/ShortMessage.html#setMessage-int-"><code>setMessage(int)</code></a>
<a href="../../../javax/sound/midi/ShortMessage.html#setMessage-int-int-int-"><code>setMessage(int, int, int)</code></a>
<a href="../../../javax/sound/midi/ShortMessage.html#setMessage-int-int-int-int-"><code>setMessage(int, int, int, int)</code></a>
<a href="../../../javax/sound/midi/ShortMessage.html#getCommand--"><code>getCommand()</code></a>
<a href="../../../javax/sound/midi/ShortMessage.html#getChannel--"><code>getChannel()</code></a>
<a href="../../../javax/sound/midi/ShortMessage.html#getData1--"><code>getData1()</code></a>
<a href="../../../javax/sound/midi/ShortMessage.html#getData2--"><code>getData2()</code></a>
</dd>
</dl> </li>
</ul> <a name="ShortMessage-byte:A-">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>ShortMessage</h4> <pre>protected ShortMessage(byte[] data)</pre>
<div class="block">
构造一个新的
<code>ShortMessage</code>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<span><code>data</code> - 包含完整消息的字节数组。</span>
<span>消息数据可以使用<code>setMessage</code>方法更改。</span>
</dd>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../../javax/sound/midi/ShortMessage.html#setMessage-int-"><code>setMessage(int)</code></a>
</dd>
</dl> </li>
</ul> </li>
</ul>
<!-- ============ METHOD DETAIL ========== -->
<ul class="blockList">
<li class="blockList"><a name="method.detail">
<!-- --> </a> <h3>方法详细信息</h3> <a name="setMessage-int-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>setMessage</h4> <pre>public void setMessage(int status)
throws <a href="../../../javax/sound/midi/InvalidMidiDataException.html" title="class in javax.sound.midi">InvalidMidiDataException</a></pre>
<div class="block">
设置不含数据字节的MIDI消息的参数。
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>status</code> - MIDI状态字节
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../javax/sound/midi/InvalidMidiDataException.html" title="class in javax.sound.midi">InvalidMidiDataException</a></code> - 如果
<code>status</code>没有为不需要数据字节的消息指定有效的MIDI状态字节。
</dd>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../../javax/sound/midi/ShortMessage.html#setMessage-int-int-int-"><code>setMessage(int, int, int)</code></a>
<a href="../../../javax/sound/midi/ShortMessage.html#setMessage-int-int-int-int-"><code>setMessage(int, int, int, int)</code></a>
</dd>
</dl> </li>
</ul> <a name="setMessage-int-int-int-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>setMessage</h4> <pre>public void setMessage(int status,
int data1,
int data2)
throws <a href="../../../javax/sound/midi/InvalidMidiDataException.html" title="class in javax.sound.midi">InvalidMidiDataException</a></pre>
<div class="block">
<span>设置一个需要一个或两个数据字节的MIDI消息的参数。</span>
<span>如果消息只有一个数据字节,则忽略第二个数据字节;</span>
<span>如果消息没有任何数据字节,则两个数据字节都将被忽略。</span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>status</code> - MIDI状态字节
</dd>
<dd>
<code>data1</code> - 第一个数据字节
</dd>
<dd>
<code>data2</code> - 第二个数据字节
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../javax/sound/midi/InvalidMidiDataException.html" title="class in javax.sound.midi">InvalidMidiDataException</a></code> - 如果状态字节或属于该消息的所有数据字节未指定有效的MIDI消息。
</dd>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../../javax/sound/midi/ShortMessage.html#setMessage-int-int-int-int-"><code>setMessage(int, int, int, int)</code></a>
<a href="../../../javax/sound/midi/ShortMessage.html#setMessage-int-"><code>setMessage(int)</code></a>
</dd>
</dl> </li>
</ul> <a name="setMessage-int-int-int-int-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>setMessage</h4> <pre>public void setMessage(int command,
int channel,
int data1,
int data2)
throws <a href="../../../javax/sound/midi/InvalidMidiDataException.html" title="class in javax.sound.midi">InvalidMidiDataException</a></pre>
<div class="block">
<span>设置通道消息的短消息参数,最多可以包含两个数据字节。</span>
<span>如果消息只需要一个数据字节,则忽略第二个数据字节;</span>
<span>如果消息没有任何数据字节,则两个数据字节都将被忽略。</span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>command</code> - 此消息表示的MIDI命令
</dd>
<dd>
<code>channel</code> - 与消息相关
<code>channel</code>的通道
</dd>
<dd>
<code>data1</code> - 第一个数据字节
</dd>
<dd>
<code>data2</code> - 第二个数据字节
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../javax/sound/midi/InvalidMidiDataException.html" title="class in javax.sound.midi">InvalidMidiDataException</a></code> - 如果属于该消息的状态字节或所有数据字节则不指定有效的MIDI消息
</dd>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../../javax/sound/midi/ShortMessage.html#setMessage-int-int-int-"><code>setMessage(int, int, int)</code></a>
<a href="../../../javax/sound/midi/ShortMessage.html#setMessage-int-"><code>setMessage(int)</code></a>
<a href="../../../javax/sound/midi/ShortMessage.html#getCommand--"><code>getCommand()</code></a>
<a href="../../../javax/sound/midi/ShortMessage.html#getChannel--"><code>getChannel()</code></a>
<a href="../../../javax/sound/midi/ShortMessage.html#getData1--"><code>getData1()</code></a>
<a href="../../../javax/sound/midi/ShortMessage.html#getData2--"><code>getData2()</code></a>
</dd>
</dl> </li>
</ul> <a name="getChannel--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getChannel</h4> <pre>public int getChannel()</pre>
<div class="block">
<span>获取与此事件关联的MIDI通道。</span>
<span>该方法假设事件是MIDI通道消息;</span>
<span>如果没有,返回值将不会有意义。</span>
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
MIDI通道与消息相关联。
</dd>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../../javax/sound/midi/ShortMessage.html#setMessage-int-int-int-int-"><code>setMessage(int, int, int, int)</code></a>
</dd>
</dl> </li>
</ul> <a name="getCommand--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getCommand</h4> <pre>public int getCommand()</pre>
<div class="block">
<span>获取与此事件相关联的MIDI命令。</span>
<span>该方法假设事件是MIDI通道消息;</span>
<span>如果没有,返回值将不会有意义。</span>
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
与此事件关联的MIDI命令
</dd>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../../javax/sound/midi/ShortMessage.html#setMessage-int-int-int-int-"><code>setMessage(int, int, int, int)</code></a>
</dd>
</dl> </li>
</ul> <a name="getData1--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getData1</h4> <pre>public int getData1()</pre>
<div class="block">
获取消息中的第一个数据字节。
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
<code>data1</code>字段的值
</dd>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../../javax/sound/midi/ShortMessage.html#setMessage-int-int-int-"><code>setMessage(int, int, int)</code></a>
</dd>
</dl> </li>
</ul> <a name="getData2--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getData2</h4> <pre>public int getData2()</pre>
<div class="block">
获取消息中的第二个数据字节。
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
该值为
<code>data2</code>字段
</dd>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<a href="../../../javax/sound/midi/ShortMessage.html#setMessage-int-int-int-"><code>setMessage(int, int, int)</code></a>
</dd>
</dl> </li>
</ul> <a name="clone--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>clone</h4> <pre>public <a href="../../../java/lang/Object.html" title="class in java.lang">Object</a> clone()</pre>
<div class="block">
创建与该对象相同的类和新内容相同的新对象。
</div>
<dl>
<dt>
<span class="overrideSpecifyLabel">Specified by:</span>
</dt>
<dd>
<code><a href="../../../javax/sound/midi/MidiMessage.html#clone--">clone</a></code>在类别
<code><a href="../../../javax/sound/midi/MidiMessage.html" title="class in javax.sound.midi">MidiMessage</a></code>
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
这个实例的一个克隆。
</dd>
<dt>
<span class="seeLabel">另请参见:</span>
</dt>
<dd>
<span><a href="../../../java/lang/Cloneable.html" title="java.lang中的接口"><code>Cloneable</code></a></span>
</dd>
</dl> </li>
</ul> <a name="getDataLength-int-">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>getDataLength</h4> <pre>protected final int getDataLength(int status)
throws <a href="../../../javax/sound/midi/InvalidMidiDataException.html" title="class in javax.sound.midi">InvalidMidiDataException</a></pre>
<div class="block">
检索与特定状态字节值相关联的数据字节数。
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>status</code> - 状态字节值它必须表示一个短的MIDI消息
</dd>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
数据长度以字节为单位0,1或2
</dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../../javax/sound/midi/InvalidMidiDataException.html" title="class in javax.sound.midi">InvalidMidiDataException</a></code> - if the
<code>status</code> argument does not represent the status byte for any short message
</dd>
</dl> </li>
</ul> </li>
</ul> </li>
</ul>
</div>
</div>