IPropertyUI：：FormatForDisplay 方法 (shobjidl_core.h)

發行項
03/05/2024

開發人員應該改用 IPropertyDescription 。取得屬性值的格式化 Unicode 字串表示。

語法

HRESULT FormatForDisplay(
  [in]  REFFMTID                fmtid,
  [in]  PROPID                  pid,
  [in]  const PROPVARIANT       *ppropvar,
  [in]  PROPERTYUI_FORMAT_FLAGS puiff,
  [out] LPWSTR                  pwszText,
  [in]  DWORD                   cchText
);

參數

[in] fmtid

類型： REFFMTID

[in] pid

類型： PROPID

[in] ppropvar

類型： PROPVARIANT*

PROPVARIANT 結構，其中包含屬性的類型和值。

[in] puiff

類型： PROPERTYUI_FORMAT_FLAGS

傳回屬性值的格式。

PUIFFDF_DEFAULT (0x00000000)

0x00000000。

PUIFFDF_RIGHTTOLEFT (0x00000001)

0x00000001。已被取代，請勿使用。

PUIFFDF_SHORTFORMAT (0x00000002)

0x00000002。使用字串的簡短格式版本。

PUIFFDF_NOTIME (0x00000004)

0x00000004。截斷時間到天數，而不是小時/分鐘/秒。

PUIFFDF_FRIENDLYDATE (0x00000008)

0x00000008。使用日期的易記名稱：「Today」、“ Today 等。

[out] pwszText

類型： LPWSTR

屬性值，格式化為顯示。

[in] cchText

類型： DWORD

傳回值

類型： HRESULT

如果此方法成功，則會傳回 S_OK。否則，它會傳回 HRESULT 錯誤碼。

規格需求

需求	值
最低支援的用戶端	Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限桌面應用程式]
目標平台	Windows
標頭	shobjidl_core.h

共用方式為