Compartilhar via


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.