Enumerazione SIGDN (shobjidl_core.h)

Articolo
03/08/2023

Richiede il formato del nome visualizzato di un elemento per recuperare tramite IShellItem::GetDisplayName e SHGetNameFromIDList.

Sintassi

typedef enum _SIGDN {
  SIGDN_NORMALDISPLAY = 0,
  SIGDN_PARENTRELATIVEPARSING,
  SIGDN_DESKTOPABSOLUTEPARSING,
  SIGDN_PARENTRELATIVEEDITING,
  SIGDN_DESKTOPABSOLUTEEDITING,
  SIGDN_FILESYSPATH,
  SIGDN_URL,
  SIGDN_PARENTRELATIVEFORADDRESSBAR,
  SIGDN_PARENTRELATIVE,
  SIGDN_PARENTRELATIVEFORUI
} SIGDN;

Costanti


`SIGDN_NORMALDISPLAY` Valore: 0 0x00000000. Restituisce il nome visualizzato relativo alla cartella padre. Nell'interfaccia utente questo nome è in genere ideale per visualizzare l'utente.
`SIGDN_PARENTRELATIVEPARSING` (int)0x80018001. Restituisce il nome di analisi relativo alla cartella padre. Questo nome non è adatto per l'uso nell'interfaccia utente.
`SIGDN_DESKTOPABSOLUTEPARSING` (int)0x80028000. Restituisce il nome di analisi relativo al desktop. Questo nome non è adatto per l'uso nell'interfaccia utente.
`SIGDN_PARENTRELATIVEEDITING` (int)0x80031001. Restituisce il nome di modifica relativo alla cartella padre. Nell'interfaccia utente questo nome è adatto per la visualizzazione all'utente.
`SIGDN_DESKTOPABSOLUTEEDITING` (int)0x8004c000. Restituisce il nome di modifica relativo al desktop. Nell'interfaccia utente questo nome è adatto per la visualizzazione all'utente.
`SIGDN_FILESYSPATH` (int)0x80058000. Restituisce il percorso del file system dell'elemento, se ne ha uno. Solo gli elementi che segnalano SFGAO_FILESYSTEM hanno un percorso del file system. Quando un elemento non ha un percorso del file system, una chiamata a IShellItem::GetDisplayName in tale elemento avrà esito negativo. Nell'interfaccia utente questo nome è adatto per la visualizzazione all'utente in alcuni casi, ma si noti che potrebbe non essere specificato per tutti gli elementi.
`SIGDN_URL` (int)0x80068000. Restituisce l'URL dell'elemento, se ne ha uno. Alcuni elementi non hanno un URL e in questi casi una chiamata a IShellItem::GetDisplayName avrà esito negativo. Questo nome è adatto per la visualizzazione all'utente in alcuni casi, ma si noti che potrebbe non essere specificato per tutti gli elementi.
`SIGDN_PARENTRELATIVEFORADDRESSBAR` (int)0x8007c001. Restituisce il percorso relativo alla cartella padre in un formato descrittivo come visualizzato in una barra degli indirizzi. Questo nome è adatto per la visualizzazione all'utente.
`SIGDN_PARENTRELATIVE` (int)0x80080001. Restituisce il percorso relativo alla cartella padre.
`SIGDN_PARENTRELATIVEFORUI` (int)0x80094001. Introdotta in Windows 8.

Commenti

È possibile recuperare diverse forme di nome di un elemento tramite le proprietà dell'elemento, incluse quelle elencate qui. Si noti che non tutte le proprietà sono presenti su tutti gli elementi, quindi verranno visualizzate solo quelle appropriate per l'elemento.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP con SP1 [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Intestazione	shobjidl_core.h (include Shobjidl.h)

Condividi tramite