@thinkfree.dev/tfo-sdk 0.2.0 → 0.2.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +140 -59
- package/dist/index.d.ts +692 -750
- package/dist/index.js +1 -9
- package/dist/index.js.map +1 -1
- package/dist/sdk-api-catalog.json +695 -388
- package/dist/sdk-api-doc.html +1739 -1050
- package/dist/sdk-api-doc.md +330 -252
- package/dist/version.json +4 -4
- package/package.json +23 -2
package/dist/sdk-api-doc.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# Thinkfree Office SDK — API 기능 명세
|
|
2
2
|
|
|
3
|
-
> 기준일 2026-09-
|
|
3
|
+
> 기준일 2026-09-15 · SDK 빌드 시 자동 생성되는 문서입니다 (`npm run generate:doc`).
|
|
4
4
|
> dist 안의 원본은 빌드마다 덮어써집니다 — 내용을 편집하려면 전달받은 사본에서 작업하세요.
|
|
5
5
|
|
|
6
6
|
외부 서비스에서 Thinkfree Office 문서(Word · Spreadsheet · Presentation)를 제어할 수 있는 기능 목록입니다.
|
|
@@ -34,22 +34,22 @@
|
|
|
34
34
|
- [Name](#cell-name) (이름 정의) — 8
|
|
35
35
|
- [Range](#cell-range) (셀 범위) — 74
|
|
36
36
|
- [Table](#cell-table) (표) — 9
|
|
37
|
-
- [**Presentation**](#mod-show) — 객체 15 · 기능
|
|
37
|
+
- [**Presentation**](#mod-show) — 객체 15 · 기능 342
|
|
38
38
|
- [Document](#show-document) (문서) — 54
|
|
39
39
|
- [Slide](#show-slide) (슬라이드) — 56
|
|
40
|
-
- [BasePathShape](#show-basepathshape) (도형 (패스)) —
|
|
41
|
-
- [BaseShape](#show-baseshape) (도형 공통) —
|
|
40
|
+
- [BasePathShape](#show-basepathshape) (도형 (패스)) — 31
|
|
41
|
+
- [BaseShape](#show-baseshape) (도형 공통) — 35
|
|
42
42
|
- [Chart](#show-chart) (차트) — 15
|
|
43
43
|
- [Comment](#show-comment) (댓글) — 13
|
|
44
44
|
- [Control](#show-control) — 0
|
|
45
45
|
- [Diagram](#show-diagram) — 0
|
|
46
46
|
- [Group](#show-group) (그룹) — 2
|
|
47
|
-
- [Image](#show-image) (이미지) —
|
|
48
|
-
- [Line](#show-line) (선) —
|
|
47
|
+
- [Image](#show-image) (이미지) — 3
|
|
48
|
+
- [Line](#show-line) (선) — 4
|
|
49
49
|
- [OleObject](#show-oleobject) — 0
|
|
50
|
-
- [Shape](#show-shape) (도형) —
|
|
51
|
-
- [Table](#show-table) (표) —
|
|
52
|
-
- [TableCell](#show-tablecell) (표 셀) —
|
|
50
|
+
- [Shape](#show-shape) (도형) — 51
|
|
51
|
+
- [Table](#show-table) (표) — 21
|
|
52
|
+
- [TableCell](#show-tablecell) (표 셀) — 57
|
|
53
53
|
- [**Common — 모듈 공통 상수**](#mod-common) — 상수 8
|
|
54
54
|
|
|
55
55
|
<a id="mod-word"></a>
|
|
@@ -261,10 +261,10 @@ Gets and edits the content and formatting of a single paragraph.
|
|
|
261
261
|
| `getStructure` | Returns the structure information of this paragraph.<br>- Includes index, type, paragraph ID, area ID and text. | — | a list containing this single paragraph entry<br>`{ paragraphs: { index: number; type: string; id: string; storyId: string; text: string }[] }` |
|
|
262
262
|
| `getContentHtml` | Returns the content of this paragraph as HTML with formatting.<br>- The paragraph is represented as a <p> element. | — | HTML of this paragraph and the paragraph count<br>`{ html: string; paragraphCount: number }` |
|
|
263
263
|
| `insertText` | Inserts text into the paragraph or replaces the entire paragraph content.<br>- Formatting is preserved. To change or reset formatting, use setTextFormat(), clearFormat() or setStyle() on the returned range.<br><br><b>Example</b><pre><code>para.insertText("hello"); // append at paragraph start (default)<br>para.insertText("world", { position: InsertAt.END }); // append at paragraph end<br>para.insertText("X", { offset: 3 }); // insert at the 3rd character position<br>para.insertText("new text", { replace: true }); // replace the entire paragraph</code></pre> | `text` 문자열 — text to insert<br>`options` (선택) `{ offset?: number; position?: InsertAt; replace?: boolean }` — insert/replace options<br> · `offset` character position within the paragraph (0-based); takes precedence over position<br> · `position` append position (when offset is absent). start (paragraph start) \| end (paragraph end) (기본값: InsertAt.START)<br> · `replace` if true, replaces the entire paragraph content with the new text (position arguments ignored) (기본값: false) | range of the text just inserted (or replaced, when replacing)<br>[`WordRange`](#word-wordrange) |
|
|
264
|
-
| `insertShape` | Inserts a shape of the given preset into the paragraph.<br>- After insertion, use the returned shape to set formatting and placement.<br><br><b>Example</b><pre><code>para.insertShape(ShapePreset.RECT); // 100x100 rectangle at paragraph start (default)<br>para.insertShape(ShapePreset.ELLIPSE, { offset: 3 }); // insert at the 3rd character position<br>para.insertShape(ShapePreset.RECT, { position: InsertAt.END }); // insert at paragraph end</code></pre> | `preset` [`ShapePreset`](#common-shapepreset) — base shape of the shape (e.g. "rect", "ellipse", "roundRect")<br>`options` (선택) `{ width?: number; height?: number; offset?: number; position?: InsertAt }` — shape insertion options<br> · `width` width (
|
|
265
|
-
| `insertTextbox` | Inserts a text box into the paragraph.<br><br><b>Example</b><pre><code>para.insertTextbox({ text: "Notice" }); // insert a text box<br>para.insertTextbox({ width: 200, height: 100, offset: 3 }); // specify size and position</code></pre> | `options` (선택) `{ width?: number; height?: number; text?: string; offset?: number; position?: InsertAt }` — text box insertion options<br> · `width` width (
|
|
266
|
-
| `insertImage` | Inserts an image into the paragraph, placed inline like a character.<br>- Processed asynchronously regardless of the image source.<br><br><b>Example</b><pre><code>await para.insertImage({ url: "https://example.com/image.png" }); // insert an external image<br>await para.insertImage({ src: imagePath, width: 200, offset: 3 }); // specify size and position of an uploaded image</code></pre> | `options` `{ src?: string; url?: string; base64?: string; width?: number; height?: number; offset?: number; position?: InsertAt }` — image insertion options (exactly one source among src/url/base64 is required)<br> · `src` path of an already uploaded image<br> · `url` image URL (uploaded first, then inserted)<br> · `base64` base64 data (uploaded first, then inserted)<br> · `width` width (
|
|
267
|
-
| `insertWebVideo` | Inserts a web video into the paragraph, placed inline like a character.<br>- Supports YouTube and 3DS 3DEXPERIENCE URLs and is processed asynchronously.<br>- Uses a fallback image if the preview image cannot be fetched.<br><br><b>Example</b><pre><code>await para.insertWebVideo(videoUrl); // insert a video from a supported URL<br>await para.insertWebVideo(videoUrl, { width: 320, height: 180, position: InsertAt.END }); // specify size at paragraph end</code></pre> | `url` 문자열 — web video URL (YouTube / 3DS 3DEXPERIENCE)<br>`options` (선택) `{ width?: number; height?: number; offset?: number; position?: InsertAt }` — web video insertion options<br> · `width` width (
|
|
264
|
+
| `insertShape` | Inserts a shape of the given preset into the paragraph.<br>- After insertion, use the returned shape to set formatting and placement.<br><br><b>Example</b><pre><code>para.insertShape(ShapePreset.RECT); // 100x100 rectangle at paragraph start (default)<br>para.insertShape(ShapePreset.ELLIPSE, { offset: 3 }); // insert at the 3rd character position<br>para.insertShape(ShapePreset.RECT, { position: InsertAt.END }); // insert at paragraph end</code></pre> | `preset` [`ShapePreset`](#common-shapepreset) — base shape of the shape (e.g. "rect", "ellipse", "roundRect")<br>`options` (선택) `{ width?: number; height?: number; offset?: number; position?: InsertAt }` — shape insertion options<br> · `width` width (pt) (기본값: 75)<br> · `height` height (pt) (기본값: 75)<br> · `offset` character position within the paragraph (0-based); takes precedence over position<br> · `position` insertion position (when offset is absent). start (paragraph start) \| end (paragraph end) (기본값: InsertAt.START) | the inserted shape<br>[`WordShape`](#word-wordshape) |
|
|
265
|
+
| `insertTextbox` | Inserts a text box into the paragraph.<br><br><b>Example</b><pre><code>para.insertTextbox({ text: "Notice" }); // insert a text box<br>para.insertTextbox({ width: 200, height: 100, offset: 3 }); // specify size and position</code></pre> | `options` (선택) `{ width?: number; height?: number; text?: string; offset?: number; position?: InsertAt }` — text box insertion options<br> · `width` width (pt) (기본값: 75)<br> · `height` height (pt) (기본값: 75)<br> · `text` initial content text<br> · `offset` character position within the paragraph (0-based); takes precedence over position<br> · `position` insertion position (when offset is absent). start (paragraph start) \| end (paragraph end) (기본값: InsertAt.START) | creation result (shape: shape object / storyId: text box area ID / paragraphId: first paragraph ID)<br>`{ shape: WordShape; storyId: string; paragraphId: string }` |
|
|
266
|
+
| `insertImage` | Inserts an image into the paragraph, placed inline like a character.<br>- Processed asynchronously regardless of the image source.<br><br><b>Example</b><pre><code>await para.insertImage({ url: "https://example.com/image.png" }); // insert an external image<br>await para.insertImage({ src: imagePath, width: 200, offset: 3 }); // specify size and position of an uploaded image</code></pre> | `options` `{ src?: string; url?: string; base64?: string; width?: number; height?: number; offset?: number; position?: InsertAt }` — image insertion options (exactly one source among src/url/base64 is required)<br> · `src` path of an already uploaded image<br> · `url` image URL (uploaded first, then inserted)<br> · `base64` base64 data (uploaded first, then inserted)<br> · `width` width (pt) (기본값: original size)<br> · `height` height (pt) (기본값: original size)<br> · `offset` character position within the paragraph (0-based); takes precedence over position<br> · `position` insertion position (when offset is absent). start (paragraph start) \| end (paragraph end) (기본값: InsertAt.START) | the inserted image<br>[`WordImage`](#word-wordimage) |
|
|
267
|
+
| `insertWebVideo` | Inserts a web video into the paragraph, placed inline like a character.<br>- Supports YouTube and 3DS 3DEXPERIENCE URLs and is processed asynchronously.<br>- Uses a fallback image if the preview image cannot be fetched.<br><br><b>Example</b><pre><code>await para.insertWebVideo(videoUrl); // insert a video from a supported URL<br>await para.insertWebVideo(videoUrl, { width: 320, height: 180, position: InsertAt.END }); // specify size at paragraph end</code></pre> | `url` 문자열 — web video URL (YouTube / 3DS 3DEXPERIENCE)<br>`options` (선택) `{ width?: number; height?: number; offset?: number; position?: InsertAt }` — web video insertion options<br> · `width` width (pt) (기본값: original thumbnail size)<br> · `height` height (pt) (기본값: original thumbnail size)<br> · `offset` character position within the paragraph (0-based); takes precedence over position<br> · `position` insertion position (when offset is absent). start (paragraph start) \| end (paragraph end) (기본값: InsertAt.START) | the inserted web video image object<br>[`WordImage`](#word-wordimage) |
|
|
268
268
|
| `insertLineBreak` | Inserts a line break into the paragraph.<br>- Breaks the line while keeping the paragraph, like Shift+Enter.<br><br><b>Example</b><pre><code>para.insertLineBreak(); // line break at paragraph start<br>para.insertLineBreak({ offset: 3 }); // line break at the given character position</code></pre> | `options` (선택) `{ offset?: number; position?: InsertAt }` — insertion position options<br> · `offset` character position within the paragraph (0-based); a position past the end of the paragraph is adjusted to the paragraph end. takes precedence over position<br> · `position` insertion position (when offset is absent). start (paragraph start) \| end (paragraph end) (기본값: InsertAt.START) | — |
|
|
269
269
|
| `insertTab` | Inserts a tab character into the paragraph.<br>- Tab stop positions are set separately with setTabs().<br><br><b>Example</b><pre><code>para.insertTab(); // insert a tab at paragraph start<br>para.insertTab({ position: InsertAt.END }); // insert a tab at paragraph end</code></pre> | `options` (선택) `{ offset?: number; position?: InsertAt }` — insertion position options<br> · `offset` character position within the paragraph (0-based); a position past the end of the paragraph is adjusted to the paragraph end. takes precedence over position<br> · `position` insertion position (when offset is absent). start (paragraph start) \| end (paragraph end) (기본값: InsertAt.START) | — |
|
|
270
270
|
| `insertSymbol` | Inserts a symbol into the paragraph.<br>- font not specified: inserts the Unicode character as plain text.<br> - font specified: inserts the symbol glyph of that font.<br><br><b>Example</b><pre><code>para.insertSymbol("2605"); // insert ★ at paragraph start<br>para.insertSymbol("F0FC", { font: "Wingdings" }); // Wingdings check mark symbol</code></pre> | `charCode` `string \| number` — Unicode code point (hex string "2605" \| "0x2605" \| number 0x2605)<br>`options` (선택) `{ font?: string; offset?: number; position?: InsertAt }` — symbol insertion options<br> · `font` if specified, inserts the symbol glyph of that font<br> · `offset` character position within the paragraph (0-based); takes precedence over position<br> · `position` insertion position (when offset is absent). start (paragraph start) \| end (paragraph end) (기본값: InsertAt.START) | — |
|
|
@@ -278,7 +278,7 @@ Gets and edits the content and formatting of a single paragraph.
|
|
|
278
278
|
| `setTextFormat` | Applies text formatting to the entire text of the paragraph.<br><br><b>Example</b><pre><code>para.setTextFormat({ bold: true }); // make all text in the paragraph bold<br>para.setTextFormat({ size: 12, color: "#FF0000" }); // set size and color</code></pre> | `options` [`TextFormat`](#word-textformat) — text formatting to apply | — |
|
|
279
279
|
| `clearFormat` | Resets the text formatting and paragraph formatting of the entire paragraph. | — | — |
|
|
280
280
|
| `select` | Sets this paragraph as the on-screen selection.<br>- Does not change document content.<br><br><b>Example</b><pre><code>para.select(); // select the entire paragraph<br>para.select(SelectionMode.END); // place the cursor at paragraph end</code></pre> | `mode` (선택) [`SelectionMode`](#word-selectionmode) — "select" (entire paragraph) / "start" (cursor at paragraph start) / "end" (cursor at paragraph end) (기본값: SelectionMode.SELECT) | — |
|
|
281
|
-
| `setParagraphFormat` | Applies the given paragraph formatting to this paragraph.<br>- Only the specified fields are changed. Text formatting is set with setTextFormat().<br><br><b>Example</b><pre><code>para.setParagraphFormat({ align: TextAlign.CENTER }); // center alignment<br>para.setParagraphFormat({ lineSpacing: 1.5, spaceAfter: 10 }); // 1.5x line spacing, 10pt space after paragraph<br>para.setParagraphFormat({ leftIndent: 20, align: null }); //
|
|
281
|
+
| `setParagraphFormat` | Applies the given paragraph formatting to this paragraph.<br>- Only the specified fields are changed. Text formatting is set with setTextFormat().<br><br><b>Example</b><pre><code>para.setParagraphFormat({ align: TextAlign.CENTER }); // center alignment<br>para.setParagraphFormat({ lineSpacing: 1.5, spaceAfter: 10 }); // 1.5x line spacing, 10pt space after paragraph<br>para.setParagraphFormat({ leftIndent: 20, align: null }); // 20pt left indent, remove alignment</code></pre> | `options` [`ParagraphFormat`](#word-paragraphformat) — paragraph formatting to apply | — |
|
|
282
282
|
| `setParagraphBorder` | Sets the border of this paragraph.<br>- Uses the same Border format as cell borders.<br><br><b>Example</b><pre><code>para.setParagraphBorder({ location: BorderLocation.ALL, style: BorderStyle.SOLID, color: "#0000FF", width: 1 }); // blue solid line on all four sides and between paragraphs<br>para.setParagraphBorder({ location: BorderLocation.BOTTOM, style: BorderStyle.DOUBLE, color: "#000000", width: 2 }); // double line on the bottom only<br>para.setParagraphBorder({ location: BorderLocation.ALL, style: BorderStyle.NONE, color: "#000000", width: 0 }); // remove borders</code></pre> | `border` [`Border`](#word-border) — border value | — |
|
|
283
283
|
| `setTabs` | Sets the tab stop positions of this paragraph.<br>- Replaces the existing setting with the given array; an empty array removes all tab stops.<br><br><b>Example</b><pre><code>para.setTabs([{ position: 72, alignment: TabAlignment.LEFT }]); // left-aligned tab at 72pt (1 inch)<br>para.setTabs([]); // remove all tab stops</code></pre> | `tabs` [`TabStop`](#word-tabstop) 목록 — array of tab stops | — |
|
|
284
284
|
| `setStyle` | Applies a style to this paragraph.<br>- Applying a style resets the existing direct formatting.<br>- A paragraph style is applied to the paragraph; a character style is applied to the entire text of the paragraph.<br><br><b>Example</b><pre><code>para.setStyle(Style.HEADING_1); // Heading 1 paragraph style<br>para.setStyle("MyCustomStyle"); // custom document style (key obtained from getStyles)<br>para.setStyle(null); // remove the style (revert to default)</code></pre> | `style` `Style \| string \| null` — Style enum for built-in styles (value = key), or the style value from getStyles() for custom document styles. null removes the style (reverts to default) | — |
|
|
@@ -344,10 +344,10 @@ Reads and edits content within a specified range of the document.
|
|
|
344
344
|
| `select` | Sets this range as the on-screen selection.<br>- Does not change document content.<br><br><b>Example</b><pre><code>range.select(); // select the whole range<br>range.select(SelectionMode.END); // place the cursor at the range end<br>doc.getSelection().select(SelectionMode.START); // collapse the current selection to a cursor at its start</code></pre> | `mode` (선택) [`SelectionMode`](#word-selectionmode) — "select" (whole range) / "start" (cursor at the start point) / "end" (cursor at the end point) (기본값: SelectionMode.SELECT) | — |
|
|
345
345
|
| `insertParagraph` | Inserts a new paragraph above or below the anchor paragraph of this range.<br>- The new paragraph inherits the anchor paragraph's direct paragraph formatting such as alignment, spacing, and indents.<br>- To reset the inherited direct formatting, call clearFormat() on the returned paragraph.<br><br><b>Example</b><pre><code>range.insertParagraph("new paragraph"); // add below the range paragraph<br>range.insertParagraph("above", { position: InsertAt.BEFORE }); // add above the range paragraph</code></pre> | `text` 문자열 — text of the new paragraph<br>`options` (선택) `{ position?: InsertAt }` — insert options<br> · `position` relative to the range paragraph: "before" (above) / "after" (below) (기본값: InsertAt.AFTER) | the newly created paragraph<br>[`WordParagraph`](#word-wordparagraph) |
|
|
346
346
|
| `insertTable` | Inserts a table relative to the paragraph of the range.<br>- Cannot insert inside a table cell (nested tables are not supported — an error occurs if the insertion point is inside a cell).<br><br><b>Example</b><pre><code>range.insertTable(3, 4); // 3x4 table below the range paragraph<br>range.insertTable(2, 2, { position: InsertAt.BEFORE }); // insert above the range paragraph<br>range.insertTable(2, 2, { values: [["a", "b"], ["c", "d"]] }); // fill cells on creation</code></pre> | `rows` 숫자 — number of rows<br>`columns` 숫자 — number of columns<br>`options` (선택) `{ position?: InsertAt; values?: string[][] }` — insert options<br> · `position` relative to the range paragraph: "before" (above) / "after" (below) (기본값: InsertAt.AFTER)<br> · `values` cell values to fill right after creation (2D array; exceeding the table size raises an error before issuing) | the inserted table<br>[`WordTable`](#word-wordtable) |
|
|
347
|
-
| `insertShape` | Inserts a shape of the given preset into the paragraph of this range.<br>- Use the returned shape to set formatting and placement.<br><br><b>Example</b><pre><code>range.insertShape(ShapePreset.RECT); // insert a rectangle<br>range.insertShape(ShapePreset.ELLIPSE, { width: 200, height: 100 }); // ellipse with a specified size</code></pre> | `preset` [`ShapePreset`](#common-shapepreset) — basic shape of the shape (e.g. "rect", "ellipse", "roundRect")<br>`options` (선택) [`Size`](#word-size) — size (
|
|
347
|
+
| `insertShape` | Inserts a shape of the given preset into the paragraph of this range.<br>- Use the returned shape to set formatting and placement.<br><br><b>Example</b><pre><code>range.insertShape(ShapePreset.RECT); // insert a rectangle<br>range.insertShape(ShapePreset.ELLIPSE, { width: 200, height: 100 }); // ellipse with a specified size</code></pre> | `preset` [`ShapePreset`](#common-shapepreset) — basic shape of the shape (e.g. "rect", "ellipse", "roundRect")<br>`options` (선택) [`Size`](#word-size) — size (pt; an omitted axis defaults to 75) | the inserted shape<br>[`WordShape`](#word-wordshape) |
|
|
348
348
|
| `insertTextbox` | Inserts a text box into the paragraph of the range.<br><br><b>Example</b><pre><code>range.insertTextbox({ text: "Notice" }); // insert a text box<br>range.insertTextbox({ width: 200, height: 100, text: "Description" }); // specify size and content</code></pre> | `options` (선택) `Size & { text?: String }` — text box creation options (an omitted size axis defaults to 100; text is the initial content) | creation result (shape: shape object / storyId: text box area ID / paragraphId: first paragraph ID)<br>`{ shape: WordShape; storyId: string; paragraphId: string }` |
|
|
349
|
-
| `insertImage` | Inserts an image inline at the start position of this range.<br>- Processed asynchronously regardless of the image source.<br><br><b>Example</b><pre><code>await range.insertImage({ url: "https://example.com/image.png" }); // insert an external image<br>await range.insertImage({ src: imagePath, width: 200, height: 150 }); // insert an uploaded image (size required)</code></pre> | `options` `{ src?: string; url?: string; base64?: string; width?: number; height?: number }` — image insert options (exactly one source among src/url/base64 is required)<br> · `src` path of an already uploaded image<br> · `url` image URL (uploaded first, then inserted)<br> · `base64` base64 data (uploaded first, then inserted)<br> · `width` width (
|
|
350
|
-
| `insertWebVideo` | Inserts a web video inline at the start position of this range.<br>- Supports YouTube and 3DS 3DEXPERIENCE URLs and is processed asynchronously.<br>- If the preview image cannot be fetched, a fallback image is used.<br><br><b>Example</b><pre><code>await range.insertWebVideo(videoUrl); // insert a video from a supported URL<br>await range.insertWebVideo(videoUrl, { width: 320, height: 180 }); // specify the size</code></pre> | `url` 문자열 — web video URL (YouTube / 3DS 3DEXPERIENCE)<br>`options` (선택) [`Size`](#word-size) — size (
|
|
349
|
+
| `insertImage` | Inserts an image inline at the start position of this range.<br>- Processed asynchronously regardless of the image source.<br><br><b>Example</b><pre><code>await range.insertImage({ url: "https://example.com/image.png" }); // insert an external image<br>await range.insertImage({ src: imagePath, width: 200, height: 150 }); // insert an uploaded image (size required)</code></pre> | `options` `{ src?: string; url?: string; base64?: string; width?: number; height?: number }` — image insert options (exactly one source among src/url/base64 is required)<br> · `src` path of an already uploaded image<br> · `url` image URL (uploaded first, then inserted)<br> · `base64` base64 data (uploaded first, then inserted)<br> · `width` width (pt). Required with src — the original size is only known for url/base64, which are measured on upload (기본값: original size)<br> · `height` height (pt). Required with src — the original size is only known for url/base64, which are measured on upload (기본값: original size) | the inserted image<br>[`WordImage`](#word-wordimage) |
|
|
350
|
+
| `insertWebVideo` | Inserts a web video inline at the start position of this range.<br>- Supports YouTube and 3DS 3DEXPERIENCE URLs and is processed asynchronously.<br>- If the preview image cannot be fetched, a fallback image is used.<br><br><b>Example</b><pre><code>await range.insertWebVideo(videoUrl); // insert a video from a supported URL<br>await range.insertWebVideo(videoUrl, { width: 320, height: 180 }); // specify the size</code></pre> | `url` 문자열 — web video URL (YouTube / 3DS 3DEXPERIENCE)<br>`options` (선택) [`Size`](#word-size) — size (pt) (기본값: thumbnail original size) | the inserted web video image object<br>[`WordImage`](#word-wordimage) |
|
|
351
351
|
| `insertLineBreak` | Inserts a line break at the start position of this range.<br>- Breaks the line while keeping the paragraph, like Shift+Enter.<br><br><b>Example</b><pre><code>range.insertLineBreak(); // line break at the range start</code></pre> | — | — |
|
|
352
352
|
| `insertTab` | Inserts a tab character at the start position of this range.<br>- Tab stop positions are set separately with setTabs().<br><br><b>Example</b><pre><code>range.insertTab(); // insert a tab at the range start</code></pre> | — | — |
|
|
353
353
|
| `insertSymbol` | Inserts a symbol at the start position of this range.<br>- font not specified: inserts the Unicode character as plain text.<br> - font specified: inserts it as a symbol glyph of that font.<br><br><b>Example</b><pre><code>range.insertSymbol("2605"); // insert the star symbol ★<br>range.insertSymbol("F0FC", { font: "Wingdings" }); // check mark symbol in the specified font</code></pre> | `charCode` `string \| number` — Unicode code point (hex string "2605" \| "0x2605" \| number 0x2605)<br>`options` (선택) `{ font?: string }` — when font is specified, inserts the symbol in that font | — |
|
|
@@ -394,10 +394,10 @@ Gets and edits the content and formatting of a shape or text box.
|
|
|
394
394
|
| `getFill` | Returns the current fill settings of the shape.<br>- The return value can be passed to setFill() as-is.<br>- A theme color fill or a radial gradient fill returns only type, so passing such a value back to setFill() fails. | — | fill information (same shape as the setFill input), null if there is no fill information<br>[`ShapeFill`](#word-shapefill) (없을 수 있음) |
|
|
395
395
|
| `getLine` | Returns the current line settings of the shape.<br>- The return value can be passed to setLine() as-is. | — | line information (same shape as the setLine input), null if there is no line information<br>[`ShapeLine`](#word-shapeline) (없을 수 있음) |
|
|
396
396
|
| `getHyperlink` | Returns the hyperlink information attached to the shape.<br>- A shape can have one hyperlink.<br><br><b>Example</b><pre><code>const link = shape.getHyperlink();<br>if (link) { shape.updateHyperlink({ url: "https://new.com" }); } // update if present</code></pre> | — | link information, null if none. For a bookmark, url="#name" and anchor="name"<br>`{ url: string; tooltip: string \| null; linkType: HyperlinkType; anchor?: string } \| null` |
|
|
397
|
-
| `resize` | Changes the size of the shape.<br>- Specify at least one of width or height. The size of the unspecified dimension is kept.<br><br><b>Example</b><pre><code>shape.resize({ width: 200, height: 100 }); // change width and height together<br>shape.resize({ width: 200 }); // change width only (height kept)</code></pre> | `options` [`Size`](#word-size) — new size (
|
|
397
|
+
| `resize` | Changes the size of the shape.<br>- Specify at least one of width or height. The size of the unspecified dimension is kept.<br><br><b>Example</b><pre><code>shape.resize({ width: 200, height: 100 }); // change width and height together<br>shape.resize({ width: 200 }); // change width only (height kept)</code></pre> | `options` [`Size`](#word-size) — new size (pt). Each field is optional, at least one required; omitted axes keep their current value | — |
|
|
398
398
|
| `setWrap` | Changes the wrap mode of the shape.<br>- Switches between inline with text and in front of / behind text.<br><br><b>Example</b><pre><code>shape.setWrap(ShapeWrap.INLINE); // inline with text<br>shape.setWrap(ShapeWrap.INFRONT); // in front of text<br>shape.setWrap(ShapeWrap.BEHIND); // behind text</code></pre> | `wrap` [`ShapeWrap`](#word-shapewrap) — "inline"\|"infront"\|"behind" | — |
|
|
399
399
|
| `setZOrder` | Changes the z-order of a shape placed in front of or behind text.<br>- Specifying the same position for a shape already at the very front or back makes no change.<br><br><b>Example</b><pre><code>shape.setZOrder(ShapeZOrder.FRONT); // bring to front<br>shape.setZOrder(ShapeZOrder.BACKWARD); // send backward one step</code></pre> | `order` [`ShapeZOrder`](#common-shapezorder) — "front"\|"back"\|"forward"\|"backward" | — |
|
|
400
|
-
| `move` | Changes the position of a shape placed in front of or behind text.<br>- x and y are
|
|
400
|
+
| `move` | Changes the position of a shape placed in front of or behind text.<br>- x and y are pt coordinates relative to relativeFromH and relativeFromV; unspecified fields are kept.<br>- A reference point must be given together with its coordinate, because changing the reference point changes the meaning of the coordinate.<br>- If anchorParagraphId is given, the shape moves to that paragraph; otherwise only the position within the current paragraph changes.<br><br><b>Example</b><pre><code>shape.move({ x: 100, y: 50 }); // move coordinates only, keeping the current reference points<br>shape.move({ x: 0, relativeFromH: PositionRelativeFromH.PAGE }); // move while changing the horizontal reference to the page<br>shape.move({ anchorParagraphId: "p1", x: 30, y: 30 }); // re-anchor to another paragraph</code></pre> | `options` `{ x?: number; y?: number; relativeFromH?: PositionRelativeFromH; relativeFromV?: PositionRelativeFromV; anchorParagraphId?: string }` — move options (x/y in pt). Omitted fields keep their current value | — |
|
|
401
401
|
| `setFill` | Sets the shape fill.<br>- For blipFill, give image as one of { src } (file name already uploaded to the server) / { url } (external image address) / { base64 }.<br> url and base64 are uploaded to the server first and then applied, so the result must be awaited in every case — always call with await.<br> - The input has the same shape as the getFill() return value (ShapeFill), so a read value can be re-applied as-is.<br><br><b>Example</b><pre><code>await shape.setFill({ type: FillType.SOLID, color: "#FF0000" }); // solid color<br>await shape.setFill({ type: FillType.NONE }); // remove fill<br>await shape.setFill({ type: FillType.GRADIENT, stops: [{ position: 0, color: "#FFFFFF" }, { position: 100, color: "#000000" }], angle: 90 }); // gradient<br>await shape.setFill({ type: FillType.IMAGE, image: { url: "https://example.com/a.png" } }); // external image (uploaded first)</code></pre> | `fill` [`ShapeFill`](#word-shapefill) — fill information (type determines which fields are valid) | no return value<br>— |
|
|
402
402
|
| `setLine` | Sets the shape line.<br>- Omitted = no change, null (color/dash/compound) = remove. null or a non-number for width is rejected (no "remove" meaning).<br><br><b>Example</b><pre><code>shape.setLine({ color: "#000000", width: 2 }); // black 2pt line<br>shape.setLine({ dash: LineDash.DASH }); // change dash style only<br>shape.setLine({ color: null }); // remove line</code></pre> | `options` [`ShapeLine`](#word-shapeline) — line options. Omitted = no change, null for color/dash/compound = remove | — |
|
|
403
403
|
| `insertHyperlink` | Sets a hyperlink on the shape.<br>- Replaces an existing link if present. Web address, email and bookmark are distinguished by URL format; a web address without a protocol gets https:// prepended.<br><br><b>Example</b><pre><code>shape.insertHyperlink("https://example.com"); // web link<br>shape.insertHyperlink("mailto:a@b.com", { tooltip: "Send mail" }); // email + tooltip<br>shape.insertHyperlink("#bookmark1"); // bookmark within the document</code></pre> | `url` 문자열 — link destination<br>`options` (선택) `{ tooltip?: string }` — additional options<br> · `tooltip` mouse-over tooltip (기본값: url) | — |
|
|
@@ -569,9 +569,9 @@ Gets a single table row and inserts or deletes adjacent rows.
|
|
|
569
569
|
|---|---|---|
|
|
570
570
|
| `align` (선택) | [`TextAlign`](#word-textalign) (없을 수 있음) | alignment ("left"\|"center"\|"right"\|"justify", null removes it) |
|
|
571
571
|
| `lineSpacing` (선택) | `number \| string \| null` | line spacing — number = multiple (e.g. 1.5), "Npx" = the same multiple fixed (e.g. "1.5px"; N is a line-height multiple, not pixels), null = remove |
|
|
572
|
-
| `leftIndent` (선택) | 숫자 (없을 수 있음) | left indent (
|
|
573
|
-
| `rightIndent` (선택) | 숫자 (없을 수 있음) | right indent (
|
|
574
|
-
| `firstLineIndent` (선택) | 숫자 (없을 수 있음) | first-line indent (
|
|
572
|
+
| `leftIndent` (선택) | 숫자 (없을 수 있음) | left indent (pt, null removes it) |
|
|
573
|
+
| `rightIndent` (선택) | 숫자 (없을 수 있음) | right indent (pt, null removes it) |
|
|
574
|
+
| `firstLineIndent` (선택) | 숫자 (없을 수 있음) | first-line indent (pt, negative for a hanging indent, null removes it) |
|
|
575
575
|
| `spaceBefore` (선택) | 숫자 (없을 수 있음) | space before the paragraph (pt, null removes it) |
|
|
576
576
|
| `spaceAfter` (선택) | 숫자 (없을 수 있음) | space after the paragraph (pt, null removes it) |
|
|
577
577
|
| `backgroundColor` (선택) | 문자열 (없을 수 있음) | paragraph background color (shading fill, hex "#RRGGBB", null removes it) |
|
|
@@ -624,13 +624,13 @@ Gets a single table row and inserts or deletes adjacent rows.
|
|
|
624
624
|
| `shapeId` | 문자열 | 도형 ID (영구 GUID) |
|
|
625
625
|
| `shapeType` | [`ShapeType`](#word-shapetype) | 도형 종류 ("sp"=도형/텍스트박스, "pic"=이미지) |
|
|
626
626
|
| `storyId` | 문자열 | 도형이 속한 영역 ID (본문 "0") |
|
|
627
|
-
| `width` | 숫자 | 너비(
|
|
628
|
-
| `height` | 숫자 | 높이(
|
|
627
|
+
| `width` | 숫자 | 너비(pt) |
|
|
628
|
+
| `height` | 숫자 | 높이(pt) |
|
|
629
629
|
| `wrap` | [`ShapeWrap`](#word-shapewrap) | 배치 모드 (inline/infront/behind) |
|
|
630
630
|
| `zIndex` | 숫자 | 앞뒤 순서 (floating 전용 의미) |
|
|
631
631
|
| `anchor` | `{ paragraphId: string; offset?: number }` | 소속 위치 (offset 은 inline 전용 단락 내 글자 위치) |
|
|
632
|
-
| `x` (선택) | 숫자 | floating 전용 가로 위치(
|
|
633
|
-
| `y` (선택) | 숫자 | floating 전용 세로 위치(
|
|
632
|
+
| `x` (선택) | 숫자 | floating 전용 가로 위치(pt, relativeFromH 기준 — move 에 그대로 재사용 가능) |
|
|
633
|
+
| `y` (선택) | 숫자 | floating 전용 세로 위치(pt, relativeFromV 기준) |
|
|
634
634
|
| `relativeFromH` (선택) | [`PositionRelativeFromH`](#word-positionrelativefromh) | floating 전용 가로 기준점 |
|
|
635
635
|
| `relativeFromV` (선택) | [`PositionRelativeFromV`](#word-positionrelativefromv) | floating 전용 세로 기준점 |
|
|
636
636
|
| `fill` | [`ShapeFill`](#word-shapefill) (없을 수 있음) | 채우기 readback (setFill 입력과 대칭) |
|
|
@@ -2027,43 +2027,42 @@ Presentation 문서를 다루는 기능입니다. 슬라이드 추가·복제,
|
|
|
2027
2027
|
|
|
2028
2028
|
| 기능 | 설명 | 입력 | 결과 |
|
|
2029
2029
|
|---|---|---|---|
|
|
2030
|
-
| `getFill` | 도형 채우기를 반환한다. (
|
|
2031
|
-
| `getLineStyle` | 선 스타일을 반환한다. (setLineColor/setLineWidth/setLineDash/setLineCap/setLineJoin
|
|
2032
|
-
| `getLineColor` | 선 색상을 반환한다. (setLineColor 대칭. 투명도까지 필요하면 getLineStyle 사용) | — | 선 색상 (hex "#RRGGBB"
|
|
2033
|
-
| `getLineWidth` | 선 두께(pt)를 반환한다. (setLineWidth 대칭) | — | 선 두께 (pt). 선
|
|
2034
|
-
| `getLineDash` | 선 대시 유형을 반환한다. (setLineDash 대칭) | — | 선 대시 유형. LineDash enum 이 아니거나
|
|
2035
|
-
| `getLineCap` | 선 끝 모양(cap)을 반환한다. (setLineCap 대칭) | — | 선 끝 모양.
|
|
2036
|
-
| `getLineJoin` | 선 연결 유형(join)을 반환한다. (setLineJoin 대칭) | — | 선 연결(모서리) 유형.
|
|
2037
|
-
| `getEffects` | 도형에 적용된 효과를 반환한다. 적용된 효과만 키로 포함된다.<br>각 값은 대응 setter(setOuterShadow/setInnerShadow/setGlow/setSoftEdge/setReflection/set3d) 인자와
|
|
2038
|
-
| `setSolidFill` | 도형 채우기를 단색으로 설정한다. | `color` 문자열 — hex (#RRGGBB) 또는 scheme color<br>`alpha` (선택) 숫자 — 투명도 (0~100) (기본값:
|
|
2030
|
+
| `getFill` | 도형 채우기를 반환한다. (setFill 대칭 - 반환 객체를 그대로 넘길 수 있다)<br>type 별 개별 setter 는 setSolidFill/setGradientFill/setImageFill/setPatternFill/removeFill 이다. | — | 채우기 정보. noFill 이면 `{ type: FillType.NONE }`, 대상 도형이 없으면(협업 중 삭제 등) null<br>[`Fill`](#show-fill) (없을 수 있음) |
|
|
2031
|
+
| `getLineStyle` | 선 스타일을 반환한다. (setLineStyle 대칭 - 반환 객체를 그대로 넘길 수 있다)<br>개별 setter 는 setLineColor/setLineGradient/setLineWidth/setLineDash/setLineCap/setLineJoin 이다.<br><br>선 채우기는 getFill 과 같은 형태로 담는다. | — | 선 스타일. 대상 도형이 없으면 null<br>[`LineStyle`](#show-linestyle) (없을 수 있음) |
|
|
2032
|
+
| `getLineColor` | 선 색상을 반환한다. (setLineColor 대칭. 투명도까지 필요하면 getLineStyle 사용) | — | 선 색상 (hex "#RRGGBB" — scheme color 도 hex 로 풀려서 나온다). 선이 없거나 대상 도형이 없으면 null<br>문자열 (없을 수 있음) |
|
|
2033
|
+
| `getLineWidth` | 선 두께(pt)를 반환한다. (setLineWidth 대칭) | — | 선 두께 (pt). 선 없음(noFill)이어도 두께는 그대로 반환한다. 대상 도형이 없으면 null<br>숫자 (없을 수 있음) |
|
|
2034
|
+
| `getLineDash` | 선 대시 유형을 반환한다. (setLineDash 대칭) | — | 선 대시 유형. LineDash enum 이 아니거나 대상 도형이 없으면 null<br>[`LineDash`](#common-linedash) (없을 수 있음) |
|
|
2035
|
+
| `getLineCap` | 선 끝 모양(cap)을 반환한다. (setLineCap 대칭) | — | 선 끝 모양. 설정이 없거나 대상 도형이 없으면 null<br>[`LineCap`](#show-linecap) (없을 수 있음) |
|
|
2036
|
+
| `getLineJoin` | 선 연결 유형(join)을 반환한다. (setLineJoin 대칭) | — | 선 연결(모서리) 유형. 설정이 없거나 대상 도형이 없으면 null<br>[`LineJoin`](#show-linejoin) (없을 수 있음) |
|
|
2037
|
+
| `getEffects` | 도형에 적용된 효과를 반환한다. 적용된 효과만 키로 포함된다.<br>각 값은 대응 setter(setOuterShadow/setInnerShadow/setGlow/setSoftEdge/setReflection/set3d) 의 인자와 같은 형태다.<br>그림자·네온의 alpha 는 불투명(0)이어도 항상 포함되고, 길이(pt)·비율(%)은 소수 첫째 자리로 반올림된다.<br>outerShadow·innerShadow 가 함께 실린 문서면 둘 다 담는다 (setter 로는 하나만 넣을 수 있다). | — | 효과 정보. 적용된 효과가 없으면 빈 객체 `{}`, 대상 도형이 없으면(협업 중 삭제 등) null<br>[`Effects`](#show-effects) (없을 수 있음) |
|
|
2038
|
+
| `setSolidFill` | 도형 채우기를 단색으로 설정한다. | `color` 문자열 — hex (#RRGGBB) 또는 scheme color<br>`alpha` (선택) 숫자 — 투명도 (0~100, 0=불투명). 소수점 셋째 자리까지 저장된다 (기본값: 기존 값 유지) | — |
|
|
2039
2039
|
| `setGradientFill` | 그라데이션 채우기를 설정한다.<br><br><b>Example</b><pre><code>shape.setGradientFill("lin", [{ color: "#FF0000" }, { color: "#0000FF" }], 90);</code></pre> | `type` (선택) [`GradientType`](#show-gradienttype) — 그라데이션 유형 (lin/circle/rect/shape) (기본값: GradientType.LINEAR)<br>`stops` (선택) `{ color: string; pos?: number; alpha?: number }[]` — 색상 변화점. pos 생략 시 균등 분배, alpha 는 투명도(0~100, 0=불투명) (기본값: [{ color: "accent1", pos: 0 }, { color: "bg1", pos: 100 }])<br>`angle` (선택) 숫자 — 그라데이션 각도 (lin 일 때만 사용) (기본값: 45) | — |
|
|
2040
|
-
| `setImageFill` | 이미지 채우기를 설정한다.<br><br><b>Example</b><pre><code>shape.setImageFill(url, ImageFillMode.TILE, 0, { scale: { x: 50, y: 50 }, mirror: "x", align: "tl", rotateWithShape: true });</code></pre> | `imageUrl` 문자열 — 이미지 URL<br>`fillMode` (선택) [`ImageFillMode`](#show-imagefillmode) — 이미지 채우기 방식 (기본값: ImageFillMode.STRETCH)<br>`alpha` (선택) 숫자 — 투명도 (0~100) (기본값: 0
|
|
2040
|
+
| `setImageFill` | 이미지 채우기를 설정한다.<br><br><b>Example</b><pre><code>shape.setImageFill(url, ImageFillMode.TILE, 0, { scale: { x: 50, y: 50 }, mirror: "x", align: "tl", rotateWithShape: true });</code></pre> | `imageUrl` 문자열 — 이미지 URL<br>`fillMode` (선택) [`ImageFillMode`](#show-imagefillmode) — 이미지 채우기 방식 (기본값: ImageFillMode.STRETCH)<br>`alpha` (선택) 숫자 — 투명도 (0~100, 0=불투명) (기본값: 0)<br>`detail` (선택) [`ImageFillDetail`](#show-imagefilldetail) — 세부 옵션. offset/scale/mirror/align 은 fillMode=ImageFillMode.TILE 일 때만 반영 (기본값: {}) | 이미지 업로드 후 채우기 적용이 끝나면 resolve. 대상 도형이 없으면(업로드 중 삭제 포함) SHAPE_NOT_FOUND 로 reject<br>— |
|
|
2041
2041
|
| `removeFill` | 채우기를 제거한다 (noFill). | — | — |
|
|
2042
|
-
| `setPatternFill` | 패턴(무늬) 채우기를 설정한다. (getFill 왕복 대칭
|
|
2043
|
-
| `setFill` | getFill() 이 반환한 채우기 객체를 그대로 적용한다. (getFill 대칭 — 도형→도형 채우기 복사)<br>
|
|
2044
|
-
| `setLineColor` | 선 색상을 설정한다. | `color` 문자열 — hex (#RRGGBB) 또는 scheme color<br>`alpha` (선택) 숫자 — 투명도 (0~100,
|
|
2042
|
+
| `setPatternFill` | 패턴(무늬) 채우기를 설정한다. (getFill 왕복 대칭) | `preset` [`PatternPreset`](#show-patternpreset) — 무늬 프리셋 (apiConstants.PatternPreset)<br>`foreColor` (선택) 문자열 — 전경색 hex (#RRGGBB) 또는 scheme color (기본은 테마 강조색1) (기본값: "accent1")<br>`backColor` (선택) 문자열 — 배경색 hex (#RRGGBB) 또는 scheme color (기본은 테마 배경색1) (기본값: "bg1")<br>`foreAlpha` (선택) 숫자 — 전경색 투명도 (0~100, 0=불투명) (기본값: 0)<br>`backAlpha` (선택) 숫자 — 배경색 투명도 (0~100, 0=불투명) (기본값: 0) | — |
|
|
2043
|
+
| `setFill` | getFill() 이 반환한 채우기 객체를 그대로 적용한다. (getFill 대칭 — 도형→도형 채우기 복사)<br>image 는 조회 결과의 embed 를 재사용하므로 같은 문서 안에서만 복원된다.<br>embed 없는 image 는 적용할 그림이 없어 거부한다 (새 이미지는 setImageFill). | `fill` (선택) [`Fill`](#show-fill) — getFill() 반환값. 생략하면 아무것도 변경하지 않는다 | — |
|
|
2044
|
+
| `setLineColor` | 선 색상을 설정한다. | `color` 문자열 — hex (#RRGGBB) 또는 scheme color<br>`alpha` (선택) 숫자 — 투명도 (0~100, 0=불투명). 소수점 셋째 자리까지 저장된다 (기본값: 기존 값 유지) | — |
|
|
2045
2045
|
| `setLineGradient` | 선(테두리) 그라데이션 채우기를 설정한다.<br><br><b>Example</b><pre><code>shape.setLineGradient("lin", [{ color: "#FF0000" }, { color: "#0000FF" }], 90);</code></pre> | `type` (선택) [`GradientType`](#show-gradienttype) — 그라데이션 유형 (lin/circle/rect/shape) (기본값: GradientType.LINEAR)<br>`stops` (선택) `{ color: string; pos?: number; alpha?: number }[]` — 색상 변화점. pos 생략 시 균등 분배, alpha 는 투명도(0~100, 0=불투명) (기본값: [{ color: "accent1", pos: 0 }, { color: "bg1", pos: 100 }])<br>`angle` (선택) 숫자 — 그라데이션 각도 (lin 일 때만 사용) (기본값: 45) | — |
|
|
2046
2046
|
| `removeLineColor` | 선 색상을 제거한다 (noFill). | — | — |
|
|
2047
2047
|
| `setLineWidth` | 선 두께를 설정한다. | `lineWidth` 숫자 — 선 두께 (pt 단위) | — |
|
|
2048
2048
|
| `setLineDash` | 선 스타일(대시)을 설정한다. | `lineDash` [`LineDash`](#common-linedash) — 선 대시 스타일 | — |
|
|
2049
2049
|
| `setLineCap` | 선 끝 모양(cap)을 설정한다. | `lineCap` [`LineCap`](#show-linecap) — 선 끝 모양 | — |
|
|
2050
2050
|
| `setLineJoin` | 선 연결 유형(join)을 설정한다. | `lineJoin` [`LineJoin`](#show-linejoin) — 선 연결(모서리) 유형 | — |
|
|
2051
|
-
| `setLineStyle` | getLineStyle() 이 반환한 선 스타일 객체를 그대로 적용한다. (getLineStyle 대칭 — 도형→도형 선 복사) | `style` [`LineStyle`](#show-linestyle) — getLineStyle()
|
|
2052
|
-
| `setOuterShadow` | 외부 그림자를 적용한다.
|
|
2053
|
-
| `setInnerShadow` | 내부 그림자를 적용한다.
|
|
2054
|
-
| `setGlow` | 네온(광선) 효과를 적용한다.
|
|
2055
|
-
| `setSoftEdge` | 옅은 테두리(softEdge) 효과를 적용한다.
|
|
2056
|
-
| `setReflection` | 반사 효과를 적용한다.
|
|
2057
|
-
| `removeEffect` | 효과를 제거한다. | `effectType` [`EffectType`](#show-effecttype) — 제거할 효과 타입 | — |
|
|
2058
|
-
| `
|
|
2059
|
-
| `set3d` | 도형에 3D 효과를 적용한다. scene3d 또는 sp3d 중 비어있는 인자는 적용하지 않는다. | `scene3d` (선택) [`Scene3d`](#show-scene3d) — 카메라(회전) 설정 (기본값: 미적용)<br>`sp3d` (선택) [`Sp3d`](#show-sp3d) — 입체(깊이) 설정 (기본값: 미적용) | — |
|
|
2051
|
+
| `setLineStyle` | getLineStyle() 이 반환한 선 스타일 객체를 그대로 적용한다. (getLineStyle 대칭 — 도형→도형 선 복사) | `style` (선택) [`LineStyle`](#show-linestyle) — getLineStyle() 반환값. 생략하면 아무것도 변경하지 않는다 | — |
|
|
2052
|
+
| `setOuterShadow` | 외부 그림자를 적용한다. (getEffects().outerShadow 대칭 - 반환 객체를 그대로 넘길 수 있다)<br>생략한 필드는 기본값으로 채운다 (필드별 기본값은 OuterShadow 참조).<br>도형이 갖는 그림자는 하나다 - 내부 그림자가 걸려 있으면 외부 그림자로 바뀐다. | `shadow` (선택) [`OuterShadow`](#show-outershadow) — 그림자 설정 | — |
|
|
2053
|
+
| `setInnerShadow` | 내부 그림자를 적용한다. (getEffects().innerShadow 대칭 - 반환 객체를 그대로 넘길 수 있다)<br>생략한 필드는 기본값으로 채운다 (필드별 기본값은 InnerShadow 참조).<br>도형이 갖는 그림자는 하나다 - 외부 그림자가 걸려 있으면 내부 그림자로 바뀐다. | `shadow` (선택) [`InnerShadow`](#show-innershadow) — 그림자 설정 | — |
|
|
2054
|
+
| `setGlow` | 네온(광선) 효과를 적용한다. (getEffects().glow 대칭 - 반환 객체를 그대로 넘길 수 있다)<br>생략한 필드는 기본값으로 채운다 (필드별 기본값은 Glow 참조). | `glow` (선택) [`Glow`](#show-glow) — 네온(광선) 설정 | — |
|
|
2055
|
+
| `setSoftEdge` | 옅은 테두리(softEdge) 효과를 적용한다. (getEffects().softEdge 대칭 - 반환 객체를 그대로 넘길 수 있다)<br>생략한 필드는 기본값으로 채운다 (필드별 기본값은 SoftEdge 참조). | `softEdge` (선택) [`SoftEdge`](#show-softedge) — 옅은 테두리 설정 | — |
|
|
2056
|
+
| `setReflection` | 반사 효과를 적용한다. (getEffects().reflection 대칭 - 반환 객체를 그대로 넘길 수 있다)<br>생략한 필드는 기본값으로 채운다 (필드별 기본값은 Reflection 참조). | `reflection` (선택) [`Reflection`](#show-reflection) — 반사 설정 | — |
|
|
2057
|
+
| `removeEffect` | 효과를 제거한다. 그 효과가 걸려 있지 않으면 아무 일도 하지 않는다.<br>도형이 직접 가진 효과만 제거한다 - 도형 스타일(effectRef)에서 상속받은 효과는 제거할 수 없어,<br>getEffects() 가 돌려주는데도 아무 일도 하지 않는 경우가 있다. | `effectType` [`EffectType`](#show-effecttype) — 제거할 효과 타입 | — |
|
|
2058
|
+
| `set3d` | 도형에 3D 효과를 적용한다. scene3d 와 sp3d 중 비어 있는 인자는 적용하지 않는다. | `scene3d` (선택) [`Scene3d`](#show-scene3d) — 카메라(회전) 설정. 생략하면 적용하지 않음<br>`sp3d` (선택) [`Sp3d`](#show-sp3d) — 입체(깊이) 설정. 생략하면 적용하지 않음 | — |
|
|
2060
2059
|
| `remove3d` | 도형의 3D 효과를 제거한다. | — | — |
|
|
2061
|
-
| `setEffects` | getEffects() 가 반환한 효과 객체를 그대로 적용한다. (getEffects 대칭 — 도형→도형 효과 복사)<br>포함된 효과 키만 대응 setter 로 적용한다. scene3d/sp3d 는 set3d 로 함께
|
|
2060
|
+
| `setEffects` | getEffects() 가 반환한 효과 객체를 그대로 적용한다. (getEffects 대칭 — 도형→도형 효과 복사)<br>포함된 효과 키만 대응 setter 로 적용한다. scene3d/sp3d 는 set3d 로 함께 넘긴다.<br>대상의 기존 효과를 지우지는 않는다 - 완전 복사하려면 removeEffect/remove3d 로 먼저 제거한 뒤 적용한다.<br>outerShadow 와 innerShadow 를 함께 넘기면 거부하지 않고 순서대로 적용해 나중 것만 남는다. | `effects` (선택) [`Effects`](#show-effects) — getEffects() 반환값. 생략하면 아무것도 변경하지 않는다 | — |
|
|
2062
2061
|
|
|
2063
2062
|
<a id="show-baseshape"></a>
|
|
2064
2063
|
### BaseShape — 도형 공통 (`BaseShape`)
|
|
2065
2064
|
|
|
2066
|
-
모든 도형 종류가 공유하는 공통 API 로, 위치·크기·회전 조회와 변경(getTransform/moveBy/
|
|
2065
|
+
모든 도형 종류가 공유하는 공통 API 로, 위치·크기·회전 조회와 변경(getTransform/moveBy/setRotation 등), 정렬·순서·뒤집기(align/reorder/flip), 하이퍼링크(getHyperlink/setHyperlink/removeHyperlink), 도형 종류 판별 가드(isShape/isImage/isChart 등)를 제공한다.
|
|
2067
2066
|
|
|
2068
2067
|
| 기능 | 설명 | 입력 | 결과 |
|
|
2069
2068
|
|---|---|---|---|
|
|
@@ -2076,26 +2075,31 @@ Presentation 문서를 다루는 기능입니다. 슬라이드 추가·복제,
|
|
|
2076
2075
|
| `isDiagram` | 이 핸들이 `Diagram` 인지 판별한다 (union 좁히기용 type guard).<br>SDK 핸들의 내부 판별값을 동기 검사한다 — postMessage 왕복 없음, await 불필요. | — | `this is Diagram` |
|
|
2077
2076
|
| `isOleObject` | 이 핸들이 `OleObject` 인지 판별한다 (union 좁히기용 type guard).<br>SDK 핸들의 내부 판별값을 동기 검사한다 — postMessage 왕복 없음, await 불필요. | — | `this is OleObject` |
|
|
2078
2077
|
| `isControl` | 이 핸들이 `Control` 인지 판별한다 (union 좁히기용 type guard).<br>SDK 핸들의 내부 판별값을 동기 검사한다 — postMessage 왕복 없음, await 불필요. | — | `this is Control` |
|
|
2079
|
-
| `getTransform` | 도형의 위치, 크기, 회전 정보를
|
|
2080
|
-
| `getWidth` | 도형의 너비를 반환한다. (setWidth 대칭) | — | 너비 (px 단위).
|
|
2081
|
-
| `getHeight` | 도형의 높이를 반환한다. (setHeight 대칭) | — | 높이 (px 단위).
|
|
2082
|
-
| `getX` | 도형의 X 좌표를 반환한다. (setX 대칭) | — | X 좌표 (px 단위).
|
|
2083
|
-
| `getY` | 도형의 Y 좌표를 반환한다. (setY 대칭) | — | Y 좌표 (px 단위).
|
|
2084
|
-
| `getRotation` | 도형의 회전 각도를 반환한다. (
|
|
2078
|
+
| `getTransform` | 도형의 위치, 크기, 회전 정보를 반환한다.<br>x/y 는 반전(flip) 여부와 무관하게 도형의 좌상단이라, 반환값을 다른 도형의 setTransform 에 그대로 넘기면<br>두 도형이 같은 자리에 놓인다.<br>값은 에디터 입력 단위로 반올림해 반환한다 - 크기는 소수 한 자리, 위치는 정수.<br>setter 도 같은 단위로 넣으므로, 임포트 문서처럼 더 잘게 놓인 도형은 되넘길 때 그만큼 움직인다. | — | 도형의 위치·크기·회전 정보. 대상 도형이 없으면(협업 중 삭제 등) null<br>[`ShapeTransform`](#show-shapetransform) (없을 수 있음) |
|
|
2079
|
+
| `getWidth` | 도형의 너비를 반환한다. (setWidth 대칭) | — | 너비 (px 단위). 대상 도형이 없으면 null<br>숫자 (없을 수 있음) |
|
|
2080
|
+
| `getHeight` | 도형의 높이를 반환한다. (setHeight 대칭) | — | 높이 (px 단위). 대상 도형이 없으면 null<br>숫자 (없을 수 있음) |
|
|
2081
|
+
| `getX` | 도형의 X 좌표를 반환한다. (setX 대칭) | — | X 좌표 (px 단위). 대상 도형이 없으면 null<br>숫자 (없을 수 있음) |
|
|
2082
|
+
| `getY` | 도형의 Y 좌표를 반환한다. (setY 대칭) | — | Y 좌표 (px 단위). 대상 도형이 없으면 null<br>숫자 (없을 수 있음) |
|
|
2083
|
+
| `getRotation` | 도형의 회전 각도를 반환한다. (setRotation 대칭) | — | 회전 각도 (degree). 대상 도형이 없으면 null<br>숫자 (없을 수 있음) |
|
|
2085
2084
|
| `getPresetId` | 도형의 OOXML preset id (prst) 를 반환한다. | — | preset id (prst), 없으면 null<br>문자열 (없을 수 있음) |
|
|
2086
|
-
| `isPlaceholder` | 도형이 placeholder(제목 · 본문 틀 등)인지 반환한다. | — | placeholder
|
|
2087
|
-
| `
|
|
2088
|
-
| `
|
|
2089
|
-
| `
|
|
2090
|
-
| `
|
|
2091
|
-
| `
|
|
2085
|
+
| `isPlaceholder` | 도형이 placeholder(제목 · 본문 틀 등)인지 반환한다. | — | placeholder 여부. 대상 도형이 없으면 null<br>`boolean \| null` |
|
|
2086
|
+
| `getPlaceholderType` | 도형의 placeholder 종류를 반환한다. | — | placeholder 종류. placeholder 가 아니거나 대상 도형이 없으면 null<br>[`PlaceholderType`](#show-placeholdertype) (없을 수 있음) |
|
|
2087
|
+
| `hasText` | 도형이 텍스트를 담고 있는지 반환한다. 에디터가 텍스트를 비었다고 보는 기준과 같다 —<br>공백만 있거나 빈 문단이 둘 이상(개행만 넣은 상태)이면 true, 빈 문단 하나뿐이면 false 다.<br>도형 레벨 텍스트가 없는 종류(표·그룹·차트)는 항상 false 다. (표는 셀 단위로 조회) | — | 텍스트 존재 여부. 대상 도형이 없으면 null<br>`boolean \| null` |
|
|
2088
|
+
| `getZOrderIndex` | 부모(슬라이드, 그룹 자식이면 그 그룹) 안에서 도형의 z-order 순번을 반환한다. 0 이 맨 뒤이며, 클수록 앞이다. | — | z-order 순번. 대상 도형이 없으면 null<br>숫자 (없을 수 있음) |
|
|
2089
|
+
| `isFlippedH` | 도형이 좌우로 반전된 상태인지 반환한다. (flip(FlipDirection.HORIZONTAL) 을 호출하면 이 값이 뒤집힌다) | — | 좌우 반전 여부. 대상 도형이 없으면 null<br>`boolean \| null` |
|
|
2090
|
+
| `isFlippedV` | 도형이 상하로 반전된 상태인지 반환한다. (flip(FlipDirection.VERTICAL) 을 호출하면 이 값이 뒤집힌다) | — | 상하 반전 여부. 대상 도형이 없으면 null<br>`boolean \| null` |
|
|
2091
|
+
| `getHyperlink` | 도형에 설정된 하이퍼링크를 반환한다. 반환 객체를 그대로 setHyperlink 에 넘길 수 있다.<br>지원하지 않는 종류(프로그램 실행·매크로 등)가 걸려 있으면 null 이다. | — | 하이퍼링크 정보. 하이퍼링크(action)가 없으면 null<br>[`Hyperlink`](#show-hyperlink) (없을 수 있음) |
|
|
2092
|
+
| `setWidth` | 도형의 너비를 설정한다. 크기 조정이 불가능한 도형이면 무시된다. | `width` 숫자 — 너비 (px 단위, 소수 한 자리로 반올림) | — |
|
|
2093
|
+
| `setHeight` | 도형의 높이를 설정한다. 크기 조정이 불가능한 도형이면 무시된다. | `height` 숫자 — 높이 (px 단위, 소수 한 자리로 반올림) | — |
|
|
2094
|
+
| `setX` | 도형의 X 좌표를 절대값으로 설정한다. 이동이 불가능한 도형이면 무시된다. (상대 이동은 moveBy) | `x` 숫자 — X 좌표 (px 단위, 정수로 반올림) | — |
|
|
2095
|
+
| `setY` | 도형의 Y 좌표를 절대값으로 설정한다. 이동이 불가능한 도형이면 무시된다. | `y` 숫자 — Y 좌표 (px 단위, 정수로 반올림) | — |
|
|
2092
2096
|
| `moveBy` | 도형을 현재 위치 기준으로 x, y 만큼 상대 이동한다. (절대 좌표 설정은 setX / setY) | `distance` [`ShapeMoveDistance`](#show-shapemovedistance) — 이동량 (px 단위) | — |
|
|
2093
|
-
| `
|
|
2094
|
-
| `setTransform` | 도형의 위치·크기·회전을 한 번에 설정한다. getTransform() 반환값을 그대로 넘길 수 있다. (getTransform 대칭)<br
|
|
2095
|
-
| `flip` | 도형을 상하 또는 좌우로 반전한다. | `direction` [`FlipDirection`](#show-flipdirection) — 반전 방향 | — |
|
|
2096
|
-
| `reorder` | 도형의 정렬 순서(앞으로/뒤로)를 변경한다. | `order` [`ShapeZOrder`](#common-shapezorder) — 순서 변경 타입 | — |
|
|
2097
|
-
| `align` | 도형을 슬라이드 기준으로 정렬한다. | `alignType` [`AlignType`](#show-aligntype) — 정렬 타입 | — |
|
|
2098
|
-
| `setHyperlink` | 도형에 하이퍼링크를 설정한다. (getHyperlink 대칭 — 반환 객체를 그대로 넘겨 하이퍼링크를 복사할 수 있다)<br
|
|
2097
|
+
| `setRotation` | 도형의 회전 각도를 절대값으로 설정한다. 회전이 불가능한 도형이면 무시된다. (getRotation 대칭) | `rotation` 숫자 — 회전 각도 (degree) | — |
|
|
2098
|
+
| `setTransform` | 도형의 위치·크기·회전을 한 번에 설정한다. getTransform() 반환값을 그대로 넘길 수 있다. (getTransform 대칭)<br>값을 준 필드만 크기→위치→회전 순으로 적용하고, 생략한 필드는 현재 값을 유지한다.<br>각 필드는 개별 setter 와 같이 해당 조작(크기/이동/회전)이 불가능한 도형에서 무시된다. | `transform` (선택) `Partial<ShapeTransform>` — 위치/크기 (px) · 회전 (degree) | — |
|
|
2099
|
+
| `flip` | 도형을 상하 또는 좌우로 반전한다. 현재 반전 상태를 뒤집는 토글이며, 지금 반전돼 있는지는<br>isFlippedH()/isFlippedV() 로 읽는다. 회전이 불가능한 도형에서는 반전도 무시된다.<br>회전된 도형은 각도도 거울상으로 함께 바뀐다 (getRotation() 값이 360 - 기존 각도 로 바뀐다). | `direction` [`FlipDirection`](#show-flipdirection) — 반전 방향 | — |
|
|
2100
|
+
| `reorder` | 도형의 정렬 순서(앞으로/뒤로)를 변경한다. 이미 목표 위치라 바뀔 것이 없으면 무시된다. | `order` [`ShapeZOrder`](#common-shapezorder) — 순서 변경 타입 | — |
|
|
2101
|
+
| `align` | 도형을 슬라이드 기준으로 정렬한다. 이동이 불가능한 도형이면 무시된다.<br>그룹 자식도 그룹 안이 아니라 슬라이드를 기준으로 움직인다(에디터와 같다).<br>자식이 그룹 밖으로 나가면 그룹이 자식을 담도록 함께 넓어진다. | `alignType` [`AlignType`](#show-aligntype) — 정렬 타입 | — |
|
|
2102
|
+
| `setHyperlink` | 도형에 하이퍼링크를 설정한다. (getHyperlink 대칭 — 반환 객체를 그대로 넘겨 하이퍼링크를 복사할 수 있다)<br>지원하지 않는 종류나 유효하지 않은 대상(없는 슬라이드 id 등)은 무시한다. | `hyperlink` [`Hyperlink`](#show-hyperlink) — getHyperlink() 반환값과 같은 Hyperlink 객체. type 이 없으면 무시한다 | — |
|
|
2099
2103
|
| `removeHyperlink` | 도형의 하이퍼링크를 제거한다. | — | — |
|
|
2100
2104
|
|
|
2101
2105
|
<a id="show-chart"></a>
|
|
@@ -2173,32 +2177,35 @@ Presentation 문서를 다루는 기능입니다. 슬라이드 추가·복제,
|
|
|
2173
2177
|
|
|
2174
2178
|
| 기능 | 설명 | 입력 | 결과 |
|
|
2175
2179
|
|---|---|---|---|
|
|
2176
|
-
| `getChildren` | 그룹의 자식 도형 목록을 반환한다. | — | 자식 도형
|
|
2177
|
-
| `ungroup` | 그룹을 해제하여 자식
|
|
2180
|
+
| `getChildren` | 그룹의 자식 도형 목록을 반환한다. | — | 자식 도형 목록. 그룹 도형이 없으면(협업 중 삭제 등) 빈 배열<br>`(Shape \| Image \| Line \| Group \| Chart \| Table \| Diagram \| OleObject \| Control)[]` |
|
|
2181
|
+
| `ungroup` | 그룹을 해제하여 자식 도형을 슬라이드 최상위로 분리한다.<br>해제 후 이 Group 인스턴스와 미리 얻어 둔 자식 프록시는 무효가 된다 (자식이 새 id 를 받는다). | — | 분리된 자식 도형 배열<br>`(Shape \| Image \| Line \| Group \| Chart \| Table \| Diagram \| OleObject \| Control)[]` |
|
|
2178
2182
|
|
|
2179
2183
|
<a id="show-image"></a>
|
|
2180
2184
|
### Image — 이미지 (`Image`)
|
|
2181
2185
|
|
|
2182
|
-
이미지 도형을 다루는 핸들로, 원본 크기 되돌리기(
|
|
2186
|
+
이미지 도형을 다루는 핸들로, 원본 크기 되돌리기(resetSize)와 이미지 자르기 조회·설정(getCrop/setCrop)을 제공하며, 위치·크기·채우기·선·효과는 BasePathShape 공통 API 를 그대로 쓴다.
|
|
2183
2187
|
|
|
2184
2188
|
> 📎 [**BasePathShape**](#show-basepathshape)의 모든 기능을 포함합니다 (아래는 추가 기능).
|
|
2185
2189
|
|
|
2186
2190
|
| 기능 | 설명 | 입력 | 결과 |
|
|
2187
2191
|
|---|---|---|---|
|
|
2188
|
-
| `
|
|
2189
|
-
| `
|
|
2192
|
+
| `getCrop` | 이미지에 적용된 자르기(crop) 상태를 반환한다. (setCrop 대칭 - 반환 객체를 그대로 넘길 수 있다)<br>모든 값의 단위는 퍼센트다 (-100~100). 자르지 않은 방향은 0 이고, 음수는 바깥 여백이다. | — | 자르기 상태. 대상 이미지가 없으면 null<br>[`ImageCrop`](#show-imagecrop) (없을 수 있음) |
|
|
2193
|
+
| `resetSize` | 이미지를 문서에 실린 원본 크기로 되돌린다. 자르기(crop)가 있으면 함께 제거한다. | — | — |
|
|
2194
|
+
| `setCrop` | 이미지를 지정한 방향으로 자른다. (getCrop 대칭 - 반환 객체를 그대로 넘길 수 있다)<br>지정한 방향만 적용하고 생략한 방향은 기존 값을 유지한다. 자르기를 없애려면 0 을 명시한다.<br>모든 값의 단위는 퍼센트다 (-100~100). 양수는 그 방향을 잘라 내고, 음수는 바깥 여백을 만든다.<br>병합 결과가 지금 값과 같으면 아무것도 하지 않는다. | `crop` `Partial<ImageCrop>` — 자르기 설정 | — |
|
|
2190
2195
|
|
|
2191
2196
|
<a id="show-line"></a>
|
|
2192
2197
|
### Line — 선 (`Line`)
|
|
2193
2198
|
|
|
2194
|
-
연결선을 다루는 핸들로, 시작·끝 화살표
|
|
2199
|
+
연결선을 다루는 핸들로, 시작·끝 화살표 조회·설정(getHeadEnd/getTailEnd/setHeadEnd/setTailEnd)을 제공하고 선 색·두께·점선 등 선 서식은 BasePathShape 공통 API 를 그대로 쓰며, 회전·반전은 지원하지 않아(에디터 UI 도 같은 제약) 물려받은 setRotation/flip 은 액션을 만들지 않고 무시된다.
|
|
2195
2200
|
|
|
2196
2201
|
> 📎 [**BasePathShape**](#show-basepathshape)의 모든 기능을 포함합니다 (아래는 추가 기능).
|
|
2197
2202
|
|
|
2198
2203
|
| 기능 | 설명 | 입력 | 결과 |
|
|
2199
2204
|
|---|---|---|---|
|
|
2200
|
-
| `
|
|
2201
|
-
| `
|
|
2205
|
+
| `getHeadEnd` | 연결선의 시작 화살표(headEnd)를 반환한다. (setHeadEnd 대칭 - 반환 객체를 그대로 넘길 수 있다) | — | 시작 화살표 설정. 대상 연결선이 없으면 null. 화살표가 없는 상태는 null 이 아니라 type 이 LineEndType.NONE 인 객체다<br>[`LineEnd`](#show-lineend) (없을 수 있음) |
|
|
2206
|
+
| `getTailEnd` | 연결선의 끝 화살표(tailEnd)를 반환한다. (setTailEnd 대칭 - 반환 객체를 그대로 넘길 수 있다) | — | 끝 화살표 설정. 대상 연결선이 없으면 null. 화살표가 없는 상태는 null 이 아니라 type 이 LineEndType.NONE 인 객체다<br>[`LineEnd`](#show-lineend) (없을 수 있음) |
|
|
2207
|
+
| `setHeadEnd` | 연결선의 시작 화살표(headEnd)를 설정한다. (getHeadEnd 대칭 - 반환 객체를 그대로 넘길 수 있다)<br>화살표를 없애려면 type 에 LineEndType.NONE 을 준다.<br>width/length 를 생략하면 기존 크기가 아니라 기본값(MEDIUM)이 적용된다. | `lineEnd` `Partial<LineEnd> & {type: LineEndType}` — 화살표 설정 | — |
|
|
2208
|
+
| `setTailEnd` | 연결선의 끝 화살표(tailEnd)를 설정한다. (getTailEnd 대칭 - 반환 객체를 그대로 넘길 수 있다)<br>화살표를 없애려면 type 에 LineEndType.NONE 을 준다.<br>width/length 를 생략하면 기존 크기가 아니라 기본값(MEDIUM)이 적용된다. | `lineEnd` `Partial<LineEnd> & {type: LineEndType}` — 화살표 설정 | — |
|
|
2202
2209
|
|
|
2203
2210
|
<a id="show-oleobject"></a>
|
|
2204
2211
|
### OleObject (`OleObject`)
|
|
@@ -2219,53 +2226,56 @@ OLE 개체를 다루는 핸들로, 내용 편집은 지원하지 않으며 위
|
|
|
2219
2226
|
|
|
2220
2227
|
| 기능 | 설명 | 입력 | 결과 |
|
|
2221
2228
|
|---|---|---|---|
|
|
2222
|
-
| `getParagraphStyle` | 대표 단락(range 가 걸친 첫 단락)의 단락 서식을 반환한다. (setParagraphStyle 대칭)<br>반환 객체를 그대로 다른 개체의 setParagraphStyle 에 넘길 수 있다. 값이 없는 속성은 키를
|
|
2223
|
-
| `getAlignH` | 대표 단락의 가로 정렬을 반환한다. (setAlignH 대칭) | `range` (선택) `
|
|
2224
|
-
| `getLineSpacing` | 대표 단락의 줄 간격 값을 반환한다. (setLineSpacing 대칭) | `range` (선택) `
|
|
2225
|
-
| `getLineSpacingType` | 대표 단락의 줄 간격 유형을 반환한다. (setLineSpacing 의 type 대칭) | `range` (선택) `
|
|
2226
|
-
| `getSpaceBefore` | 대표 단락의 단락 앞 간격(UI "문단 위")을 반환한다. (setSpaceBefore 대칭) | `range` (선택) `
|
|
2227
|
-
| `getSpaceAfter` | 대표 단락의 단락 뒤 간격(UI "문단 아래")을 반환한다. (setSpaceAfter 대칭) | `range` (선택) `
|
|
2228
|
-
| `getMarginLeft` | 대표 단락의 왼쪽 여백(UI "텍스트 앞")을 반환한다. (setMarginLeft 대칭) | `range` (선택) `
|
|
2229
|
-
| `getFirstLineIndent` | 대표 단락의 첫 줄 들여쓰기(UI "첫 줄")를 반환한다. (setFirstLineIndent 대칭) | `range` (선택) `
|
|
2230
|
-
| `getLevel` | 대표 단락의 목록 수준을 반환한다. (setLevel 대칭) | `range` (선택) `
|
|
2231
|
-
| `
|
|
2232
|
-
| `
|
|
2233
|
-
| `
|
|
2234
|
-
| `
|
|
2235
|
-
| `
|
|
2236
|
-
| `
|
|
2237
|
-
| `
|
|
2238
|
-
| `
|
|
2239
|
-
| `
|
|
2240
|
-
| `
|
|
2241
|
-
| `
|
|
2242
|
-
| `
|
|
2229
|
+
| `getParagraphStyle` | 대표 단락(range 가 걸친 첫 단락)의 단락 서식을 반환한다. (setParagraphStyle 대칭)<br>반환 객체를 그대로 다른 개체의 setParagraphStyle 에 넘길 수 있다. 값이 없는 속성은 키를 담지 않는다.<br>값은 레이아웃/마스터 상속까지 반영해 실제 적용된 값이라 단락이 직접 지정한 값만 골라낼 수는 없고,<br>같은 단락에 그대로 다시 넘기면 상속값과 같은 속성은 직접 지정으로 남지 않는다.<br>목록 수준은 서식 값이 아니라 상속 프리셋이라 담지 않는다. (getLevel 대칭) | `range` (선택) [`TextRange`](#show-textrange) — 읽을 텍스트 구간 (기본값: 전체 텍스트) | 단락 서식. 텍스트/단락 없으면 null<br>[`ParagraphStyle`](#show-paragraphstyle) (없을 수 있음) |
|
|
2230
|
+
| `getAlignH` | 대표 단락의 가로 정렬을 반환한다. (setAlignH 대칭) | `range` (선택) [`TextRange`](#show-textrange) — 읽을 텍스트 구간 (기본값: 전체 텍스트) | 가로 정렬. 텍스트/단락 없으면 null<br>[`TextAlignH`](#show-textalignh) (없을 수 있음) |
|
|
2231
|
+
| `getLineSpacing` | 대표 단락의 줄 간격 값을 반환한다. (setLineSpacing 대칭) | `range` (선택) [`TextRange`](#show-textrange) — 읽을 텍스트 구간 (기본값: 전체 텍스트) | 줄 간격 값 (MULTIPLE: 배수%, EXACT: pt). 텍스트/단락 없으면 null<br>숫자 (없을 수 있음) |
|
|
2232
|
+
| `getLineSpacingType` | 대표 단락의 줄 간격 유형을 반환한다. (setLineSpacing 의 type 대칭) | `range` (선택) [`TextRange`](#show-textrange) — 읽을 텍스트 구간 (기본값: 전체 텍스트) | 줄 간격 유형. 텍스트/단락 없으면 null<br>[`LineSpacingType`](#show-linespacingtype) (없을 수 있음) |
|
|
2233
|
+
| `getSpaceBefore` | 대표 단락의 단락 앞 간격(UI "문단 위")을 반환한다. (setSpaceBefore 대칭) | `range` (선택) [`TextRange`](#show-textrange) — 읽을 텍스트 구간 (기본값: 전체 텍스트) | 단락 앞 간격 (pt). 배수(%) 저장/텍스트 없음이면 null<br>숫자 (없을 수 있음) |
|
|
2234
|
+
| `getSpaceAfter` | 대표 단락의 단락 뒤 간격(UI "문단 아래")을 반환한다. (setSpaceAfter 대칭) | `range` (선택) [`TextRange`](#show-textrange) — 읽을 텍스트 구간 (기본값: 전체 텍스트) | 단락 뒤 간격 (pt). 배수(%) 저장/텍스트 없음이면 null<br>숫자 (없을 수 있음) |
|
|
2235
|
+
| `getMarginLeft` | 대표 단락의 왼쪽 여백(UI "텍스트 앞")을 반환한다. (setMarginLeft 대칭) | `range` (선택) [`TextRange`](#show-textrange) — 읽을 텍스트 구간 (기본값: 전체 텍스트) | 왼쪽 여백 (pt). 텍스트/단락 없으면 null<br>숫자 (없을 수 있음) |
|
|
2236
|
+
| `getFirstLineIndent` | 대표 단락의 첫 줄 들여쓰기(UI "첫 줄")를 반환한다. (setFirstLineIndent 대칭) | `range` (선택) [`TextRange`](#show-textrange) — 읽을 텍스트 구간 (기본값: 전체 텍스트) | 첫 줄 들여쓰기 (pt, 음수는 내어쓰기). 텍스트/단락 없으면 null<br>숫자 (없을 수 있음) |
|
|
2237
|
+
| `getLevel` | 대표 단락의 목록 수준을 반환한다. (setLevel 대칭) | `range` (선택) [`TextRange`](#show-textrange) — 읽을 텍스트 구간 (기본값: 전체 텍스트) | 목록 수준 (1~9). 텍스트/단락 없으면 null<br>숫자 (없을 수 있음) |
|
|
2238
|
+
| `getBulletStyle` | 대표 단락의 글머리 기호 스타일을 반환한다. 반환 필드를 풀어서 setBulletStyle(type, subType, startAt) 에 넘길 수 있다.<br>값은 레이아웃/마스터 상속까지 반영해 실제 적용된 값이고, 없는 값(시작 번호)과 되넘길 수 없는 값(프리셋 밖 번호 유형)은 키를 담지 않는다.<br>그림 글머리·프리셋 밖 문자는 조회 전용이라 그대로는 적용되지 않는다. (제약은 setBulletStyle 참조) | `range` (선택) [`TextRange`](#show-textrange) — 읽을 텍스트 구간 (기본값: 전체 텍스트) | 글머리 기호 스타일. 텍스트/단락 없으면 null<br>[`BulletStyle`](#show-bulletstyle) (없을 수 있음) |
|
|
2239
|
+
| `getText` | 텍스트를 plain text로 반환한다. 문단 사이의 개행은 그대로 들어가지만,<br>마지막 문단을 끝맺는 개행은 글자가 아니라 담지 않는다 (빈 텍스트는 ""). | `range` (선택) [`TextRange`](#show-textrange) — 읽을 텍스트 구간 (UTF-16 코드 단위 offset) (기본값: 전체 텍스트) | 해당 구간의 텍스트 (plain text). 텍스트 모델이 없거나 빈 구간이면 ""<br>문자열 |
|
|
2240
|
+
| `getFontStyle` | 대표 run(range 가 걸친 첫 run)의 글꼴 스타일을 반환한다. (setFontStyle 대칭)<br>반환 객체를 그대로 다른 개체의 setFontStyle 에 넘길 수 있다. 값이 없는 속성은 키를 담지 않는다.<br>값은 레이아웃/마스터/표 스타일 상속까지 반영해 실제 적용된 값이라 run 이 직접 지정한 값만 골라낼 수는 없다. | `range` (선택) [`TextRange`](#show-textrange) — 읽을 텍스트 구간 (기본값: 전체 텍스트) | 글꼴 스타일. run/스타일 없으면 빈 객체 `{}`, 대상 텍스트가 없거나(협업 중 삭제 등) 유효하지 않은 구간이면 null<br>[`FontStyle`](#show-fontstyle) (없을 수 있음) |
|
|
2241
|
+
| `getBold` | 대표 run 의 굵게 여부를 반환한다. (setBold 대칭 — 상속까지 반영된 실제 적용값) | `range` (선택) [`TextRange`](#show-textrange) — 읽을 텍스트 구간 (기본값: 전체 텍스트) | 굵게 여부. 대상 텍스트가 없거나 유효하지 않은 구간이면 null<br>`boolean \| null` |
|
|
2242
|
+
| `getItalic` | 대표 run 의 기울임 여부를 반환한다. (setItalic 대칭 — 상속까지 반영된 실제 적용값) | `range` (선택) [`TextRange`](#show-textrange) — 읽을 텍스트 구간 (기본값: 전체 텍스트) | 기울임 여부. 대상 텍스트가 없거나 유효하지 않은 구간이면 null<br>`boolean \| null` |
|
|
2243
|
+
| `getUnderline` | 대표 run 의 밑줄 유형을 반환한다. (setUnderline 대칭 — 상속까지 반영된 실제 적용값) | `range` (선택) [`TextRange`](#show-textrange) — 읽을 텍스트 구간 (기본값: 전체 텍스트) | 밑줄 유형. 대상 텍스트가 없거나 유효하지 않은 구간이면 null<br>[`Underline`](#show-underline) (없을 수 있음) |
|
|
2244
|
+
| `getStrike` | 대표 run 의 취소선 유형을 반환한다. (setStrike 대칭 — 상속까지 반영된 실제 적용값) | `range` (선택) [`TextRange`](#show-textrange) — 읽을 텍스트 구간 (기본값: 전체 텍스트) | 취소선 유형. 대상 텍스트가 없거나 유효하지 않은 구간이면 null<br>[`Strike`](#show-strike) (없을 수 있음) |
|
|
2245
|
+
| `getFontSize` | 대표 run 의 글자 크기(pt)를 반환한다. (setFontSize 대칭 — 상속까지 반영된 실제 적용값) | `range` (선택) [`TextRange`](#show-textrange) — 읽을 텍스트 구간 (기본값: 전체 텍스트) | 글자 크기 (pt). 대상 텍스트가 없거나 유효하지 않은 구간이면 null<br>숫자 (없을 수 있음) |
|
|
2246
|
+
| `getFontFamily` | 대표 run 의 글꼴 이름을 반환한다. (setFontFamily 대칭 — 상속까지 반영된 실제 적용값) | `range` (선택) [`TextRange`](#show-textrange) — 읽을 텍스트 구간 (기본값: 전체 텍스트) | 글꼴 이름. 대상 텍스트가 없거나 유효하지 않은 구간이면 null<br>문자열 (없을 수 있음) |
|
|
2247
|
+
| `getTextColor` | 대표 run 의 글자 색상을 반환한다. (setTextColor 대칭 — 상속까지 반영된 실제 적용값) | `range` (선택) [`TextRange`](#show-textrange) — 읽을 텍스트 구간 (기본값: 전체 텍스트) | 글자 색상 (hex "#RRGGBB" — scheme color 도 hex 로 풀려서 나온다). solid 채우기가 아니거나 대상 텍스트가 없거나 유효하지 않은 구간이면 null<br>문자열 (없을 수 있음) |
|
|
2248
|
+
| `getTextHyperlink` | 텍스트 구간의 하이퍼링크를 반환한다. (setTextHyperlink 대칭 — 반환 객체를 그대로 넘겨 복사할 수 있다)<br>range 를 주면 그 구간의 첫 글자, range 가 없으면 텍스트의 첫 글자가 속한 run 을 기준으로 한다.<br>도형 자체에 걸린 하이퍼링크는 getHyperlink 로 읽는다. | `range` (선택) [`TextRange`](#show-textrange) — 조회할 텍스트 구간 (기본값: 텍스트 첫 글자) | 하이퍼링크 정보 (getHyperlink 와 같은 Hyperlink 객체). 링크 없음/텍스트 없음/미노출 action 이면 null<br>[`Hyperlink`](#show-hyperlink) (없을 수 있음) |
|
|
2249
|
+
| `getTextboxAutoFit` | 텍스트 상자 자동 맞춤 유형을 반환한다. (setTextboxAutoFit 대칭) | — | 자동 맞춤 유형. 대상 텍스트가 없으면 null<br>[`AutoFitType`](#show-autofittype) (없을 수 있음) |
|
|
2250
|
+
| `getAlignV` | 텍스트 세로 정렬을 반환한다. (setAlignV 대칭)<br>TextAlignV 는 TOP 이 0 인 숫자 enum 이라, 값이 있는지는 truthy 검사가 아니라 null 비교로 본다. | — | 세로 정렬. 대상 텍스트가 없으면 null<br>[`TextAlignV`](#show-textalignv) (없을 수 있음) |
|
|
2251
|
+
| `setText` | 텍스트를 설정한다. 인자 조합에 따라 다음과 같이 동작한다.<br>- range 없음: 전체 텍스트를 text 로 교체<br>- range 있음: 지정한 구간만 text 로 교체<br>- text 가 빈 문자열("")이면 교체 대신 해당 범위를 삭제<br><br>삭제 없이 끼워넣는 삽입은 insertText 를 사용한다.<br>(단, from 이 텍스트 끝이면 지울 글자가 없어 끝 삽입으로 동작).<br><br>대체된 자리의 글자 서식은 구간 시작 위치의 글자 서식을, 문단 서식은 기존 문단의 서식을 따른다. | `text` 문자열 — 설정할 텍스트. 빈 문자열("")이면 삭제로 동작<br>`range` (선택) [`TextRange`](#show-textrange) — 교체할 텍스트 구간 to = from + 글자수 - 1 (0-based) 예: "가나다" 전체 = {from: 0, to: 2}, "가나다" 중 "가" = {from: 0, to: 0} offset 은 UTF-16 코드 단위라 서로게이트 페어를 가르는 range 는 반쪽이 아니라 그 글자 전체가 대상이 된다 (range 를 받는 서식 setter 도 같다) (기본값: 전체 텍스트) | — |
|
|
2243
2252
|
| `insertText` | 텍스트를 삽입한다.<br>삽입한 글자의 서식은 삽입 지점 바로 앞 글자의 런 서식을 따른다. | `text` 문자열 — 삽입할 텍스트<br>`textOffset` (선택) 숫자 — 삽입 위치 offset (기본값: 텍스트 끝) | — |
|
|
2244
|
-
| `setFontStyle` | 글꼴 스타일을 설정한다. 단일 속성은 setBold/setItalic/setFontSize/setFontFamily/setTextColor 사용 권장. | `style` [`FontStyle`](#show-fontstyle) — 글꼴 스타일 설정<br>`range` (선택) `
|
|
2245
|
-
| `setBold` |
|
|
2246
|
-
| `setItalic` | 글자
|
|
2247
|
-
| `setUnderline` | 글자
|
|
2248
|
-
| `setStrike` | 글자
|
|
2249
|
-
| `setFontSize` | 글자
|
|
2250
|
-
| `setFontFamily` |
|
|
2251
|
-
| `setTextColor` | 글자
|
|
2252
|
-
| `setTextHyperlink` | 텍스트에 하이퍼링크를 설정한다. (getTextHyperlink 대칭 — 반환 객체를 그대로 넘겨 링크를 복사할 수 있다)<br>도형 전체에 링크를 거는 setHyperlink 와 달리 글자(run)
|
|
2253
|
-
| `removeTextHyperlink` | 텍스트의 하이퍼링크를 제거한다. (도형 자체에 걸린 하이퍼링크는 removeHyperlink) | `range` (선택) `
|
|
2253
|
+
| `setFontStyle` | 글꼴 스타일을 설정한다. 단일 속성은 setBold/setItalic/setFontSize/setFontFamily/setTextColor 사용 권장. | `style` [`FontStyle`](#show-fontstyle) — 글꼴 스타일 설정<br>`range` (선택) [`TextRange`](#show-textrange) — 적용할 텍스트 구간 (기본값: 전체 텍스트) | — |
|
|
2254
|
+
| `setBold` | 글자를 굵게 설정한다. | `enabled` 참/거짓 — true: 굵게, false: 해제<br>`range` (선택) [`TextRange`](#show-textrange) — 적용할 텍스트 구간 (기본값: 전체 텍스트) | — |
|
|
2255
|
+
| `setItalic` | 글자 기울임을 설정한다. | `enabled` 참/거짓 — true: 기울임, false: 해제<br>`range` (선택) [`TextRange`](#show-textrange) — 적용할 텍스트 구간 (기본값: 전체 텍스트) | — |
|
|
2256
|
+
| `setUnderline` | 글자 밑줄을 설정한다. | `underline` [`Underline`](#show-underline) — 밑줄 유형<br>`range` (선택) [`TextRange`](#show-textrange) — 적용할 텍스트 구간 (기본값: 전체 텍스트) | — |
|
|
2257
|
+
| `setStrike` | 글자 취소선을 설정한다. | `strike` [`Strike`](#show-strike) — 취소선 유형<br>`range` (선택) [`TextRange`](#show-textrange) — 적용할 텍스트 구간 (기본값: 전체 텍스트) | — |
|
|
2258
|
+
| `setFontSize` | 글자 크기를 설정한다. | `fontSize` 숫자 — pt 단위<br>`range` (선택) [`TextRange`](#show-textrange) — 적용할 텍스트 구간 (기본값: 전체 텍스트) | — |
|
|
2259
|
+
| `setFontFamily` | 글꼴을 설정한다. | `fontFamily` 문자열 — 글꼴 이름<br>`range` (선택) [`TextRange`](#show-textrange) — 적용할 텍스트 구간 (기본값: 전체 텍스트) | — |
|
|
2260
|
+
| `setTextColor` | 글자 색상을 설정한다. | `color` 문자열 — hex (#RRGGBB) 또는 scheme color<br>`range` (선택) [`TextRange`](#show-textrange) — 적용할 텍스트 구간 (기본값: 전체 텍스트) | — |
|
|
2261
|
+
| `setTextHyperlink` | 텍스트에 하이퍼링크를 설정한다. (getTextHyperlink 대칭 — 반환 객체를 그대로 넘겨 링크를 복사할 수 있다)<br>도형 전체에 링크를 거는 setHyperlink 와 달리 링크가 글자(run) 단위로 걸리며 하이퍼링크 서식으로 표시된다.<br>지원하지 않는 종류나 유효하지 않은 대상(없는 슬라이드 id 등)은 무시한다. | `hyperlink` [`Hyperlink`](#show-hyperlink) — getTextHyperlink() 반환값과 같은 Hyperlink 객체. type 이 없으면 무시한다<br>`range` (선택) [`TextRange`](#show-textrange) — 적용할 텍스트 구간 (기본값: 전체 텍스트) | — |
|
|
2262
|
+
| `removeTextHyperlink` | 텍스트의 하이퍼링크를 제거한다. (도형 자체에 걸린 하이퍼링크는 removeHyperlink) | `range` (선택) [`TextRange`](#show-textrange) — 제거할 텍스트 구간 (기본값: 전체 텍스트) | — |
|
|
2254
2263
|
| `insertSymbol` | 지정한 offset 위치에 특수문자(symbol)를 삽입한다. | `textOffset` 숫자 — 삽입 위치 offset<br>`symbol` 문자열 — 삽입할 특수문자 | — |
|
|
2255
|
-
| `setAlignH` | 텍스트 가로 정렬을 설정한다. range 를 주면 그 구간이 걸친 단락에만 적용한다. | `align` [`TextAlignH`](#show-textalignh) — 가로 정렬<br>`range` (선택) `
|
|
2256
|
-
| `setParagraphStyle` | 단락 서식을 한 번에 설정한다. range 를 주면 그 구간이 걸친 단락에만 적용한다.<br
|
|
2257
|
-
| `setLineSpacing` | 줄 간격을 설정한다. range 를 주면 그 구간이 걸친 단락에만 적용한다.<br>MULTIPLE 이면
|
|
2258
|
-
| `setSpaceBefore` | 단락 앞 간격(UI "문단 위")을 설정한다. | `spaceBefore` 숫자 — 단락 앞 간격 (pt)<br>`range` (선택) `
|
|
2259
|
-
| `setSpaceAfter` | 단락 뒤 간격(UI "문단 아래")을 설정한다. | `spaceAfter` 숫자 — 단락 뒤 간격 (pt)<br>`range` (선택) `
|
|
2260
|
-
| `setMarginLeft` | 단락 전체의 왼쪽 여백(UI "텍스트 앞")을 설정한다. 첫 줄만
|
|
2261
|
-
| `setFirstLineIndent` | 단락 첫 줄의 들여쓰기(UI "첫 줄")를 설정한다. 둘째 줄부터는 marginLeft 를 따른다.<br>양수는 들여쓰기, 음수는 내어쓰기, 0 은
|
|
2262
|
-
| `setLevel` | 목록 수준(개요 계층 깊이)을 설정한다. range 가 걸친 단락을 모두 같은 수준으로 맞춘다.<br>pt 단위 들여쓰기(setFirstLineIndent/setMarginLeft)와 달리 수준은 상속 프리셋 선택이라,<br>바꾸면 그 수준의 글머리
|
|
2263
|
-
| `setBulletStyle` | 글머리 기호 스타일을 설정한다. | `bulletType`
|
|
2264
|
-
| `setAlignV` | 텍스트 세로 정렬을 설정한다. | `align` [`TextAlignV`](#show-textalignv) — 세로 정렬 | — |
|
|
2265
|
-
| `setTextboxAutoFit` | 텍스트 상자 자동 맞춤 유형을 설정한다. | `autoAlignType` [`AutoFitType`](#show-autofittype) — 자동 맞춤 유형 | — |
|
|
2266
|
-
| `getAdjustValues` | 일반 도형에 정의된 조절값과 조절 가능한 범위를 반환한다. 반환된 name은 조절값 조회와 변경 API에서 사용한다. | — | 조절값
|
|
2267
|
-
| `
|
|
2268
|
-
| `
|
|
2264
|
+
| `setAlignH` | 텍스트 가로 정렬을 설정한다. range 를 주면 그 구간이 걸친 단락에만 적용한다. | `align` [`TextAlignH`](#show-textalignh) — 가로 정렬<br>`range` (선택) [`TextRange`](#show-textrange) — 적용할 텍스트 구간 (기본값: 전체 텍스트) | — |
|
|
2265
|
+
| `setParagraphStyle` | 단락 서식을 한 번에 설정한다. range 를 주면 그 구간이 걸친 단락에만 적용한다.<br>값을 준 속성만 바뀐다. null/undefined 는 "변경 없음"으로 무시하며, 지정한 값을 상속 상태로 되돌리는 방법은 아직 없다.<br>단일 속성은 setLineSpacing/setMarginLeft/setFirstLineIndent/setSpaceBefore/setSpaceAfter 사용 권장.<br>목록 수준은 바꿀 때 딸려오는 부수 효과(글머리 기호·글자 크기)가 있어 여기 담지 않는다. (setLevel 참고) | `style` [`ParagraphStyle`](#show-paragraphstyle) — 단락 서식 설정<br>`range` (선택) [`TextRange`](#show-textrange) — 적용할 텍스트 구간 (기본값: 전체 텍스트) | — |
|
|
2266
|
+
| `setLineSpacing` | 줄 간격을 설정한다. range 를 주면 그 구간이 걸친 단락에만 적용한다.<br>lineSpacing 의 단위는 유형에 따라 다르다 - MULTIPLE 이면 배수 백분율(150=1.5배), EXACT 이면 pt 다. | `lineSpacing` 숫자 — 줄 간격 값 (MULTIPLE: 배수%, EXACT: pt)<br>`type` (선택) [`LineSpacingType`](#show-linespacingtype) — 줄 간격 유형 (기본값: LineSpacingType.MULTIPLE)<br>`range` (선택) [`TextRange`](#show-textrange) — 적용할 텍스트 구간 (기본값: 전체 텍스트) | — |
|
|
2267
|
+
| `setSpaceBefore` | 단락 앞 간격(UI "문단 위")을 설정한다. | `spaceBefore` 숫자 — 단락 앞 간격 (pt)<br>`range` (선택) [`TextRange`](#show-textrange) — 적용할 텍스트 구간 (기본값: 전체 텍스트) | — |
|
|
2268
|
+
| `setSpaceAfter` | 단락 뒤 간격(UI "문단 아래")을 설정한다. | `spaceAfter` 숫자 — 단락 뒤 간격 (pt)<br>`range` (선택) [`TextRange`](#show-textrange) — 적용할 텍스트 구간 (기본값: 전체 텍스트) | — |
|
|
2269
|
+
| `setMarginLeft` | 단락 전체의 왼쪽 여백(UI "텍스트 앞")을 설정한다. 첫 줄만 들여쓰려면 setFirstLineIndent 를 사용한다. | `marginLeft` 숫자 — 왼쪽 여백 (pt)<br>`range` (선택) [`TextRange`](#show-textrange) — 적용할 텍스트 구간 (기본값: 전체 텍스트) | — |
|
|
2270
|
+
| `setFirstLineIndent` | 단락 첫 줄의 들여쓰기(UI "첫 줄")를 설정한다. 둘째 줄부터는 marginLeft 를 따른다.<br>양수는 들여쓰기, 음수는 내어쓰기, 0 은 들여쓰기 없음이다.<br>글머리 기호 목록의 계층 깊이를 바꾸려면 setLevel 을 사용한다. | `firstLineIndent` 숫자 — 첫 줄 들여쓰기 (pt)<br>`range` (선택) [`TextRange`](#show-textrange) — 적용할 텍스트 구간 (기본값: 전체 텍스트) | — |
|
|
2271
|
+
| `setLevel` | 목록 수준(개요 계층 깊이)을 설정한다. range 가 걸친 단락을 모두 같은 수준으로 맞춘다.<br>pt 단위 들여쓰기(setFirstLineIndent/setMarginLeft)와 달리 수준은 상속 프리셋 선택이라,<br>바꾸면 그 수준의 글머리 기호·글자 크기가 따라오고 marginLeft 는 새 수준의 값으로 덮인다.<br>setMarginLeft 로 지정한 값도 버려지므로 둘을 함께 쓸 때는 setLevel 을 먼저 호출한다. (firstLineIndent 는 유지)<br>대상 텍스트가 허용하는 범위(제목 개체는 1 수준뿐)로 제한한다. | `level` 숫자 — 목록 수준 (1=최상위 ~ 9)<br>`range` (선택) [`TextRange`](#show-textrange) — 적용할 텍스트 구간 (기본값: 전체 텍스트) | — |
|
|
2272
|
+
| `setBulletStyle` | 글머리 기호 스타일을 설정한다. (getBulletStyle 대칭)<br>그림 글머리(BulletType.BLIP)는 적용을 지원하지 않는 조회 전용 유형이라 거부한다.<br>CharType 프리셋 밖의 문자도 적용할 수 없다 (조회 전용이라 받을 인자가 없다). | `bulletType` `Exclude<BulletType, "buBlip">` — 글머리 기호 유형<br>`subType` (선택) `NumberedType \| CharType` — BulletType.AUTO_NUM: 번호 매기기 유형 (기본값 NumberedType.NUMBER_WITH_DOT), BulletType.CHAR: 글머리 문자 유형 (기본값 CharType.DOT)<br>`startAt` (선택) 숫자 — 시작 번호 (BulletType.AUTO_NUM 일 때만 사용) (기본값: 1)<br>`range` (선택) [`TextRange`](#show-textrange) — 적용할 텍스트 구간 (기본값: 전체 텍스트) | — |
|
|
2273
|
+
| `setAlignV` | 텍스트 세로 정렬을 설정한다. (getAlignV 대칭) | `align` [`TextAlignV`](#show-textalignv) — 세로 정렬 | — |
|
|
2274
|
+
| `setTextboxAutoFit` | 텍스트 상자 자동 맞춤 유형을 설정한다. 이미 같은 유형이면 아무것도 하지 않는다. | `autoAlignType` [`AutoFitType`](#show-autofittype) — 자동 맞춤 유형 | — |
|
|
2275
|
+
| `getAdjustValues` | 일반 도형에 정의된 조절값과 조절 가능한 범위를 반환한다. 반환된 name 은 조절값 조회와 변경 API 에서 사용한다. | — | 조절값 목록. 대상 도형이 없으면(협업 중 삭제 등) null<br>`AdjustValue[] \| null` |
|
|
2276
|
+
| `isFlatTx` | 3D 회전 시 텍스트를 평면으로 유지하는지 반환한다. (setFlatTx 대칭) | — | 텍스트 평면 유지 여부. 대상 도형이 없으면 null<br>`boolean \| null` |
|
|
2277
|
+
| `setFlatTx` | 3D 회전 시 텍스트를 평면으로 유지할지 설정한다. (isFlatTx 대칭) | `enabled` 참/거짓 — true 이면 텍스트 평면 유지, false 이면 해제 | — |
|
|
2278
|
+
| `setAdjustValue` | 일반 도형의 조절값(adjust value) 하나를 변경한다. 여러 조절값을 함께 변경하려면 setAdjustValues 를 사용한다. | `name` 문자열 — 조절값 이름(getAdjustValues 결과)<br>`value` 숫자 — 조절값. 정수로 반올림되며 허용 범위를 벗어나면 최솟값 또는 최댓값으로 제한됨 (getAdjustValues 의 min/max 가 null 인 경우처럼 범위를 알 수 없으면 제한하지 않는다) | — |
|
|
2269
2279
|
| `setAdjustValues` | 일반 도형의 여러 조절값(adjust value)을 한 번에 변경한다. | `avList` [`AdjustValueUpdate`](#show-adjustvalueupdate) 목록 — 변경할 조절값 목록 | — |
|
|
2270
2280
|
|
|
2271
2281
|
<a id="show-table"></a>
|
|
@@ -2277,25 +2287,27 @@ OLE 개체를 다루는 핸들로, 내용 편집은 지원하지 않으며 위
|
|
|
2277
2287
|
|
|
2278
2288
|
| 기능 | 설명 | 입력 | 결과 |
|
|
2279
2289
|
|---|---|---|---|
|
|
2280
|
-
| `getRowCount` | 표의 행 개수를 반환한다. | — | 행
|
|
2281
|
-
| `getColCount` | 표의 열 개수를 반환한다. | — | 열
|
|
2282
|
-
| `getCell` |
|
|
2290
|
+
| `getRowCount` | 표의 행 개수를 반환한다. | — | 행 개수. 표가 없으면 0<br>숫자 |
|
|
2291
|
+
| `getColCount` | 표의 열 개수를 반환한다. | — | 열 개수. 표가 없으면 0<br>숫자 |
|
|
2292
|
+
| `getCell` | 지정 좌표의 셀을 반환한다. 병합 영역 내부 좌표를 지정하면 그 병합 영역의 대표 셀을 반환한다. | `row` 숫자 — 행 인덱스 (0-based)<br>`col` 숫자 — 열 인덱스 (0-based) | 해당 셀 (범위를 벗어나면 null)<br>[`TableCell`](#show-tablecell) (없을 수 있음) |
|
|
2283
2293
|
| `getCells` | 모든 셀을 배열로 반환한다.<br>병합된 셀은 대표 셀 하나만 포함한다. | — | 셀 목록<br>[`TableCell`](#show-tablecell) 목록 |
|
|
2284
|
-
| `findCells` | 조건에 맞는 셀 배열을 반환한다.<br>복수 조건은 AND로
|
|
2294
|
+
| `findCells` | 조건에 맞는 셀 배열을 반환한다.<br>복수 조건은 AND 로 결합한다. range 는 셀 본체가 범위와 겹치면 매칭된다<br>(병합 대표 셀이 범위 밖에 있어도 셀 일부가 범위 안이면 결과에 포함된다).<br>그 외 조건은 병합된 셀의 대표 셀 좌표/속성 기준으로 평가한다. | `filter` (선택) [`CellFilter`](#show-cellfilter) — 검색 조건. null 도 조건 없음으로 본다 (기본값: 전체 셀) | 조건에 맞는 셀 목록<br>[`TableCell`](#show-tablecell) 목록 |
|
|
2285
2295
|
| `getColWidth` | 지정 열의 너비를 반환한다. (setColWidth 대칭) | `colIndex` 숫자 — 열 인덱스 (0-based) | 너비 (px 단위), 범위 밖이면 null<br>숫자 (없을 수 있음) |
|
|
2286
2296
|
| `getRowHeight` | 지정 행의 높이를 반환한다. (setRowHeight 대칭) | `rowIndex` 숫자 — 행 인덱스 (0-based) | 높이 (px 단위), 범위 밖이면 null<br>숫자 (없을 수 있음) |
|
|
2287
2297
|
| `getRow` | 지정 행의 셀 배열을 반환한다.<br>병합된 셀은 대표 셀 하나만 포함한다. | `rowIndex` 숫자 — 0-based 행 인덱스 | 해당 행의 셀 목록<br>[`TableCell`](#show-tablecell) 목록 |
|
|
2288
2298
|
| `getColumn` | 지정 열의 셀 배열을 반환한다.<br>병합된 셀은 대표 셀 하나만 포함한다. | `colIndex` 숫자 — 0-based 열 인덱스 | 해당 열의 셀 목록<br>[`TableCell`](#show-tablecell) 목록 |
|
|
2289
|
-
| `
|
|
2290
|
-
| `
|
|
2291
|
-
| `
|
|
2292
|
-
| `
|
|
2299
|
+
| `getStyleName` | 표에 적용된 스타일 이름을 반환한다. (setStyle 대칭)<br>반환한 이름은 그대로 setStyle 에 되먹일 수 있다. 다만 문서에만 실려 있고 편집기 갤러리에는<br>없는 스타일이면 doc.getTableStyleNames() 목록에는 나오지 않는다. | — | 표 스타일 이름. 스타일이 없거나 이름이 없는 스타일(문서가 이름을 싣지 않은 경우)이면 null<br>문자열 (없을 수 있음) |
|
|
2300
|
+
| `getStyleOption` | 표 스타일 옵션(머리글 행, 줄무늬 행 등)의 활성화 여부를 반환한다. (setStyleOption 대칭) | `option` [`TableStyleOption`](#show-tablestyleoption) — 옵션 유형 (apiConstants.TableStyleOption) | 활성화 여부. 표나 표 속성을 읽을 수 없으면 null<br>`boolean \| null` |
|
|
2301
|
+
| `setStyle` | 표 스타일을 변경한다. (getStyleName 대칭) | `styleName` 문자열 — 표 스타일 이름 (doc.getTableStyleNames() 결과) | — |
|
|
2302
|
+
| `setStyleOption` | 표 스타일 옵션(머리글 행, 줄무늬 행 등)을 변경한다. (getStyleOption 대칭) | `option` [`TableStyleOption`](#show-tablestyleoption) — 옵션 유형 (apiConstants.TableStyleOption)<br>`enabled` 참/거짓 — 활성화 여부 | — |
|
|
2303
|
+
| `mergeCell` | 지정 범위의 셀을 병합한다. | `startRow` 숫자 — 병합 시작 행 인덱스 (0-based)<br>`startCol` 숫자 — 병합 시작 열 인덱스 (0-based)<br>`endRow` 숫자 — 병합 끝 행 인덱스 (0-based, inclusive)<br>`endCol` 숫자 — 병합 끝 열 인덱스 (0-based, inclusive) | — |
|
|
2304
|
+
| `unmergeCell` | 지정 범위의 병합된 셀을 해제한다. | `startRow` 숫자 — 해제 시작 행 인덱스 (0-based)<br>`startCol` 숫자 — 해제 시작 열 인덱스 (0-based)<br>`endRow` 숫자 — 해제 끝 행 인덱스 (0-based, inclusive)<br>`endCol` 숫자 — 해제 끝 열 인덱스 (0-based, inclusive) | — |
|
|
2293
2305
|
| `insertRow` | 기준 행의 위 또는 아래에 행을 삽입한다.<br>새 행은 기준 행의 서식을 상속한다. | `baseRowIndex` 숫자 — 삽입 기준 행 인덱스 (0-based)<br>`position` [`InsertPosition`](#show-insertposition) — InsertPosition.ABOVE \| InsertPosition.BELOW<br>`insertNum` 숫자 — 삽입할 행 개수 | — |
|
|
2294
|
-
| `deleteRow` | 지정 범위의 행을 삭제한다. | `startRow` 숫자 — 삭제 시작 행 인덱스 (0-based)<br>`endRow` 숫자 — 삭제 끝 행 인덱스 | — |
|
|
2306
|
+
| `deleteRow` | 지정 범위의 행을 삭제한다. 모든 행을 지울 수는 없다 - 한 행짜리 표에서 그 행을 지우려 하면 오류가 난다.<br>표 자체를 없애려면 Slide.deleteShape 를 쓴다. | `startRow` 숫자 — 삭제 시작 행 인덱스 (0-based)<br>`endRow` 숫자 — 삭제 끝 행 인덱스 (0-based, inclusive) | — |
|
|
2295
2307
|
| `insertCol` | 기준 열의 왼쪽 또는 오른쪽에 열을 삽입한다.<br>새 열은 기준 열의 서식을 상속한다. | `baseColIndex` 숫자 — 삽입 기준 열 인덱스 (0-based)<br>`position` [`InsertPosition`](#show-insertposition) — InsertPosition.LEFT \| InsertPosition.RIGHT<br>`insertNum` 숫자 — 삽입할 열 개수 | — |
|
|
2296
|
-
| `deleteCol` | 지정 범위의 열을 삭제한다. | `startCol` 숫자 — 삭제 시작 열 인덱스 (0-based)<br>`endCol` 숫자 — 삭제 끝 열 인덱스 | — |
|
|
2297
|
-
| `setRowHeight` | 지정 행의 높이를 변경한다. | `rowIndex` 숫자 — 행 인덱스 (0-based)<br>`newHeight` 숫자 — 새 높이 (px 단위) | — |
|
|
2298
|
-
| `setColWidth` | 지정 열의 너비를 변경한다. | `colIndex` 숫자 — 열 인덱스 (0-based)<br>`newWidth` 숫자 — 새 너비 (px 단위) | — |
|
|
2308
|
+
| `deleteCol` | 지정 범위의 열을 삭제한다. 모든 열을 지울 수는 없다 - 한 열짜리 표에서 그 열을 지우려 하면 오류가 난다.<br>표 자체를 없애려면 Slide.deleteShape 를 쓴다. | `startCol` 숫자 — 삭제 시작 열 인덱스 (0-based)<br>`endCol` 숫자 — 삭제 끝 열 인덱스 (0-based, inclusive) | — |
|
|
2309
|
+
| `setRowHeight` | 지정 행의 높이를 변경한다. | `rowIndex` 숫자 — 행 인덱스 (0-based)<br>`newHeight` 숫자 — 새 높이 (px 단위). rowIndex 가 표의 행 수를 벗어나면 무시된다 | — |
|
|
2310
|
+
| `setColWidth` | 지정 열의 너비를 변경한다. | `colIndex` 숫자 — 열 인덱스 (0-based)<br>`newWidth` 숫자 — 새 너비 (px 단위). colIndex 가 표의 열 수를 벗어나면 무시된다 | — |
|
|
2299
2311
|
|
|
2300
2312
|
<a id="show-tablecell"></a>
|
|
2301
2313
|
### TableCell — 표 셀 (`TableCell`)
|
|
@@ -2305,58 +2317,62 @@ OLE 개체를 다루는 핸들로, 내용 편집은 지원하지 않으며 위
|
|
|
2305
2317
|
| 기능 | 설명 | 입력 | 결과 |
|
|
2306
2318
|
|---|---|---|---|
|
|
2307
2319
|
| `isShape` | 이 핸들이 `Shape` 인지 판별한다 (union 좁히기용 type guard).<br>SDK 핸들의 내부 판별값을 동기 검사한다 — postMessage 왕복 없음, await 불필요. | — | `this is Shape` |
|
|
2308
|
-
| `getParagraphStyle` | 대표 단락(range 가 걸친 첫 단락)의 단락 서식을 반환한다. (setParagraphStyle 대칭)<br>반환 객체를 그대로 다른 개체의 setParagraphStyle 에 넘길 수 있다. 값이 없는 속성은 키를
|
|
2309
|
-
| `getAlignH` | 대표 단락의 가로 정렬을 반환한다. (setAlignH 대칭) | `range` (선택) `
|
|
2310
|
-
| `getLineSpacing` | 대표 단락의 줄 간격 값을 반환한다. (setLineSpacing 대칭) | `range` (선택) `
|
|
2311
|
-
| `getLineSpacingType` | 대표 단락의 줄 간격 유형을 반환한다. (setLineSpacing 의 type 대칭) | `range` (선택) `
|
|
2312
|
-
| `getSpaceBefore` | 대표 단락의 단락 앞 간격(UI "문단 위")을 반환한다. (setSpaceBefore 대칭) | `range` (선택) `
|
|
2313
|
-
| `getSpaceAfter` | 대표 단락의 단락 뒤 간격(UI "문단 아래")을 반환한다. (setSpaceAfter 대칭) | `range` (선택) `
|
|
2314
|
-
| `getMarginLeft` | 대표 단락의 왼쪽 여백(UI "텍스트 앞")을 반환한다. (setMarginLeft 대칭) | `range` (선택) `
|
|
2315
|
-
| `getFirstLineIndent` | 대표 단락의 첫 줄 들여쓰기(UI "첫 줄")를 반환한다. (setFirstLineIndent 대칭) | `range` (선택) `
|
|
2316
|
-
| `getLevel` | 대표 단락의 목록 수준을 반환한다. (setLevel 대칭) | `range` (선택) `
|
|
2317
|
-
| `
|
|
2318
|
-
| `
|
|
2319
|
-
| `
|
|
2320
|
-
| `
|
|
2321
|
-
| `
|
|
2322
|
-
| `
|
|
2323
|
-
| `
|
|
2324
|
-
| `
|
|
2325
|
-
| `
|
|
2326
|
-
| `
|
|
2327
|
-
| `
|
|
2328
|
-
| `
|
|
2320
|
+
| `getParagraphStyle` | 대표 단락(range 가 걸친 첫 단락)의 단락 서식을 반환한다. (setParagraphStyle 대칭)<br>반환 객체를 그대로 다른 개체의 setParagraphStyle 에 넘길 수 있다. 값이 없는 속성은 키를 담지 않는다.<br>값은 레이아웃/마스터 상속까지 반영해 실제 적용된 값이라 단락이 직접 지정한 값만 골라낼 수는 없고,<br>같은 단락에 그대로 다시 넘기면 상속값과 같은 속성은 직접 지정으로 남지 않는다.<br>목록 수준은 서식 값이 아니라 상속 프리셋이라 담지 않는다. (getLevel 대칭) | `range` (선택) [`TextRange`](#show-textrange) — 읽을 텍스트 구간 (기본값: 전체 텍스트) | 단락 서식. 텍스트/단락 없으면 null<br>[`ParagraphStyle`](#show-paragraphstyle) (없을 수 있음) |
|
|
2321
|
+
| `getAlignH` | 대표 단락의 가로 정렬을 반환한다. (setAlignH 대칭) | `range` (선택) [`TextRange`](#show-textrange) — 읽을 텍스트 구간 (기본값: 전체 텍스트) | 가로 정렬. 텍스트/단락 없으면 null<br>[`TextAlignH`](#show-textalignh) (없을 수 있음) |
|
|
2322
|
+
| `getLineSpacing` | 대표 단락의 줄 간격 값을 반환한다. (setLineSpacing 대칭) | `range` (선택) [`TextRange`](#show-textrange) — 읽을 텍스트 구간 (기본값: 전체 텍스트) | 줄 간격 값 (MULTIPLE: 배수%, EXACT: pt). 텍스트/단락 없으면 null<br>숫자 (없을 수 있음) |
|
|
2323
|
+
| `getLineSpacingType` | 대표 단락의 줄 간격 유형을 반환한다. (setLineSpacing 의 type 대칭) | `range` (선택) [`TextRange`](#show-textrange) — 읽을 텍스트 구간 (기본값: 전체 텍스트) | 줄 간격 유형. 텍스트/단락 없으면 null<br>[`LineSpacingType`](#show-linespacingtype) (없을 수 있음) |
|
|
2324
|
+
| `getSpaceBefore` | 대표 단락의 단락 앞 간격(UI "문단 위")을 반환한다. (setSpaceBefore 대칭) | `range` (선택) [`TextRange`](#show-textrange) — 읽을 텍스트 구간 (기본값: 전체 텍스트) | 단락 앞 간격 (pt). 배수(%) 저장/텍스트 없음이면 null<br>숫자 (없을 수 있음) |
|
|
2325
|
+
| `getSpaceAfter` | 대표 단락의 단락 뒤 간격(UI "문단 아래")을 반환한다. (setSpaceAfter 대칭) | `range` (선택) [`TextRange`](#show-textrange) — 읽을 텍스트 구간 (기본값: 전체 텍스트) | 단락 뒤 간격 (pt). 배수(%) 저장/텍스트 없음이면 null<br>숫자 (없을 수 있음) |
|
|
2326
|
+
| `getMarginLeft` | 대표 단락의 왼쪽 여백(UI "텍스트 앞")을 반환한다. (setMarginLeft 대칭) | `range` (선택) [`TextRange`](#show-textrange) — 읽을 텍스트 구간 (기본값: 전체 텍스트) | 왼쪽 여백 (pt). 텍스트/단락 없으면 null<br>숫자 (없을 수 있음) |
|
|
2327
|
+
| `getFirstLineIndent` | 대표 단락의 첫 줄 들여쓰기(UI "첫 줄")를 반환한다. (setFirstLineIndent 대칭) | `range` (선택) [`TextRange`](#show-textrange) — 읽을 텍스트 구간 (기본값: 전체 텍스트) | 첫 줄 들여쓰기 (pt, 음수는 내어쓰기). 텍스트/단락 없으면 null<br>숫자 (없을 수 있음) |
|
|
2328
|
+
| `getLevel` | 대표 단락의 목록 수준을 반환한다. (setLevel 대칭) | `range` (선택) [`TextRange`](#show-textrange) — 읽을 텍스트 구간 (기본값: 전체 텍스트) | 목록 수준 (1~9). 텍스트/단락 없으면 null<br>숫자 (없을 수 있음) |
|
|
2329
|
+
| `getBulletStyle` | 대표 단락의 글머리 기호 스타일을 반환한다. 반환 필드를 풀어서 setBulletStyle(type, subType, startAt) 에 넘길 수 있다.<br>값은 레이아웃/마스터 상속까지 반영해 실제 적용된 값이고, 없는 값(시작 번호)과 되넘길 수 없는 값(프리셋 밖 번호 유형)은 키를 담지 않는다.<br>그림 글머리·프리셋 밖 문자는 조회 전용이라 그대로는 적용되지 않는다. (제약은 setBulletStyle 참조) | `range` (선택) [`TextRange`](#show-textrange) — 읽을 텍스트 구간 (기본값: 전체 텍스트) | 글머리 기호 스타일. 텍스트/단락 없으면 null<br>[`BulletStyle`](#show-bulletstyle) (없을 수 있음) |
|
|
2330
|
+
| `getText` | 텍스트를 plain text로 반환한다. 문단 사이의 개행은 그대로 들어가지만,<br>마지막 문단을 끝맺는 개행은 글자가 아니라 담지 않는다 (빈 텍스트는 ""). | `range` (선택) [`TextRange`](#show-textrange) — 읽을 텍스트 구간 (UTF-16 코드 단위 offset) (기본값: 전체 텍스트) | 해당 구간의 텍스트 (plain text). 텍스트 모델이 없거나 빈 구간이면 ""<br>문자열 |
|
|
2331
|
+
| `getFontStyle` | 대표 run(range 가 걸친 첫 run)의 글꼴 스타일을 반환한다. (setFontStyle 대칭)<br>반환 객체를 그대로 다른 개체의 setFontStyle 에 넘길 수 있다. 값이 없는 속성은 키를 담지 않는다.<br>값은 레이아웃/마스터/표 스타일 상속까지 반영해 실제 적용된 값이라 run 이 직접 지정한 값만 골라낼 수는 없다. | `range` (선택) [`TextRange`](#show-textrange) — 읽을 텍스트 구간 (기본값: 전체 텍스트) | 글꼴 스타일. run/스타일 없으면 빈 객체 `{}`, 대상 텍스트가 없거나(협업 중 삭제 등) 유효하지 않은 구간이면 null<br>[`FontStyle`](#show-fontstyle) (없을 수 있음) |
|
|
2332
|
+
| `getBold` | 대표 run 의 굵게 여부를 반환한다. (setBold 대칭 — 상속까지 반영된 실제 적용값) | `range` (선택) [`TextRange`](#show-textrange) — 읽을 텍스트 구간 (기본값: 전체 텍스트) | 굵게 여부. 대상 텍스트가 없거나 유효하지 않은 구간이면 null<br>`boolean \| null` |
|
|
2333
|
+
| `getItalic` | 대표 run 의 기울임 여부를 반환한다. (setItalic 대칭 — 상속까지 반영된 실제 적용값) | `range` (선택) [`TextRange`](#show-textrange) — 읽을 텍스트 구간 (기본값: 전체 텍스트) | 기울임 여부. 대상 텍스트가 없거나 유효하지 않은 구간이면 null<br>`boolean \| null` |
|
|
2334
|
+
| `getUnderline` | 대표 run 의 밑줄 유형을 반환한다. (setUnderline 대칭 — 상속까지 반영된 실제 적용값) | `range` (선택) [`TextRange`](#show-textrange) — 읽을 텍스트 구간 (기본값: 전체 텍스트) | 밑줄 유형. 대상 텍스트가 없거나 유효하지 않은 구간이면 null<br>[`Underline`](#show-underline) (없을 수 있음) |
|
|
2335
|
+
| `getStrike` | 대표 run 의 취소선 유형을 반환한다. (setStrike 대칭 — 상속까지 반영된 실제 적용값) | `range` (선택) [`TextRange`](#show-textrange) — 읽을 텍스트 구간 (기본값: 전체 텍스트) | 취소선 유형. 대상 텍스트가 없거나 유효하지 않은 구간이면 null<br>[`Strike`](#show-strike) (없을 수 있음) |
|
|
2336
|
+
| `getFontSize` | 대표 run 의 글자 크기(pt)를 반환한다. (setFontSize 대칭 — 상속까지 반영된 실제 적용값) | `range` (선택) [`TextRange`](#show-textrange) — 읽을 텍스트 구간 (기본값: 전체 텍스트) | 글자 크기 (pt). 대상 텍스트가 없거나 유효하지 않은 구간이면 null<br>숫자 (없을 수 있음) |
|
|
2337
|
+
| `getFontFamily` | 대표 run 의 글꼴 이름을 반환한다. (setFontFamily 대칭 — 상속까지 반영된 실제 적용값) | `range` (선택) [`TextRange`](#show-textrange) — 읽을 텍스트 구간 (기본값: 전체 텍스트) | 글꼴 이름. 대상 텍스트가 없거나 유효하지 않은 구간이면 null<br>문자열 (없을 수 있음) |
|
|
2338
|
+
| `getTextColor` | 대표 run 의 글자 색상을 반환한다. (setTextColor 대칭 — 상속까지 반영된 실제 적용값) | `range` (선택) [`TextRange`](#show-textrange) — 읽을 텍스트 구간 (기본값: 전체 텍스트) | 글자 색상 (hex "#RRGGBB" — scheme color 도 hex 로 풀려서 나온다). solid 채우기가 아니거나 대상 텍스트가 없거나 유효하지 않은 구간이면 null<br>문자열 (없을 수 있음) |
|
|
2339
|
+
| `getTextHyperlink` | 텍스트 구간의 하이퍼링크를 반환한다. (setTextHyperlink 대칭 — 반환 객체를 그대로 넘겨 복사할 수 있다)<br>range 를 주면 그 구간의 첫 글자, range 가 없으면 텍스트의 첫 글자가 속한 run 을 기준으로 한다.<br>도형 자체에 걸린 하이퍼링크는 getHyperlink 로 읽는다. | `range` (선택) [`TextRange`](#show-textrange) — 조회할 텍스트 구간 (기본값: 텍스트 첫 글자) | 하이퍼링크 정보 (getHyperlink 와 같은 Hyperlink 객체). 링크 없음/텍스트 없음/미노출 action 이면 null<br>[`Hyperlink`](#show-hyperlink) (없을 수 있음) |
|
|
2340
|
+
| `getTextboxAutoFit` | 텍스트 상자 자동 맞춤 유형을 반환한다. (setTextboxAutoFit 대칭) | — | 자동 맞춤 유형. 대상 텍스트가 없으면 null<br>[`AutoFitType`](#show-autofittype) (없을 수 있음) |
|
|
2341
|
+
| `getAlignV` | 텍스트 세로 정렬을 반환한다. (setAlignV 대칭)<br>TextAlignV 는 TOP 이 0 인 숫자 enum 이라, 값이 있는지는 truthy 검사가 아니라 null 비교로 본다. | — | 세로 정렬. 대상 텍스트가 없으면 null<br>[`TextAlignV`](#show-textalignv) (없을 수 있음) |
|
|
2342
|
+
| `setText` | 텍스트를 설정한다. 인자 조합에 따라 다음과 같이 동작한다.<br>- range 없음: 전체 텍스트를 text 로 교체<br>- range 있음: 지정한 구간만 text 로 교체<br>- text 가 빈 문자열("")이면 교체 대신 해당 범위를 삭제<br><br>삭제 없이 끼워넣는 삽입은 insertText 를 사용한다.<br>(단, from 이 텍스트 끝이면 지울 글자가 없어 끝 삽입으로 동작).<br><br>대체된 자리의 글자 서식은 구간 시작 위치의 글자 서식을, 문단 서식은 기존 문단의 서식을 따른다. | `text` 문자열 — 설정할 텍스트. 빈 문자열("")이면 삭제로 동작<br>`range` (선택) [`TextRange`](#show-textrange) — 교체할 텍스트 구간 to = from + 글자수 - 1 (0-based) 예: "가나다" 전체 = {from: 0, to: 2}, "가나다" 중 "가" = {from: 0, to: 0} offset 은 UTF-16 코드 단위라 서로게이트 페어를 가르는 range 는 반쪽이 아니라 그 글자 전체가 대상이 된다 (range 를 받는 서식 setter 도 같다) (기본값: 전체 텍스트) | — |
|
|
2329
2343
|
| `insertText` | 텍스트를 삽입한다.<br>삽입한 글자의 서식은 삽입 지점 바로 앞 글자의 런 서식을 따른다. | `text` 문자열 — 삽입할 텍스트<br>`textOffset` (선택) 숫자 — 삽입 위치 offset (기본값: 텍스트 끝) | — |
|
|
2330
|
-
| `setFontStyle` | 글꼴 스타일을 설정한다. 단일 속성은 setBold/setItalic/setFontSize/setFontFamily/setTextColor 사용 권장. | `style` [`FontStyle`](#show-fontstyle) — 글꼴 스타일 설정<br>`range` (선택) `
|
|
2331
|
-
| `setBold` |
|
|
2332
|
-
| `setItalic` | 글자
|
|
2333
|
-
| `setUnderline` | 글자
|
|
2334
|
-
| `setStrike` | 글자
|
|
2335
|
-
| `setFontSize` | 글자
|
|
2336
|
-
| `setFontFamily` |
|
|
2337
|
-
| `setTextColor` | 글자
|
|
2338
|
-
| `setTextHyperlink` | 텍스트에 하이퍼링크를 설정한다. (getTextHyperlink 대칭 — 반환 객체를 그대로 넘겨 링크를 복사할 수 있다)<br>도형 전체에 링크를 거는 setHyperlink 와 달리 글자(run)
|
|
2339
|
-
| `removeTextHyperlink` | 텍스트의 하이퍼링크를 제거한다. (도형 자체에 걸린 하이퍼링크는 removeHyperlink) | `range` (선택) `
|
|
2344
|
+
| `setFontStyle` | 글꼴 스타일을 설정한다. 단일 속성은 setBold/setItalic/setFontSize/setFontFamily/setTextColor 사용 권장. | `style` [`FontStyle`](#show-fontstyle) — 글꼴 스타일 설정<br>`range` (선택) [`TextRange`](#show-textrange) — 적용할 텍스트 구간 (기본값: 전체 텍스트) | — |
|
|
2345
|
+
| `setBold` | 글자를 굵게 설정한다. | `enabled` 참/거짓 — true: 굵게, false: 해제<br>`range` (선택) [`TextRange`](#show-textrange) — 적용할 텍스트 구간 (기본값: 전체 텍스트) | — |
|
|
2346
|
+
| `setItalic` | 글자 기울임을 설정한다. | `enabled` 참/거짓 — true: 기울임, false: 해제<br>`range` (선택) [`TextRange`](#show-textrange) — 적용할 텍스트 구간 (기본값: 전체 텍스트) | — |
|
|
2347
|
+
| `setUnderline` | 글자 밑줄을 설정한다. | `underline` [`Underline`](#show-underline) — 밑줄 유형<br>`range` (선택) [`TextRange`](#show-textrange) — 적용할 텍스트 구간 (기본값: 전체 텍스트) | — |
|
|
2348
|
+
| `setStrike` | 글자 취소선을 설정한다. | `strike` [`Strike`](#show-strike) — 취소선 유형<br>`range` (선택) [`TextRange`](#show-textrange) — 적용할 텍스트 구간 (기본값: 전체 텍스트) | — |
|
|
2349
|
+
| `setFontSize` | 글자 크기를 설정한다. | `fontSize` 숫자 — pt 단위<br>`range` (선택) [`TextRange`](#show-textrange) — 적용할 텍스트 구간 (기본값: 전체 텍스트) | — |
|
|
2350
|
+
| `setFontFamily` | 글꼴을 설정한다. | `fontFamily` 문자열 — 글꼴 이름<br>`range` (선택) [`TextRange`](#show-textrange) — 적용할 텍스트 구간 (기본값: 전체 텍스트) | — |
|
|
2351
|
+
| `setTextColor` | 글자 색상을 설정한다. | `color` 문자열 — hex (#RRGGBB) 또는 scheme color<br>`range` (선택) [`TextRange`](#show-textrange) — 적용할 텍스트 구간 (기본값: 전체 텍스트) | — |
|
|
2352
|
+
| `setTextHyperlink` | 텍스트에 하이퍼링크를 설정한다. (getTextHyperlink 대칭 — 반환 객체를 그대로 넘겨 링크를 복사할 수 있다)<br>도형 전체에 링크를 거는 setHyperlink 와 달리 링크가 글자(run) 단위로 걸리며 하이퍼링크 서식으로 표시된다.<br>지원하지 않는 종류나 유효하지 않은 대상(없는 슬라이드 id 등)은 무시한다. | `hyperlink` [`Hyperlink`](#show-hyperlink) — getTextHyperlink() 반환값과 같은 Hyperlink 객체. type 이 없으면 무시한다<br>`range` (선택) [`TextRange`](#show-textrange) — 적용할 텍스트 구간 (기본값: 전체 텍스트) | — |
|
|
2353
|
+
| `removeTextHyperlink` | 텍스트의 하이퍼링크를 제거한다. (도형 자체에 걸린 하이퍼링크는 removeHyperlink) | `range` (선택) [`TextRange`](#show-textrange) — 제거할 텍스트 구간 (기본값: 전체 텍스트) | — |
|
|
2340
2354
|
| `insertSymbol` | 지정한 offset 위치에 특수문자(symbol)를 삽입한다. | `textOffset` 숫자 — 삽입 위치 offset<br>`symbol` 문자열 — 삽입할 특수문자 | — |
|
|
2341
|
-
| `setAlignH` | 텍스트 가로 정렬을 설정한다. range 를 주면 그 구간이 걸친 단락에만 적용한다. | `align` [`TextAlignH`](#show-textalignh) — 가로 정렬<br>`range` (선택) `
|
|
2342
|
-
| `setParagraphStyle` | 단락 서식을 한 번에 설정한다. range 를 주면 그 구간이 걸친 단락에만 적용한다.<br
|
|
2343
|
-
| `setLineSpacing` | 줄 간격을 설정한다. range 를 주면 그 구간이 걸친 단락에만 적용한다.<br>MULTIPLE 이면
|
|
2344
|
-
| `setSpaceBefore` | 단락 앞 간격(UI "문단 위")을 설정한다. | `spaceBefore` 숫자 — 단락 앞 간격 (pt)<br>`range` (선택) `
|
|
2345
|
-
| `setSpaceAfter` | 단락 뒤 간격(UI "문단 아래")을 설정한다. | `spaceAfter` 숫자 — 단락 뒤 간격 (pt)<br>`range` (선택) `
|
|
2346
|
-
| `setMarginLeft` | 단락 전체의 왼쪽 여백(UI "텍스트 앞")을 설정한다. 첫 줄만
|
|
2347
|
-
| `setFirstLineIndent` | 단락 첫 줄의 들여쓰기(UI "첫 줄")를 설정한다. 둘째 줄부터는 marginLeft 를 따른다.<br>양수는 들여쓰기, 음수는 내어쓰기, 0 은
|
|
2348
|
-
| `setLevel` | 목록 수준(개요 계층 깊이)을 설정한다. range 가 걸친 단락을 모두 같은 수준으로 맞춘다.<br>pt 단위 들여쓰기(setFirstLineIndent/setMarginLeft)와 달리 수준은 상속 프리셋 선택이라,<br>바꾸면 그 수준의 글머리
|
|
2349
|
-
| `setBulletStyle` | 글머리 기호 스타일을 설정한다. | `bulletType`
|
|
2350
|
-
| `setAlignV` | 텍스트 세로 정렬을 설정한다. | `align` [`TextAlignV`](#show-textalignv) — 세로 정렬 | — |
|
|
2351
|
-
| `setTextboxAutoFit` | 텍스트 상자 자동 맞춤 유형을 설정한다. | `autoAlignType` [`AutoFitType`](#show-autofittype) — 자동 맞춤 유형 | — |
|
|
2355
|
+
| `setAlignH` | 텍스트 가로 정렬을 설정한다. range 를 주면 그 구간이 걸친 단락에만 적용한다. | `align` [`TextAlignH`](#show-textalignh) — 가로 정렬<br>`range` (선택) [`TextRange`](#show-textrange) — 적용할 텍스트 구간 (기본값: 전체 텍스트) | — |
|
|
2356
|
+
| `setParagraphStyle` | 단락 서식을 한 번에 설정한다. range 를 주면 그 구간이 걸친 단락에만 적용한다.<br>값을 준 속성만 바뀐다. null/undefined 는 "변경 없음"으로 무시하며, 지정한 값을 상속 상태로 되돌리는 방법은 아직 없다.<br>단일 속성은 setLineSpacing/setMarginLeft/setFirstLineIndent/setSpaceBefore/setSpaceAfter 사용 권장.<br>목록 수준은 바꿀 때 딸려오는 부수 효과(글머리 기호·글자 크기)가 있어 여기 담지 않는다. (setLevel 참고) | `style` [`ParagraphStyle`](#show-paragraphstyle) — 단락 서식 설정<br>`range` (선택) [`TextRange`](#show-textrange) — 적용할 텍스트 구간 (기본값: 전체 텍스트) | — |
|
|
2357
|
+
| `setLineSpacing` | 줄 간격을 설정한다. range 를 주면 그 구간이 걸친 단락에만 적용한다.<br>lineSpacing 의 단위는 유형에 따라 다르다 - MULTIPLE 이면 배수 백분율(150=1.5배), EXACT 이면 pt 다. | `lineSpacing` 숫자 — 줄 간격 값 (MULTIPLE: 배수%, EXACT: pt)<br>`type` (선택) [`LineSpacingType`](#show-linespacingtype) — 줄 간격 유형 (기본값: LineSpacingType.MULTIPLE)<br>`range` (선택) [`TextRange`](#show-textrange) — 적용할 텍스트 구간 (기본값: 전체 텍스트) | — |
|
|
2358
|
+
| `setSpaceBefore` | 단락 앞 간격(UI "문단 위")을 설정한다. | `spaceBefore` 숫자 — 단락 앞 간격 (pt)<br>`range` (선택) [`TextRange`](#show-textrange) — 적용할 텍스트 구간 (기본값: 전체 텍스트) | — |
|
|
2359
|
+
| `setSpaceAfter` | 단락 뒤 간격(UI "문단 아래")을 설정한다. | `spaceAfter` 숫자 — 단락 뒤 간격 (pt)<br>`range` (선택) [`TextRange`](#show-textrange) — 적용할 텍스트 구간 (기본값: 전체 텍스트) | — |
|
|
2360
|
+
| `setMarginLeft` | 단락 전체의 왼쪽 여백(UI "텍스트 앞")을 설정한다. 첫 줄만 들여쓰려면 setFirstLineIndent 를 사용한다. | `marginLeft` 숫자 — 왼쪽 여백 (pt)<br>`range` (선택) [`TextRange`](#show-textrange) — 적용할 텍스트 구간 (기본값: 전체 텍스트) | — |
|
|
2361
|
+
| `setFirstLineIndent` | 단락 첫 줄의 들여쓰기(UI "첫 줄")를 설정한다. 둘째 줄부터는 marginLeft 를 따른다.<br>양수는 들여쓰기, 음수는 내어쓰기, 0 은 들여쓰기 없음이다.<br>글머리 기호 목록의 계층 깊이를 바꾸려면 setLevel 을 사용한다. | `firstLineIndent` 숫자 — 첫 줄 들여쓰기 (pt)<br>`range` (선택) [`TextRange`](#show-textrange) — 적용할 텍스트 구간 (기본값: 전체 텍스트) | — |
|
|
2362
|
+
| `setLevel` | 목록 수준(개요 계층 깊이)을 설정한다. range 가 걸친 단락을 모두 같은 수준으로 맞춘다.<br>pt 단위 들여쓰기(setFirstLineIndent/setMarginLeft)와 달리 수준은 상속 프리셋 선택이라,<br>바꾸면 그 수준의 글머리 기호·글자 크기가 따라오고 marginLeft 는 새 수준의 값으로 덮인다.<br>setMarginLeft 로 지정한 값도 버려지므로 둘을 함께 쓸 때는 setLevel 을 먼저 호출한다. (firstLineIndent 는 유지)<br>대상 텍스트가 허용하는 범위(제목 개체는 1 수준뿐)로 제한한다. | `level` 숫자 — 목록 수준 (1=최상위 ~ 9)<br>`range` (선택) [`TextRange`](#show-textrange) — 적용할 텍스트 구간 (기본값: 전체 텍스트) | — |
|
|
2363
|
+
| `setBulletStyle` | 글머리 기호 스타일을 설정한다. (getBulletStyle 대칭)<br>그림 글머리(BulletType.BLIP)는 적용을 지원하지 않는 조회 전용 유형이라 거부한다.<br>CharType 프리셋 밖의 문자도 적용할 수 없다 (조회 전용이라 받을 인자가 없다). | `bulletType` `Exclude<BulletType, "buBlip">` — 글머리 기호 유형<br>`subType` (선택) `NumberedType \| CharType` — BulletType.AUTO_NUM: 번호 매기기 유형 (기본값 NumberedType.NUMBER_WITH_DOT), BulletType.CHAR: 글머리 문자 유형 (기본값 CharType.DOT)<br>`startAt` (선택) 숫자 — 시작 번호 (BulletType.AUTO_NUM 일 때만 사용) (기본값: 1)<br>`range` (선택) [`TextRange`](#show-textrange) — 적용할 텍스트 구간 (기본값: 전체 텍스트) | — |
|
|
2364
|
+
| `setAlignV` | 텍스트 세로 정렬을 설정한다. (getAlignV 대칭) | `align` [`TextAlignV`](#show-textalignv) — 세로 정렬 | — |
|
|
2365
|
+
| `setTextboxAutoFit` | 텍스트 상자 자동 맞춤 유형을 설정한다. 이미 같은 유형이면 아무것도 하지 않는다. | `autoAlignType` [`AutoFitType`](#show-autofittype) — 자동 맞춤 유형 | — |
|
|
2352
2366
|
| `getRowIndex` | 셀의 행 인덱스를 반환한다. | — | 행 인덱스 (0-based)<br>숫자 |
|
|
2353
2367
|
| `getColIndex` | 셀의 열 인덱스를 반환한다. | — | 열 인덱스 (0-based)<br>숫자 |
|
|
2354
|
-
| `
|
|
2355
|
-
| `
|
|
2368
|
+
| `getColSpan` | 셀이 가로로 차지하는 열 수를 반환한다. 병합되지 않았으면 1 이다. | — | 열 병합 수. 표가 없거나 해당 위치에 셀이 없으면 null<br>숫자 (없을 수 있음) |
|
|
2369
|
+
| `getRowSpan` | 셀이 세로로 차지하는 행 수를 반환한다. 병합되지 않았으면 1 이다. | — | 행 병합 수. 표가 없거나 해당 위치에 셀이 없으면 null<br>숫자 (없을 수 있음) |
|
|
2370
|
+
| `getFill` | 셀에 명시적으로 설정된 배경 채우기를 반환한다. (setSolidFill 대칭)<br>스타일 상속분은 포함하지 않으며(셀에 직접 지정한 채우기만), alpha 는 setSolidFill 과 같은<br>투명도(0~100, 0=불투명)로 반환한다. | — | 채우기 정보. 명시적 fill 없으면 `{ type: FillType.NONE }`, 표가 없으면 null<br>[`Fill`](#show-fill) (없을 수 있음) |
|
|
2371
|
+
| `getBorderStyle` | 지정 위치의 셀 테두리 스타일을 반환한다. (setBorderStyle 대칭)<br>ALL 일괄 조회는 지원하지 않는다 - 한 변씩 조회한다. | `position` `Exclude<BorderPosition, "all">` — 테두리 위치 | 테두리 스타일. 해당 위치에 명시적 테두리가 없으면 null<br>[`BorderStyle`](#show-borderstyle) (없을 수 있음) |
|
|
2356
2372
|
| `deleteText` | 셀 안의 모든 텍스트를 제거한다. | — | — |
|
|
2357
|
-
| `setSolidFill` | 셀 배경을 단색으로 채운다. | `color` 문자열 — hex (#RRGGBB) 또는 scheme color<br>`alpha` (선택) 숫자 — 투명도 (0~100, 100=완전 투명)
|
|
2358
|
-
| `setFill` | getFill() 이 반환한 채우기 객체를 그대로 적용한다. (getFill 대칭 — 셀 채우기 복사)<br
|
|
2359
|
-
| `setBorderStyle` | 셀 테두리 스타일을 설정한다.
|
|
2373
|
+
| `setSolidFill` | 셀 배경을 단색으로 채운다. | `color` 문자열 — hex (#RRGGBB) 또는 scheme color<br>`alpha` (선택) 숫자 — 투명도 (0~100, 0=불투명, 100=완전 투명). 생략하면 기존 투명도 유지 | — |
|
|
2374
|
+
| `setFill` | getFill() 이 반환한 채우기 객체를 그대로 적용한다. (getFill 대칭 — 셀 채우기 복사)<br>셀 채우기 설정은 단색만 지원한다 — getFill() 이 다른 타입(none/gradient 등)을 돌려준 셀의 값은 되넘길 수 없다. | `fill` `Fill & { type: "solidFill" }` — 적용할 단색 채우기 | — |
|
|
2375
|
+
| `setBorderStyle` | 셀 테두리 스타일을 설정한다. 생략한 속성은 유지되지 않고 기본값이 되므로, 일부만 바꾸려면<br>getBorderStyle() 반환값에 바꿀 속성을 덮어 함께 넘긴다. 셋을 모두 생략하면 아무것도 바꾸지 않는다.<br>ALL 은 위/아래/왼쪽/오른쪽 4변만 설정한다 - 대각선은 포함하지 않는다. 색상은 hex / scheme color 모두 자동 판정. | `position` [`BorderPosition`](#show-borderposition) — 테두리 위치<br>`color` (선택) 문자열 — hex (#RRGGBB) 또는 scheme color name<br>`width` (선택) 숫자 — 선 두께 (pt 단위)<br>`lineDash` (선택) [`LineDash`](#common-linedash) — 선 대시 유형 | — |
|
|
2360
2376
|
|
|
2361
2377
|
### 부록 — 입출력 데이터 형식 (Presentation)
|
|
2362
2378
|
|
|
@@ -2409,7 +2425,7 @@ OLE 개체를 다루는 핸들로, 내용 편집은 지원하지 않으며 위
|
|
|
2409
2425
|
| `placeholderType` (선택) | [`PlaceholderType`](#show-placeholdertype) | placeholder 유형 |
|
|
2410
2426
|
| `shapeType` (선택) | [`ShapeType`](#show-shapetype) | 도형 종류 |
|
|
2411
2427
|
| `presetId` (선택) | `ShapePreset \| ShapePresetFamily \| string \| (ShapePreset \| ShapePresetFamily \| string)[]` | 도형 프리셋. ShapePreset 값(정확 매칭) 또는 ShapePresetFamily 키(계열 매칭). 배열로 여러 개 지정 가능 |
|
|
2412
|
-
| `textContains` (선택) | 문자열 |
|
|
2428
|
+
| `textContains` (선택) | 문자열 | 도형 텍스트에 포함된 문자열 |
|
|
2413
2429
|
| `hasText` (선택) | 참/거짓 | 텍스트 존재 여부 |
|
|
2414
2430
|
| `fillType` (선택) | [`FillType`](#show-filltype) | 채우기 유형 |
|
|
2415
2431
|
| `fillColor` (선택) | 문자열 | 채우기 색상 (hex) |
|
|
@@ -2425,7 +2441,7 @@ OLE 개체를 다루는 핸들로, 내용 편집은 지원하지 않으며 위
|
|
|
2425
2441
|
|
|
2426
2442
|
| 항목 | 형식 | 설명 |
|
|
2427
2443
|
|---|---|---|
|
|
2428
|
-
| `textContains` (선택) | 문자열 | 셀
|
|
2444
|
+
| `textContains` (선택) | 문자열 | 셀 텍스트에 포함된 문자열 |
|
|
2429
2445
|
| `rowCount` (선택) | 숫자 | 행 수 |
|
|
2430
2446
|
| `colCount` (선택) | 숫자 | 열 수 |
|
|
2431
2447
|
|
|
@@ -2434,7 +2450,7 @@ OLE 개체를 다루는 핸들로, 내용 편집은 지원하지 않으며 위
|
|
|
2434
2450
|
|
|
2435
2451
|
| 항목 | 형식 | 설명 |
|
|
2436
2452
|
|---|---|---|
|
|
2437
|
-
| `textContains` (선택) | 문자열 | 댓글
|
|
2453
|
+
| `textContains` (선택) | 문자열 | 댓글 텍스트에 포함된 문자열 |
|
|
2438
2454
|
| `isReply` (선택) | 참/거짓 | 답글 여부 |
|
|
2439
2455
|
| `parentCommentId` (선택) | 문자열 | 특정 부모의 답글만 필터 |
|
|
2440
2456
|
|
|
@@ -2449,7 +2465,7 @@ OLE 개체를 다루는 핸들로, 내용 편집은 지원하지 않으며 위
|
|
|
2449
2465
|
| `orient` (선택) | [`TransitionEffectDir`](#show-transitioneffectdir) | 분할 방향 (SPLIT 효과 전용: horz\|vert) (기본값: 효과 기본값) |
|
|
2450
2466
|
| `thruBlack` (선택) | 참/거짓 | 검은 화면을 거쳐 전환 (FADE/CUT 효과 전용) (기본값: false) |
|
|
2451
2467
|
| `advTm` (선택) | 숫자 | 자동 진행 시간 (s) (기본값: 자동 진행 안 함) |
|
|
2452
|
-
| `advClick` (선택) | 참/거짓 | 클릭으로 진행 여부 (기본값: true
|
|
2468
|
+
| `advClick` (선택) | 참/거짓 | 클릭으로 진행 여부 (기본값: true) |
|
|
2453
2469
|
|
|
2454
2470
|
<a id="show-chartfilter"></a>
|
|
2455
2471
|
#### `ChartFilter`
|
|
@@ -2471,8 +2487,8 @@ OLE 개체를 다루는 핸들로, 내용 편집은 지원하지 않으며 위
|
|
|
2471
2487
|
|
|
2472
2488
|
| 항목 | 형식 | 설명 |
|
|
2473
2489
|
|---|---|---|
|
|
2474
|
-
| `x` | 숫자 | X 좌표 (px
|
|
2475
|
-
| `y` | 숫자 | Y 좌표 (px
|
|
2490
|
+
| `x` | 숫자 | 좌상단 X 좌표 (px 단위, 반전·회전과 무관한 모델 기준) |
|
|
2491
|
+
| `y` | 숫자 | 좌상단 Y 좌표 (px 단위, 반전·회전과 무관한 모델 기준) |
|
|
2476
2492
|
| `width` | 숫자 | 너비 (px 단위) |
|
|
2477
2493
|
| `height` | 숫자 | 높이 (px 단위) |
|
|
2478
2494
|
| `angle` | 숫자 | 회전 각도 (degree) |
|
|
@@ -2493,8 +2509,8 @@ OLE 개체를 다루는 핸들로, 내용 편집은 지원하지 않으며 위
|
|
|
2493
2509
|
|
|
2494
2510
|
| 항목 | 형식 | 설명 |
|
|
2495
2511
|
|---|---|---|
|
|
2496
|
-
| `x` (선택) | 숫자 | X 이동량 (px 단위, 양수 = 오른쪽)
|
|
2497
|
-
| `y` (선택) | 숫자 | Y 이동량 (px 단위, 양수 = 아래)
|
|
2512
|
+
| `x` (선택) | 숫자 | X 이동량 (px 단위, 양수 = 오른쪽). 생략하면 X 는 이동하지 않음 |
|
|
2513
|
+
| `y` (선택) | 숫자 | Y 이동량 (px 단위, 양수 = 아래). 생략하면 Y 는 이동하지 않음 |
|
|
2498
2514
|
|
|
2499
2515
|
<a id="show-fill"></a>
|
|
2500
2516
|
#### `Fill`
|
|
@@ -2503,14 +2519,14 @@ OLE 개체를 다루는 핸들로, 내용 편집은 지원하지 않으며 위
|
|
|
2503
2519
|
|---|---|---|
|
|
2504
2520
|
| `type` | [`FillType`](#show-filltype) | 채우기 종류 (apiConstants.FillType). getFill 출력과 findShapes({fillType}) 필터가 같은 어휘를 쓴다 |
|
|
2505
2521
|
| `color` (선택) | 문자열 | solid: hex "#RRGGBB" 또는 scheme color |
|
|
2506
|
-
| `alpha` (선택) | 숫자 | solid/image: 투명도(0~100, 0
|
|
2522
|
+
| `alpha` (선택) | 숫자 | solid/image: 투명도 (0~100, 0=불투명). 불투명이면 키를 생략한다 |
|
|
2507
2523
|
| `gradientType` (선택) | [`GradientType`](#show-gradienttype) | gradient: 그라데이션 유형(lin/circle/rect/shape) |
|
|
2508
|
-
| `angle` (선택) | 숫자 | gradient: 각도(degree) |
|
|
2524
|
+
| `angle` (선택) | 숫자 | gradient: 각도(degree). 조회값은 0.1도 단위이며 [0, 360) 으로 정규화된다(360 은 0) |
|
|
2509
2525
|
| `stops` (선택) | `{ color: string; pos?: number; alpha?: number }[]` | gradient: 색상 변화점 |
|
|
2510
2526
|
| `fillMode` (선택) | [`ImageFillMode`](#show-imagefillmode) | image: 이미지 채우기 방식 |
|
|
2511
|
-
| `embed` (선택) | 문자열 | image:
|
|
2512
|
-
| `width` (선택) | 숫자 | image:
|
|
2513
|
-
| `height` (선택) | 숫자 | image:
|
|
2527
|
+
| `embed` (선택) | 문자열 | image: 같은 문서 안 setFill 왕복용 업로드 리소스 id |
|
|
2528
|
+
| `width` (선택) | 숫자 | image: 원본 이미지 너비 (px) |
|
|
2529
|
+
| `height` (선택) | 숫자 | image: 원본 이미지 높이 (px) |
|
|
2514
2530
|
| `offset` (선택) | `{ x: number; y: number }` | image: 바둑판 오프셋 (pt). fillMode=ImageFillMode.TILE 일 때만 존재 |
|
|
2515
2531
|
| `scale` (선택) | `{ x: number; y: number }` | image: 바둑판 배율 (%). fillMode=ImageFillMode.TILE 일 때만 존재 |
|
|
2516
2532
|
| `mirror` (선택) | [`ImageTileFlip`](#show-imagetileflip) | image: 바둑판 대칭. fillMode=ImageFillMode.TILE 일 때만 존재 |
|
|
@@ -2519,8 +2535,8 @@ OLE 개체를 다루는 핸들로, 내용 편집은 지원하지 않으며 위
|
|
|
2519
2535
|
| `preset` (선택) | [`PatternPreset`](#show-patternpreset) | pattern: 무늬 프리셋 (apiConstants.PatternPreset) |
|
|
2520
2536
|
| `foreColor` (선택) | 문자열 | pattern: 전경색 (hex "#RRGGBB"/scheme) |
|
|
2521
2537
|
| `backColor` (선택) | 문자열 | pattern: 배경색 (hex "#RRGGBB"/scheme) |
|
|
2522
|
-
| `foreAlpha` (선택) | 숫자 | pattern: 전경색 투명도 (0~100, 0
|
|
2523
|
-
| `backAlpha` (선택) | 숫자 | pattern: 배경색 투명도 (0~100, 0
|
|
2538
|
+
| `foreAlpha` (선택) | 숫자 | pattern: 전경색 투명도 (0~100, 0=불투명). 불투명이면 키를 생략한다 |
|
|
2539
|
+
| `backAlpha` (선택) | 숫자 | pattern: 배경색 투명도 (0~100, 0=불투명). 불투명이면 키를 생략한다 |
|
|
2524
2540
|
|
|
2525
2541
|
<a id="show-linestyle"></a>
|
|
2526
2542
|
#### `LineStyle`
|
|
@@ -2529,59 +2545,131 @@ OLE 개체를 다루는 핸들로, 내용 편집은 지원하지 않으며 위
|
|
|
2529
2545
|
|---|---|---|
|
|
2530
2546
|
| `type` | [`FillType`](#show-filltype) | 선 채우기 종류 (apiConstants.FillType). getFill 출력과 같은 어휘 |
|
|
2531
2547
|
| `color` (선택) | 문자열 (없을 수 있음) | solid: 선 색상 (hex "#RRGGBB"/scheme) |
|
|
2532
|
-
| `alpha` (선택) | 숫자 | solid: 투명도 (0~100, 0
|
|
2548
|
+
| `alpha` (선택) | 숫자 | solid: 투명도 (0~100, 0=불투명). 불투명이면 키를 생략한다 |
|
|
2533
2549
|
| `gradientType` (선택) | [`GradientType`](#show-gradienttype) | gradient: 그라데이션 유형(lin/circle/rect/shape) |
|
|
2534
2550
|
| `stops` (선택) | `{ color: string; pos?: number; alpha?: number }[]` | gradient: 색상 변화점 |
|
|
2535
|
-
| `angle` (선택) | 숫자 | gradient: 각도(degree) |
|
|
2536
|
-
| `width` | 숫자 (없을 수 있음) | 선 두께 (pt). 선
|
|
2551
|
+
| `angle` (선택) | 숫자 | gradient: 각도(degree). 조회값은 0.1도 단위이며 [0, 360) 으로 정규화된다(360 은 0) |
|
|
2552
|
+
| `width` | 숫자 (없을 수 있음) | 선 두께 (pt). 선 없음(noFill)이어도 두께는 그대로 담긴다 |
|
|
2537
2553
|
| `dash` | [`LineDash`](#common-linedash) (없을 수 있음) | 선 대시 유형 |
|
|
2538
2554
|
| `cap` | [`LineCap`](#show-linecap) (없을 수 있음) | 선 끝 모양 |
|
|
2539
2555
|
| `join` | [`LineJoin`](#show-linejoin) (없을 수 있음) | 선 연결(모서리) 유형 |
|
|
2540
2556
|
|
|
2541
|
-
<a id="show-
|
|
2542
|
-
#### `
|
|
2557
|
+
<a id="show-lineend"></a>
|
|
2558
|
+
#### `LineEnd`
|
|
2543
2559
|
|
|
2544
2560
|
| 항목 | 형식 | 설명 |
|
|
2545
2561
|
|---|---|---|
|
|
2546
|
-
| `
|
|
2547
|
-
| `
|
|
2548
|
-
| `
|
|
2549
|
-
| `softEdge` (선택) | `{ rad: number }` | 옅은 테두리 (setSoftEdge) |
|
|
2550
|
-
| `reflection` (선택) | `{ blur: number; dist: number; stPos: number; endPos: number; dir: number; fadeDir: number; startAlpha: number; endAlpha: number; sx: number; sy: number; kx: number; ky: number; algn: string; rotWithShape: boolean }` | 반사. 전체 필드를 setReflection 공개 인자로 사용할 수 있다. 렌더에 반영되는 것은 blur/dist/endPos/startAlpha/endAlpha 이며 dir 은 렌더가 참조하지 않는다. 배치 파라미터는 sx/sy 배율·kx/ky 기울임(degree)·algn 정렬·rotWithShape 이다. stPos·fadeDir 은 웹쇼 렌더가 참조하지 않지만, 외부 문서(PowerPoint 등)에서 온 값이 setReflection 의 기본값으로 덮이지 않도록 함께 반환한다 |
|
|
2551
|
-
| `scene3d` (선택) | [`Scene3d`](#show-scene3d) | 카메라(회전) 3D (set3d 의 scene3d) |
|
|
2552
|
-
| `sp3d` (선택) | [`Sp3d`](#show-sp3d) | 입체(깊이) 3D (set3d 의 sp3d) |
|
|
2562
|
+
| `type` | [`LineEndType`](#show-lineendtype) | 화살표 타입 |
|
|
2563
|
+
| `width` | [`LineEndSize`](#show-lineendsize) | 화살표 너비 |
|
|
2564
|
+
| `length` | [`LineEndSize`](#show-lineendsize) | 화살표 길이 |
|
|
2553
2565
|
|
|
2554
|
-
<a id="show-
|
|
2555
|
-
#### `
|
|
2566
|
+
<a id="show-imagecrop"></a>
|
|
2567
|
+
#### `ImageCrop`
|
|
2556
2568
|
|
|
2557
2569
|
| 항목 | 형식 | 설명 |
|
|
2558
2570
|
|---|---|---|
|
|
2559
|
-
| `
|
|
2560
|
-
| `
|
|
2561
|
-
| `
|
|
2562
|
-
| `
|
|
2563
|
-
|
|
2571
|
+
| `left` | 숫자 | 왼쪽 crop 퍼센트 |
|
|
2572
|
+
| `top` | 숫자 | 위쪽 crop 퍼센트 |
|
|
2573
|
+
| `right` | 숫자 | 오른쪽 crop 퍼센트 |
|
|
2574
|
+
| `bottom` | 숫자 | 아래쪽 crop 퍼센트 |
|
|
2575
|
+
|
|
2576
|
+
<a id="show-bulletstyle"></a>
|
|
2577
|
+
#### `BulletStyle`
|
|
2578
|
+
|
|
2579
|
+
| 항목 | 형식 | 설명 |
|
|
2580
|
+
|---|---|---|
|
|
2581
|
+
| `type` | [`BulletType`](#show-bullettype) | 글머리 기호 유형 |
|
|
2582
|
+
| `subType` (선택) | `NumberedType \| CharType` | BulletType.AUTO_NUM: 번호 매기기 유형, BulletType.CHAR: 글머리 문자 유형 (CharType 7종 프리셋의 문자와 글꼴이 모두 일치할 때만 포함) |
|
|
2583
|
+
| `startAt` (선택) | 숫자 | 시작 번호 (BulletType.AUTO_NUM 일 때만 포함) |
|
|
2584
|
+
| `char` (선택) | 문자열 | 글머리 문자 원문 (BulletType.CHAR 일 때만 포함. 프리셋 밖의 문자도 그대로 반환) |
|
|
2585
|
+
|
|
2586
|
+
<a id="show-outershadow"></a>
|
|
2587
|
+
#### `OuterShadow`
|
|
2588
|
+
|
|
2589
|
+
| 항목 | 형식 | 설명 |
|
|
2590
|
+
|---|---|---|
|
|
2591
|
+
| `color` (선택) | 문자열 | hex (#RRGGBB) 또는 scheme color (기본값: "#000000") |
|
|
2592
|
+
| `alpha` (선택) | 숫자 | 투명도 (0~100, 0=불투명) (기본값: 50) |
|
|
2593
|
+
| `blur` (선택) | 숫자 | 흐림 반경 (pt) (기본값: 6) |
|
|
2594
|
+
| `dist` (선택) | 숫자 | 거리 (pt) (기본값: 6) |
|
|
2595
|
+
| `dir` (선택) | 숫자 | 방향 (degree) (기본값: 90) |
|
|
2596
|
+
| `sx` (선택) | 숫자 | 가로 배율 (%) (기본값: 100) |
|
|
2597
|
+
| `sy` (선택) | 숫자 | 세로 배율 (%) (기본값: 100) |
|
|
2598
|
+
| `kx` (선택) | 숫자 | 가로 기울임 (degree) (기본값: 0) |
|
|
2599
|
+
| `ky` (선택) | 숫자 | 세로 기울임 (degree) (기본값: 0) |
|
|
2600
|
+
| `algn` (선택) | [`RectAlign`](#show-rectalign) | 정렬 기준 (기본값: RectAlign.CENTER) |
|
|
2601
|
+
| `rotWithShape` (선택) | 참/거짓 | 도형 회전 연동 (기본값: false) |
|
|
2602
|
+
|
|
2603
|
+
<a id="show-innershadow"></a>
|
|
2604
|
+
#### `InnerShadow`
|
|
2605
|
+
|
|
2606
|
+
| 항목 | 형식 | 설명 |
|
|
2607
|
+
|---|---|---|
|
|
2608
|
+
| `color` (선택) | 문자열 | hex (#RRGGBB) 또는 scheme color (기본값: "#000000") |
|
|
2609
|
+
| `alpha` (선택) | 숫자 | 투명도 (0~100, 0=불투명) (기본값: 50) |
|
|
2610
|
+
| `blur` (선택) | 숫자 | 흐림 반경 (pt) (기본값: 6) |
|
|
2611
|
+
| `dist` (선택) | 숫자 | 거리 (pt) (기본값: 6) |
|
|
2612
|
+
| `dir` (선택) | 숫자 | 방향 (degree) (기본값: 90) |
|
|
2613
|
+
|
|
2614
|
+
<a id="show-glow"></a>
|
|
2615
|
+
#### `Glow`
|
|
2616
|
+
|
|
2617
|
+
| 항목 | 형식 | 설명 |
|
|
2618
|
+
|---|---|---|
|
|
2619
|
+
| `color` (선택) | 문자열 | hex (#RRGGBB) 또는 scheme color (기본값: "#356FFF") |
|
|
2620
|
+
| `alpha` (선택) | 숫자 | 투명도 (0~100, 0=불투명) (기본값: 50) |
|
|
2621
|
+
| `rad` (선택) | 숫자 | 광선 반경 (pt) (기본값: 10) |
|
|
2622
|
+
|
|
2623
|
+
<a id="show-softedge"></a>
|
|
2624
|
+
#### `SoftEdge`
|
|
2564
2625
|
|
|
2565
|
-
|
|
2566
|
-
|
|
2626
|
+
| 항목 | 형식 | 설명 |
|
|
2627
|
+
|---|---|---|
|
|
2628
|
+
| `rad` (선택) | 숫자 | 반경 (pt) (기본값: 5) |
|
|
2629
|
+
|
|
2630
|
+
<a id="show-reflection"></a>
|
|
2631
|
+
#### `Reflection`
|
|
2567
2632
|
|
|
2568
2633
|
| 항목 | 형식 | 설명 |
|
|
2569
2634
|
|---|---|---|
|
|
2570
|
-
| `
|
|
2571
|
-
| `
|
|
2572
|
-
| `
|
|
2573
|
-
| `
|
|
2574
|
-
| `
|
|
2575
|
-
| `
|
|
2576
|
-
| `
|
|
2635
|
+
| `blur` (선택) | 숫자 | 흐림 반경 (pt) (기본값: 0.5) |
|
|
2636
|
+
| `dist` (선택) | 숫자 | 거리 (pt) (기본값: 0) |
|
|
2637
|
+
| `stPos` (선택) | 숫자 | 시작 위치 (0~100). 렌더링에는 반영되지 않는다 (기본값: 0) |
|
|
2638
|
+
| `endPos` (선택) | 숫자 | 반사 크기 (0~100) (기본값: 50) |
|
|
2639
|
+
| `startAlpha` (선택) | 숫자 | 시작 투명도 (0~100, 0=불투명) (기본값: 50) |
|
|
2640
|
+
| `endAlpha` (선택) | 숫자 | 끝 투명도 (0~100, 0=불투명) (기본값: 99.7) |
|
|
2641
|
+
| `dir` (선택) | 숫자 | 방향 (degree). 렌더링에는 반영되지 않는다 (기본값: 90) |
|
|
2642
|
+
| `fadeDir` (선택) | 숫자 | 페이드 방향 (degree). 렌더링에는 반영되지 않는다 (기본값: 90) |
|
|
2643
|
+
| `sx` (선택) | 숫자 | 가로 배율 (%) (기본값: 100) |
|
|
2644
|
+
| `sy` (선택) | 숫자 | 세로 배율 (%) (기본값: -100) |
|
|
2645
|
+
| `kx` (선택) | 숫자 | 가로 기울임 (degree) (기본값: 0) |
|
|
2646
|
+
| `ky` (선택) | 숫자 | 세로 기울임 (degree) (기본값: 0) |
|
|
2647
|
+
| `algn` (선택) | [`RectAlign`](#show-rectalign) | 정렬 기준 (기본값: RectAlign.BOTTOM_LEFT) |
|
|
2648
|
+
| `rotWithShape` (선택) | 참/거짓 | 도형 회전 연동 (기본값: false) |
|
|
2577
2649
|
|
|
2578
|
-
<a id="show-
|
|
2579
|
-
#### `
|
|
2650
|
+
<a id="show-effects"></a>
|
|
2651
|
+
#### `Effects`
|
|
2580
2652
|
|
|
2581
2653
|
| 항목 | 형식 | 설명 |
|
|
2582
2654
|
|---|---|---|
|
|
2583
|
-
| `
|
|
2584
|
-
| `
|
|
2655
|
+
| `outerShadow` (선택) | [`OuterShadow`](#show-outershadow) | 외부 그림자 |
|
|
2656
|
+
| `innerShadow` (선택) | [`InnerShadow`](#show-innershadow) | 내부 그림자 |
|
|
2657
|
+
| `glow` (선택) | [`Glow`](#show-glow) | 네온(광선) |
|
|
2658
|
+
| `softEdge` (선택) | [`SoftEdge`](#show-softedge) | 옅은 테두리 |
|
|
2659
|
+
| `reflection` (선택) | [`Reflection`](#show-reflection) | 반사 |
|
|
2660
|
+
| `scene3d` (선택) | [`Scene3d`](#show-scene3d) | 카메라(회전) 3D |
|
|
2661
|
+
| `sp3d` (선택) | [`Sp3d`](#show-sp3d) | 입체(깊이) 3D |
|
|
2662
|
+
|
|
2663
|
+
<a id="show-imagefilldetail"></a>
|
|
2664
|
+
#### `ImageFillDetail`
|
|
2665
|
+
|
|
2666
|
+
| 항목 | 형식 | 설명 |
|
|
2667
|
+
|---|---|---|
|
|
2668
|
+
| `offset` (선택) | `{ x?: number; y?: number }` | 바둑판 오프셋 (pt) (기본값: {x: 0, y: 0}) |
|
|
2669
|
+
| `scale` (선택) | `{ x?: number; y?: number }` | 바둑판 배율 (%) (기본값: {x: 100, y: 100}) |
|
|
2670
|
+
| `mirror` (선택) | [`ImageTileFlip`](#show-imagetileflip) | 바둑판 대칭 (기본값: ImageTileFlip.NONE) |
|
|
2671
|
+
| `align` (선택) | [`RectAlign`](#show-rectalign) | 바둑판 정렬 기준점 (기본값: RectAlign.TOP_LEFT) |
|
|
2672
|
+
| `rotateWithShape` (선택) | 참/거짓 | 도형과 함께 회전 여부. 생략하면 기존 동작 유지 (모델 기본 true) |
|
|
2585
2673
|
|
|
2586
2674
|
<a id="show-scene3d"></a>
|
|
2587
2675
|
#### `Scene3d`
|
|
@@ -2609,7 +2697,7 @@ OLE 개체를 다루는 핸들로, 내용 편집은 지원하지 않으며 위
|
|
|
2609
2697
|
| `value` | 숫자 | 현재 조절값(단위 기준 정수) |
|
|
2610
2698
|
| `min` | 숫자 (없을 수 있음) | 설정 가능한 최솟값, 범위를 알 수 없으면 null |
|
|
2611
2699
|
| `max` | 숫자 (없을 수 있음) | 설정 가능한 최댓값, 범위를 알 수 없으면 null |
|
|
2612
|
-
| `unit` | 문자열 (없을 수 있음) | 값의
|
|
2700
|
+
| `unit` | 문자열 (없을 수 있음) | 값의 단위 (pct 는 1/1000%, ang 는 1/60000도). 범위를 알 수 없으면 null |
|
|
2613
2701
|
|
|
2614
2702
|
<a id="show-adjustvalueupdate"></a>
|
|
2615
2703
|
#### `AdjustValueUpdate`
|
|
@@ -2627,7 +2715,7 @@ OLE 개체를 다루는 핸들로, 내용 편집은 지원하지 않으며 위
|
|
|
2627
2715
|
| `range` (선택) | `{ startRow: number; startCol: number; endRow: number; endCol: number }` | 셀 범위 (0-based, inclusive) |
|
|
2628
2716
|
| `rowIndex` (선택) | 숫자 | 특정 행만 (0-based, 대표 셀 기준) |
|
|
2629
2717
|
| `colIndex` (선택) | 숫자 | 특정 열만 (0-based, 대표 셀 기준) |
|
|
2630
|
-
| `isEmpty` (선택) | 참/거짓 | true:
|
|
2718
|
+
| `isEmpty` (선택) | 참/거짓 | true: 텍스트가 비어 있는 셀, false: 텍스트가 있는 셀 |
|
|
2631
2719
|
| `isMerged` (선택) | 참/거짓 | true: 병합 대표 셀, false: 단일 셀 |
|
|
2632
2720
|
| `textContains` (선택) | 문자열 | 셀 텍스트에 포함된 문자열 |
|
|
2633
2721
|
| `fillColor` (선택) | 문자열 | 셀 배경색 일치 (hex "#RRGGBB", 대소문자 무시, 스타일 상속분 미포함) |
|
|
@@ -2643,6 +2731,14 @@ OLE 개체를 다루는 핸들로, 내용 편집은 지원하지 않으며 위
|
|
|
2643
2731
|
| `width` | 숫자 (없을 수 있음) | 선 두께 (pt) |
|
|
2644
2732
|
| `dash` | [`LineDash`](#common-linedash) (없을 수 있음) | 선 대시 유형 |
|
|
2645
2733
|
|
|
2734
|
+
<a id="show-textrange"></a>
|
|
2735
|
+
#### `TextRange`
|
|
2736
|
+
|
|
2737
|
+
| 항목 | 형식 | 설명 |
|
|
2738
|
+
|---|---|---|
|
|
2739
|
+
| `from` | 숫자 | 시작 글자 offset (0-based) |
|
|
2740
|
+
| `to` | 숫자 | 끝 글자 offset (포함) |
|
|
2741
|
+
|
|
2646
2742
|
<a id="show-fontstyle"></a>
|
|
2647
2743
|
#### `FontStyle`
|
|
2648
2744
|
|
|
@@ -2663,12 +2759,12 @@ OLE 개체를 다루는 핸들로, 내용 편집은 지원하지 않으며 위
|
|
|
2663
2759
|
| 항목 | 형식 | 설명 |
|
|
2664
2760
|
|---|---|---|
|
|
2665
2761
|
| `alignH` (선택) | [`TextAlignH`](#show-textalignh) | 가로 정렬 |
|
|
2666
|
-
| `lineSpacing` (선택) | 숫자 | 줄 간격
|
|
2762
|
+
| `lineSpacing` (선택) | 숫자 | 줄 간격 값. MULTIPLE 이면 배수 백분율(150=1.5배), EXACT 이면 pt |
|
|
2667
2763
|
| `lineSpacingType` (선택) | [`LineSpacingType`](#show-linespacingtype) | 줄 간격 유형 (기본값: LineSpacingType.MULTIPLE) |
|
|
2668
|
-
| `marginLeft` (선택) | 숫자 | 단락 전체의 왼쪽 여백 (pt
|
|
2669
|
-
| `firstLineIndent` (선택) | 숫자 | 첫
|
|
2670
|
-
| `spaceBefore` (선택) | 숫자 | 단락 앞 간격 (pt
|
|
2671
|
-
| `spaceAfter` (선택) | 숫자 | 단락 뒤 간격 (pt
|
|
2764
|
+
| `marginLeft` (선택) | 숫자 | 단락 전체의 왼쪽 여백 (pt) |
|
|
2765
|
+
| `firstLineIndent` (선택) | 숫자 | 첫 줄에만 적용되는 들여쓰기 (pt). 양수는 들여쓰기, 음수는 내어쓰기, 0 은 들여쓰기 없음 |
|
|
2766
|
+
| `spaceBefore` (선택) | 숫자 | 단락 앞 간격 (pt) |
|
|
2767
|
+
| `spaceAfter` (선택) | 숫자 | 단락 뒤 간격 (pt) |
|
|
2672
2768
|
|
|
2673
2769
|
### 부록 — 상수 목록 (Presentation)
|
|
2674
2770
|
|
|
@@ -3028,22 +3124,6 @@ datetime1 과 동일한 기본 sentinel 인 DatetimeFigureOut 은 제외한다.
|
|
|
3028
3124
|
| `WORDART_VERTICAL` | `wordArtVert` | — |
|
|
3029
3125
|
| `MONGOLIAN_VERTICAL` | `mongolianVert` | — |
|
|
3030
3126
|
|
|
3031
|
-
<a id="show-textmode"></a>
|
|
3032
|
-
#### `TextMode`
|
|
3033
|
-
|
|
3034
|
-
| 상수 | 값 | 설명 |
|
|
3035
|
-
|---|---|---|
|
|
3036
|
-
| `REPLACE` | `replace` | — |
|
|
3037
|
-
| `APPEND` | `append` | — |
|
|
3038
|
-
|
|
3039
|
-
<a id="show-movemode"></a>
|
|
3040
|
-
#### `MoveMode`
|
|
3041
|
-
|
|
3042
|
-
| 상수 | 값 | 설명 |
|
|
3043
|
-
|---|---|---|
|
|
3044
|
-
| `ABSOLUTE` | `absolute` | — |
|
|
3045
|
-
| `RELATIVE` | `relative` | — |
|
|
3046
|
-
|
|
3047
3127
|
<a id="show-textalignv"></a>
|
|
3048
3128
|
#### `TextAlignV`
|
|
3049
3129
|
|
|
@@ -3343,9 +3423,7 @@ datetime1 과 동일한 기본 sentinel 인 DatetimeFigureOut 은 제외한다.
|
|
|
3343
3423
|
#### `ShapePresetFamily`
|
|
3344
3424
|
|
|
3345
3425
|
ShapePreset family 정의 (family ID → preset 목록).
|
|
3346
|
-
정본: commonFrame/js/uiFramework/templateDefine.js 의 shape_btn_<family>_ 팔레트.
|
|
3347
3426
|
findShapes 의 presetId 에 family 키("rectangle" 등)를 전달하면 해당 계열 전체를, ShapePreset 값("rect" 등)을 전달하면 그 도형만 매칭한다.
|
|
3348
|
-
신규 도형 추가 시 templateDefine.js 와 동기화할 것.
|
|
3349
3427
|
|
|
3350
3428
|
| 상수 | 값 | 설명 |
|
|
3351
3429
|
|---|---|---|
|