+ indicates the property is supported and relevant in both Demo and Professional versions (property name is green) P indicates the property is supported and relevant in the Professional version only x indicates the property is unsupported or irrelevant in this mode or document format All property names are case-insensitive; a few property values are case-sensitive, depending on Office.
Property Name | Action Type | Doc Type | Units | Possible values | Default value if unused | Description | ||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
Open | Read | Write | Format | Close | XLS | DOC | PPT | |||||
'Mode' | + | x | x | x | x | + | + | + | string | 'read' / 'write' / 'append' | 'read' | indicates the read/write mode of the opened file |
'Display' | + | x | x | x | x | + | + | + | boolean | true/false/1/0/'on'/'off' | false | indicates whether to display or hide the opened file |
'Sheet' | P | P | P | P | x | P | x | x | integer or string | positive integer index or sheet name | last saved | indicates the required XLS worksheet |
'Page' | P | P | P | P | x | x | P | P | integer | positive integer index | DOC: last saved; PPT: 1 | indicates the required DOC/PPT page number |
'Slide' | P | P | P | P | x | x | x | P | integer | positive integer index | 1 | indicates the required PPT slide number (same as 'Page') |
'Range' | P | P | P | P | x | P | P | P | XLS: string; DOC/PPT: 2 integers | XLS: 'A1' or 'A1:C4' format; DOC/PPT: [startChar#,endChar#] | none | selected range: absolute (XLS) or relative to current position (DOC/PPT) |
'Line' | P | P | P | P | x | x | P | x | integer | positive integer index | none | selected line number relative to current position; 0 = start of document |
'DivType' | x | P | x | x | x | x | P | x | string | 'Characters' / 'Words' / 'Sentences' / 'Paragraphs' / 'Content' | 'Content' | Defines textual divisions in the returned data |
'Save' | x | x | P | P | x | P | P | P | boolean | true/false/1/0/'on'/'off' | false | If true, save the document after modification (false = much faster) |
'Title' | x | x | + | x | x | + | + | + | string | anything | none | Sheet/page/slide title |
'Data' | x | x | + | x | x | + | + | + | string/ numeric/ matrix/ cell-array/... | anything | none | data values to be written |
'Image' or 'Picture' | x | x | + | x | x | + | + | + | string or number | image filename or figure handle | none | image to be inserted |
'Meta' | x | x | P | x | x | P | P | P | boolean | true/false/1/0/'on'/'off' | false | indicates that figure image should be pasted as meta-info, not screenshot. Note: this might fail if Adobe Acrobat is installed |
'NewPage' | x | x | P | x | x | x | P | x | boolean | true/false/1/0/'on'/'off' | false | indicates that a page-break should be inserted before the data. Also see 'PageBreakBefore' property below |
'HeaderText' | x | x | P | x | x | P | P | x | string | anything | '' = empty | indicates header text for the current worksheet (XLS) or the entire document (DOC). Unavailable in PPT |
'FooterText' | x | x | P | x | x | P | P | P | string | anything | filename | indicates footer text for the current worksheet (XLS), current slide (PPT) or the entire document (DOC) |
'Fgcolor' or 'Foreground' | x | x | + | + | x | + | + | + | string or numeric vector | all valid Matlab colors (e.g., 'g','green' or [0,1,0]) | 'black' | Font foreground color |
'Bgcolor' or 'Background' | x | x | P | P | x | P | P | P | string or numeric vector | all valid Matlab colors (e.g., 'g','green' or [0,1,0]) | 'white' | Font background color. PPT: also see 'SlideColor' below |
'FontSize' | x | x | P | P | x | P | P | P | number | positive number | none (normally 10 or 12) | Font size (e.g., 13) |
'FontName' | x | x | P | P | x | P | P | P | string | valid font name | none | Font name (e.g., 'Times New Roman' or 'Arial') |
'Bold' | x | x | + | + | x | + | + | + | boolean | true/false/1/0/'on'/'off' | false | Bold font |
'Italic' | x | x | P | P | x | P | P | P | boolean | true/false/1/0/'on'/'off' | false | Italic font |
'Underline' | x | x | P | P | x | P | P | P | integer | XLS: 0-2; DOC: 0-4; PPT: 0/1 | 0 = no line | Underline font (0=none, 1=single, 2=double, 3=thick, 4=words); Matlab7 also accepts strings: 'wdUnderlineWords' etc. |
'Strikethrough' | x | x | P | P | x | P | P | x | boolean | true/false/1/0/'on'/'off' | false | Strikethrough font |
'AllCaps' | x | x | P | P | x | x | P | x | boolean | true/false/1/0/'on'/'off' | false | All-caps font: lowercase 'a' looks exactly like uppercase 'A' |
'SmallCaps' | x | x | P | P | x | x | P | x | boolean | true/false/1/0/'on'/'off' | false | Small-caps font: lowercase 'a' looks like a small uppercase 'A' |
'Subscript' | x | x | P | P | x | P | P | P | boolean | true/false/1/0/'on'/'off' | false | Subscript font |
'Superscript' | x | x | P | P | x | P | P | P | boolean | true/false/1/0/'on'/'off' | false | Superscript font |
'Shadow' | x | x | P | P | x | P | P | P | boolean | true/false/1/0/'on'/'off' | false | Shadowed font |
'Emboss' | x | x | P | P | x | x | P | P | boolean | true/false/1/0/'on'/'off' | false | Embossed font |
'WrapText' | x | x | P | P | x | P | x | P | boolean | true/false/1/0/'on'/'off' | false | Wrap text within cell(s) / box |
'NumberFormat' | x | x | P | P | x | P | x | x | string | any valid format specifier | none | Cell format specifier (e.g., '#,##0_);[Red](#,##0)') |
'TextOrientation' | x | x | P | P | x | P | x | P | degrees | XLS: -90:90; PPT: 0 or -90 | 0 = Eastward | Indicates text direction: -90=downward, +90=upward. PPT only accepts 0 or -90; XLS accepts full range |
'EdgeLeft' | x | x | P | P | x | P | P | x | number or cell array | weight (0/0.5/1/1.5/2/3/4) or {weight,color} | none | Left border. Set weight to [] or 0 to remove this border. Note: this property fails in Matlab 6 (ok in 7) |
'EdgeRight' | x | x | P | P | x | P | P | x | number or cell array | weight (0/0.5/1/1.5/2/3/4) or {weight,color} | none | Left border. Set weight to [] or 0 to remove this border. Note: this property fails in Matlab 6 (ok in 7) |
'EdgeTop' | x | x | P | P | x | P | P | x | number or cell array | weight (0/0.5/1/1.5/2/3/4) or {weight,color} | none | Left border. Set weight to [] or 0 to remove this border. Note: this property fails in Matlab 6 (ok in 7) |
'EdgeBottom' | x | x | P | P | x | P | P | x | number or cell array | weight (0/0.5/1/1.5/2/3/4) or {weight,color} | none | Left border. Set weight to [] or 0 to remove this border. Note: this property fails in Matlab 6 (ok in 7) |
'Halign' | x | x | P | P | x | P | P | x | string | 'right' / 'center' / 'left' / 'justify' XLS: also 'fill' / 'general' | 'general' | Horizontal cell/paragraph alignment |
'Valign' | x | x | P | P | x | P | x | x | string | 'top' / 'center' / 'bottom' / 'justify' | 'bottom' | Vertical cell alignment |
'LineSpacing' | x | x | P | P | x | x | P | P | number | positive number | 1 | Spacing between lines: 1/1.5/2 indicate single-double spacing; any other value is treated as an exact number of [points]. Matlab7 also accepts strings: 'wdLineSpaceSingle' etc. |
'SpaceBefore' | x | x | P | P | x | x | P | P | number | positive number | 0.2 | Spacing before selected line(s) in [points] |
'SpaceAfter' | x | x | P | P | x | x | P | P | number | positive number | 0 | Spacing after selected line(s) in [points] |
'WidowControl' | x | x | P | P | x | x | P | x | boolean | true/false/1/0/'on'/'off' | false | DOC paragraph widow/orphan control |
'KeepWithNext' | x | x | P | P | x | x | P | x | boolean | true/false/1/0/'on'/'off' | false | DOC paragraph "Keep-with-next" (keep next paragraph on same page) |
'KeepTogether' | x | x | P | P | x | x | P | x | boolean | true/false/1/0/'on'/'off' | false | DOC paragraph "Keep-Together" (keep this paragraph on same page) |
'PageBreakBefore' | x | x | P | P | x | x | P | x | boolean | true/false/1/0/'on'/'off' | false | DOC paragraph "Page-Break-Before" (start paragraph on top of new page). Also see 'NewPage' property above |
'Bullet' | x | x | P | P | x | x | P | P | string | 'None' / 'Numbered' / 'Unnumbered' or 'Bullet' | 'None' | Bullet/numberring type (unnumbered = bullet) |
'LeftIndent' | x | x | P | P | x | x | P | P | number | positive number | 0 | Left paragraph indent in [points] |
'RightIndent' | x | x | P | P | x | x | P | P | number | positive number | 0 | Right paragraph indent in [points] |
'IndentLevel' | x | x | P | P | x | x | x | P | integer | positive integer | 1 | Indent level. Default = leftmost indent = 1 |
'RowHeight' | x | x | P | P | x | P | x | x | number | positive number | system dependent | XLS row height (e.g., 12.75) |
'ColWidth' | x | x | P | P | x | P | x | x | number | positive number | system dependent | XLS column width (e.g., 8.5) |
'RowAutoFit' | x | x | P | P | x | P | x | x | boolean | true/false/1/0/'on'/'off' | false | Auto-fit selected XLS row(s) according to the contained value(s) |
'ColAutoFit' | x | x | P | P | x | P | x | x | boolean | true/false/1/0/'on'/'off' | false | Auto-fit selected XLS column(s) according to the contained value(s) |
'RowHidden' | x | x | P | P | x | P | x | x | boolean | true/false/1/0/'on'/'off' | false | Hides or unhides the selected XLS row(s) |
'ColHidden' | x | x | P | P | x | P | x | x | boolean | true/false/1/0/'on'/'off' | false | Hides or unhides the selected XLS column(s) |
'SheetHidden' | x | x | P | P | x | P | x | x | boolean | true/false/1/0/'on'/'off' | false | Hides or unhides the selected XLS worksheet |
'SheetName' | x | x | P | P | x | P | x | x | string | almost anything up to 32 chars | none | XLS worksheet (tab) name |
'TabColor' | x | x | P | P | x | P | x | x | string or numeric vector | all valid Matlab colors (e.g., 'g','green' or [0,1,0]) | 'white' | XLS worksheet tab color; ''=white |
'SlideHidden' | x | x | P | P | x | x | x | P | boolean | true/false/1/0/'on'/'off' | false | Hides or unhides the selected PPT slide |
'SlideColor' | x | x | P | P | x | x | x | P | string or numeric vector | all valid Matlab colors (e.g., 'g','green' or [0,1,0]) | 'white' | PPT slide background color; ''=white. Note: 'BgColor' sets the text frame color, not the slide color |
'BgPicture' | x | x | P | P | x | P | P | P | string | filename | '' | Background image for the current worksheet/page/slide; Use '' to remove |
'PageOrientation' | x | x | P | P | x | P | P | P | string | 'Landscape' / 'Portrait' | none (system dependent) | Page orientation |
'Release' | x | x | x | x | + | + | + | + | boolean | true/false/1/0/'on'/'off' | true = release | indicates whether or not to release the COM server from memory after closing the file (recommended unless the same server will be reused shortly). |
'DelStd' | x | x | x | x | P | P | x | x | boolean | true/false/1/0/'on'/'off' | false | deletes the standard XLS worksheets. Note that XLS files must have at least one sheet, so if the file has only the standard sheets, then the last one will not be deleted. |