uTools-Manuals/docs/java/javax/imageio/IIOParam.html

<div class="header">
<div class="subTitle">
     javax.imageio 
   </div>
<h2 class="title" title="Class IIOParam">Class IIOParam</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>javax.imageio.IIOParam</li>
</ul> </li>
</ul>
<div class="description">
<ul class="blockList">
<li class="blockList">
<dl>
<dt>
        已知直接子类：
       </dt>
<dd>
<span><a href="../../javax/imageio/ImageReadParam.html" title="javax.imageio中的类">ImageReadParam</a> ， <a href="../../javax/imageio/ImageWriteParam.html" title="javax.imageio中的类">ImageWriteParam</a></span>
</dd>
</dl>
<hr/> <br/> <pre>public abstract class <span class="typeNameLabel">IIOParam</span>
extends <a href="../../java/lang/Object.html" title="class in java.lang">Object</a></pre>
<div class="block">
<span>描述流如何解码或编码的所有类的超类。</span>
<span>该类包含<code>ImageReadParam</code>和<code>ImageWriteParam</code>共享的所有变量和方法。</span>
<p> <span>该类提供了指定源区域和目标区域的机制。</span> <span>读取时，源是流，内存中的映像是目标。</span> <span>写作时，这些都是相反的。</span> <span>在写入的情况下，目的地区域可以仅与支持像素替换的写入器一起使用。</span> </p>
<p> <span>可以使用可移动的子采样网格为读者和作者指定抽取次采样。</span> </p>
<p> <span>可以选择源和目的地频带的子集。</span> </p>
</div> </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>protected <a href="../../javax/imageio/IIOParamController.html" title="interface in javax.imageio">IIOParamController</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/IIOParam.html#controller">controller</a></span></code>
<div class="block">
              该 
             <code>IIOParamController</code>将用于提供此设置 
             <code>IIOParam</code>对象时 
             <code>activateController</code>方法被调用。 
            </div> </td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>protected <a href="../../javax/imageio/IIOParamController.html" title="interface in javax.imageio">IIOParamController</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/IIOParam.html#defaultController">defaultController</a></span></code>
<div class="block">
              当调用 
             <code>activateController</code>方法时，默认的 
             <code>IIOParamController</code>将用于为此 
             <code>IIOParam</code>对象提供设置。 
            </div> </td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>protected <a href="../../java/awt/Point.html" title="class in java.awt">Point</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/IIOParam.html#destinationOffset">destinationOffset</a></span></code>
<div class="block">
              应放置左上角解码像素的目的地偏移量。 
            </div> </td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>protected <a href="../../javax/imageio/ImageTypeSpecifier.html" title="class in javax.imageio">ImageTypeSpecifier</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/IIOParam.html#destinationType">destinationType</a></span></code>
<div class="block">
              一个 
             <code>ImageTypeSpecifier</code>中使用读取操作时生成目标图像，或写入操作时设置输出颜色类型。 
            </div> </td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>protected int[]</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/IIOParam.html#sourceBands">sourceBands</a></span></code>
<div class="block">
<code>int</code> s的数组， 
             <code>int</code>将使用哪些源频段，或 
             <code>null</code> 。 
            </div> </td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>protected <a href="../../java/awt/Rectangle.html" title="class in java.awt">Rectangle</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/IIOParam.html#sourceRegion">sourceRegion</a></span></code>
<div class="block">
              源区域， 
             <code>null</code>如果没有设置。 
            </div> </td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>protected int</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/IIOParam.html#sourceXSubsampling">sourceXSubsampling</a></span></code>
<div class="block">
              在水平方向应用抽取次采样。 
            </div> </td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>protected int</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/IIOParam.html#sourceYSubsampling">sourceYSubsampling</a></span></code>
<div class="block">
              在垂直方向应用抽取次采样。 
            </div> </td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>protected int</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/IIOParam.html#subsamplingXOffset">subsamplingXOffset</a></span></code>
<div class="block">
              在采样之前应用于子采样网格的水平偏移。 
            </div> </td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>protected int</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/IIOParam.html#subsamplingYOffset">subsamplingYOffset</a></span></code>
<div class="block">
              在二次采样之前应用于子采样网格的垂直偏移。 
            </div> </td>
</tr>
</tbody>
</table> </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>protected </code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/IIOParam.html#IIOParam--">IIOParam</a></span>()</code>
<div class="block">
              受保护的构造函数只能由子类调用。 
            </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>boolean</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/IIOParam.html#activateController--">activateController</a></span>()</code>
<div class="block">
              激活此 
             <code>IIOParam</code>对象的已 
             <code>IIOParamController</code>
<code>IIOParam</code>并返回结果值。 
            </div> </td>
</tr>
<tr class="rowColor" id="i1">
<td class="colFirst"><code><a href="../../javax/imageio/IIOParamController.html" title="interface in javax.imageio">IIOParamController</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/IIOParam.html#getController--">getController</a></span>()</code>
<div class="block">
              返回 
             <code>IIOParamController</code>安装的IIOParamController。 
            </div> </td>
