PSFormatPropertyValue-Funktion (propsys.h)
Ruft eine formatierte Unicode-Zeichenfolgendarstellung eines Eigenschaftswerts ab, der in einem Eigenschaftenspeicher gespeichert ist. Diese Funktion weist Arbeitsspeicher für die Ausgabezeichenfolge zu.
Syntax
PSSTDAPI PSFormatPropertyValue(
[in] IPropertyStore *pps,
[in] IPropertyDescription *ppd,
[in] PROPDESC_FORMAT_FLAGS pdff,
[out] LPWSTR *ppszDisplay
);
Parameter
[in] pps
Typ: IPropertyStore*
Zeiger auf einen IPropertyStore, der den Eigenschaftenspeicher darstellt, aus dem der Eigenschaftswert genommen wird.
[in] ppd
Typ: IPropertyDescription*
Zeiger auf eine IPropertyDescription, die die Eigenschaft darstellt, deren Wert abgerufen wird.
[in] pdff
Mindestens eine PROPDESC_FORMAT_FLAGS , die das Format angeben, das auf die Eigenschaftenzeichenfolge angewendet werden soll. Mögliche Werte finden Sie unter PROPDESC_FORMAT_FLAGS .
[out] ppszDisplay
Typ: LPWSTR*
Wenn die Funktion zurückgibt, enthält einen Zeiger auf den formatierten Wert als null-beendete Unicode-Zeichenfolge.
Rückgabewert
Typ: HRESULT
Wenn diese Funktion erfolgreich ist, gibt sie S_OK zurück. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.
Hinweise
Diese Funktion verwendet den ppd-Parameter , um IPropertyDescription::FormatForDisplay aufzurufen. Dieser Aufruf bietet eine Unicode-Zeichenfolgendarstellung eines Eigenschaftswerts mit zusätzlicher Formatierung basierend auf einem oder mehreren PROPDESC_FORMAT_FLAGS.
Sie müssen Component Object Model (COM) mit CoInitialize oder OleInitialize initialisieren , bevor Sie PSFormatPropertyValue aufrufen.
Die Funktion weist Arbeitsspeicher zu und gibt einen Zeiger auf diesen Speicher in ppszDisplay zurück. Die aufrufende Anwendung muss CoTaskMemFree verwenden, um die von ppszDisplay angegebene Zeichenfolge freizugeben, wenn sie nicht mehr benötigt wird.
Der Zweck dieser Funktion besteht darin, Daten in eine Zeichenfolge zu konvertieren, die für die Anzeige für den Benutzer geeignet ist. Der Wert wird entsprechend dem aktuellen Gebietsschema, der Sprache des Benutzers, dem PROPDESC_FORMAT_FLAGS und der Durch den Eigenschaftenschlüssel angegebenen Eigenschaftenbeschreibung formatiert. Informationen dazu, wie das Eigenschaftenbeschreibungsschema die Formatierung des Werts beeinflusst, finden Sie in den folgenden Themen:
In der Regel werden die PROPDESC_FORMAT_FLAGS verwendet, um das in der Eigenschaftenbeschreibung vorgeschriebene Format zu ändern.Die Ausgabezeichenfolge kann Unicode-Richtungszeichen enthalten. Diese nicht überziehenden Zeichen beeinflussen den bidirektionalen Unicode-Algorithmus, sodass die Werte richtig angezeigt werden, wenn eine LTR-Sprache (Left-to-Right) in einem RTL-Fenster (Right-to-Left) gezeichnet wird oder ein RTL in einem LTR-Fenster gezeichnet wird. Diese Zeichen umfassen Folgendes: "\x200e", "\x200f", "\x202a", "\x202b", "\x202c", "\x202d", "\x202e".
Die folgenden Eigenschaften verwenden spezielle Formate und sind vom PROPDESC_FORMAT_FLAGS nicht betroffen. Beachten Sie, dass die angegebenen Beispiele für Zeichenfolgen gelten, deren aktuelles Gebietsschema auf Englisch festgelegt ist. In der Regel wird die Ausgabe lokalisiert, sofern nicht angegeben.
| Eigenschaft | Format |
|---|---|
| System.FileAttributes | Die folgenden Dateiattribute werden in Buchstaben konvertiert und angefügt, um eine Zeichenfolge zu erstellen (z. B. ein Wert von 0x1801 (FILE_ATTRIBUTE_READONLY | FILE_ATTRIBUTE_COMPRESSED | FILE_ATTRIBUTE_OFFLINE) wird in "RCO" konvertiert):
|
| System.Photo.ISOSpeed | Beispiel: "ISO-400". |
| System.Photo.ShutterSpeed |
Der APEX-Wert wird mithilfe dieser Formel in eine Belichtungszeit konvertiert:
Beispiel: "2 Sekunden". oder "1/125 Sek.". |
| System.Photo.ExposureTime | Beispiel: "2 Sekunden". oder "1/125 Sekunden". |
| System.Photo.Aperture |
Der APEX-Wert wird mithilfe dieser Formel in eine F-Zahl konvertiert:
Beispiel: "f/5.6". |
| System.Photo.FNumber | Beispiel: "f/5.6". |
| System.Photo.SubjectDistance | Beispiel: "15 m" oder "250 mm". |
| System.Photo.FocalLength | Beispiel: "50 mm". |
| System.Photo.FlashEnergy | Beispiel: "500 bpcs". |
| System.Photo.ExposureBias | Beispiel: "-2 Schritt", "0 Schritt" oder "+3 Schritt". |
| System.Computer.DecoratedFreeSpace | Beispiel: "105 MB frei von 13,2 GB". |
| System.ItemType | Beispiel: "Anwendung" oder "JPEG-Bild". |
| System.ControlPanel.Category | Beispiel: "Darstellung und Personalisierung". |
| System.ComputerName | Beispiel: "LITWARE05 (dieser Computer)" oder "testbox07". |
Wenn der Eigenschaftenschlüssel keiner Eigenschaftsbeschreibung in einem der registrierten Eigenschaftenschemas entspricht, wählt diese Funktion ein Format basierend auf dem Typ des Werts aus.
| Typ des Werts | Format |
|---|---|
| VT_BOOLEAN | Wird nicht unterstützt. |
| VT_FILETIME | Datums-/Uhrzeitzeichenfolge, wie durch PROPDESC_FORMAT_FLAGS und das aktuelle Gebietsschema angegeben. PDFF_SHORTTIME und PDFF_SHORTDATE sind die Standardeinstellung. Beispiel: "13.11.2006 15:22 Uhr". |
| Numerischer VARTYPE | Dezimalzeichenfolge im aktuellen Gebietsschema. Beispiel: "42". |
| VT_LPWSTR oder andere | In eine Zeichenfolge konvertiert. Sequenzen von "\r", "\t" oder "\n" werden durch ein einzelnes Leerzeichen ersetzt. |
| VT_VECTOR | Etwas | Durch Semikolon getrennte Werte. Ein Semikolon wird unabhängig vom Gebietsschema verwendet. |
Beispiele
Im folgenden Beispiel, das als Teil eines größeren Programms eingeschlossen werden soll, wird veranschaulicht, wie SIE PSFormatPropertyValue verwenden, um einen Bewertungswert zu formatieren.
// IPropertyStore *pStore;
// Assume the variable pps is initialized and valid.
IPropertyDescription *pPropDesc;
HRESULT hr = PSGetPropertyDescription(PKEY_Rating, IID_PPV_ARGS(&pPropDesc));
if (SUCCEEDED(hr))
{
PWSTR pszValue;
hr = PSFormatPropertyValue(pStore, pPropDesc, PDFF_DEFAULT, &pszValue);
if (SUCCEEDED(hr))
{
// pszValue contains a formatted string similar to "3 stars".
CoTaskMemFree(pszValue);
}
pPropDesc->Release();
}
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2008 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | propsys.h |
| Bibliothek | Propsys.lib |
| DLL | Propsys.dll (Version 6.0 oder höher) |
| Verteilbare Komponente | Windows Desktop Search (WDS) 3.0 |