Ensembles de propriétés DocumentSummaryInformation et UserDefined

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.