</tr>
<tr class="altColor" id="i2">
<td class="colFirst"><code><a href="../../javax/imageio/IIOParamController.html" title="interface in javax.imageio">IIOParamController</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/IIOParam.html#getDefaultController--">getDefaultController</a></span>()</code>
<div class="block">
              返回默认的 
             <code>IIOParamController</code> ，如果有一个，不管当前安装的控制器。 
            </div> </td>
</tr>
<tr class="rowColor" id="i3">
<td class="colFirst"><code><a href="../../java/awt/Point.html" title="class in java.awt">Point</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/IIOParam.html#getDestinationOffset--">getDestinationOffset</a></span>()</code>
<div class="block">
              返回目标图像中要放置像素的偏移量。 
            </div> </td>
</tr>
<tr class="altColor" id="i4">
<td class="colFirst"><code><a href="../../javax/imageio/ImageTypeSpecifier.html" title="class in javax.imageio">ImageTypeSpecifier</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/IIOParam.html#getDestinationType--">getDestinationType</a></span>()</code>
<div class="block">
              返回由读返回图像的类型，如果是通过调用设置为 
             <code>setDestination(ImageTypeSpecifier)</code> ，为 
             <code>ImageTypeSpecifier</code> 。 
            </div> </td>
</tr>
<tr class="rowColor" id="i5">
<td class="colFirst"><code>int[]</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/IIOParam.html#getSourceBands--">getSourceBands</a></span>()</code>
<div class="block">
              返回要使用的一组源频带。 
            </div> </td>
</tr>
<tr class="altColor" id="i6">
<td class="colFirst"><code><a href="../../java/awt/Rectangle.html" title="class in java.awt">Rectangle</a></code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/IIOParam.html#getSourceRegion--">getSourceRegion</a></span>()</code>
<div class="block">
              返回要使用的源区域。 
            </div> </td>
</tr>
<tr class="rowColor" id="i7">
<td class="colFirst"><code>int</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/IIOParam.html#getSourceXSubsampling--">getSourceXSubsampling</a></span>()</code>
<div class="block">
              返回每个像素前进的源列数。 
            </div> </td>
</tr>
<tr class="altColor" id="i8">
<td class="colFirst"><code>int</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/IIOParam.html#getSourceYSubsampling--">getSourceYSubsampling</a></span>()</code>
<div class="block">
              返回每个像素的行数。 
            </div> </td>
</tr>
<tr class="rowColor" id="i9">
<td class="colFirst"><code>int</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/IIOParam.html#getSubsamplingXOffset--">getSubsamplingXOffset</a></span>()</code>
<div class="block">
              返回子采样网格的水平偏移。 
            </div> </td>
</tr>
<tr class="altColor" id="i10">
<td class="colFirst"><code>int</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/IIOParam.html#getSubsamplingYOffset--">getSubsamplingYOffset</a></span>()</code>
<div class="block">
              返回子采样网格的垂直偏移。 
            </div> </td>
</tr>
<tr class="rowColor" id="i11">
<td class="colFirst"><code>boolean</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/IIOParam.html#hasController--">hasController</a></span>()</code>
<div class="block">
              如果为此 
             <code>IIOParam</code>对象安装了控制器，则返回 
             <code>true</code> 。 
            </div> </td>
</tr>
<tr class="altColor" id="i12">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/IIOParam.html#setController-javax.imageio.IIOParamController-">setController</a></span>(<a href="../../javax/imageio/IIOParamController.html" title="interface in javax.imageio">IIOParamController</a> controller)</code>
<div class="block">
              设置 
             <code>IIOParamController</code>被用来提供用于此设置 
             <code>IIOParam</code>对象时 
             <code>activateController</code>方法被调用时，重写所有默认控制器。 
            </div> </td>
</tr>
<tr class="rowColor" id="i13">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/IIOParam.html#setDestinationOffset-java.awt.Point-">setDestinationOffset</a></span>(<a href="../../java/awt/Point.html" title="class in java.awt">Point</a> destinationOffset)</code>
<div class="block">
              指定目标图像中的未来解码像素的偏移量，读取时或写入区域的位置。 
            </div> </td>
</tr>
<tr class="altColor" id="i14">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/IIOParam.html#setDestinationType-javax.imageio.ImageTypeSpecifier-">setDestinationType</a></span>(<a href="../../javax/imageio/ImageTypeSpecifier.html" title="class in javax.imageio">ImageTypeSpecifier</a> destinationType)</code>
<div class="block">
              使用 
             <code>ImageTypeSpecifier</code>设置目标图像所需的图像类型。 
            </div> </td>
</tr>
<tr class="rowColor" id="i15">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/IIOParam.html#setSourceBands-int:A-">setSourceBands</a></span>(int[] sourceBands)</code>
<div class="block">
              设置要使用的源频带的索引。 
            </div> </td>
