Método IPropertySystem::GetPropertyDescriptionListFromString (propsys.h)
Obtém uma instância do objeto de subsistema que implementa IPropertyDescriptionList, para obter uma coleção ordenada de descrições de propriedade, com base na cadeia de caracteres fornecida.
Sintaxe
HRESULT GetPropertyDescriptionListFromString(
[in] LPCWSTR pszPropList,
[in] REFIID riid,
[out] void **ppv
);
Parâmetros
[in] pszPropList
Tipo: LPCWSTR
Um ponteiro para uma cadeia de caracteres que identifica a lista de propriedades.
[in] riid
Tipo: REFIID
Uma referência ao IID desejado.
[out] ppv
Tipo: void**
O endereço de um ponteiro de interface IPropertyDescriptionList .
Retornar valor
Tipo: HRESULT
Retorna um dos valores a seguir.
| Código de retorno | Descrição |
|---|---|
|
Indica que a interface foi obtida. |
|
Indica que ppv é NULL. |
Comentários
A sintaxe da cadeia de caracteres da lista de descrição da propriedade ("proplist") consiste em uma sequência de nomes de propriedades canônicas, com sinalizadores associados a cada nome de propriedade. A cadeia de caracteres começa com "prop:". A sintaxe tem esta aparência: prop:[flags]propertyname[endflags];
Os sinalizadores são opcionais e podem ser qualquer um deles abaixo. Observação: esses sinalizadores são convertidos na enumeração PROPDESC_VIEW_FLAGS .
| Sinalizador | Significado |
|---|---|
| - | Classificar em ordem inversa (PDVF_REVERSESORT). |
| 0 | Mostrar por padrão nas listas primária e secundária (PDVF_SHOWBYDEFAULT | PDVF_SHOWINPRIMARYLIST | PDVF_SHOWINSECONDARYLIST). |
| 1 | Mostrar nas listas primária e secundária (PDVF_SHOWINPRIMARYLIST | PDVF_SHOWINSECONDARYLIST). |
| 2 | Mostrar na lista secundária (PDVF_SHOWINSECONDARYLIST). |
| ^ | Inicie um novo grupo (PDVF_BEGINNEWGROUP). |
| / | Alinhar à direita (PDVF_RIGHTALIGN). |
| * | Oculte se o valor não estiver presente. |
| | | Alinhamento centralizado. (PDVF_CENTERALIGN). |
| ~ | Oculte o rótulo. (PDVF_HIDELABEL). |
| # | Área de preenchimento. (PDVF_FILLAREA). |
| ? | Ocultar se não houver suporte pelo manipulador de propriedades (PDVF_HIDEIFUNSUPPORTED). |
| < | Analisar como link (PDVF_PARSEASLINK). |
| & | Mostrar como link inteiro (PDVF_SHOWASWHOLELINK). |
Da perspectiva da pasta dbfolder e do arquivo:
| 0 | Mostrar como uma coluna no defview, no menu do seletor de colunas e na caixa de diálogo do seletor de colunas. |
| 1 | Mostrar no menu e na caixa de diálogo do seletor de colunas. |
| 2 | Mostrar na caixa de diálogo do seletor de colunas. |
| NULL | Inclua nos resultados da pesquisa, mas oculte na interface do usuário. |
As endflags também são opcionais e podem ser as seguintes:
| EndFlag | Significado |
|---|---|
| ] | Coluna final (usada para exibição de blocos estendidos). |
É recomendável que você use a macro IID_PPV_ARGS, definida em objbase.h, para empacotar os parâmetros riid e ppv . Essa macro fornece o IID correto com base na interface apontada pelo valor em ppv, eliminando a possibilidade de um erro de codificação.
Para obter mais informações sobre esquemas de propriedade, consulte Esquemas de propriedade.
Requisitos
| Cliente mínimo com suporte | Windows XP com SP2, Windows Vista [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2003 com SP1 [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | propsys.h |
| DLL | Propsys.dll (versão 5.0 ou posterior) |
| Redistribuível | Pesquisa da Área de Trabalho do Windows (WDS) 3.0 |