Icon コンストラクター

定義

Icon クラスの新しいインスタンスを初期化します。Initializes a new instance of the Icon class.

オーバーロード

Icon(Stream)

指定したデータ ストリームで Icon クラスの新しいインスタンスを初期化します。Initializes a new instance of the Icon class from the specified data stream.

Icon(String)

指定したファイル名から、Icon クラスの新しいインスタンスを初期化します。Initializes a new instance of the Icon class from the specified file name.

Icon(Icon, Size)

Icon クラスの新しいインスタンスを初期化し、要求されたサイズに一致するアイコンを検索します。Initializes a new instance of the Icon class and attempts to find a version of the icon that matches the requested size.

Icon(Stream, Size)

指定したストリームから指定したサイズで Icon クラスの新しいインスタンスを初期化します。Initializes a new instance of the Icon class of the specified size from the specified stream.

Icon(String, Size)

指定したファイルから指定したサイズで Icon クラスの新しいインスタンスを初期化します。Initializes a new instance of the Icon class of the specified size from the specified file.

Icon(Type, String)

指定のアセンブリのリソースで Icon クラスの新しいインスタンスを初期化します。Initializes a new instance of the Icon class from a resource in the specified assembly.

Icon(Icon, Int32, Int32)

Icon クラスの新しいインスタンスを初期化し、要求されたサイズに一致するアイコンを検索します。Initializes a new instance of the Icon class and attempts to find a version of the icon that matches the requested size.

Icon(Stream, Int32, Int32)

指定のデータ ストリームから指定の幅と高さで、Icon クラスの新しいインスタンスを初期化します。Initializes a new instance of the Icon class from the specified data stream and with the specified width and height.

Icon(String, Int32, Int32)

指定したファイルから幅と高さを指定して、Icon クラスの新しいインスタンスを初期化します。Initializes a new instance of the Icon class with the specified width and height from the specified file.

Icon(Stream)

指定したデータ ストリームで Icon クラスの新しいインスタンスを初期化します。Initializes a new instance of the Icon class from the specified data stream.

public:
 Icon(System::IO::Stream ^ stream);
public Icon (System.IO.Stream stream);
new System.Drawing.Icon : System.IO.Stream -> System.Drawing.Icon

パラメーター

stream
Stream

Icon の読み込み元のデータ ストリーム。The data stream from which to load the Icon.

例外

stream パラメーターが null です。The stream parameter is null.

注釈

アイコンリソースには、複数のアイコンイメージを含めることができます。An icon resource can contain multiple icon images. 1つのアイコンファイルには、複数のサイズと色深度の画像が含まれている場合があります。One icon file may contain images in several sizes and color depths. アプリケーションで使用されるイメージは、オペレーティングシステムと設定によって異なります。The image that is used in an application depends on the operating system and settings. 次の一覧は、アイコンの一般的なサイズの詳細を示しています。The following list details the typical sizes for an icon:

  • 16ピクセル x 16 ピクセル16 pixels x 16 pixels

  • 32ピクセル x 32 ピクセル32 pixels x 32 pixels

  • 48ピクセル x 48 ピクセル48 pixels x 48 pixels

このコンストラクターは、指定されたストリームに格納されている最小のイメージを返します。This constructor returns the smallest image that is contained in the specified stream.

Icon(String)

指定したファイル名から、Icon クラスの新しいインスタンスを初期化します。Initializes a new instance of the Icon class from the specified file name.

public:
 Icon(System::String ^ fileName);
public Icon (string fileName);
new System.Drawing.Icon : string -> System.Drawing.Icon
Public Sub New (fileName As String)

パラメーター

fileName
String

Icon の読み込み元のファイル。The file to load the Icon from.

注釈

アイコンリソースには、複数のアイコンイメージを含めることができます。An icon resource can contain multiple icon images. 1つのアイコンファイルには、複数のサイズと色深度の画像が含まれている場合があります。One icon file may contain images in several sizes and color depths. アプリケーションで使用されるイメージは、オペレーティングシステムと設定によって異なります。The image that is used in an application depends on the operating system and settings. 次の一覧は、アイコンの一般的なサイズの詳細を示しています。The following list details the typical sizes for an icon:

  • 16ピクセル x 16 ピクセル16 pixels x 16 pixels

  • 32ピクセル x 32 ピクセル32 pixels x 32 pixels

  • 48ピクセル x 48 ピクセル48 pixels x 48 pixels

このコンストラクターは、指定されたファイルに格納されている最小のイメージを返します。This constructor returns the smallest image that is contained in the specified file.

Icon(Icon, Size)

Icon クラスの新しいインスタンスを初期化し、要求されたサイズに一致するアイコンを検索します。Initializes a new instance of the Icon class and attempts to find a version of the icon that matches the requested size.

public:
 Icon(System::Drawing::Icon ^ original, System::Drawing::Size size);
public Icon (System.Drawing.Icon original, System.Drawing.Size size);
new System.Drawing.Icon : System.Drawing.Icon * System.Drawing.Size -> System.Drawing.Icon

