PersonPicture 类

定义

命名空间:

Microsoft.UI.Xaml.Controls

表示一个控件，该控件在用户头像可用的情况下显示用户头像，在用户头像不可用的情况下显示该用户的姓名缩写或通用字形。

本文档适用于Windows 应用 SDK中的 WinUI 2 for UWP (for WinUI，请参阅) Windows 应用 SDK命名空间。

/// [Microsoft.UI.Xaml.MUXContractProperty(version=5)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.Version(1)]
class PersonPicture : Control

/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.Version(1)]
/// [Microsoft.UI.Xaml.CustomAttributes.MUXContractProperty(version=5)]
/// [Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallback(enable=true)]
/// [Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallbackMethodName(value="OnPropertyChanged")]
class PersonPicture : Control

/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallback(enable=true)]
/// [Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallbackMethodName(value="OnPropertyChanged")]
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.XamlContract, 65536)]
class PersonPicture : Control

[Microsoft.UI.Xaml.MUXContractProperty(version=5)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.Version(1)]
public class PersonPicture : Control

[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.Version(1)]
[Microsoft.UI.Xaml.CustomAttributes.MUXContractProperty(version=5)]
[Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallback(enable=true)]
[Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallbackMethodName(value="OnPropertyChanged")]
public class PersonPicture : Control

[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallback(enable=true)]
[Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallbackMethodName(value="OnPropertyChanged")]
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.UI.Xaml.XamlContract), 65536)]
public class PersonPicture : Control

Public Class PersonPicture
Inherits Control

<PersonPicture/>

继承

Control

PersonPicture

属性

Microsoft.UI.Xaml.MUXContractPropertyAttribute MarshalingBehaviorAttribute ThreadingAttribute VersionAttribute Microsoft.UI.Xaml.CustomAttributes.MUXContractPropertyAttribute Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallbackAttribute Microsoft.UI.Xaml.CustomAttributes.MUXPropertyChangedCallbackMethodNameAttribute ContractVersionAttribute

示例

提示

有关详细信息、设计指南和代码示例，请参阅 人员图片。

打开 WinUI 2 库应用，查看 PersonPicture 的运行情况。

WinUI 2 库应用包括大多数 WinUI 2 控件、特性和功能的交互式示例。 通过 Microsoft Store 获取应用，或在 GitHub 上获取源代码。

注解

控件样式和模板

可以修改默认 的 Style 和 ControlTemplate ，为控件提供唯一的外观。 有关修改控件样式和模板的信息，请参阅 XAML 样式。 XAML 还包括可用于在不修改控件模板的情况下修改处于不同视觉状态的控件颜色的资源。 修改这些资源优先于设置 背景 和 前台等属性。 有关详细信息，请参阅 XAML 样式一文的轻量级样式部分。

GitHub 上 PersonPicture_themeresources.xaml 文件的 ThemeDictionaries 部分中列出了此控件的资源。 ResourceKey每个 的值引用 StaticResourceCommon_themeresources_any.xaml 文件中的画笔和颜色。

构造函数

PersonPicture()

初始化 PersonPicture 类的新实例。 本文档适用于Windows 应用 SDK中的 WinUI 2 for UWP (for WinUI，请参阅) Windows 应用 SDK命名空间。

属性