</tr>
<tr class="altColor" id="i16">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/IIOParam.html#setSourceRegion-java.awt.Rectangle-">setSourceRegion</a></span>(<a href="../../java/awt/Rectangle.html" title="class in java.awt">Rectangle</a> sourceRegion)</code>
<div class="block">
              设置感兴趣的源区域。 
            </div> </td>
</tr>
<tr class="rowColor" id="i17">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><span class="memberNameLink"><a href="../../javax/imageio/IIOParam.html#setSourceSubsampling-int-int-int-int-">setSourceSubsampling</a></span>(int sourceXSubsampling, int sourceYSubsampling, int subsamplingXOffset, int subsamplingYOffset)</code>
<div class="block">
              指定抽取次采样以应用于I / O。 
            </div> </td>
</tr>
</tbody>
</table>
<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#clone--">clone</a>, <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="sourceRegion">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>sourceRegion</h4> <pre>protected <a href="../../java/awt/Rectangle.html" title="class in java.awt">Rectangle</a> sourceRegion</pre>
<div class="block">
            源区域，如果没有设置， 
           <code>null</code> 。 
          </div> </li>
</ul> <a name="sourceXSubsampling">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>sourceXSubsampling</h4> <pre>protected int sourceXSubsampling</pre>
<div class="block">
<span>在水平方向应用抽取次采样。</span>
<span>默认值为<code>1</code> 。</span>
<span>该值不能为负数或0。</span>
</div> </li>
</ul> <a name="sourceYSubsampling">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>sourceYSubsampling</h4> <pre>protected int sourceYSubsampling</pre>
<div class="block">
<span>在垂直方向应用抽取次采样。</span>
<span>默认值为<code>1</code> 。</span>
<span>该值不能为负数或0。</span>
</div> </li>
</ul> <a name="subsamplingXOffset">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>subsamplingXOffset</h4> <pre>protected int subsamplingXOffset</pre>
<div class="block">
<span>在采样之前应用于子采样网格的水平偏移。</span>
<span>要使用的第一个像素将从该区域的原点偏移该量，或者如果未指定区域，则将偏移该图像。</span>
</div> </li>
</ul> <a name="subsamplingYOffset">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>subsamplingYOffset</h4> <pre>protected int subsamplingYOffset</pre>
<div class="block">
<span>在二次采样之前应用于子采样网格的垂直偏移。</span>
<span>要使用的第一个像素将从该区域的原点偏移该量，或者如果未指定区域，则将偏移该图像。</span>
</div> </li>
</ul> <a name="sourceBands">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>sourceBands</h4> <pre>protected int[] sourceBands</pre>
<div class="block">
<span><code>int</code>的阵列<code>int</code>将使用哪些源频段，或<code>null</code> 。</span>
<span>如果<code>null</code> ， <code>null</code>使用的源频带集合如在<code>setSourceBands</code>方法的注释中所述。</span>
<span>不应该允许任何价值为负数。</span>
</div> </li>
</ul> <a name="destinationType">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>destinationType</h4> <pre>protected <a href="../../javax/imageio/ImageTypeSpecifier.html" title="class in javax.imageio">ImageTypeSpecifier</a> destinationType</pre>
<div class="block">
<span>一个<code>ImageTypeSpecifier</code>中使用读取操作时生成目标图像，或写入操作时设置输出颜色类型。</span>
<span>如果未设置，则值为<code>null</code> 。</span>
<span>默认值为<code>null</code> 。</span>
</div> </li>
</ul> <a name="destinationOffset">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>destinationOffset</h4> <pre>protected <a href="../../java/awt/Point.html" title="class in java.awt">Point</a> destinationOffset</pre>
<div class="block">
<span>应放置左上角解码像素的目的地偏移量。</span>
<span>默认值为（0，0）。</span>
</div> </li>
</ul> <a name="defaultController">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>defaultController</h4> <pre>protected <a href="../../javax/imageio/IIOParamController.html" title="interface in javax.imageio">IIOParamController</a> defaultController</pre>
<div class="block">
<span>当调用<code>activateController</code>方法时，默认的<code>IIOParamController</code>将用于为此<code>IIOParam</code>对象提供设置。</span>
<span>这个默认值应该由子类设置，选择提供自己的默认控制器（通常是GUI）来设置参数。</span>
</div>
<dl>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<span><a href="../../javax/imageio/IIOParamController.html" title="javax.imageio中的接口"><code>IIOParamController</code></a> ， <a href="../../javax/imageio/IIOParam.html#getDefaultController--"><code>getDefaultController()</code></a> ， <a href="../../javax/imageio/IIOParam.html#activateController--"><code>activateController()</code></a></span>
</dd>
</dl> </li>
</ul> <a name="controller">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>controller</h4> <pre>protected <a href="../../javax/imageio/IIOParamController.html" title="interface in javax.imageio">IIOParamController</a> controller</pre>
<div class="block">
<span>该<code>IIOParamController</code>将用于提供此设置<code>IIOParam</code>对象时<code>activateController</code>方法被调用。</span>
<span>此值覆盖任何默认控制器，即使为空。</span>
</div>
<dl>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<span><a href="../../javax/imageio/IIOParamController.html" title="javax.imageio中的接口"><code>IIOParamController</code></a> ， <a href="../../javax/imageio/IIOParam.html#setController-javax.imageio.IIOParamController-"><code>setController(IIOParamController)</code></a> ， <a href="../../javax/imageio/IIOParam.html#hasController--"><code>hasController()</code></a> ， <a href="../../javax/imageio/IIOParam.html#activateController--"><code>activateController()</code></a></span>
</dd>
</dl> </li>
</ul> </li>
</ul>
<!-- ========= CONSTRUCTOR DETAIL ======== -->
<ul class="blockList">
<li class="blockList"><a name="constructor.detail">
<!-- --> </a> <h3>构造方法详细信息</h3> <a name="IIOParam--">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>IIOParam</h4> <pre>protected IIOParam()</pre>
<div class="block">
            受保护的构造函数只能由子类调用。 
          </div> </li>
