Méthode IPropertySystem ::GetPropertyDescriptionListFromString (propsys.h)

Article
01/10/2024

Obtient une instance de l’objet de sous-système qui implémente IPropertyDescriptionList, pour obtenir une collection ordonnée de descriptions de propriétés, en fonction de la chaîne fournie.

Syntaxe

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

Paramètres

[in] pszPropList

Type : LPCWSTR

Pointeur vers une chaîne qui identifie la liste de propriétés.

[in] riid

Type : REFIID

Référence à l’IID souhaité.

[out] ppv

Type : void**

Adresse d’un pointeur d’interface IPropertyDescriptionList .

Valeur retournée

Type : HRESULT

Retourne l’une des valeurs suivantes.

Code de retour	Description
S_OK	Indique que l’interface est obtenue.
E_INVALIDARG	Indique que ppv a lavaleur NULL.

Remarques

La syntaxe de la chaîne de liste de description des propriétés (« proplist ») se compose d’une séquence de noms de propriétés canoniques, avec des indicateurs associés à chaque nom de propriété. La chaîne commence par « prop : ». La syntaxe ressemble à ceci : prop:[flags]propertyname[endflags];

Les indicateurs sont facultatifs et peuvent être l’un des indicateurs ci-dessous. Remarque : ces indicateurs se traduisent par l’énumération PROPDESC_VIEW_FLAGS .

Indicateur	Signification
-	Trier dans l’ordre inverse (PDVF_REVERSESORT).
0	Afficher par défaut dans les listes primaire et secondaire (PDVF_SHOWBYDEFAULT \| PDVF_SHOWINPRIMARYLIST \| PDVF_SHOWINSECONDARYLIST).
1	Afficher dans les listes primaire et secondaire (PDVF_SHOWINPRIMARYLIST \| PDVF_SHOWINSECONDARYLIST).
2	Afficher dans la liste secondaire (PDVF_SHOWINSECONDARYLIST).
^	Commencez un nouveau groupe (PDVF_BEGINNEWGROUP).
/	Alignement droit (PDVF_RIGHTALIGN).
*	Masquez si la valeur n’est pas présente.
\|	Aligner au centre. (PDVF_CENTERALIGN).
~	Masquez l’étiquette. (PDVF_HIDELABEL).
#	Zone de remplissage. (PDVF_FILLAREA).
?	Masquer si non pris en charge par le gestionnaire de propriétés (PDVF_HIDEIFUNSUPPORTED).
<	Analyser en tant que lien (PDVF_PARSEASLINK).
&	Afficher comme lien entier (PDVF_SHOWASWHOLELINK).

Du point de vue du dbfolder et du dossier de fichiers :

0	Afficher sous forme de colonne dans defview, le menu du sélecteur de colonnes et la boîte de dialogue du sélecteur de colonnes.
1	Afficher dans le menu et la boîte de dialogue du sélecteur de colonnes.
2	Afficher dans la boîte de dialogue du sélecteur de colonnes.
NULL	Incluez dans les résultats de la recherche, mais masquez-le dans l’interface utilisateur.

Les extrémités sont également facultatives et peuvent être les suivantes :

EndFlag	Signification
]	Colonne de fin (utilisée pour la vue mosaïque étendue).

Il est recommandé d’utiliser la macro IID_PPV_ARGS, définie dans objbase.h, pour empaqueter les paramètres riid et ppv . Cette macro fournit l’IID correct en fonction de l’interface pointée vers la valeur dans ppv, éliminant ainsi la possibilité d’une erreur de codage.

Pour plus d’informations sur les schémas de propriétés, consultez Schémas de propriété.

Configuration requise


Client minimal pris en charge	Windows XP avec SP2, Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 avec SP1 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	propsys.h
DLL	Propsys.dll (version 5.0 ou ultérieure)
Composant redistribuable	Windows Desktop Search (WDS) 3.0

Voir aussi

IPropertySystem

Partager via