IPropertySystem::GetPropertyDescriptionListFromString メソッド (propsys.h)

  • [アーティクル]

指定された文字列に基づいてプロパティの説明の順序付きコレクションを取得するために、 IPropertyDescriptionList を実装するサブシステム オブジェクトのインスタンスを取得します。

構文

HRESULT GetPropertyDescriptionListFromString(
  [in]  LPCWSTR pszPropList,
  [in]  REFIID  riid,
  [out] void    **ppv
);

パラメーター

[in] pszPropList

種類: LPCWSTR

プロパティ リストを識別する文字列へのポインター。

[in] riid

型: REFIID

目的の IID への参照。

[out] ppv

型: void**

IPropertyDescriptionList インターフェイス ポインターのアドレス。

戻り値

型: HRESULT

次のいずれかの値を返します。

リターン コード 説明
S_OK
 インターフェイスが取得されたことを示します。
E_INVALIDARG
 ppv が NULL であることを示します。

注釈

プロパティの説明リスト文字列 ("proplist") 構文は、各プロパティ名に関連付けられたフラグを持つ正規のプロパティ名のシーケンスで構成されます。 文字列は "prop:" で始まります。 構文は次のようになります。 prop:[flags]propertyname[endflags];

フラグは省略可能であり、以下のいずれかになります。 注: これらのフラグは 、PROPDESC_VIEW_FLAGS 列挙型に変換されます。

フラグ 説明
- 逆順 (PDVF_REVERSESORT) で並べ替えます。
0 プライマリ リストとセカンダリ リストの両方に既定で表示 (PDVF_SHOWBYDEFAULT |PDVF_SHOWINPRIMARYLIST |PDVF_SHOWINSECONDARYLIST)。
1 プライマリ リストとセカンダリ リストに表示する (PDVF_SHOWINPRIMARYLIST |PDVF_SHOWINSECONDARYLIST)。
2 セカンダリ リストに表示 (PDVF_SHOWINSECONDARYLIST)。
^ 新しいグループ (PDVF_BEGINNEWGROUP) を開始します。
/ 右揃え (PDVF_RIGHTALIGN)。
* 値が存在しない場合は非表示にします。
| 中央揃え。 (PDVF_CENTERALIGN)。
~ ラベルを非表示にします。 (PDVF_HIDELABEL)。
# 塗りつぶし領域。 (PDVF_FILLAREA)。
? プロパティ ハンドラーでサポートされていない場合は非表示にします (PDVF_HIDEIFUNSUPPORTED)。
< リンクとして解析します (PDVF_PARSEASLINK)。
& リンク全体として表示 (PDVF_SHOWASWHOLELINK)。
 

dbfolder とファイル フォルダーの観点から:

0 defview、列選択メニュー、および列選択ダイアログで列として表示します。
1 列の選択メニューとダイアログに表示します。
2 列選択ダイアログに表示します。
NULL 検索結果にを含めますが、UI では非表示にします。
 

endflags も省略可能であり、次の場合があります。

EndFlag 意味
] 終了列 (拡張タイル ビューに使用)。
 

riid パラメーターと ppv パラメーターをパッケージ化するには、objbase.h で定義されているIID_PPV_ARGS マクロを使用することをお勧めします。 このマクロは 、ppv の値によって指されるインターフェイスに基づいて正しい IID を提供し、コーディング エラーの可能性を排除します。

プロパティ スキーマの詳細については、「プロパティ スキーマ」を参照してください。

要件

   
サポートされている最小のクライアント WINDOWS XP と SP2、Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2003 SP1 [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー propsys.h
[DLL] Propsys.dll (バージョン 5.0 以降)
再頒布可能パッケージ Windows デスクトップ検索 (WDS) 3.0

こちらもご覧ください

IPropertySystem