documentation for the Word SP-2 API?

[David Thielen]

Hi;

Is there a url or download of the COM API for Word including the new
SP-2 functionality?

thanks - dave

david@[email protected]
Windward Reports -- http://www.WindwardReports.com
me -- http://dave.thielen.com

Cubicle Wars - http://www.windwardreports.com/film.htm

 

[Colbert Zhou [MSFT]]

Hello Dave,

As far as I know, even the Object Models of different versions Office are
almost the same, so the complete version of Word Object Model document is
Word 2007 Developer Reference,
http://msdn.microsoft.com/en-us/library/bb243297.aspx

What detailed information you want to know from the 2003 SP2? As far as I
research, Office 2003 SP2 just includes some fixes and security updates.
Its Object Model should be same as Word 2003 version.
http://www.microsoft.com/downloads/details.aspx?FamilyId=57E27A97-2DB6-4654-
9DB6-EC7D5B4DD867&displaylang=en


Best regards,
Ji Zhou
Microsoft Online Community Support

 

[David Thielen]

Hi;

For the Word 2007 (not 2003) SP-2 release, it added Document.Charts
and some other stuff like that.

thanks - dave

Hello Dave,

As far as I know, even the Object Models of different versions Office are
almost the same, so the complete version of Word Object Model document is
Word 2007 Developer Reference,
http://msdn.microsoft.com/en-us/library/bb243297.aspx

What detailed information you want to know from the 2003 SP2? As far as I
research, Office 2003 SP2 just includes some fixes and security updates.
Its Object Model should be same as Word 2003 version.
http://www.microsoft.com/downloads/details.aspx?FamilyId=57E27A97-2DB6-4654-
9DB6-EC7D5B4DD867&displaylang=en


Best regards,
Ji Zhou
Microsoft Online Community Support

david@[email protected]
Windward Reports -- http://www.WindwardReports.com
me -- http://dave.thielen.com

Cubicle Wars - http://www.windwardreports.com/film.htm

 

[Colbert Zhou [MSFT]]

Hello Dave,

There is no dedicated document for these currently. But I find a msdn blog
article describes a whole version of the Chart object's key differences
between SP2 and previous version,
http://blogs.msdn.com/officedevdocs/archive/2008/10/30/office-chart-object-m
odel-in-powerpoint-and-word.aspx

I quote it here for your convience to read,

"
The Chart object in Word 2007 SP2 and PowerPoint 2007 SP2 does have a few
differences from the Excel 2007 SP2 implementation.

1.Programmatically creating or manipulating a ChartData object in Word 2007
SP2 or PowerPoint 2007 SP2 will cause Excel 2007 SP2 to run.

2.Chart properties and methods for manipulating the chart sheet aren't
implemented.
The concept of a chart sheet is specific to Excel 2007. Chart sheets aren't
used in Word 2007 or PowerPoint 2007, so methods and properties used to
reference or manipulate a chart sheet have been disabled for those
applications.

3.Properties and methods that, in Excel 2007 SP2 normally take a Range
object reference now take a range address in Word 2007 SP2/PowerPoint 2007
SP2.
The Range object in Word 2007 SP2 and PowerPoint 2007 SP2 is different than
the Range object in Excel 2007 SP2. To prevent confusion, the charting
object model in Word 2007 SP2 and PowerPoint 2007 SP2 accepts range address
strings, such as "='Sheet1'!$A$1:$D$5", in those properties and methods
(such as the SetSourceData method of the Chart object) that accept Range
objects in Excel 2007 SP2.

4.A new object, ChartData, has been added to the VBA object models for Word
2007 SP2 and PowerPoint 2007 SP2 to provide access to the underlying linked
or embedded data for a chart.
Each chart has, associated with it, the data used to draw the chart in Word
2007 SP2 or PowerPoint 2007 SP2. The chart data can either be linked from
an external Excel workbook, or embedded as part of the chart itself. The
ChartData object encapsulates access to the data for a given chart in Word
2007 SP2 or PowerPoint 2007 SP2. For example, the following VBA code
displays, then minimizes, the chart data for each chart contained by the
active document in Word 2007 SP2:"

Hope this helps!

Best regards,
Ji Zhou
Microsoft Online Community Support

 

[David Thielen]

That helps a lot.

Can you ask the Office team to release full documentation in the near
future?

thanks - dave

Hello Dave,

There is no dedicated document for these currently. But I find a msdn blog
article describes a whole version of the Chart object's key differences
between SP2 and previous version,
http://blogs.msdn.com/officedevdocs/archive/2008/10/30/office-chart-object-m
odel-in-powerpoint-and-word.aspx

I quote it here for your convience to read,

"
The Chart object in Word 2007 SP2 and PowerPoint 2007 SP2 does have a few
differences from the Excel 2007 SP2 implementation.

1.Programmatically creating or manipulating a ChartData object in Word 2007
SP2 or PowerPoint 2007 SP2 will cause Excel 2007 SP2 to run.

2.Chart properties and methods for manipulating the chart sheet aren't
implemented.
The concept of a chart sheet is specific to Excel 2007. Chart sheets aren't
used in Word 2007 or PowerPoint 2007, so methods and properties used to
reference or manipulate a chart sheet have been disabled for those
applications.