</ul> </li>
</ul>
<!-- ============ METHOD DETAIL ========== -->
<ul class="blockList">
<li class="blockList"><a name="method.detail">
<!-- --> </a> <h3>方法详细信息</h3> <a name="setSourceRegion-java.awt.Rectangle-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>setSourceRegion</h4> <pre>public void setSourceRegion(<a href="../../java/awt/Rectangle.html" title="class in java.awt">Rectangle</a> sourceRegion)</pre>
<div class="block">
<span>设置感兴趣的源区域。</span>
<span>感兴趣的区域被描述为一个矩形，源图像的左上角是像素（0,0），并且向下和向右增加值。</span>
<span>实际使用的像素数将取决于setSourceSubsampling设置的<code>setSourceSubsampling</code>采样因子。</span>
<span>如果子采样被设置为使得该数字为零，则将抛出<code>IllegalStateException</code> 。</span>
<p> <span>由该方法指定的感兴趣的源区域将根据需要进行修剪以适应源边界以及实际I / O时的目标偏移量，宽度和高度。</span> </p>
<p> <span>对于<code>null</code> ， <code>sourceRegion</code>将删除任何区域规范，导致使用整个图像。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>sourceRegion</code> - a 
            <code>Rectangle</code>感兴趣的源区域，或 
            <code>null</code> 。 
           </dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></code> - 如果 
            <code>sourceRegion</code>是非 
            <code>null</code>和 
            <code>sourceRegion.x</code>或 
            <code>sourceRegion.y</code>是否定的。 
           </dd>
<dd>
<code><a href="../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></code> - 如果 
            <code>sourceRegion</code>是非 
            <code>null</code>和 
            <code>sourceRegion.width</code>或 
            <code>sourceRegion.height</code>是负数或0。 
           </dd>
<dd>
<code><a href="../../java/lang/IllegalStateException.html" title="class in java.lang">IllegalStateException</a></code> - 如果子采样使得该区域将具有二次采样宽度或零度的高度。 
           </dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<a href="../../javax/imageio/IIOParam.html#getSourceRegion--"><code>getSourceRegion()</code></a> ， 
            <a href="../../javax/imageio/IIOParam.html#setSourceSubsampling-int-int-int-int-"><code>setSourceSubsampling(int, int, int, int)</code></a> ， 
            <a href="../../javax/imageio/IIOParam.html#setDestinationOffset-java.awt.Point-"><code>setDestinationOffset(java.awt.Point)</code></a> ， 
            <a href="../../javax/imageio/IIOParam.html#getDestinationOffset--"><code>getDestinationOffset()</code></a>
</dd>
</dl> </li>
</ul> <a name="getSourceRegion--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getSourceRegion</h4> <pre>public <a href="../../java/awt/Rectangle.html" title="class in java.awt">Rectangle</a> getSourceRegion()</pre>
<div class="block">
<span>返回要使用的源区域。</span>
<span>返回的值是由最近调用<code>setSourceRegion</code> ，如果没有区域设置， <code>null</code> 。</span>
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             源感兴趣区域为 
            <code>Rectangle</code> ，或 
            <code>null</code> 。 
           </dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<a href="../../javax/imageio/IIOParam.html#setSourceRegion-java.awt.Rectangle-"><code>setSourceRegion(java.awt.Rectangle)</code></a>
</dd>
</dl> </li>
</ul> <a name="setSourceSubsampling-int-int-int-int-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>setSourceSubsampling</h4> <pre>public void setSourceSubsampling(int sourceXSubsampling,
                                 int sourceYSubsampling,
                                 int subsamplingXOffset,
                                 int subsamplingYOffset)</pre>
