ImageIcon 類別
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
表示使用 影像 做為其內容的圖示。
本檔適用于 Windows 應用程式 SDK 中適用于 WinUI 的 WinUI 2 for UWP (,請參閱Windows 應用程式 SDK命名空間) 。
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.XamlContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class ImageIcon : IconElement
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.XamlContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public class ImageIcon : IconElement
Public Class ImageIcon
Inherits IconElement
- 繼承
-
ImageIcon
- 屬性
提示
如需詳細資訊、設計指引和程式碼範例,請參閱 Windows 應用程式的圖示。
WinUI 3 資源庫和WinUI 2 資源庫應用程式包含大部分 WinUI 3 和 WinUI 2 控制項、特性和功能的互動式範例。
如果已安裝,請按一下下列連結加以開啟: WinUI 3 資源庫 或 WinUI 2 資源庫。
如果未安裝,您可以從 Microsoft Store 下載 WinUI 3 資源庫 和 WinUI 2 資源庫 。
您也可以從 GitHub 取得的原始程式碼 (使用 WinUI 3 的主要 分支和 WinUI 2) 的 winui2 分支。
下列範例顯示具有 的 ImageIcon
AppBarButton。
來源 會指定包含在應用程式套件中的影像。
<!--
xmlns:muxc="using:Microsoft.UI.Xaml.Controls"
-->
<AppBarButton Label="ImageIcon">
<AppBarButton.Icon>
<muxc:ImageIcon Source="ms-appx:///Assets/globe.png"/>
</AppBarButton.Icon>
</AppBarButton>
以下示範如何從點陣圖資料流程載入 ImageIcon
。
// using muxc = Microsoft.UI.Xaml.Controls;
var bitmapSource = new BitmapSource();
await bitmapSource.SetSourceAsync(bitmapStream);
var icon = new muxc.ImageIcon() { Source = bitmapSource };
支援的映射類型是.bmp、.gif、.jpg、.png、.wdp 和 .tiff。
影像在透明背景上應該為實心。
只會使用多框架影像的第一個畫面。 若要使用動畫圖標,請參閱 AnimatedIcon。
由於支援的檔案類型, ImageIcon
會忽略 Foreground 屬性,因此您無法像在其他 IconSource 衍生控制項上一樣變更前景色彩。
ImageIcon
通常會與 AppBarButton搭配使用,但可在任何 IconElement
位置使用。
Image |
初始化 本檔適用于 Windows 應用程式 SDK 中適用于 WinUI 的 WinUI 2 for UWP (,請參閱Windows 應用程式 SDK命名空間) 。 |
Source |
取得或設定要作為圖示之影像檔案的 URI。 本檔適用于 Windows 應用程式 SDK 中適用于 WinUI 的 WinUI 2 for UWP (,請參閱Windows 應用程式 SDK命名空間) 。 |
Source |
識別 本檔適用于 Windows 應用程式 SDK 中適用于 WinUI 的 WinUI 2 for UWP (,請參閱Windows 應用程式 SDK命名空間) 。 |