Metodo IPropertySystem::GetPropertyDescriptionListFromString (propsys.h)
Ottiene un'istanza dell'oggetto sottosistema che implementa IPropertyDescriptionList, per ottenere una raccolta ordinata di descrizioni delle proprietà, in base alla stringa specificata.
Sintassi
HRESULT GetPropertyDescriptionListFromString(
[in] LPCWSTR pszPropList,
[in] REFIID riid,
[out] void **ppv
);
Parametri
[in] pszPropList
Tipo: LPCWSTR
Puntatore a una stringa che identifica l'elenco di proprietà.
[in] riid
Tipo: REFIID
Riferimento all'IID desiderato.
[out] ppv
Tipo: void**
Indirizzo di un puntatore all'interfaccia IPropertyDescriptionList .
Valore restituito
Tipo: HRESULT
Restituisce uno dei valori seguenti.
| Codice restituito | Descrizione |
|---|---|
|
Indica che l'interfaccia viene ottenuta. |
|
Indica che ppv è NULL. |
Commenti
La sintassi della stringa di elenco delle proprietà ("proplist") è costituita da una sequenza di nomi di proprietà canonici, con flag associati a ogni nome di proprietà. La stringa inizia con "prop:". La sintassi è simile alla seguente: prop:[flags]propertyname[endflags];
I flag sono facoltativi e possono essere uno di questi sotto. Nota: questi flag si traducono nell'enumerazione PROPDESC_VIEW_FLAGS .
| Contrassegno | Significato |
|---|---|
| - | Ordina in ordine inverso (PDVF_REVERSESORT). |
| 0 | Mostra per impostazione predefinita negli elenchi primari e secondari (PDVF_SHOWBYDEFAULT | PDVF_SHOWINPRIMARYLIST | PDVF_SHOWINSECONDARYLIST). |
| 1 | Mostra negli elenchi primari e secondari (PDVF_SHOWINPRIMARYLIST | PDVF_SHOWINSECONDARYLIST). |
| 2 | Mostra nell'elenco secondario (PDVF_SHOWINSECONDARYLIST). |
| ^ | Iniziare un nuovo gruppo (PDVF_BEGINNEWGROUP). |
| / | Allinea a destra (PDVF_RIGHTALIGN). |
| * | Nascondere se il valore non è presente. |
| | | Allinea al centro. (PDVF_CENTERALIGN). |
| ~ | Nascondere l'etichetta. (PDVF_HIDELABEL). |
| # | Area di riempimento. (PDVF_FILLAREA). |
| ? | Nascondi se non supportato dal gestore di proprietà (PDVF_HIDEIFUNSUPPORTED). |
| < | Analizza come collegamento (PDVF_PARSEASLINK). |
| & | Mostra come intero collegamento (PDVF_SHOWASWHOLELINK). |
Dal punto di vista della cartella dbfolder e file:
| 0 | Mostra come colonna in defview, menu di selezione colonne e finestra di dialogo di selezione colonne. |
| 1 | Mostra nel menu e nella finestra di dialogo del pulsante di scelta della colonna. |
| 2 | Mostra nella finestra di dialogo del programma di selezione colonne. |
| NULL | Includere nei risultati della ricerca, ma nascondersi nell'interfaccia utente. |
Gli endflag sono facoltativi e possono essere i seguenti:
| EndFlag | Significato |
|---|---|
| ] | Colonna finale (usata per la visualizzazione riquadri estesi). |
È consigliabile usare la macro IID_PPV_ARGS, definita in objbase.h, per creare un pacchetto dei parametri riid e ppv . Questa macro fornisce l'IID corretto in base all'interfaccia a cui punta il valore in ppv, eliminando la possibilità di un errore di codifica.
Per altre informazioni sugli schemi delle proprietà, vedere Schemi delle proprietà.
Requisiti
| Client minimo supportato | Windows XP con SP2, Windows Vista [solo app desktop] |
| Server minimo supportato | Windows Server 2003 con SP1 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | propsys.h |
| DLL | Propsys.dll (versione 5.0 o successiva) |
| Componente ridistribuibile | Windows Desktop Search (WDS) 3.0 |