<div class="block">
<span>指定抽取次采样以应用于I / O。</span>
<span><code>sourceXSubsampling</code>和<code>sourceYSubsampling</code>参数指定子采样周期（ <i>即</i> ，每个源像素之后要提前的行数和列数）。</span>
<span>具体来说，1的周期将使用每行或列;</span>
<span>一个2的周期将使用每隔一行或一列。</span>
<span><code>subsamplingXOffset</code>和<code>subsamplingYOffset</code>参数指定了第一个子采样像素的区域（或图像）原点的偏移。</span>
<span>调整子样本网格的原点对于在将非常大的源图像进行子采样到将被组装成完整的子采样图像的目的地区域时避免接缝是有用的。</span>
<span>大多数用户都希望将这些参数保留在0。</span>
<p> <span>要使用的像素数和扫描线的数量如下计算。</span> </p>
<p> <span>扫描线中子采样像素的数量由下式给出</span> </p>
<p> <span><code>truncate[(width - subsamplingXOffset + sourceXSubsampling - 1) / sourceXSubsampling]</code> 。</span> </p>
<p> <span>如果该区域的宽度为零，则抛出<code>IllegalStateException</code> 。</span> </p>
<p> <span>可以类似地计算要使用的扫描线的数量。</span> </p>
<p> <span>如果该区域用于创建大图像的子采样图块，其中图块宽度和高度不是子采样周期的倍数，则将二次采样网格设置为开始于源区域原点以外的位置的功能非常有用。</span> <span>如果子采样网格从块到块不保持一致，则在块边界处将存在伪像。</span> <span>通过调整每个瓦片的子采样网格偏移量进行补偿，可以避免这些伪像。</span> <span>折衷的是，为了避免这些工件，瓷砖的尺寸不一样。</span> <span>在这种情况下使用的网格偏移量由下式给出：</span> <br/> <span>网格偏移= [周期 - （区域偏移模周期）]模周期）</span> </p>
<p> <span>如果<code>sourceXSubsampling</code>或<code>sourceYSubsampling</code>为0或否，将抛出<code>IllegalArgumentException</code> 。</span> </p>
<p> <span>如果<code>subsamplingXOffset</code>或<code>subsamplingYOffset</code>为负数或大于或等于相应期间，则将抛出<code>IllegalArgumentException</code> 。</span> </p>
<p> <span>没有<code>unsetSourceSubsampling</code>方法;</span> <span>只需调用<code>setSourceSubsampling(1, 1, 0, 0)</code>即可恢复默认值。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>sourceXSubsampling</code> - 要在像素之间前进的列数。 
           </dd>
<dd>
<code>sourceYSubsampling</code> - 要在像素之间前进的行数。 
           </dd>
<dd>
<code>subsamplingXOffset</code> - 第一个子样本在该区域内的水平偏移，或者如果没有设置区域，则在图像内。 
           </dd>
<dd>
<code>subsamplingYOffset</code> - 区域内的第一个子样本的水平偏移量，如果没有设置区域，则在图像内。 
           </dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></code> - 如果任一周期为负或为0，或者任一电网偏移为负或大于相应周期。 
           </dd>
<dd>
<code><a href="../../java/lang/IllegalStateException.html" title="class in java.lang">IllegalStateException</a></code> - 如果源区域使得子采样输出将不包含像素。 
           </dd>
</dl> </li>
</ul> <a name="getSourceXSubsampling--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getSourceXSubsampling</h4> <pre>public int getSourceXSubsampling()</pre>
<div class="block">
<span>返回每个像素前进的源列数。</span>
<p> <span>如果未调用<code>setSourceSubsampling</code> ，则返回1（正确的值）。</span> </p>
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             源子采样X周期。 
           </dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<a href="../../javax/imageio/IIOParam.html#setSourceSubsampling-int-int-int-int-"><code>setSourceSubsampling(int, int, int, int)</code></a> ， 
            <a href="../../javax/imageio/IIOParam.html#getSourceYSubsampling--"><code>getSourceYSubsampling()</code></a>
</dd>
</dl> </li>
</ul> <a name="getSourceYSubsampling--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getSourceYSubsampling</h4> <pre>public int getSourceYSubsampling()</pre>
<div class="block">
<span>返回每个像素的行数。</span>
<p> <span>如果未调用<code>setSourceSubsampling</code> ，则返回1（正确的值）。</span> </p>
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             源子采样Y期。 
           </dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<a href="../../javax/imageio/IIOParam.html#setSourceSubsampling-int-int-int-int-"><code>setSourceSubsampling(int, int, int, int)</code></a> ， 
            <a href="../../javax/imageio/IIOParam.html#getSourceXSubsampling--"><code>getSourceXSubsampling()</code></a>
</dd>
</dl> </li>
</ul> <a name="getSubsamplingXOffset--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getSubsamplingXOffset</h4> <pre>public int getSubsamplingXOffset()</pre>
<div class="block">
<span>返回子采样网格的水平偏移。</span>
<p> <span>如果未调用<code>setSourceSubsampling</code> ，则返回0（这是正确的值）。</span> </p>
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             源子采样网格X偏移。 
           </dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<a href="../../javax/imageio/IIOParam.html#setSourceSubsampling-int-int-int-int-"><code>setSourceSubsampling(int, int, int, int)</code></a> ， 
            <a href="../../javax/imageio/IIOParam.html#getSubsamplingYOffset--"><code>getSubsamplingYOffset()</code></a>
