# C1.Framework.C1BitmapIcon

## Content

<div class="doc-site-dotnet-api-container">



  <h1 id="C1_Framework_C1BitmapIcon" data-uid="C1.Framework.C1BitmapIcon" class="text-break">C1BitmapIcon Class
</h1>
  <div class="markdown level0 summary"><p>Represents an icon created from an image.</p>
</div>
  <div class="markdown level0 conceptual"></div>
  <div class="inheritance">
    <h5>Inheritance</h5>
    <div class="level0"><a class="xref" href="https://learn.microsoft.com/dotnet/api/system.object">object</a></div>
    <div class="level1"><a class="xref" href="C1.Framework.C1Icon.html">C1Icon</a></div>
    <div class="level2"><span class="xref">C1BitmapIcon</span></div>
  </div>
  <div class="implements">
    <h5>Implements</h5>
    <div><a class="xref" href="https://learn.microsoft.com/dotnet/api/system.componentmodel.inotifypropertychanged">INotifyPropertyChanged</a></div>
    <div><a class="xref" href="https://learn.microsoft.com/dotnet/api/system.icloneable">ICloneable</a></div>
  </div>
  <h6><strong>Namespace</strong>: <a class="xref" href="C1.Framework.html">C1.Framework</a></h6>
  <h6><strong>Assembly</strong>: C1.Win.10.dll</h6>
  <h5 id="C1_Framework_C1BitmapIcon_syntax">Syntax</h5>
  <div class="codewrapper">
    <pre><code class="lang-csharp hljs">public class C1BitmapIcon : C1Icon, INotifyPropertyChanged, ICloneable</code></pre>
  </div>
  <div class="codewrapper">
    <pre><code class="lang-vbnet hljs">Public Class C1BitmapIcon
    Inherits C1Icon
    Implements INotifyPropertyChanged, ICloneable</code></pre>
  </div>
  <h5 id="C1_Framework_C1BitmapIcon_remarks"><strong>Remarks</strong></h5>
  <div class="markdown level0 remarks"><p>The file that you use should be a solid image on a transparent background.
The bitmap image is expected to be a true bitmap that has transparent pixels and non-transparent pixels.
The recommended format is PNG. Other file-format image sources will load but result in a solid block of the foreground color.
<b>Caution:</b> Resizing bitmaps at runtime might hurt application performance and result in blurry images. Consider using fixed-size images where possible.</p>
</div>
  <h3 id="constructors">Constructors
</h3>
  <table class="table table-bordered table-condensed">
    <thead>
      <tr>
        <th>Name</th>
        <th>Description</th>
      </tr>
    </thead>
    <tbody>
      <tr>
        <td id="C1_Framework_C1BitmapIcon__ctor" data-uid="C1.Framework.C1BitmapIcon.#ctor">
          <a class="xref" href="C1.Framework.C1BitmapIcon.-ctor.html#C1_Framework_C1BitmapIcon__ctor">C1BitmapIcon()</a>
        </td>
        <td class="markdown level1 summary"><p>Initializes a new instance of the <a class="xref" href="C1.Framework.C1BitmapIcon.html">C1BitmapIcon</a> class.</p>
</td>
      </tr>
      <tr>
        <td id="C1_Framework_C1BitmapIcon__ctor_System_String_" data-uid="C1.Framework.C1BitmapIcon.#ctor(System.String)">
          <a class="xref" href="C1.Framework.C1BitmapIcon.-ctor.html#C1_Framework_C1BitmapIcon__ctor_System_String_">C1BitmapIcon(string)</a>
        </td>
        <td class="markdown level1 summary"><p>Initializes a new instance of the <a class="xref" href="C1.Framework.C1BitmapIcon.html">C1BitmapIcon</a> class.</p>