3.Properties and methods that, in Excel 2007 SP2 normally take a Range
object reference now take a range address in Word 2007 SP2/PowerPoint 2007
SP2.
The Range object in Word 2007 SP2 and PowerPoint 2007 SP2 is different than
the Range object in Excel 2007 SP2. To prevent confusion, the charting
object model in Word 2007 SP2 and PowerPoint 2007 SP2 accepts range address
strings, such as "='Sheet1'!$A$1:$D$5", in those properties and methods
(such as the SetSourceData method of the Chart object) that accept Range
objects in Excel 2007 SP2.

4.A new object, ChartData, has been added to the VBA object models for Word
2007 SP2 and PowerPoint 2007 SP2 to provide access to the underlying linked
or embedded data for a chart.
Each chart has, associated with it, the data used to draw the chart in Word
2007 SP2 or PowerPoint 2007 SP2. The chart data can either be linked from
an external Excel workbook, or embedded as part of the chart itself. The
ChartData object encapsulates access to the data for a given chart in Word
2007 SP2 or PowerPoint 2007 SP2. For example, the following VBA code
displays, then minimizes, the chart data for each chart contained by the
active document in Word 2007 SP2:"

Hope this helps!

Best regards,
Ji Zhou
Microsoft Online Community Support

david@[email protected]
Windward Reports -- http://www.WindwardReports.com
me -- http://dave.thielen.com

Cubicle Wars - http://www.windwardreports.com/film.htm

 

[David Thielen]

Hi;

I've read the blog and looked everywhere - Any idea how I get
DocProperties.Description (<wp:docPr descr="my tag">) from the
InlineShape/Chart?

thanks - dave

Hello Dave,

As far as I know, even the Object Models of different versions Office are
almost the same, so the complete version of Word Object Model document is
Word 2007 Developer Reference,
http://msdn.microsoft.com/en-us/library/bb243297.aspx

What detailed information you want to know from the 2003 SP2? As far as I
research, Office 2003 SP2 just includes some fixes and security updates.
Its Object Model should be same as Word 2003 version.
http://www.microsoft.com/downloads/details.aspx?FamilyId=57E27A97-2DB6-4654-
9DB6-EC7D5B4DD867&displaylang=en


Best regards,
Ji Zhou
Microsoft Online Community Support

david@[email protected]
Windward Reports -- http://www.WindwardReports.com
me -- http://dave.thielen.com

Cubicle Wars - http://www.windwardreports.com/film.htm

 

[Colbert Zhou [MSFT]]

Sure. I will submit this as a content issue to the PG. Ideally, I think
these should be included in 2010's documentation.


Best regards,
Ji Zhou
Microsoft Online Community Support

 

[Colbert Zhou [MSFT]]

Hello Dave,

It seems Word team has already taken actions on this. So we can find the
chart related documentation under Word 2007 Developer Reference
documenation,
http://msdn.microsoft.com/en-us/library/bb244752.aspx


Best regards,
Ji Zhou
Microsoft Online Community Support

 

[David Thielen]

That is a very useful link - thank you.

Howver, I don't see any way to get the Description property. Are you
aware of a way to get it?

thanks - dave

Hello Dave,

It seems Word team has already taken actions on this. So we can find the
chart related documentation under Word 2007 Developer Reference
documenation,
http://msdn.microsoft.com/en-us/library/bb244752.aspx


Best regards,
Ji Zhou
Microsoft Online Community Support

david@[email protected]
Windward Reports -- http://www.WindwardReports.com
me -- http://dave.thielen.com

Cubicle Wars - http://www.windwardreports.com/film.htm

 

[Colbert Zhou [MSFT]]

Hello Dave,

This seems not related to the original documentation concerns, so I did not
catched it well. But now, I got your point. So the question is we add the
string to DocProperties.Description via OpenXML SDK. Then how to retrieve
it from the COM AddIn? I have a quick debug via Word VBA IDE, but I did not
find any property expose the Description content from the watch window. I
am still researching further and consulting on this. I will get back as
long as I get any progress. You may expect a follow up in 48 hours.

Have a nice day!


Best regards,
Ji Zhou - MSFT
Microsoft Online Community Support

 

[Colbert Zhou [MSFT]]

Hello Dave,

So, the description property you mention is the descr attribute of wp:docPr
element in this discussion link, right?
http://social.msdn.microsoft.com/Forums/en/oxmlsdk/thread/4aaf0de1-93e3-452c
-afd1-5dbc5cde443c

I found the corresponding COM property for that is
InlineShape.AlternativeText.

Taking this document for example,
http://cid-c2e0d62e8a095a30.skydrive.live.com/self.aspx/Public/chartex14.doc
x

We can get the descr attribute content "alt text description" via,
Document.InlineShapes[1].AlternativeText


Best regards,
Ji Zhou - MSFT
Microsoft Online Community Support

 

[David Thielen]

I swear I looked at that - but apparently I didn't. Works great.

thanks - dave

Hello Dave,

So, the description property you mention is the descr attribute of wp:docPr
element in this discussion link, right?
http://social.msdn.microsoft.com/Forums/en/oxmlsdk/thread/4aaf0de1-93e3-452c
-afd1-5dbc5cde443c

I found the corresponding COM property for that is
InlineShape.AlternativeText.

Taking this document for example,
http://cid-c2e0d62e8a095a30.skydrive.live.com/self.aspx/Public/chartex14.doc
x

We can get the descr attribute content "alt text description" via,
Document.InlineShapes[1].AlternativeText


Best regards,
Ji Zhou - MSFT
Microsoft Online Community Support

david@[email protected]
Windward Reports -- http://www.WindwardReports.com
me -- http://dave.thielen.com

Cubicle Wars - http://www.windwardreports.com/film.htm