</dd>
</dl> </li>
</ul> <a name="getSubsamplingYOffset--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getSubsamplingYOffset</h4> <pre>public int getSubsamplingYOffset()</pre>
<div class="block">
<span>返回子采样网格的垂直偏移。</span>
<p> <span>如果未调用<code>setSourceSubsampling</code> ，则返回0（这是正确的值）。</span> </p>
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             源子采样网格Y偏移。 
           </dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<a href="../../javax/imageio/IIOParam.html#setSourceSubsampling-int-int-int-int-"><code>setSourceSubsampling(int, int, int, int)</code></a> ， 
            <a href="../../javax/imageio/IIOParam.html#getSubsamplingXOffset--"><code>getSubsamplingXOffset()</code></a>
</dd>
</dl> </li>
</ul> <a name="setSourceBands-int:A-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>setSourceBands</h4> <pre>public void setSourceBands(int[] sourceBands)</pre>
<div class="block">
<span>设置要使用的源频带的索引。</span>
<span>不允许重复索引。</span>
<p> <span><code>null</code>值表示将使用所有源频段。</span> </p>
<p> <span>在读出时，一个<code>IllegalArgumentException</code>将由读取器或写入如果已指定比最大可用源频带索引大的值抛出，或者如果要使用的源频带和目的地频带的数目是不同的。</span> <span><code>ImageReader.checkReadParamBandSettings</code>方法可用于自动化此测试。</span> </p>
<p> <span>语义上，一个副本是由阵列组成的;</span> <span>对此调用后的数组内容的更改对此<code>IIOParam</code>没有任何影响。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>sourceBands</code> - 要使用的整数带索引数组。 
           </dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></code> - 如果 
            <code>sourceBands</code>包含负值或重复值。 
           </dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<a href="../../javax/imageio/IIOParam.html#getSourceBands--"><code>getSourceBands()</code></a> ， 
            <a href="../../javax/imageio/ImageReadParam.html#setDestinationBands-int:A-"><code>ImageReadParam.setDestinationBands(int[])</code></a> ， 
            <a href="../../javax/imageio/ImageReader.html#checkReadParamBandSettings-javax.imageio.ImageReadParam-int-int-"><code>ImageReader.checkReadParamBandSettings(javax.imageio.ImageReadParam, int, int)</code></a>
</dd>
</dl> </li>
</ul> <a name="getSourceBands--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getSourceBands</h4> <pre>public int[] getSourceBands()</pre>
<div class="block">
<span>返回要使用的一组源频带。</span>
<span>返回的值是由最近调用<code>setSourceBands</code> ，或<code>null</code>如果没有调用<code>setSourceBands</code> 。</span>
<p> <span>语义上，返回的数组是一个副本;</span> <span>对此调用后的数组内容的更改对此<code>IIOParam</code>没有任何影响。</span> </p>
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             要使用的一组源频段，或 
            <code>null</code> 。 
           </dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<a href="../../javax/imageio/IIOParam.html#setSourceBands-int:A-"><code>setSourceBands(int[])</code></a>
</dd>
</dl> </li>
</ul> <a name="setDestinationType-javax.imageio.ImageTypeSpecifier-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>setDestinationType</h4> <pre>public void setDestinationType(<a href="../../javax/imageio/ImageTypeSpecifier.html" title="class in javax.imageio">ImageTypeSpecifier</a> destinationType)</pre>
<div class="block">
<span>使用<code>ImageTypeSpecifier</code>设置目标图像的所需图像类型。</span>
<p> <span>读取时，如果目标的布局已经使用这种方法设置，每次调用一个<code>ImageReader</code> <code>read</code>方法将返回一个新<code>BufferedImage</code>使用由所提供的类型说明符所指定的格式。</span> <span>作为副作用，任何目的地<code>BufferedImage</code>通过设置<code>ImageReadParam.setDestination(BufferedImage)</code>将不再被设定为目的地。</span> <span>换句话说，这种方法可以被认为是调用<code>setDestination((BufferedImage)null)</code> 。</span> </p>
<p> <span>当写入时，目的地类型可能用于确定图像的颜色类型。</span> <span><code>SampleModel</code>信息将被忽略，可能是<code>null</code> 。</span> <span>例如，4带图像可以表示CMYK或RGBA数据。</span> <span>如果设置了目的地类型，其<code>ColorModel</code>将覆盖图像本身上的任何<code>ColorModel</code> 。</span> <span>当使用<code>setSourceBands</code>时，这是至关重要的，因为图像的<code>ColorModel</code>将引用整个图像，而不是被写入的带子集。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>destinationType</code> -的 
            <code>ImageTypeSpecifier</code>被用来确定目标布局和颜色类型。 
           </dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<a href="../../javax/imageio/IIOParam.html#getDestinationType--"><code>getDestinationType()</code></a>