パラメーター

original
Icon

サイズが変更されたアイコンの読み込み元の IconThe Icon from which to load the newly sized icon.

size
Size

新しい Size の高さと幅を指定する Icon 構造体。A Size structure that specifies the height and width of the new Icon.

例外

original パラメーターが null です。The original parameter is null.

注釈

サイズと完全に一致するバージョンが見つからない場合は、最も近い一致が使用されます。If a version cannot be found that exactly matches the size, the closest match is used. original パラメーターが1つのサイズの Icon である場合、このメソッドは重複するアイコンだけを作成します。If the original parameter is an Icon that has a single size, this method only creates a duplicate icon. DrawImage メソッドの拡大機能を使用して、アイコンのサイズを変更します。Use the stretching capabilities of the DrawImage method to resize the icon.

Icon(Stream, Size)

指定したストリームから指定したサイズで Icon クラスの新しいインスタンスを初期化します。Initializes a new instance of the Icon class of the specified size from the specified stream.

public:
 Icon(System::IO::Stream ^ stream, System::Drawing::Size size);
public Icon (System.IO.Stream stream, System.Drawing.Size size);
new System.Drawing.Icon : System.IO.Stream * System.Drawing.Size -> System.Drawing.Icon

パラメーター

stream
Stream

アイコン データを格納しているストリーム。The stream that contains the icon data.

size
Size

アイコンのサイズ。The desired size of the icon.

例外

streamnull、つまりイメージ データが含まれていません。The stream is null or does not contain image data.

Icon(String, Size)

指定したファイルから指定したサイズで Icon クラスの新しいインスタンスを初期化します。Initializes a new instance of the Icon class of the specified size from the specified file.

public:
 Icon(System::String ^ fileName, System::Drawing::Size size);
public Icon (string fileName, System.Drawing.Size size);
new System.Drawing.Icon : string * System.Drawing.Size -> System.Drawing.Icon

パラメーター

fileName
String

アイコンのデータを格納するファイルのパスと名前。The name and path to the file that contains the icon data.

size
Size

アイコンのサイズ。The desired size of the icon.

例外

stringnull、つまりイメージ データが含まれていません。The string is null or does not contain image data.

注釈

指定したファイルに目的のサイズと一致するイメージが含まれていない場合は、サイズが最も近いアイコンが返されます。If the specified file does not contain an image that matches the desired size, the icon that has the closest size is returned.

現在のアプリケーションディレクトリに存在しない場合、fileName には完全なパスを含める必要があります。The fileName should include the complete path if it is not in the current application directory.

Icon(Type, String)

指定のアセンブリのリソースで Icon クラスの新しいインスタンスを初期化します。Initializes a new instance of the Icon class from a resource in the specified assembly.

public:
 Icon(Type ^ type, System::String ^ resource);
public Icon (Type type, string resource);
new System.Drawing.Icon : Type * string -> System.Drawing.Icon

パラメーター

type
Type

リソースを検索するアセンブリを指定する TypeA Type that specifies the assembly in which to look for the resource.

resource
String

読み込むリソース名。The resource name to load.

例外

resource によって指定されたアイコンが、指定された type が含まれるアセンブリに見つかりません。An icon specified by resource cannot be found in the assembly that contains the specified type.

Icon コンストラクターの使用方法を次のコード例に示します。The following code example demonstrates how to use the Icon constructor. この例を実行するには、Windows フォームにコードを貼り付け、フォームの Paint イベントを処理します。To run this example, paste the code into a Windows Form and handle the form's Paint event. eEventArgsとして渡し、Paint イベントハンドラーから ConstructAnIconFromAType メソッドを呼び出します。Call the ConstructAnIconFromAType method from the Paint event handler, passing e as EventArgs.

private void ConstructAnIconFromAType(PaintEventArgs e)
{

    Icon icon1 = new Icon(typeof(Control), "Error.ico");
    e.Graphics.DrawIcon(icon1, new Rectangle(10, 10, 50, 50));
}
Private Sub ConstructAnIconFromAType(ByVal e As PaintEventArgs)

    Dim icon1 As New Icon(GetType(Control), "Error.ico")
    e.Graphics.DrawIcon(icon1, New Rectangle(10, 10, 50, 50))

End Sub

注釈

このコンストラクターは、type パラメーターによって指定された型を含むアセンブリの resource パラメーターによって指定された名前を持つリソースから Icon を作成します。This constructor creates an Icon from a resource with the name specified by the resource parameter in the assembly that contains the type specified by the type parameter.

このコンストラクターは、指定された型の名前空間とリソースの文字列名を組み合わせて、アセンブリマニフェストで一致するものを検索します。This constructor combines the namespace of the given type together with the string name of the resource and looks for a match in the assembly manifest. たとえば、Control の型を渡し、このコンストラクターに Error.ico して、System.Windows.Forms.Error.icoという名前のリソースを検索することができます。For example you can pass in the Control type and Error.ico to this constructor, and it looks for a resource that is named System.Windows.Forms.Error.ico.