</td>
      </tr>
      <tr>
        <td id="C1_Framework_C1BitmapIcon__ctor_System_String_System_Drawing_Size_System_Drawing_Color_System_Drawing_Image_" data-uid="C1.Framework.C1BitmapIcon.#ctor(System.String,System.Drawing.Size,System.Drawing.Color,System.Drawing.Image)">
          <a class="xref" href="C1.Framework.C1BitmapIcon.-ctor.html#C1_Framework_C1BitmapIcon__ctor_System_String_System_Drawing_Size_System_Drawing_Color_System_Drawing_Image_">C1BitmapIcon(string, Size, Color, Image)</a>
        </td>
        <td class="markdown level1 summary"><p>Initializes a new instance of the <a class="xref" href="C1.Framework.C1BitmapIcon.html">C1BitmapIcon</a> class with specified key, size and color.</p>
</td>
      </tr>
      <tr>
        <td id="C1_Framework_C1BitmapIcon__ctor_System_String_System_Drawing_Size_System_Drawing_Color_System_Object_System_Int32_" data-uid="C1.Framework.C1BitmapIcon.#ctor(System.String,System.Drawing.Size,System.Drawing.Color,System.Object,System.Int32)">
          <a class="xref" href="C1.Framework.C1BitmapIcon.-ctor.html#C1_Framework_C1BitmapIcon__ctor_System_String_System_Drawing_Size_System_Drawing_Color_System_Object_System_Int32_">C1BitmapIcon(string, Size, Color, object, int)</a>
        </td>
        <td class="markdown level1 summary"><p>Initializes a new instance of the <a class="xref" href="C1.Framework.C1BitmapIcon.html">C1BitmapIcon</a> class with specified key, size and color.</p>
</td>
      </tr>
    </tbody>
  </table>
  <h3 id="properties">Properties
</h3>
  <table class="table table-bordered table-condensed">
    <thead>
      <tr>
        <th>Name</th>
        <th>Description</th>
      </tr>
    </thead>
    <tbody>
      <tr>
        <td id="C1_Framework_C1BitmapIcon_ImageIndex" data-uid="C1.Framework.C1BitmapIcon.ImageIndex">
          <a class="xref" href="C1.Framework.C1BitmapIcon.ImageIndex.html#C1_Framework_C1BitmapIcon_ImageIndex">ImageIndex</a>
        </td>
        <td class="markdown level1 summary"><p>Gets or sets the index of the small image in the SmallImageList.</p>
</td>
      </tr>
      <tr>
        <td id="C1_Framework_C1BitmapIcon_ImageKey" data-uid="C1.Framework.C1BitmapIcon.ImageKey">
          <a class="xref" href="C1.Framework.C1BitmapIcon.ImageKey.html#C1_Framework_C1BitmapIcon_ImageKey">ImageKey</a>
        </td>
        <td class="markdown level1 summary"><p>Gets or sets the key of the small image in the SmallImageList.</p>
</td>
      </tr>
      <tr>
        <td id="C1_Framework_C1BitmapIcon_ImageList" data-uid="C1.Framework.C1BitmapIcon.ImageList">
          <a class="xref" href="C1.Framework.C1BitmapIcon.ImageList.html#C1_Framework_C1BitmapIcon_ImageList">ImageList</a>
        </td>
        <td class="markdown level1 summary"><p>Gets or sets the object that contains the images to display.</p>
</td>
      </tr>
      <tr>
        <td id="C1_Framework_C1BitmapIcon_ShowAsMonochrome" data-uid="C1.Framework.C1BitmapIcon.ShowAsMonochrome">
          <a class="xref" href="C1.Framework.C1BitmapIcon.ShowAsMonochrome.html#C1_Framework_C1BitmapIcon_ShowAsMonochrome">ShowAsMonochrome</a>
        </td>
        <td class="markdown level1 summary"><p>Gets or sets a value that indicates whether the bitmap is shown in a single color.</p>
</td>
      </tr>
      <tr>
        <td id="C1_Framework_C1BitmapIcon_Source" data-uid="C1.Framework.C1BitmapIcon.Source">
          <a class="xref" href="C1.Framework.C1BitmapIcon.Source.html#C1_Framework_C1BitmapIcon_Source">Source</a>
        </td>
        <td class="markdown level1 summary"><p>Gets or sets the image source.</p>
