ContextNode.CreateSubNode メソッド

[アーティクル]
10/28/2008

子 ContextNode オブジェクトを新規作成します。

名前空間 : Microsoft.Ink
アセンブリ : Microsoft.Ink.Analysis (Microsoft.Ink.Analysis.dll 内)

構文

'宣言
Public Function CreateSubNode ( _
    type As Guid _
) As ContextNode
'使用
Dim instance As ContextNode
Dim type As Guid
Dim returnValue As ContextNode

returnValue = instance.CreateSubNode(type)

public ContextNode CreateSubNode(
    Guid type
)

public:
ContextNode^ CreateSubNode(
    Guid type
)

public ContextNode CreateSubNode(
    Guid type
)

public function CreateSubNode(
    type : Guid
) : ContextNode

パラメータ

type
型 : System.Guid
作成するコンテキストノードの型。ContextNodeType クラスで定義されている GUID のいずれかを使用して、作成する型を指定します。

戻り値

型 : Microsoft.Ink.ContextNode
親がこの ContextNode である、新しく作成された ContextNode オブジェクト。

解説

既存の子ノードが既に存在する場合、新しく作成された ContextNode は SubNodes のコレクション内の最後の子として追加されます。

アプリケーションが不適切なノード (たとえば、ImageNode ノードがあるはずの位置にある手書き領域) の追加を意図せずに試みた場合、コードは CreateSubNode から例外をスローします。

例

この例では、すべての行を独自の段落に配置します。また、InkAnalyzer の行を使用することにより、theInkAnalyzer; がそれらの各行の新しい段落サブノードを作成して、行の親をそれらの新しい段落に再設定します。

' Take each line and make it its own paragraph
Dim originalParagraphs As ContextNodeCollection = _
    theInkAnalyzer.FindNodesOfType(Microsoft.Ink.ContextNodeType.Paragraph)
Dim lines As ContextNodeCollection = _
    theInkAnalyzer.FindNodesOfType(Microsoft.Ink.ContextNodeType.Line)
Dim lineNode As ContextNode
For Each lineNode In lines
    ' Create a new alignment level and paragraph
    Dim lineParagraph As ContextNode = lineNode.ParentNode
    Dim writingRegion As ContextNode = lineParagraph.ParentNode
    Dim newParagraph As ParagraphNode = _
        CType(writingRegion.CreateSubNode(Microsoft.Ink.ContextNodeType.Paragraph), ParagraphNode)
    ' Reparent the line
    lineNode.Reparent(newParagraph)
Next lineNode
' Remove original paragraphs and alignment nodes
Dim originalParagraph As ContextNode
For Each originalParagraph In originalParagraphs
    Dim originalAlignmentLevel As ContextNode = originalParagraph.ParentNode
    originalAlignmentLevel.DeleteSubNode(originalParagraph)
    originalAlignmentLevel.ParentNode.DeleteSubNode(originalAlignmentLevel)
Next originalParagraph

            // Take each line and make it its own paragraph
            ContextNodeCollection originalParagraphs = 
                theInkAnalyzer.FindNodesOfType(Microsoft.Ink.ContextNodeType.Paragraph);
            ContextNodeCollection lines = 
                theInkAnalyzer.FindNodesOfType(Microsoft.Ink.ContextNodeType.Line);
            foreach (ContextNode lineNode in lines)
            {
                // Create a new paragraph
                ContextNode paragraph = lineNode.ParentNode;
                ContextNode writingRegion = paragraph.ParentNode;
                ParagraphNode newParagraph = (ParagraphNode)
                    writingRegion.CreateSubNode(Microsoft.Ink.ContextNodeType.Paragraph);
                // Reparent the line
                lineNode.Reparent(newParagraph);
            }
            // Remove original paragraphs 
            foreach (ContextNode originalParagraph in originalParagraphs)
            {
                ContextNode originalWritingRegion = originalParagraph.ParentNode;
                originalWritingRegion.DeleteSubNode(originalParagraph);
            }