IPropertySystem::GetPropertyDescriptionListFromString-Methode (propsys.h)
Ruft eine instance des Subsystemobjekts ab, das IPropertyDescriptionList implementiert, um eine geordnete Auflistung von Eigenschaftenbeschreibungen basierend auf der bereitgestellten Zeichenfolge abzurufen.
Syntax
HRESULT GetPropertyDescriptionListFromString(
[in] LPCWSTR pszPropList,
[in] REFIID riid,
[out] void **ppv
);
Parameter
[in] pszPropList
Typ: LPCWSTR
Ein Zeiger auf eine Zeichenfolge, die die Eigenschaftenliste identifiziert.
[in] riid
Typ: REFIID
Ein Verweis auf die gewünschte IID.
[out] ppv
Typ: void**
Die Adresse eines IPropertyDescriptionList-Schnittstellenzeigers .
Rückgabewert
Typ: HRESULT
Gibt einen der folgenden Werte zurück.
| Rückgabecode | BESCHREIBUNG |
|---|---|
|
Gibt an, dass die Schnittstelle abgerufen wird. |
|
Gibt an , dass ppvNULL ist. |
Hinweise
Die Syntax der Eigenschaftenbeschreibungslistenzeichenfolge ("Proplist") besteht aus einer Sequenz kanonischer Eigenschaftennamen, wobei jedem Eigenschaftsnamen Flags zugeordnet sind. Die Zeichenfolge beginnt mit "prop:". Die Syntax sieht wie folgt aus: prop:[flags]propertyname[endflags];
Die Flags sind optional und können eines der folgenden sein. Hinweis: Diese Flags werden in die PROPDESC_VIEW_FLAGS Enumeration übersetzt.
| Flag | Bedeutung |
|---|---|
| - | Sortieren in umgekehrter Reihenfolge (PDVF_REVERSESORT). |
| 0 | Standardmäßig sowohl in der primären als auch in der sekundären Liste anzeigen (PDVF_SHOWBYDEFAULT | PDVF_SHOWINPRIMARYLIST | PDVF_SHOWINSECONDARYLIST). |
| 1 | Anzeigen in der primären und sekundären Liste (PDVF_SHOWINPRIMARYLIST | PDVF_SHOWINSECONDARYLIST). |
| 2 | In sekundärer Liste anzeigen (PDVF_SHOWINSECONDARYLIST). |
| ^ | Beginnen Sie eine neue Gruppe (PDVF_BEGINNEWGROUP). |
| / | Rechtsbündig (PDVF_RIGHTALIGN). |
| * | Ausblenden, wenn der Wert nicht vorhanden ist. |
| | | Zentrig ausrichten. (PDVF_CENTERALIGN). |
| ~ | Blenden Sie die Bezeichnung aus. (PDVF_HIDELABEL). |
| # | Bereich ausfüllen. (PDVF_FILLAREA). |
| ? | Ausblenden, wenn vom Eigenschaftenhandler (PDVF_HIDEIFUNSUPPORTED) nicht unterstützt wird. |
| < | Analysieren als Link (PDVF_PARSEASLINK). |
| & | Als ganzen Link anzeigen (PDVF_SHOWASWHOLELINK). |
Aus sicht des Dbfolders und des Dateiordners:
| 0 | Anzeigen als Spalte im Defview-, Spaltenwählermenü und Spaltenwählerdialogfeld. |
| 1 | Anzeigen im Menü der Spaltenwährung und im Dialogfeld. |
| 2 | Im Dialogfeld "Spaltenwährer" anzeigen. |
| NULL | In die Suchergebnisse einschließen, aber auf der Benutzeroberfläche ausblenden. |
Die Endflags sind ebenfalls optional und können wie folgt aussehen:
| EndFlag | Bedeutung |
|---|---|
| ] | Endspalte (wird für erweiterte Kachelnansicht verwendet). |
Es wird empfohlen, das makro IID_PPV_ARGS zu verwenden, das in objbase.h definiert ist, um die Parameter riid und ppv zu packen. Dieses Makro stellt die richtige IID basierend auf der Schnittstelle bereit, auf die der Wert in ppv verweist, wodurch die Möglichkeit eines Codierungsfehlers beseitigt wird.
Weitere Informationen zu Eigenschaftenschemas finden Sie unter Eigenschaftenschemas.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows XP mit SP2, Windows Vista [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2003 mit SP1 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | propsys.h |
| DLL | Propsys.dll (Version 5.0 oder höher) |
| Verteilbare Komponente | Windows Desktop Search (WDS) 3.0 |