<doc>
  <legacy_id>1158</legacy_id>
  <name>opaque</name>
  <type>property</type>
  <syntax>
    <example>set the opaque of <i>object</i> to {true | false}</example>
  </syntax>
  <library></library>
  <objects>
  </objects>
  <synonyms>
  </synonyms>
  <classification>
    <category>Appearance &amp; Positioning</category>
  </classification>
  <references>
    <keyword tag="opaque">opaque Keyword</keyword>
    <property tag="visible">visible Property</property>
    <property tag="blendLevel">blendLevel Property</property>
    <property tag="backgroundPattern">backgroundPattern Property</property>
    <property tag="fillGradient">fillGradient Property</property>
    <property tag="strokeGradient">strokeGradient Property</property>
    <property tag="fillRule">fillRule Property</property>
  </references>
  <history>
    <introduced version="1.0">Added.</introduced>
  </history>
  <platforms>
    <mac/>
    <windows/>
    <linux/>
    <ios/>
    <android/>
  </platforms>
  <classes>
    <desktop/>
    <server/>
    <web/>
    <mobile/>
  </classes>
  <security>
  </security>
  <summary>Specifies whether the inside of a <keyword tag="control">control</keyword> or card is opaque or transparent to the <glossary tag="object">objects</glossary> beneath it.</summary>
  <examples>
    <example>set the opaque of control 7 to false</example>
  </examples>
  <description>
    <p>Use the <b>opaque</b> <glossary tag="property">property</glossary> to change the <glossary tag="appearance">appearance</glossary> of an <glossary tag="object">object</glossary>.</p><p/><p><b>Value:</b></p><p>The <b>opaque</b> of a control or card is true or false.</p><p/><p><b>Comments:</b></p><p>If a control's <b>opaque</b> <glossary tag="property">property</glossary> is set to true, its entire rectangle is opaque, and <glossary tag="object">objects</glossary> underneath it cannot be seen.</p><p/><p>If the <b>opaque</b> <glossary tag="property">property</glossary> is set to false, the text or other content and the borders of the <glossary tag="object">object</glossary> are drawn, but its <object tag="group">background</object> becomes transparent and <glossary tag="object">objects</glossary> beneath it show through.</p><p/><p>The setting of a card's <b>opaque</b> property determines whether it is filled with its effective background color before the objects on it are rendered. If it is false, the stack will first be filled with the effective background color of the stack.</p><p/><p>If the <i>object</i> is an <keyword tag="image">image</keyword>, the setting of the <b>opaque</b> <glossary tag="property">property</glossary> has no effect. Painted areas of the <keyword tag="image">image</keyword> are opaque, and areas with no paint (transparent or "erased" areas) are not opaque, regardless of the setting of the <glossary tag="image">image's</glossary> <keyword tag="opaque">opaque</keyword> <glossary tag="property">property</glossary>.</p><p/><p><code/><img src="202651"/> <b>Tip:</b><code/> <glossary tag="graphic">Graphics</glossary> whose <property tag="ink">ink</property> <glossary tag="property">property</glossary> is set to <keyword tag="noOp">noOp</keyword> are transparent, but (unlike <glossary tag="graphic">graphics</glossary> whose <b>opaque</b> is set to false) they still intercept mouse clicks within the <glossary tag="graphic">graphic's</glossary> outline. To create an invisible hot spot with a non-rectangular shape, use a <keyword tag="curve">curve</keyword> or <keyword tag="polygon">polygon</keyword> <keyword tag="graphic">graphic</keyword> and set its <property tag="ink">ink</property> to <keyword tag="noOp">noOp</keyword>.</p><p/><p>Setting a button's or field's <b>style</b> <glossary tag="property">property</glossary> to "opaque" sets its <b>opaque</b> to true.</p><p/><p><code/><img src="202652"/> <b>Cross-platform note:</b><code/> The setting of a <glossary tag="button">button's</glossary> <keyword tag="opaque">opaque</keyword> <glossary tag="property">property</glossary> has no effect on <glossary tag="Mac OS">Mac OS</glossary> and <glossary tag="OS X">OS X systems</glossary> if the <property tag="lookAndFeel">lookAndFeel</property> is set to "Appearance Manager", the <glossary tag="button">button's</glossary> <property tag="style">style</property> is "standard", and the <glossary tag="button">button's</glossary> <property tag="threeD">threeD</property> and <property tag="showBorder">showBorder</property> <property tag="properties">properties</property> are both set to true. In this case, the button is drawn by the operating system's Appearance Manager routines and is always opaque, regardless of the setting of its <keyword tag="opaque">opaque</keyword> <glossary tag="property">property</glossary>.</p>
  </description>
</doc>