Méthode IPropertySystem ::GetPropertyDescriptionListFromString (propsys.h)
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 |
|---|---|
|
Indique que l’interface est obtenue. |
|
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 |