Aspose.Note FOSS for Python
이 참조는 전체 공개 API 표면을 다룹니다 aspose-note 버전 26.3.1. 패키지에서 내보낸 심볼만 여기서 문서화됩니다 aspose.note 패키지는 여기서 문서화됩니다. 아래에 있는 모든 것은 aspose.note._internal 구현 세부 사항이며 사전 통보 없이 변경될 수 있습니다.
ImageRenderOptions: pip install aspose-note (core) 또는 pip install "aspose-note[pdf]" (PDF 내보내기 포함)
ImageRenderOptions: from aspose.note import Document, RichText, ...
ImageRenderOptions
문서 및 탐색
| ImageRenderOptions | ImageRenderOptions |
|---|---|
Document | 루트 문서 객체. 파일을 로드하고 .one 파일을 로드하고, 페이지를 순회하며, PDF로 저장합니다. |
DocumentVisitor | 문서 트리의 방문자 패턴 순회를 위한 추상 기본 클래스. |
Node | 모든 문서 노드의 기본 클래스. |
CompositeNode | 자식 노드를 포함할 수 있는 노드의 기본 클래스. |
문서 구조
| ImageRenderOptions | ImageRenderOptions |
|---|---|
Page | OneNote 페이지를 나타냅니다. |
Title | TitleText, TitleDate, TitleTime을 포함하는 페이지 제목 블록. |
Outline | OutlineElement 노드를 위한 위치 기반 컨테이너. |
OutlineElement | 리프 컨테이너; RichText, Image, Table, AttachedFile을 보유합니다. |
ImageRenderOptions
| ImageRenderOptions | ImageRenderOptions |
|---|---|
RichText | 포맷팅 실행, 태그 및 하이퍼링크가 포함된 텍스트 블록. |
TextRun | RichText 내의 단일 서식이 적용된 텍스트 세그먼트. |
TextStyle | TextRun에 대한 서식 속성. |
Image | 원시 바이트와 메타데이터를 포함한 임베디드 이미지. |
AttachedFile | 원시 바이트를 포함한 임베디드 파일 첨부. |
Table | 행, 셀 및 열 너비가 있는 표. |
TableRow | 표 안의 행. |
TableCell | TableRow 안의 셀; 콘텐츠 노드를 포함합니다. |
NoteTag | 콘텐츠 노드에 연결된 OneNote 태그(별표, 체크박스 등). |
NumberList | OutlineElement에 대한 번호 매기기 목록 메타데이터. |
ImageRenderOptions
| ImageRenderOptions | ImageRenderOptions |
|---|---|
LoadOptions | 로드 옵션 .one 파일. |
SaveOptions | 저장 옵션에 대한 기본 클래스. |
PdfSaveOptions | PDF 전용 저장 옵션(태그 아이콘). |
호환성 스텁
| ImageRenderOptions | ImageRenderOptions |
|---|---|
License | 호환성 스텁: SetLicense() 이 FOSS 구현에서는 아무 작업도 수행하지 않습니다. |
Metered | 호환성 스텁: SetMeteredKey() 이 FOSS 구현에서는 아무 작업도 수행하지 않습니다. |
클래스 상세 정보
ImageRenderOptions
루트 문서 클래스. 로드 .one 파일 경로에서 파일, a pathlib.Path, 또는 바이너리 스트림.
from aspose.note import Document, LoadOptions
doc = Document(source=None, load_options=None)생성자 매개변수:
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|
source | `str | Path |
load_options | `LoadOptions | None` |
ImageRenderOptions:
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|
DisplayName | `str | None` |
CreationTime | `datetime | None` |
FileFormat | FileFormat | OneNote 파일 형식 버전에 대한 최선의 추정값 표시 |
ImageRenderOptions:
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|
Count() | () -> int | 직접 하위 페이지 수 |
GetPageHistory(page) | (Page) -> list[Page] | ImageRenderOptions [page] (스텁; 전체 기록은 아직 구현되지 않음) |
DetectLayoutChanges() | () -> None | 호환성 스텁; 동작 없음 |
Save(target, format_or_options) | `(str | Path |
Accept(visitor) | (DocumentVisitor) -> None | 방문자 순회 호출 |
for page in doc | N/A | 직접 하위 Page 노드 반복 |
Document.FileFormat 노트: 이 속성은 OneNote 파일 형식 버전에 대한 최선의 추정값을 제공합니다. The FileFormat enum은 세 가지 값을 가집니다: OneNote2010, OneNoteOnline, 및 OneNote2007.
Document.Save() 스트림 지원: target 바이너리 스트림일 수 있습니다 (io.BytesIO, 바이너리 쓰기 모드로 연 파일 핸들 등). 이는 테스트 스위트에 의해 확인됩니다: doc.Save(io.BytesIO(), PdfSaveOptions(SaveFormat.Pdf)).
DocumentVisitor
방문자 패턴 탐색을 위한 추상 기본 클래스입니다. 필요한 방문 메서드를 오버라이드하세요:
| ImageRenderOptions | 호출될 때 |
|---|---|
VisitDocumentStart(doc) | Document 노드에 진입 |
VisitDocumentEnd(doc) | Document 노드에서 나가기 |
VisitPageStart(page) | Page 노드에 진입 |
VisitPageEnd(page) | Page 노드에서 나가기 |
VisitTitleStart(title) | Title 노드에 진입 |
VisitTitleEnd(title) | Title 노드에서 나가기 |
VisitOutlineStart(outline) | Outline 노드에 진입 |
VisitOutlineEnd(outline) | Outline 노드에서 나가기 |
VisitOutlineElementStart(oe) | OutlineElement 노드에 진입 |
VisitOutlineElementEnd(oe) | OutlineElement 노드에서 나가기 |
VisitRichTextStart(rt) | RichText 노드에 진입 |
VisitRichTextEnd(rt) | RichText 노드에서 나가기 |
VisitImageStart(img) | Image 노드에 진입 |
VisitImageEnd(img) | Image 노드에서 나가기 |
ImageRenderOptions
모든 문서 트리 노드의 기본 클래스입니다.
| 속성 / 메서드 | ImageRenderOptions | ImageRenderOptions |
|---|---|---|
ParentNode | `Node | None` |
Document | `Document | None` |
Accept(visitor) | (DocumentVisitor) -> None | 이 노드에 방문자를 디스패치합니다 |
CompositeNode
ImageRenderOptions Node. 자식 관리 추가:
| 속성 / 메서드 | ImageRenderOptions |
|---|---|
FirstChild | 첫 번째 자식 노드, 또는 None |
LastChild | 마지막 자식 노드, 또는 None |
AppendChildLast(node) | 끝에 자식 노드를 추가합니다; 설정 node.ParentNode = self |
AppendChildFirst(node) | 시작에 자식 노드를 추가합니다 |
InsertChild(index, node) | 지정된 위치에 자식을 삽입합니다 |
RemoveChild(node) | 자식 노드를 제거합니다; 설정 node.ParentNode = None |
GetEnumerator() | 직계 자식에 대한 반복자를 반환합니다 |
for child in node | 직계 자식 반복 |
GetChildNodes(Type) | (Type) -> list[Type]: 재귀적이며, 전체 서브트리를 포함한 깊이 우선 탐색 self |
ImageRenderOptions
ImageRenderOptions CompositeNode. OneNote 페이지를 나타냅니다.
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|
Title | `Title | None` |
Author | `str | None` |
CreationTime | `datetime | None` |
LastModifiedTime | `datetime | None` |
Level | `int | None` |
ImageRenderOptions:
| ImageRenderOptions | ImageRenderOptions |
|---|---|
Clone(deep=False) | 페이지의 얕은 복제본 또는 깊은 복제본을 반환합니다 |
ImageRenderOptions
ImageRenderOptions CompositeNode. a의 제목 블록을 보유합니다 Page.
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|
TitleText | `RichText | None` |
TitleDate | `RichText | None` |
TitleTime | `RichText | None` |
ImageRenderOptions
ImageRenderOptions CompositeNode. 위치 지정 컨테이너 OutlineElement 노드.
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|
X | `float | None` |
Y | `float | None` |
Width | `float | None` |
OutlineElement
ImageRenderOptions CompositeNode. 콘텐츠 노드를 보유하는 리프 컨테이너.
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|
IndentLevel | int | 중첩 깊이 (0 = 최외곽) |
NumberList | `NumberList | None` |
Tags | list[NoteTag] | 이 요소에 연결된 OneNote 태그 |
RichText
ImageRenderOptions CompositeNode. 스타일이 적용된 텍스트 블록.
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|
Text | str | 전체 일반 텍스트 문자열 (모든 실행을 연결한 것) |
Runs | list[TextRun] | 형식이 지정된 세그먼트의 순서 목록 |
FontSize | `float | None` |
Tags | list[NoteTag] | 이 블록에 연결된 OneNote 태그 |
ImageRenderOptions:
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|
Append(text, style=None) | `(str, TextStyle | None) -> RichText` |
Replace(old_value, new_value) | (str, str) -> None | 메모리 내 문자열 치환 on Text; 업데이트되지 않음 Runs |
TextRun
ImageRenderOptions Node. 단일 서식이 적용된 텍스트 세그먼트.
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|
Text | str | 세그먼트의 텍스트 내용 (기본 "") |
Style | TextStyle | 서식 속성 |
Start | `int | None` |
End | `int | None` |
TextStyle
ImageRenderOptions Node. 문자별 서식 속성 TextRun.
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|---|
Bold | bool | False | ImageRenderOptions |
Italic | bool | False | ImageRenderOptions |
Underline | bool | False | ImageRenderOptions |
Strikethrough | bool | False | ImageRenderOptions |
Superscript | bool | False | ImageRenderOptions |
Subscript | bool | False | ImageRenderOptions |
FontName | `str | None` | None |
FontSize | `float | None` | None |
FontColor | `int | None` | None |
HighlightColor | `int | None` | None |
LanguageId | `int | None` | None |
IsHyperlink | bool | False | 이 실행이 하이퍼링크인지 여부 |
HyperlinkAddress | `str | None` | None |
ImageRenderOptions
ImageRenderOptions CompositeNode. 삽입된 이미지.
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|
FileName | `str | None` |
Bytes | bytes | 원시 이미지 데이터 (기본 b"") |
Width | `float | None` |
Height | `float | None` |
AlternativeTextTitle | `str | None` |
AlternativeTextDescription | `str | None` |
HyperlinkUrl | `str | None` |
Tags | list[NoteTag] | 이 이미지에 첨부된 OneNote 태그 |
ImageRenderOptions:
| ImageRenderOptions | ImageRenderOptions |
|---|---|
Replace(image) | ImageRenderOptions Bytes 및 FileName 다른 Image 노드에서 이 노드로 |
AttachedFile
ImageRenderOptions CompositeNode. 포함된 파일 첨부.
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|
FileName | `str | None` |
Bytes | bytes | 원시 파일 데이터 (기본값 b"") |
Tags | list[NoteTag] | 이 첨부 파일에 첨부된 OneNote 태그 |
ImageRenderOptions
ImageRenderOptions CompositeNode. OutlineElement 내의 표.
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|---|
Columns | list[float] | [] | 각 열의 너비 (포인트 단위) |
IsBordersVisible | bool | True | 표 테두리 표시 여부 |
Tags | list[NoteTag] | [] | 이 표에 첨부된 OneNote 태그 |
TableRow
ImageRenderOptions CompositeNode. a 내부의 행 Table. 반복 GetChildNodes(TableCell) 셀에 접근하려면.
TableCell
ImageRenderOptions CompositeNode. a 내부의 셀 TableRow. 포함합니다 RichText, Image, 및 기타 콘텐츠 노드.
NoteTag
ImageRenderOptions Node. 콘텐츠 노드에 연결된 OneNote 태그.
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|---|
shape | `int | None` | None |
label | `str | None` | None |
text_color | `int | None` | None |
highlight_color | `int | None` | None |
created | `int | None` | None |
completed | `int | None` | None |
타임스탬프 메모: created 및 completed 는 MS-ONE 바이너리 형식에서 파싱된 원시 정수 타임스탬프이며, datetime 객체.
팩토리 메서드:
| ImageRenderOptions | ImageRenderOptions |
|---|---|
NoteTag.CreateYellowStar() | 생성합니다 a NoteTag(shape=None, label="Yellow Star") |
NumberList
ImageRenderOptions Node. 번호 매기기 또는 글머리표 목록 메타데이터 OutlineElement.
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|---|
Format | `str | None` | None |
Restart | `int | None` | None |
IsNumbered | bool | False | 정렬된(번호 매긴) 목록에 대해 true |
LoadOptions
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|---|
DocumentPassword | `str | None` | None |
LoadHistory | bool | False | API 호환성 필드; v26.3.1에서는 기능적으로 사용되지 않음 |
SaveOptions
모든 저장 옵션의 기본 클래스입니다. 필수 위치 인수입니다.
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|
SaveFormat | SaveFormat | 대상 저장 형식 |
PdfSaveOptions
ImageRenderOptions SaveOptions. PDF 전용 내보내기 구성. 다음을 사용하여 구성 PdfSaveOptions(SaveFormat.Pdf).
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|---|
PageIndex | int | 0 | 필드가 존재합니다; v26.3.1에서 PDF 내보내기로 전달되지 않음: 출력에 영향을 주지 않음 |
PageCount | `int | None` | None |
TagIconDir | `str | None` | None |
TagIconSize | `float | None` | None |
TagIconGap | `float | None` | None |
PageIndex / PageCount 주의사항: 이러한 필드는 다음에 선언됩니다 PdfSaveOptions API 호환성을 위해, 하지만 the Document.Save() v26.3.1 구현에서는 이를 읽거나 PDF 내보내기로 전달하지 않습니다. 모든 페이지가 항상 내보내집니다.
라이선스 및 사용량 기반
.NET용 Aspose.Note와의 API 형태 호환성을 위해 호환성 스텁이 내보내집니다. 이 FOSS 구현에서는 모든 메서드가 아무 작업도 수행하지 않습니다.
from aspose.note import License, Metered
lic = License()
lic.SetLicense("path/to/license.lic") # no-op
m = Metered()
m.SetMeteredKey("public_key", "private_key") # no-opPython용 Aspose.Note FOSS의 모든 기능을 사용하기 위해 라이선스 키가 필요하지 않습니다.
ImageRenderOptions
전체 열거형 참조: ImageRenderOptions
SaveFormat
| ImageRenderOptions | ImageRenderOptions |
|---|---|
SaveFormat.Pdf | PDF 내보내기: 구현됨; 필요함 pip install "aspose-note[pdf]" |
SaveFormat.One | OneNote 형식: 선언만 됨; 발생함 UnsupportedSaveFormatException |
FileFormat
OneNote 파일 형식 버전을 나타내는 열거형 값. Document.FileFormat 최선의 시도로 표시를 제공합니다.
| ImageRenderOptions | 문자열 값 |
|---|---|
FileFormat.OneNote2010 | "onenote2010" |
FileFormat.OneNoteOnline | "onenoteonline" |
FileFormat.OneNote2007 | "onenote2007" |
HorizontalAlignment
| ImageRenderOptions | 문자열 값 |
|---|---|
HorizontalAlignment.Left | "left" |
HorizontalAlignment.Center | "center" |
HorizontalAlignment.Right | "right" |
NodeType
| ImageRenderOptions | 문자열 값 |
|---|---|
NodeType.Document | "document" |
NodeType.Page | "page" |
NodeType.Outline | "outline" |
NodeType.OutlineElement | "outline_element" |
NodeType.RichText | "rich_text" |
NodeType.Image | "image" |
NodeType.Table | "table" |
NodeType.AttachedFile | "attached_file" |
ImageRenderOptions
전체 예외 참조: ImageRenderOptions
| ImageRenderOptions | ImageRenderOptions |
|---|---|
AsposeNoteError | 모든 Aspose.Note FOSS 예외의 기본 클래스 |
FileCorruptedException | ImageRenderOptions .one 파일을 구문 분석할 수 없습니다(손상되었거나 형식이 잘못된 바이너리). |
IncorrectDocumentStructureException | 파일 구조가 유효하지 않거나 지원되지 않습니다. |
IncorrectPasswordException | 다음 상황에서 발생함 LoadOptions.DocumentPassword 설정됨; 암호화된 문서는 지원되지 않습니다. |
UnsupportedFileFormatException | 파일 형식을 인식할 수 없습니다; 다음을 노출합니다: FileFormat 필드 (string) |
UnsupportedSaveFormatException | 요청된 SaveFormat 이 버전에서는 구현되지 않았습니다. |