ContextNode.PartiallyPopulated 속성
업데이트: 2007년 11월
ContextNode 개체가 일부만 채워졌는지 또는 완전히 채워졌는지를 나타내는 값을 가져오거나 설정합니다.
네임스페이스: Microsoft.Ink
어셈블리: Microsoft.Ink.Analysis(Microsoft.Ink.Analysis.dll)
구문
‘선언
Public Property PartiallyPopulated As Boolean
‘사용 방법
Dim instance As ContextNode
Dim value As Boolean
value = instance.PartiallyPopulated
instance.PartiallyPopulated = value
public bool PartiallyPopulated { get; set; }
public:
property bool PartiallyPopulated {
bool get ();
void set (bool value);
}
/** @property */
public boolean get_PartiallyPopulated()
/** @property */
public void set_PartiallyPopulated(boolean value)
public function get PartiallyPopulated () : boolean
public function set PartiallyPopulated (value : boolean)
속성 값
형식: System.Boolean
데이터 프록시 프로세스 중에 ContextNode 개체에 전체 데이터가 들어 있지 않으면 true이고, 모든 데이터가 추가되었으면 false입니다.
설명
데이터 프록시에서 관련 정보가 모두 제공되기 전에 컨텍스트 노드 트리에 ContextNode 개체가 만들어진 경우 이 속성을 사용합니다. 이 속성은 데이터를 모두 채웠는지 여부를 나타냅니다.
이 값을 true로 설정한 경우 ContextNode가 RootNode, CustomRecognizer, AnalysisHint 또는 알 수 없는 ContextNode가 아니면 비어 있지 않은 Location 값이 있어야 합니다.
스트로크가 삭제되고 스트로크 캐시에서 스트로크를 찾을 수 없으며 트리 일부가 PartiallyPopulated로 표시되어 있으면 InkAnalyzer에서 해당 스트로크를 제거해야 한다는 알림이 이벤트를 통해 응용 프로그램으로 전달되지 않습니다. 따라서 응용 프로그램에서 스트로크를 직접 제거해야 합니다.
문서 트리를 가상화할 때 ContextNode.AddPropertyValue를 사용하여 모든 ContextNode 개체의 PropertyGuidsForContextNodes.RotatedBoundingBox 값을 설정해야 합니다. InkAnalyzer에서 계산하는 RotatedBoundingBox 속성은 기본적으로 모든 필기 ContextNode에 있어야 합니다. 그러나 응용 프로그램에서 PartiallyPopulated 속성을 설정하여 분석 결과를 가상화하는 경우 PopulateContextNode 이벤트를 처리할 때 RotatedBoundingBox 속성을 채워야 합니다. RotatedBoundingBox 속성을 설정하지 않으면 현재 분석 작업에 더 많은 문서 데이터가 사용될 수 있습니다.
예제
다음 예제는 System.Windows.Forms.TreeView를 문서 모델로 사용하여 데이터 프록시에서 InkAnalyzer의 대한 컨텍스트 노드를 저장하고 로드하는 방법을 보여 주는 샘플 코드의 PopulateNode라는 메서드입니다 각 TreeNode 개체의 Tag 속성이 DocumentNodeData 개체로 설정된 경우 DocumentNodeData 클래스는 문서 모델에 ContextNode 개체를 저장합니다.
PopulateNode 메서드는 ContextNode 개체 및 InkAnalyzer 개체를 통해 스트로크, 속성 데이터, 주석 형식, 자식 노드 및 링크를 추가하여 컨텍스트 노드를 완전히 채웁니다. 데이터의 출처는 해당 TreeNode에서 가져온 DocumentNodeData 개체입니다.
this[analyzerNode.Id]는 문서 모델 클래스에서 Guid를 TreeNode에 매핑하는 인덱서입니다.
AddLinksToAnalyer는 문서 모델 클래스에서 링크를 ContextNode에 추가하는 메서드입니다.
노드가 완전히 채워진 후 PartiallyPopulated 속성은 false로 설정됩니다.
Sub PopulateNode(ByVal analyzerNode As Microsoft.Ink.ContextNode, _
ByVal theInkAnalyzer As Microsoft.Ink.InkAnalyzer) _
Implements IDocumentModel.PopulateNode
System.Diagnostics.Debug.WriteLine( _
String.Format("IDocumentModel.PopulateNode: populate {0} {1}.", _
TreeViewDocumentModel.GetContextNodeTypeName(analyzerNode.Type), analyzerNode.Id))
System.Diagnostics.Debug.Indent()
' Get the document node associated with the analyzer node.
Dim documentNode As TreeNode = Me(analyzerNode.Id)
If documentNode Is Nothing Then
Throw New ApplicationException("The requested node does not exist in the document model.")
End If
' Get the data associated with the node.
Dim nodeData As DocumentNodeData = documentNode.Tag '
' Copy any application specific data associated with the node to the
' partially populated ContextNode.
Dim identifier As Guid
For Each identifier In nodeData.GetPropertyDataIds()
analyzerNode.AddPropertyData(identifier, nodeData.GetPropertyData(identifier))
Next identifier
' Check if the partially populated ContextNode is an ink leaf node.
If nodeData.IsInkLeafNode Then
' Add the strokes to the context node.
analyzerNode.SetStrokes(nodeData.Strokes)
Else
' Add each child subnode as a partially populated ContextNode.
Dim documentSubNode As TreeNode
For Each documentSubNode In documentNode.Nodes
' Get the DocumentNode data for the
Dim subNodeData As DocumentNodeData = documentSubNode.Tag
If analyzerNode.SubNodes.IndexOf(nodeData.Id) <> -1 Then
analyzerNode.CreatePartiallyPopulatedSubNode( _
subNodeData.Type, subNodeData.Id, subNodeData.Location)
End If
Next documentSubNode
End If
' Add links to the ContextNode.
Me.AddLinksToAnalyzer(documentNode, analyzerNode, theInkAnalyzer)
' Update the partially populated flag.
analyzerNode.PartiallyPopulated = False
System.Diagnostics.Debug.Unindent()
End Sub 'IDocumentModel.PopulateNode
void IDocumentModel.PopulateNode(
Microsoft.Ink.ContextNode analyzerNode,
Microsoft.Ink.InkAnalyzer theInkAnalyzer)
{
System.Diagnostics.Debug.WriteLine(string.Format(
"IDocumentModel.PopulateNode: populate {0} {1}.",
TreeViewDocumentModel.GetContextNodeTypeName(analyzerNode.Type),
analyzerNode.Id));
System.Diagnostics.Debug.Indent();
// Get the document node associated with the analyzer node.
TreeNode documentNode = this[analyzerNode.Id];
if (null == documentNode)
{
throw new ApplicationException(
"The requested node does not exist in the document model.");
}
// Get the data associated with the node.
DocumentNodeData nodeData = documentNode.Tag as DocumentNodeData;
// Copy any application specific data associated with the node to the
// partially populated ContextNode.
foreach (Guid identifier in nodeData.GetPropertyDataIds())
{
analyzerNode.AddPropertyData(
identifier, nodeData.GetPropertyData(identifier));
}
// Check if the partially populated ContextNode is an ink leaf node.
if (nodeData.IsInkLeafNode)
{
// Add the strokes to the context node.
analyzerNode.SetStrokes(nodeData.Strokes);
}
else
{
// Add each child subnode as a partially populated ContextNode.
foreach (TreeNode documentSubNode in documentNode.Nodes)
{
// Get the DocumentNode data for the
DocumentNodeData subNodeData = documentSubNode.Tag as DocumentNodeData;
if (analyzerNode.SubNodes.IndexOf(nodeData.Id) != -1)
{
analyzerNode.CreatePartiallyPopulatedSubNode(
subNodeData.Type, subNodeData.Id, subNodeData.Location);
}
}
}
// Add links to the ContextNode.
this.AddLinksToAnalyzer(documentNode, analyzerNode, theInkAnalyzer);
// Update the partially populated flag.
analyzerNode.PartiallyPopulated = false;
System.Diagnostics.Debug.Unindent();
}
플랫폼
Windows Vista
.NET Framework 및 .NET Compact Framework에서 모든 플랫폼의 전체 버전을 지원하지는 않습니다. 지원되는 버전의 목록을 보려면 .NET Framework 시스템 요구 사항을 참조하십시오.
버전 정보
.NET Framework
3.0에서 지원