BadgeGlyph	获取或设置要显示在锁屏提醒上的 Segoe MDL2 Assets 字体字形。 本文档适用于Windows 应用 SDK中的 WinUI 2 for UWP (for WinUI，请参阅) Windows 应用 SDK命名空间。
BadgeGlyphProperty	标识 BadgeGlyph 依赖属性。 本文档适用于Windows 应用 SDK中的 WinUI 2 for UWP (for WinUI，请参阅) Windows 应用 SDK命名空间。
BadgeImageSource	获取或设置要显示在锁屏提醒上的图像的源。 本文档适用于Windows 应用 SDK中的 WinUI 2 for UWP (for WinUI，请参阅) Windows 应用 SDK命名空间。
BadgeImageSourceProperty	标识 BadgeImageSource 依赖属性。 本文档适用于Windows 应用 SDK中的 WinUI 2 for UWP (for WinUI，请参阅) Windows 应用 SDK命名空间。
BadgeNumber	获取或设置要显示在锁屏提醒上的联系人号码。 本文档适用于Windows 应用 SDK中的 WinUI 2 for UWP (for WinUI，请参阅) Windows 应用 SDK命名空间。
BadgeNumberProperty	标识 BadgeNumber 依赖属性。 本文档适用于Windows 应用 SDK中的 WinUI 2 for UWP (for WinUI，请参阅) Windows 应用 SDK命名空间。
BadgeText	获取或设置要显示在锁屏提醒上的联系人文本。 本文档适用于Windows 应用 SDK中的 WinUI 2 for UWP (for WinUI，请参阅) Windows 应用 SDK命名空间。
BadgeTextProperty	标识 BadgeText 依赖属性。 本文档适用于Windows 应用 SDK中的 WinUI 2 for UWP (for WinUI，请参阅) Windows 应用 SDK命名空间。
Contact	获取或设置一个 Contact 对象，该对象包含有关人员的信息。 本文档适用于Windows 应用 SDK中的 WinUI 2 for UWP (for WinUI，请参阅) Windows 应用 SDK命名空间。
ContactProperty	标识 Contact 依赖属性。 本文档适用于Windows 应用 SDK中的 WinUI 2 for UWP (for WinUI，请参阅) Windows 应用 SDK命名空间。
DisplayName	获取或设置联系人的显示名称。 本文档适用于Windows 应用 SDK中的 WinUI 2 for UWP (for WinUI，请参阅) Windows 应用 SDK命名空间。
DisplayNameProperty	标识 DisplayName 依赖属性。 本文档适用于Windows 应用 SDK中的 WinUI 2 for UWP (for WinUI，请参阅) Windows 应用 SDK命名空间。
Initials	获取或设置联系人的首字母缩写。 本文档适用于Windows 应用 SDK中的 WinUI 2 for UWP (for WinUI，请参阅) Windows 应用 SDK命名空间。
InitialsProperty	标识“首字母缩写”依赖属性。 本文档适用于Windows 应用 SDK中的 WinUI 2 for UWP (for WinUI，请参阅) Windows 应用 SDK命名空间。
IsGroup	获取或设置一个值，该值指示 PersonPicture 是表示组还是个人。 本文档适用于Windows 应用 SDK中的 WinUI 2 for UWP (for WinUI，请参阅) Windows 应用 SDK命名空间。
IsGroupProperty	标识 IsGroup 依赖属性。 本文档适用于Windows 应用 SDK中的 WinUI 2 for UWP (for WinUI，请参阅) Windows 应用 SDK命名空间。
PreferSmallImage	获取或设置一个值，该值指示在两者都可用时是否显示小图像，而不是显示大图像。 本文档适用于Windows 应用 SDK中的 WinUI 2 for UWP (for WinUI，请参阅) Windows 应用 SDK命名空间。
PreferSmallImageProperty	标识 PreferSmallImage 依赖属性。 本文档适用于Windows 应用 SDK中的 WinUI 2 for UWP (for WinUI，请参阅) Windows 应用 SDK命名空间。
ProfilePicture	获取或设置联系人个人资料图片的来源。 本文档适用于Windows 应用 SDK中的 WinUI 2 for UWP (for WinUI，请参阅) Windows 应用 SDK命名空间。
ProfilePictureProperty	标识 ProfilePicture 依赖属性。 本文档适用于Windows 应用 SDK中的 WinUI 2 for UWP (for WinUI，请参阅) Windows 应用 SDK命名空间。
TemplateSettings	提供在定义 PersonPicture 模板时可以作为 TemplatedParent 源引用的计算值。 不适合一般用途。 本文档适用于Windows 应用 SDK中的 WinUI 2 for UWP (for WinUI，请参阅) Windows 应用 SDK命名空间。

另请参阅

• 个人图片控件