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

Obtiene una instancia del objeto subsistema que implementa IPropertyDescriptionList, para obtener una colección ordenada de descripciones de propiedades, en función de la cadena proporcionada.

Sintaxis

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

Parámetros

[in] pszPropList

Tipo: LPCWSTR

Puntero a una cadena que identifica la lista de propiedades.

[in] riid

Tipo: REFIID

Referencia al IID deseado.

[out] ppv

Tipo: void**

Dirección de un puntero de interfaz IPropertyDescriptionList .

Valor devuelto

Tipo: HRESULT

Devuelve uno de los valores siguientes.

Código devuelto	Descripción
S_OK	Indica que se obtiene la interfaz.
E_INVALIDARG	Indica que ppv es NULL.

Comentarios

La sintaxis de la lista de descripción de propiedades ("proplist") consta de una secuencia de nombres de propiedad canónicos, con marcas asociadas a cada nombre de propiedad. La cadena comienza por "prop:". La sintaxis tiene este aspecto: prop:[flags]propertyname[endflags];

Las marcas son opcionales y pueden ser cualquiera de las siguientes. Nota: Estas marcas se traducen en la enumeración PROPDESC_VIEW_FLAGS .

Marca	Significado
-	Ordenar en orden inverso (PDVF_REVERSESORT).
0	Mostrar de forma predeterminada en las listas principales y secundarias (PDVF_SHOWBYDEFAULT | PDVF_SHOWINPRIMARYLIST | PDVF_SHOWINSECONDARYLIST).
1	Mostrar en las listas principales y secundarias (PDVF_SHOWINPRIMARYLIST | PDVF_SHOWINSECONDARYLIST).
2	Mostrar en la lista secundaria (PDVF_SHOWINSECONDARYLIST).
^	Comience un nuevo grupo (PDVF_BEGINNEWGROUP).
/	Alineación derecha (PDVF_RIGHTALIGN).
*	Oculte si el valor no está presente.
|	Alinear el centro. (PDVF_CENTERALIGN).
~	Oculte la etiqueta. (PDVF_HIDELABEL).
#	Área de relleno. (PDVF_FILLAREA).
?	Oculte si no es compatible con el controlador de propiedades (PDVF_HIDEIFUNSUPPORTED).
<	Analizar como vínculo (PDVF_PARSEASLINK).
&	Mostrar como vínculo completo (PDVF_SHOWASWHOLELINK).

 

Desde la perspectiva de la carpeta dbfolder y de la carpeta de archivos:

0	Mostrar como una columna en defview, menú selector de columnas y cuadro de diálogo selector de columnas.
1	Mostrar en el menú y el cuadro de diálogo del selector de columnas.
2	Mostrar en el cuadro de diálogo del selector de columnas.
NULL	Incluya en los resultados de búsqueda, pero oculte en la interfaz de usuario.

 

Los endflags también son opcionales y pueden ser los siguientes:

EndFlag	Significado
]	Columna final (usada para la vista de iconos extendidos).

 

Se recomienda usar la macro IID_PPV_ARGS, definida en objbase.h, para empaquetar los parámetros riid y ppv . Esta macro proporciona el IID correcto basado en la interfaz a la que apunta el valor en ppv, lo que elimina la posibilidad de un error de codificación.

Para obtener más información sobre los esquemas de propiedades, vea Esquemas de propiedades.

Requisitos

Cliente mínimo compatible	Windows XP con SP2, Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 con SP1 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	propsys.h
Archivo DLL	Propsys.dll (versión 5.0 o posterior)
Redistribuible	Búsqueda de escritorio de Windows (WDS) 3.0

Consulte también

IPropertySystem