Microsoft Producer for PowerPoint 2003 SDK banner art
PreviousNext

property

A property element specifies metadata about a project. The property being set is specified by the name attribute. You can specify multiple properties in a project. Most of these properties are the same as those exposed by the Properties Object used in scripting. In array-based attribute values, such as PublishProfile, an additional index attribute specifies a zero-based index into the array.

Syntax

<property
    name="string value"
    index="integer value">
</property>

Attributes

name (required)

Describes a property that you want to set. Possible values are shown in the following table.

Value Description
Author Sets the Properties.Author property.
BackgroundColor Sets the background color surrounding the video in the presentation. This accepts standard HTML string color names (such as Silver or Blue), as well as hexadecimal values in the format "#rrggbb" where rr, gg, and bb represent two-digit red, green, and blue hexadecimal values from 0 to 255.
BackupMediaFiles Sets the Properties.BackupMediaFiles property.
Copyright Sets the Properties.Copyright property.
Description Sets the Properties.Description property.
DiscussionServerAddress Sets the Properties.DiscussionServerAddress property.
DiscussionServerFriendlyName Sets a friendly name associated with the discussion server named in DiscussionServerAddress. This is displayed on the pre-roll screen of the presentation.
ImageFilename Sets the Properties.ImageFilename property.
Password Sets the password to be used when access to a password-protected location is required for publishing. You may specify a user name (through the UserName value) and password to automate access to this location. This password is stored in the clear, so you should protect a file containing this value, or delete it when you are finished using it. If a password is required to publish in the destination specified by the PublishDestination value and one is not supplied (or the wrong one is supplied), the publish attempt will fail.
PublishDestination Sets the WebHost.PublishDestination property. When using the publish value for the action element, you must specify the location with this property.
PublishName Sets the Properties.PublishName property.
PublishProfile Specifies the Profile Object to use for publishing. The profile to use is specified by profile name (PV000.PRX, for instance). You can find these profiles inside the ...\shared\profiles folder in the Producer installation path. This property takes an optional index attribute used when specifying multiple publish profiles. The index value specifies the display order in the drop-down box of available profiles, with zero being the default value, and higher numbers being farther from the default. (See the topic Setting presentation playback options in Producer Help for more information.) There is no default value for PublishProfile; it must be set in order to publish.
PublishWebHost Specifies the WebHost Object to use for publishing. The WebHost to use is specified by name. The name for each WebHost can be found in the registry, under HKEY_CURRENT_USER\Software\Microsoft\Producer\WebHosts, or on the first page of Producer's Publish Wizard. This is similar to the Properties.PublishWebHost property.
Title Sets the Properties.Title property.
TOCBackgroundColor Sets the background color of the presentation table of contents.  This accepts standard HTML string color names (such as Silver or Blue), as well as hexadecimal values in the format "#rrggbb" where rr, gg, and bb represent two-digit red, green, and blue hexadecimal values from 0 to 255.
TOCFont Specifies the font to use for table of contents entries, for example "Verdana" or "Arial". This acts the same as the FACE attribute of the HTML <FONT> tag.
FontColor Sets the font color of the presentation table of contents. This acts the same as the COLOR attribute of the HTML <FONT> tag. This accepts standard HTML string color names (such as Silver or Blue), as well as hexadecimal values in the format "#rrggbb" where rr, gg, and bb represent two-digit red, green, and blue hexadecimal values from 0 to 255.
TOCFontSize Sets the font size of the table of contents. Any valid DHTML font size should work for this value, for instance example 14pt or xx-large.
UserName Specifies a user name. When access is required to a password-protected location for publishing, you may specify a user name and password to automate access to this location. Specify the password with the Password property. You can place these two values in any order. If a password and user name are required to publish in the destination specified by PublishDestination, and one is not supplied (or the wrong one is supplied), the publish attempt will fail.
WindowsMediaPlaybackAddress Sets the WebHost.WindowsMediaPlaybackAddress property.
WindowsMediaPublishDestination Sets the WebHost.WindowsMediaPublishDestination property.

index (optional)

Used only if the property is indexed, such as the PublishProfile value. It is a zero-based integer index value.

Remarks

PublishProfile and PublishDestination must both be set before you can publish a project.

Note   If your presentation uses a template that defines font color, size, background color, or other display elements, and you try setting these elements with FontColor, TOCFontSize, or other property values, the template values will override the property values.

Example Code

<properties>
    <property name="Title"> My Presentation </property>
    <property name="TOCBackgroundColor">green</property>
    <property name="TOCFont"> Arial </property>
    <property name="PublishName"> MyPresentation </property>
    <property name="PublishProfile" index=0> PV000.PRX </property>
    <property name="PublishProfile" index=1> CUSTOM.PRX </property>
</properties>

Parent/Child Elements

Hierarchy Elements
Parent properties
Child
  • None

See Also

PreviousNext


© 2001-2003 Microsoft Corporation. All rights reserved.