Os conjuntos de propriedades DocumentSummaryInformation e UserDefined

Um conjunto de propriedades DocumentSummaryInformation e UserDefined é uma extensão para o conjunto de propriedades Informações de Resumo. Ambos os conjuntos de propriedades podem existir simultaneamente.

O nome do fluxo que contém o conjunto de propriedades DocumentSummaryInformation é "\005DocumentSummaryInformation". O identificador de formato (FMTID) para o conjunto de propriedades DocumentSummaryInformation é D5CDD502-2E9C-101B-9397-08002B2CF9AE.

A declaração para esse valor está disponível nos arquivos de cabeçalho fornecidos como FMTID_DocSummaryInformation. Para obter mais informações, consulte Nomes no IStorage, The Summary Information Property Set, IPropertySetStorage::Create and Format Identifiers.

Esse fluxo também tem uma seção separada para as propriedades definidas pelo usuário personalizado, como nos conjuntos de propriedades DocumentSummaryInformation e UserDefined . Esta seção aparece na interface IPropertySetStorage como um conjunto de propriedades separado, com o seguinte FMTID (disponível como FMTID_UserDefinedProperties): D5CDD505-2E9C-101B-9397-08002B2CF9AE.

Esses dois conjuntos de propriedades são os únicos para os quais um único fluxo pode conter vários conjuntos de propriedades. O fato de esses dois conjuntos de propriedades estarem em um único fluxo afeta o comportamento da interface IPropertySetStorage . Para obter mais informações, consulte IPropertySetStorage.

A tabela a seguir lista as propriedades adicionadas ao conjunto de propriedades DocumentSummaryInformation e UserDefined . Como no conjunto de propriedades SummaryInformation , os nomes normalmente não são armazenados no conjunto de propriedades, mas são inferidos do identificador de propriedade.

Nome da propriedade	Identificador de propriedade	Valor do identificador de propriedade	Tipo VARIANT
Categoria	PIDDSI_CATEGORY	0x00000002	VT_LPSTR
PresentationTarget	PIDDSI_PRESFORMAT	0x00000003	VT_LPSTR
Bytes	PIDDSI_BYTECOUNT	0x00000004	VT_I4
Linhas	PIDDSI_LINECOUNT	0x00000005	VT_I4
Parágrafos	PIDDSI_PARCOUNT	0x00000006	VT_I4
Slides	PIDDSI_SLIDECOUNT	0x00000007	VT_I4
Observações	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
Gerente	PIDDSI_MANAGER	0x0000000E	VT_LPSTR
Empresa	PIDDSI_COMPANY	0x0000000F	VT_LPSTR
LinksUpToDate	PIDDSI_LINKSDIRTY	0x00000010	VT_BOOL

 

Essas propriedades têm os seguintes usos:

Categoria

Uma cadeia de caracteres de texto digitada pelo usuário que indica a qual categoria o arquivo pertence (memorando, proposta e assim por diante). É útil para localizar arquivos do mesmo tipo.

PresentationTarget

Formato de destino para apresentação (35mm, impressora, vídeo e assim por diante).

Bytes

Quantidade de bytes.

Linhas

Número de linhas.

Parágrafos

Número de parágrafos.

Slides

Número de slides.

Notas

Número de páginas que contêm anotações.

HiddenSlides

Número de slides ocultos.

MMClips

Número de clipes de som ou vídeo.

ScaleCrop

Defina como True (-1) quando o dimensionamento da miniatura for desejado. Se não estiver definido, o corte será desejado.

HeadingPairs

Propriedade usada internamente que indica o agrupamento de diferentes partes do documento e o número de itens em cada grupo. Os títulos das partes do documento são armazenados na propriedade TitlesofParts . A propriedade HeadingPairs é armazenada como um vetor de variantes, em pares repetidos de valores VT_LPSTR (ou VT_LPWSTR) e VT_I4 . O valor VT_LPSTR representa um nome de título e o valor VT_I4 indica a contagem de partes do documento sob esse título.

TitlesofParts

Nomes de partes do documento.

Gerente

Gerente do projeto.

Company

Nome da empresa.

LinksUpToDate

Valor booliano para indicar se os links personalizados são prejudicados por ruído excessivo, para todos os aplicativos.

Observação

Conforme descrito na versão 12.3. Formato serializado para conjuntos de propriedades da Especificação de Design OLE 2.0, os elementos de vetor nas propriedades HeadingPairs e TitlesofParts devem ser alinhados em limites de 32 bits dentro do conjunto de propriedades. No entanto, nos conjuntos de propriedades DocumentSummaryInformation e UserDefined , quando a página de código do conjunto de propriedades não for Unicode, esses elementos deverão ser empacotados.

 

O conjunto de propriedades UserDefined pode ser usado para conter quaisquer propriedades. Normalmente, ele é usado para armazenar propriedades nomeadas criadas por um usuário.