Icon(Icon, Int32, Int32)

Icon クラスの新しいインスタンスを初期化し、要求されたサイズに一致するアイコンを検索します。Initializes a new instance of the Icon class and attempts to find a version of the icon that matches the requested size.

public:
 Icon(System::Drawing::Icon ^ original, int width, int height);
public Icon (System.Drawing.Icon original, int width, int height);
new System.Drawing.Icon : System.Drawing.Icon * int * int -> System.Drawing.Icon
Public Sub New (original As Icon, width As Integer, height As Integer)

パラメーター

original
Icon

別のサイズの読み込み元のアイコン。The icon to load the different size from.

width
Int32

新しいアイコンの幅。The width of the new icon.

height
Int32

新しいアイコンの高さ。The height of the new icon.

例外

original パラメーターが null です。The original parameter is null.

次のコード例は、ToBitmap メソッドの使用方法を示します。The following code example demonstrates how to use the ToBitmap method. この例は、Windows フォームと共に使用するように設計されています。This example is designed to be used with Windows Forms. フォームを作成し、次のコードを貼り付けます。Create a form and paste the following code into it. フォームの Paint イベントハンドラーで IconToBitmap メソッドを呼び出し、ePaintEventArgsとして渡します。Call the IconToBitmap method in the form's Paint event handler, passing e as PaintEventArgs.

private:
   void IconToBitmap( PaintEventArgs^ e )
   {
      // Construct an Icon.
      System::Drawing::Icon^ icon1 = gcnew System::Drawing::Icon( SystemIcons::Exclamation,40,40 );

      // Call ToBitmap to convert it.
      Bitmap^ bmp = icon1->ToBitmap();

      // Draw the bitmap.
      e->Graphics->DrawImage( bmp, Point(30,30) );
   }
private void IconToBitmap(PaintEventArgs e)
{
    // Construct an Icon.
    Icon icon1 = new Icon(SystemIcons.Exclamation, 40, 40);

    // Call ToBitmap to convert it.
    Bitmap bmp = icon1.ToBitmap();

    // Draw the bitmap.
    e.Graphics.DrawImage(bmp, new Point(30, 30));
}
Private Sub IconToBitmap(ByVal e As PaintEventArgs)

    ' Construct an Icon.
    Dim icon1 As New Icon(SystemIcons.Exclamation, 40, 40)

    ' Call ToBitmap to convert it.
    Dim bmp As Bitmap = icon1.ToBitmap()

    ' Draw the bitmap.
    e.Graphics.DrawImage(bmp, New Point(30, 30))
End Sub

注釈

サイズと完全に一致するバージョンが見つからない場合は、最も近い一致が使用されます。If a version cannot be found that exactly matches the size, the closest match is used. original パラメーターが1つのサイズの Icon である場合、このメソッドは重複するアイコンだけを作成します。If the original parameter is an Icon that has a single size, this method only creates a duplicate icon. DrawImage メソッドの拡大機能を使用して、アイコンのサイズを変更します。Use the stretching capabilities of the DrawImage method to resize the icon.

Icon(Stream, Int32, Int32)

指定のデータ ストリームから指定の幅と高さで、Icon クラスの新しいインスタンスを初期化します。Initializes a new instance of the Icon class from the specified data stream and with the specified width and height.

public:
 Icon(System::IO::Stream ^ stream, int width, int height);
public Icon (System.IO.Stream stream, int width, int height);
new System.Drawing.Icon : System.IO.Stream * int * int -> System.Drawing.Icon

パラメーター

stream
Stream

アイコンの読み込み元のデータ ストリーム。The data stream from which to load the icon.

width
Int32

アイコンの幅 (ピクセル単位)。The width, in pixels, of the icon.

height
Int32

アイコンの高さ (ピクセル単位)。The height, in pixels, of the icon.

例外

stream パラメーターが null です。The stream parameter is null.

Icon(String, Int32, Int32)

指定したファイルから幅と高さを指定して、Icon クラスの新しいインスタンスを初期化します。Initializes a new instance of the Icon class with the specified width and height from the specified file.

public:
 Icon(System::String ^ fileName, int width, int height);
public Icon (string fileName, int width, int height);
new System.Drawing.Icon : string * int * int -> System.Drawing.Icon
Public Sub New (fileName As String, width As Integer, height As Integer)

パラメーター

fileName
String

Icon のデータを格納するファイルのパスと名前。The name and path to the file that contains the Icon data.

width
Int32

Icon の幅。The desired width of the Icon.

height
Int32

Icon の高さ。The desired height of the Icon.

例外

stringnull、つまりイメージ データが含まれていません。The string is null or does not contain image data.

注釈

指定したファイルに、目的の高さと幅に一致するイメージが含まれていない場合は、サイズが最も近いアイコンが返されます。If the specified file does not contain an image that matches the desired height and width, the icon that has the closest size is returned.

現在のアプリケーションディレクトリに存在しない場合、fileName には完全なパスを含める必要があります。The fileName should include the complete path if it is not in the current application directory.

適用対象