Icon 建構函式

定義

命名空間:: System.Drawing

組件:: System.Drawing.Common.dll

組件:: System.Drawing.dll

套件:: System.Drawing.Common v11.0.0-rc.1.26425.128

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

初始化 Icon 類別的新執行個體。

多載

名稱	Description
Icon(Stream)	從指定的資料流中初始化該類別的新實例 Icon 。
Icon(String)	從指定的檔案名稱初始化該 Icon 類別的新實例。
Icon(Icon, Size)	初始化該類別的新實例 Icon ，並嘗試尋找符合請求大小的圖示版本。
Icon(Stream, Size)	從指定的串流中初始化該類別中指定大小的新實例 Icon 。
Icon(String, Size)	從指定檔案初始化該類別中指定大小的新實例 Icon 。
Icon(Type, String)	從指定組合語言中的資源初始化該 Icon 類別的新實例。
Icon(Icon, Int32, Int32)	初始化該類別的新實例 Icon ，並嘗試尋找符合請求大小的圖示版本。
Icon(Stream, Int32, Int32)	從指定的資料流初始化該類別的新實例 Icon ，並以指定的寬度與高度。
Icon(String, Int32, Int32)	初始化一個新的類別實例 Icon ，並以指定的寬度和高度從指定的檔案中初始化。

Icon(Stream)

來源:: Icon.cs

來源:: Icon.cs

來源:: Icon.cs

來源:: Icon.cs

來源:: Icon.cs

來源:: Icon.cs

來源:: Icon.cs

來源:: Icon.cs

來源:: Icon.cs

從指定的資料流中初始化該類別的新實例 Icon 。

public:
 Icon(System::IO::Stream ^ stream);

public Icon(System.IO.Stream stream);

new System.Drawing.Icon : System.IO.Stream -> System.Drawing.Icon

Public Sub New (stream As Stream)

參數

stream: Stream

載入 Icon的資料流。

例外狀況

ArgumentException

參數 stream 為 null。

備註

一個圖示資源可以包含多個圖示影像。一個圖示檔案可能包含多種大小與色深的影像。應用程式中使用的映像檔取決於作業系統和設定。以下列表詳細說明圖示的典型尺寸：

16 像素 x 16 像素
32 像素 x 32 像素
48 像素 x 48 像素

此建構器回傳指定串流中最小的影像。

適用於

Icon(String)

來源:: Icon.cs

來源:: Icon.cs

來源:: Icon.cs

來源:: Icon.cs

來源:: Icon.cs

來源:: Icon.cs

來源:: Icon.cs

來源:: Icon.cs

來源:: Icon.cs

從指定的檔案名稱初始化該 Icon 類別的新實例。

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 檔案。

備註

16 像素 x 16 像素
32 像素 x 32 像素
48 像素 x 48 像素

此建構子回傳指定檔案中最小的影像。

適用於

Icon(Icon, Size)

來源:: Icon.cs

來源:: Icon.cs

來源:: Icon.cs

來源:: Icon.cs

來源:: Icon.cs

來源:: Icon.cs

來源:: Icon.cs

來源:: Icon.cs

來源:: Icon.cs

初始化該類別的新實例 Icon ，並嘗試尋找符合請求大小的圖示版本。

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

Public Sub New (original As Icon, size As Size)

參數

original: Icon

Icon從那裡載入新大小的圖示。

size: Size

一個 Size 結構，指定新 Icon的高度與寬度。

例外狀況

ArgumentException

參數 original 為 null。

備註

若找不到完全符合尺寸的版本，則使用最接近的版本。如果 original 參數是， Icon 只有單一大小，此方法只會產生重複圖示。利用方法 DrawImage 的拉伸功能來調整圖示大小。

適用於

Icon(Stream, Size)

來源:: Icon.cs

來源:: Icon.cs

來源:: Icon.cs

來源:: Icon.cs

來源:: Icon.cs

來源:: Icon.cs

來源:: Icon.cs

來源:: Icon.cs

來源:: Icon.cs

從指定的串流中初始化該類別中指定大小的新實例 Icon 。

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

Public Sub New (stream As Stream, size As Size)

參數

stream: Stream

包含圖示資料的串流。

size: Size

圖示的期望尺寸。

例外狀況

ArgumentException

該資料 stream 是否 null 包含影像資料。

適用於

Icon(String, Size)

來源:: Icon.cs

來源:: Icon.cs

來源:: Icon.cs

來源:: Icon.cs

來源:: Icon.cs