</dd>
</dl> </li>
</ul> <a name="getDestinationType--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getDestinationType</h4> <pre>public <a href="../../javax/imageio/ImageTypeSpecifier.html" title="class in javax.imageio">ImageTypeSpecifier</a> getDestinationType()</pre>
<div class="block">
<span>返回由读返回图像的类型，如果是通过调用设置为<code>setDestination(ImageTypeSpecifier)</code> ，为<code>ImageTypeSpecifier</code> 。</span>
<span>如果没有设置，返回<code>null</code> 。</span>
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             描述 
            <code>ImageTypeSpecifier</code>类型的ImageTypeSpecifier，或 
            <code>null</code> 。 
           </dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<a href="../../javax/imageio/IIOParam.html#setDestinationType-javax.imageio.ImageTypeSpecifier-"><code>setDestinationType(javax.imageio.ImageTypeSpecifier)</code></a>
</dd>
</dl> </li>
</ul> <a name="setDestinationOffset-java.awt.Point-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>setDestinationOffset</h4> <pre>public void setDestinationOffset(<a href="../../java/awt/Point.html" title="class in java.awt">Point</a> destinationOffset)</pre>
<div class="block">
<span>指定目标图像中的未来解码像素的偏移量，读取时或写入区域的位置。</span>
<p> <span>当读取时，要在目的地<code>BufferedImage</code>写入的区域将从该偏移开始，并且具有由感兴趣的源区域，子采样参数和目的地边界确定的宽度和高度。</span> </p>
<p> <span>正常写入不受此方法的影响，只能使用<code>ImageWriter.replacePixels</code>执行写操作。</span> <span>对于这样的写入，指定的偏移量在其像素被修改的输出流图像内。</span> </p>
<p> <span>没有<code>unsetDestinationOffset</code>方法;</span> <span>只需调用<code>setDestinationOffset(new Point(0, 0))</code>即可恢复默认值。</span> </p>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>destinationOffset</code> - 
            <code>destinationOffset</code>的偏移量，如 
            <code>Point</code> 。 
           </dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../java/lang/IllegalArgumentException.html" title="class in java.lang">IllegalArgumentException</a></code> - 如果 
            <code>destinationOffset</code>是 
            <code>null</code> 。 
           </dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<a href="../../javax/imageio/IIOParam.html#getDestinationOffset--"><code>getDestinationOffset()</code></a> ， 
            <a href="../../javax/imageio/ImageWriter.html#replacePixels-java.awt.image.RenderedImage-javax.imageio.ImageWriteParam-"><code>ImageWriter.replacePixels(java.awt.image.RenderedImage, javax.imageio.ImageWriteParam)</code></a>
</dd>
</dl> </li>
</ul> <a name="getDestinationOffset--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getDestinationOffset</h4> <pre>public <a href="../../java/awt/Point.html" title="class in java.awt">Point</a> getDestinationOffset()</pre>
<div class="block">
<span>返回目标图像中要放置像素的偏移量。</span>
<p> <span>如果<code>setDestinationOffsets</code>没有被调用，一个<code>Point</code>零X和Y值返回（这是正确的值）。</span> </p>
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             目的地偏移为 
            <code>Point</code> 。 
           </dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<a href="../../javax/imageio/IIOParam.html#setDestinationOffset-java.awt.Point-"><code>setDestinationOffset(java.awt.Point)</code></a>
</dd>
</dl> </li>
</ul> <a name="setController-javax.imageio.IIOParamController-">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>setController</h4> <pre>public void setController(<a href="../../javax/imageio/IIOParamController.html" title="interface in javax.imageio">IIOParamController</a> controller)</pre>
<div class="block">
<span>设置<code>IIOParamController</code>被用来提供用于此设置<code>IIOParam</code>对象时<code>activateController</code>方法被调用时，重写所有默认控制器。</span>
<span>如果参数为<code>null</code> ，则不会使用任何控制器，包括任何默认值。</span>
<span>要恢复默认值，请使用<code>setController(getDefaultController())</code> 。</span>
</div>
<dl>
<dt>
<span class="paramLabel">参数</span>
</dt>
<dd>
<code>controller</code> - 适当的 
            <code>IIOParamController</code>或 
            <code>null</code> 。 
           </dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<span><a href="../../javax/imageio/IIOParamController.html" title="javax.imageio中的接口"><code>IIOParamController</code></a> ， <a href="../../javax/imageio/IIOParam.html#getController--"><code>getController()</code></a> ， <a href="../../javax/imageio/IIOParam.html#getDefaultController--"><code>getDefaultController()</code></a> ， <a href="../../javax/imageio/IIOParam.html#hasController--"><code>hasController()</code></a> ， <a href="../../javax/imageio/IIOParam.html#activateController--"><code>activateController()</code></a></span>
