Partager via

Ensembles de propriétés DocumentSummaryInformation et UserDefined

  • Article

Un jeu de propriétés DocumentSummaryInformation et UserDefined est une extension du jeu de propriétés Informations de résumé. Les deux jeux de propriétés peuvent exister simultanément.

Le nom du flux qui contient le jeu de propriétés DocumentSummaryInformation est « \005DocumentSummaryInformation ». L’identificateur de format (FMTID) du jeu de propriétés DocumentSummaryInformation est D5CDD502-2E9C-101B-9397-08002B2CF9AE.

La déclaration de cette valeur est disponible dans les fichiers d’en-tête fournis en tant que FMTID_DocSummaryInformation. Pour plus d’informations, consultez Noms dans IStorage, The Summary Information Property Set, IPropertySetStorage::Create and Format Identifiers.

Ce flux a également une section distincte pour les propriétés personnalisées définies par l’utilisateur, comme dans les jeux de propriétés DocumentSummaryInformation et UserDefined . Cette section apparaît dans l’interface IPropertySetStorage sous la forme d’un ensemble de propriétés distinct, avec le FMTID suivant (disponible en tant que FMTID_UserDefinedProperties) : D5CDD505-2E9C-101B-9397-08002B2CF9AE.

Ces deux jeux de propriétés sont les seuls pour lesquels un flux unique peut contenir plusieurs jeux de propriétés. Le fait que ces deux jeux de propriétés se trouvent dans un seul flux affecte le comportement de l’interface IPropertySetStorage . Pour plus d’informations, consultez IPropertySetStorage.

Le tableau suivant répertorie les propriétés ajoutées au jeu de propriétés DocumentSummaryInformation et UserDefined . Comme dans le jeu de propriétés SummaryInformation , les noms ne sont généralement pas stockés dans le jeu de propriétés, mais sont déduits à partir de l’identificateur de propriété.

Nom de la propriété Identificateur de propriété Valeur de l’identificateur de propriété Type VARIANT
Category PIDDSI_CATEGORY 0x00000002 VT_LPSTR
PresentationTarget PIDDSI_PRESFORMAT 0x00000003 VT_LPSTR
Octets PIDDSI_BYTECOUNT 0x00000004 VT_I4
Lignes PIDDSI_LINECOUNT 0x00000005 VT_I4
Paragraphes PIDDSI_PARCOUNT 0x00000006 VT_I4
Diapositives PIDDSI_SLIDECOUNT 0x00000007 VT_I4
Notes PIDDSI_NOTECOUNT 0x00000008 VT_I4
HiddenSlides PIDDSI_HIDDENCOUNT 0x00000009 VT_I4
MMClips PIDDSI_MMCLIPCOUNT 0x0000000A VT_I4
ScaleCrop PIDDSI_SCALE 0x0000000B VT_BOOL
Headingpairs PIDDSI_HEADINGPAIR 0x0000000C | VT_VARIANT VT_VECTOR
Titlesofparts PIDDSI_DOCPARTS 0x0000000D | VT_VECTOR VT_LPSTR
Manager PIDDSI_MANAGER 0x0000000E VT_LPSTR
Company PIDDSI_COMPANY 0x0000000F VT_LPSTR
LinksUpToDate PIDDSI_LINKSDIRTY 0x00000010 VT_BOOL

 

Ces propriétés ont les utilisations suivantes :

Catégorie

Chaîne de texte tapée par l’utilisateur qui indique la catégorie à laquelle le fichier appartient (mémo, proposition, etc.). Il est utile pour rechercher des fichiers du même type.

PresentationTarget

Format cible pour la présentation (35 mm, imprimante, vidéo, etc.).

Octets

Nombre d'octets.

Lignes

Nombre de lignes.

Paragraphes

Nombre de paragraphes.

Diapositives

Nombre de diapositives.

Notes

Nombre de pages qui contiennent des notes.

HiddenSlides

Nombre de diapositives masquées.

MMClips

Nombre de clips audio ou vidéo.

ScaleCrop

Définissez sur True (-1) lorsque la mise à l’échelle de la miniature est souhaitée. S’il n’est pas défini, le rognage est souhaité.

Headingpairs

Propriété utilisée en interne indiquant le regroupement des différents composants de document et le nombre d’éléments dans chaque groupe. Les titres des parties de document sont stockés dans la propriété TitlesofParts . La propriété HeadingPairs est stockée en tant que vecteur de variantes, dans des paires répétées de valeurs VT_LPSTR (ou VT_LPWSTR) et VT_I4 . La valeur VT_LPSTR représente un nom de titre, et la valeur VT_I4 indique le nombre de parties de document sous cet en-tête.

Titlesofparts

Noms des parties de document.

Gestionnaire

Responsable du projet.

Company

Nom de la société

LinksUpToDate

Valeur booléenne pour indiquer si les liens personnalisés sont entravés par un bruit excessif, pour toutes les applications.

Notes

Comme décrit dans 12.3. Format sérialisé pour les jeux de propriétés de la spécification de conception OLE 2.0, les éléments vectoriels dans les propriétés HeadingPairs et TitlesofParts doivent être alignés sur les limites 32 bits au sein du jeu de propriétés. Toutefois, dans les jeux de propriétés DocumentSummaryInformation et UserDefined , lorsque la page de codes du jeu de propriétés n’est pas Unicode, ces éléments doivent être empaquetés.

 

Le jeu de propriétés UserDefined peut être utilisé pour contenir n’importe quelle propriété. En règle générale, il est utilisé pour stocker les propriétés nommées créées par un utilisateur.