來源:: Icon.cs

來源:: Icon.cs

來源:: Icon.cs

來源:: Icon.cs

從指定檔案初始化該類別中指定大小的新實例 Icon 。

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

Public Sub New (fileName As String, size As Size)

參數

fileName: String

包含圖示資料的檔案名稱與路徑。

size: Size

圖示的期望尺寸。

例外狀況

ArgumentException

該資料 fileName 是否 null 包含影像資料。

備註

若指定檔案中圖片大小不符，則回傳大小最接近的圖示。

如果完整路徑不在目前的應用程式目錄中，應該 fileName 會包含它。

適用於

Icon(Type, String)

來源:: Icon.cs

來源:: Icon.cs

來源:: Icon.cs

來源:: Icon.cs

來源:: Icon.cs

來源:: Icon.cs

來源:: Icon.cs

來源:: Icon.cs

來源:: Icon.cs

從指定組合語言中的資源初始化該 Icon 類別的新實例。

public:
 Icon(Type ^ type, System::String ^ resource);

public Icon(Type type, string resource);

new System.Drawing.Icon : Type * string -> System.Drawing.Icon

Public Sub New (type As Type, resource As String)

參數

type: Type

Type A 指定要尋找資源的組裝裝置。

resource: String

要載入的資源名稱。

例外狀況

ArgumentException

由指定的 resource 圖示無法在包含指定 type的組裝中找到。

範例

以下程式碼範例示範如何使用 Icon 建構子。執行此範例時，將程式碼貼入Windows表單，並處理表單的 Paint 事件。從事件處理程序呼叫該 ConstructAnIconFromAType 方法 Paint ，傳遞 e 為 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

備註

此建構子從一個資源中建立 Icon 一個資源，其名稱由 resource 包含該參數指定的 type 參數所指定的組合語言所指定的參數所指定。

此建構子將指定型態的命名空間與資源的字串名稱結合，並在組合語言清單中尋找匹配。例如，你可以將 Control 類型和 Error.ico 傳入這個建構子，它會尋找名為 System.Windows.Forms.Error.ico 的資源。

適用於

Icon(Icon, Int32, Int32)

來源:: Icon.cs

來源:: Icon.cs

來源:: Icon.cs

來源:: Icon.cs

來源:: Icon.cs

來源:: Icon.cs

來源:: Icon.cs

來源:: Icon.cs

來源:: Icon.cs

初始化該類別的新實例 Icon ，並嘗試尋找符合請求大小的圖示版本。

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

用來載入不同大小的圖示。

width: Int32

新圖示的寬度。

height: Int32

新聖像的高度。

例外狀況

ArgumentException

參數 original 為 null。

範例

以下程式碼範例示範如何使用此 ToBitmap 方法。此範例設計用於 Windows 表單。建立一個表單，然後把以下程式碼貼上去。在表單的事件處理程序中呼叫該IconToBitmap方法，並傳遞Paint為 e。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

備註

適用於

Icon(Stream, Int32, Int32)

來源:: Icon.cs

來源:: Icon.cs

來源:: Icon.cs

來源:: Icon.cs

來源:: Icon.cs

來源:: Icon.cs

來源:: Icon.cs

來源:: Icon.cs

來源:: Icon.cs

從指定的資料流初始化該類別的新實例 Icon ，並以指定的寬度與高度。

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

Public Sub New (stream As Stream, width As Integer, height As Integer)

參數

stream: Stream

就是從中載入圖示的資料流。

width: Int32

圖示的寬度（以像素為單位）。

height: Int32

圖示的高度（以像素為單位）。

例外狀況

ArgumentException

參數 stream 為 null。

適用於

Icon(String, Int32, Int32)

來源:: Icon.cs

來源:: Icon.cs

來源:: Icon.cs

來源:: Icon.cs

來源:: Icon.cs

來源:: Icon.cs

來源:: Icon.cs

來源:: Icon.cs

來源:: Icon.cs

初始化一個新的類別實例 Icon ，並以指定的寬度和高度從指定的檔案中初始化。

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 名稱與路徑。

width: Int32

所需的寬度 Icon。

height: Int32

期望的 Icon高度。

例外狀況

ArgumentException

該資料 fileName 是否 null 包含影像資料。

備註

若指定檔案中圖片不符合所需高度與寬度，則會回傳大小最接近的圖示。

如果完整路徑不在目前的應用程式目錄中，應該 fileName 會包含它。

適用於

意見反應

此頁面對您有幫助嗎？