</dd>
</dl> </li>
</ul> <a name="getController--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getController</h4> <pre>public <a href="../../javax/imageio/IIOParamController.html" title="interface in javax.imageio">IIOParamController</a> getController()</pre>
<div class="block">
<span>返回<code>IIOParamController</code>安装的IIOParamController。</span>
<span>如果有一个<code>null</code>或最近调用<code>setController</code>的参数，这可能是默认值。</span>
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             目前安装的是 
            <code>IIOParamController</code>或 
            <code>null</code> 。 
           </dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<span><a href="../../javax/imageio/IIOParamController.html" title="javax.imageio中的接口"><code>IIOParamController</code></a> ， <a href="../../javax/imageio/IIOParam.html#setController-javax.imageio.IIOParamController-"><code>setController(javax.imageio.IIOParamController)</code></a> ， <a href="../../javax/imageio/IIOParam.html#getDefaultController--"><code>getDefaultController()</code></a> ， <a href="../../javax/imageio/IIOParam.html#hasController--"><code>hasController()</code></a> ， <a href="../../javax/imageio/IIOParam.html#activateController--"><code>activateController()</code></a></span>
</dd>
</dl> </li>
</ul> <a name="getDefaultController--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>getDefaultController</h4> <pre>public <a href="../../javax/imageio/IIOParamController.html" title="interface in javax.imageio">IIOParamController</a> getDefaultController()</pre>
<div class="block">
<span>返回默认的<code>IIOParamController</code> ，如果有一个，不管当前安装的控制器。</span>
<span>如果没有默认控制器，则返回<code>null</code> 。</span>
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
             默认为 
            <code>IIOParamController</code> ，或 
            <code>null</code> 。 
           </dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<span><a href="../../javax/imageio/IIOParamController.html" title="javax.imageio中的接口"><code>IIOParamController</code></a> ， <a href="../../javax/imageio/IIOParam.html#setController-javax.imageio.IIOParamController-"><code>setController(IIOParamController)</code></a> ， <a href="../../javax/imageio/IIOParam.html#getController--"><code>getController()</code></a> ， <a href="../../javax/imageio/IIOParam.html#hasController--"><code>hasController()</code></a> ， <a href="../../javax/imageio/IIOParam.html#activateController--"><code>activateController()</code></a></span>
</dd>
</dl> </li>
</ul> <a name="hasController--">
<!-- --> </a>
<ul class="blockList">
<li class="blockList"> <h4>hasController</h4> <pre>public boolean hasController()</pre>
<div class="block">
<span>如果为此<code>IIOParam</code>对象安装了控制器，则返回<code>true</code> 。</span>
<span>这将返回<code>true</code>如果<code>getController</code>不会返回<code>null</code> 。</span>
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
<code>true</code>如果安装了控制器。 
           </dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<span><a href="../../javax/imageio/IIOParamController.html" title="javax.imageio中的接口"><code>IIOParamController</code></a> ， <a href="../../javax/imageio/IIOParam.html#setController-javax.imageio.IIOParamController-"><code>setController(IIOParamController)</code></a> ， <a href="../../javax/imageio/IIOParam.html#getController--"><code>getController()</code></a> ， <a href="../../javax/imageio/IIOParam.html#getDefaultController--"><code>getDefaultController()</code></a> ， <a href="../../javax/imageio/IIOParam.html#activateController--"><code>activateController()</code></a></span>
</dd>
</dl> </li>
</ul> <a name="activateController--">
<!-- --> </a>
<ul class="blockListLast">
<li class="blockList"> <h4>activateController</h4> <pre>public boolean activateController()</pre>
<div class="block">
<span>激活此<code>IIOParam</code>对象的安装<code>IIOParamController</code> ，并返回结果值。</span>
<span>当此方法返回<code>true</code>时，此<code>IIOParam</code>对象的所有值将准备好进行下一次读或写操作。</span>
<span>如果返回<code>false</code> ，则此对象中的设置不会受到干扰（ <i>即</i>用户取消了该操作）。</span>
<p> <span>通常，控制器将提供的一个子类的用户界面的GUI <code>IIOParam</code>用于特定插件。</span> <span>控制器不需要GUI。</span> </p>
</div>
<dl>
<dt>
<span class="returnLabel">结果</span>
</dt>
<dd>
<code>true</code>如果控制器正常完成。 
           </dd>
<dt>
<span class="throwsLabel">异常</span>
</dt>
<dd>
<code><a href="../../java/lang/IllegalStateException.html" title="class in java.lang">IllegalStateException</a></code> - 如果当前没有安装控制器。 
           </dd>
<dt>
<span class="seeLabel">另请参见：</span>
</dt>
<dd>
<span><a href="../../javax/imageio/IIOParamController.html" title="javax.imageio中的接口"><code>IIOParamController</code></a> ， <a href="../../javax/imageio/IIOParam.html#setController-javax.imageio.IIOParamController-"><code>setController(IIOParamController)</code></a> ， <a href="../../javax/imageio/IIOParam.html#getController--"><code>getController()</code></a> ， <a href="../../javax/imageio/IIOParam.html#getDefaultController--"><code>getDefaultController()</code></a> ， <a href="../../javax/imageio/IIOParam.html#hasController--"><code>hasController()</code></a></span>
</dd>
</dl> </li>
</ul> </li>
</ul> </li>
</ul>
</div>
</div>