</td>
      </tr>
      <tr>
        <td id="C1_Framework_C1BitmapIcon_Stretch" data-uid="C1.Framework.C1BitmapIcon.Stretch">
          <a class="xref" href="C1.Framework.C1BitmapIcon.Stretch.html#C1_Framework_C1BitmapIcon_Stretch">Stretch</a>
        </td>
        <td class="markdown level1 summary"><p>Gets or sets a <a class="xref" href="C1.Framework.C1BitmapIcon.Stretch.html#C1_Framework_C1BitmapIcon_Stretch">Stretch</a> enumeration value that describes how the shape fills its allocated space.</p>
</td>
      </tr>
    </tbody>
  </table>
  <h3 id="methods">Methods
</h3>
  <table class="table table-bordered table-condensed">
    <thead>
      <tr>
        <th>Name</th>
        <th>Description</th>
      </tr>
    </thead>
    <tbody>
      <tr>
        <td id="C1_Framework_C1BitmapIcon_Clone" data-uid="C1.Framework.C1BitmapIcon.Clone">
          <a class="xref" href="C1.Framework.C1BitmapIcon.Clone.html#C1_Framework_C1BitmapIcon_Clone">Clone()</a>
        </td>
        <td class="markdown level1 summary"><p>Creates a new object that is a copy of the current instance.</p>
</td>
      </tr>
      <tr>
        <td id="C1_Framework_C1BitmapIcon_Equals_System_Object_" data-uid="C1.Framework.C1BitmapIcon.Equals(System.Object)">
          <a class="xref" href="C1.Framework.C1BitmapIcon.Equals.html#C1_Framework_C1BitmapIcon_Equals_System_Object_">Equals(object)</a>
        </td>
        <td class="markdown level1 summary"><p>Indicates whether the specified object is a <a class="xref" href="C1.Framework.C1BitmapIcon.html">C1BitmapIcon</a> and has the same
property values as this icon object.</p>
</td>
      </tr>
      <tr>
        <td id="C1_Framework_C1BitmapIcon_GetHashCode" data-uid="C1.Framework.C1BitmapIcon.GetHashCode">
          <a class="xref" href="C1.Framework.C1BitmapIcon.GetHashCode.html#C1_Framework_C1BitmapIcon_GetHashCode">GetHashCode()</a>
        </td>
        <td class="markdown level1 summary"></td>
      </tr>
      <tr>
        <td id="C1_Framework_C1BitmapIcon_ReadXml_System_Xml_XmlNode_" data-uid="C1.Framework.C1BitmapIcon.ReadXml(System.Xml.XmlNode)">
          <a class="xref" href="C1.Framework.C1BitmapIcon.ReadXml.html#C1_Framework_C1BitmapIcon_ReadXml_System_Xml_XmlNode_">ReadXml(XmlNode)</a>
        </td>
        <td class="markdown level1 summary"><p>Reads this <a class="xref" href="C1.Framework.C1Icon.html">C1Icon</a> from an <span class="xref">System.Xml.XmlReader</span>.</p>
</td>
      </tr>
      <tr>
        <td id="C1_Framework_C1BitmapIcon_WriteXml_System_Xml_XmlWriter_" data-uid="C1.Framework.C1BitmapIcon.WriteXml(System.Xml.XmlWriter)">
          <a class="xref" href="C1.Framework.C1BitmapIcon.WriteXml.html#C1_Framework_C1BitmapIcon_WriteXml_System_Xml_XmlWriter_">WriteXml(XmlWriter)</a>
        </td>
        <td class="markdown level1 summary"><p>Writes this <a class="xref" href="C1.Framework.C1Icon.html">C1Icon</a> into an <span class="xref">System.Xml.XmlWriter</span>.</p>
</td>
      </tr>
    </tbody>
  </table>

</div>
