LEADTOOLS Medical(Leadtools.Dicomアセンブリ)

フレームを表示

SetStringValue(DicomElement、String、DicomCharacterSetType)メソッド








データの項目は、設定しました。
設定するために文字列値を格納する文字列。
文字は、入力文字列を挿入するとき、使用に設定しました。
データ要素の文字列値を設定します。
構文
'Declaration
 
Public Overloads Function SetStringValue( _
   ByVal element As DicomElement, _
   ByVal value As String, _
   ByVal characterSet As DicomCharacterSetType _
) As Boolean
'Usage
 
Dim instance As DicomDataSet
Dim element As DicomElement
Dim value As String
Dim characterSet As DicomCharacterSetType
Dim value As Boolean
 
value = instance.SetStringValue(element, value, characterSet)
public boolean setStringValue(DicomElement element, String value)
 function Leadtools.Dicom.DicomDataSet.SetStringValue(DicomElement,String,DicomCharacterSetType)( 
   element ,
   value ,
   characterSet 
)

パラメーター

要素
データの項目は、設定しました。
設定するために文字列値を格納する文字列。
characterSet
文字は、入力文字列を挿入するとき、使用に設定しました。

戻り値

文字列値が正常に設定されるならばtrue。データ要素の文字列値を設定することができないならば、間違った。
解説
データ要素の値表現が以下の通りである場合だけ、このメソッドは呼び出されることができます: 値表現の詳細については、「デフォルト値表現表」を参照してください。
サンプル

このサンプルは、DicomDataSetのDICOM要素の値として日本のstringを書き込むためにSetStringValueとSetStringValuePtrのいろいろなオーバーロードを使う方法を示します

Copy Code  
Imports Leadtools
Imports Leadtools.Dicom

'''
Private Sub DicomSetStringValueTest()
   DicomEngine.Startup()
   Dim ds As New DicomDataSet()
   Dim japaneseText1 As String = "亜美"
   Dim japaneseText2 As String = "千香子"
   Dim japaneseStrings() As String = {japaneseText1, japaneseText2}
   Dim element As DicomElement

   ' Example 1 - uses Specific Character Set Attribute (0008,0005) to set one string
   ds.Reset()
   element = ds.InsertElement(Nothing, False, DicomTag.PatientName, DicomVRType.PN, False, 0)
   ds.InsertElementAndSetValue(DicomTag.SpecificCharacterSet, "ISO_IR 192") ' Unicode in UTF-8
   ds.SetStringValue(element, japaneseText1)
   Dim result As String = ds.GetStringValue(element, 0)
   Debug.Assert(result = japaneseText1)

   ' Example 2 - uses Specific Character Set Attribute (0008,0005) to set two strings
   ds.Reset()
   element = ds.InsertElement(Nothing, False, DicomTag.OtherPatientNames, DicomVRType.PN, False, 0)
   ds.InsertElementAndSetValue(DicomTag.SpecificCharacterSet, "ISO_IR 192") ' Unicode in UTF-8
   ds.SetStringValue(element, japaneseStrings)
   Debug.Assert(ds.GetStringValue(element, 0) = japaneseStrings(0))
   Debug.Assert(ds.GetStringValue(element, 1) = japaneseStrings(1))

   ' Example 3 - pass in a DicomCharacterSet and set one string
   ds.Reset()
   element = ds.InsertElement(Nothing, False, DicomTag.PatientName, DicomVRType.PN, False, 0)
   ds.SetStringValue(element, japaneseText1, DicomCharacterSetType.UnicodeInUtf8)
   result = ds.GetStringValue(element, 0)
   Debug.Assert(result = japaneseText1)

   ' Example 4 -- pass in a DicomCharacterSet and set two strings
   ds.Reset()
   element = ds.InsertElement(Nothing, False, DicomTag.OtherPatientNames, DicomVRType.PN, False, 0)
   ds.SetStringValue(element, japaneseStrings, DicomCharacterSetType.UnicodeInUtf8)
   Debug.Assert(ds.GetStringValue(element, 0) = japaneseStrings(0))
   Debug.Assert(ds.GetStringValue(element, 1) = japaneseStrings(1))

   ' Example 5 -- uses Specific Character Set Attribute (0008,0005) to set one string using IntPtr
   ds.Reset()
   Dim pinnedArray As GCHandle = GCHandle.Alloc(japaneseText1, GCHandleType.Pinned)
   Dim pointer As IntPtr = pinnedArray.AddrOfPinnedObject()
   element = ds.InsertElement(Nothing, False, DicomTag.PatientName, DicomVRType.PN, False, 0)
   ds.InsertElementAndSetValue(DicomTag.SpecificCharacterSet, "ISO_IR 192") ' Unicode in UTF-8
   ds.SetStringValuePtr(element, pointer, 1)
   result = ds.GetStringValue(element, 0)
   Debug.Assert(result = japaneseText1)
   pinnedArray.Free()

   DicomEngine.Shutdown()
End Sub
using Leadtools;
using Leadtools.Dicom;

///

private void DicomSetStringValueTest()
{
   DicomEngine.Startup();
   DicomDataSet ds = new DicomDataSet();
   string japaneseText1 = "亜美";
   string japaneseText2 = "千香子";
   string[] japaneseStrings = { japaneseText1, japaneseText2 };
   DicomElement element;

   // Example 1 - uses Specific Character Set Attribute (0008,0005) to set one string
   ds.Reset();
   element = ds.InsertElement(null, false, DicomTag.PatientName, DicomVRType.PN, false, 0);
   ds.InsertElementAndSetValue(DicomTag.SpecificCharacterSet, "ISO_IR 192");     // Unicode in UTF-8
   ds.SetStringValue(element, japaneseText1);
   string result = ds.GetStringValue(element, 0);
   Debug.Assert(result == japaneseText1);

   // Example 2 - uses Specific Character Set Attribute (0008,0005) to set two strings
   ds.Reset();
   element = ds.InsertElement(null, false, DicomTag.OtherPatientNames, DicomVRType.PN, false, 0);
   ds.InsertElementAndSetValue(DicomTag.SpecificCharacterSet, "ISO_IR 192");     // Unicode in UTF-8
   ds.SetStringValue(element, japaneseStrings);
   Debug.Assert(ds.GetStringValue(element, 0) == japaneseStrings[0]);
   Debug.Assert(ds.GetStringValue(element, 1) == japaneseStrings[1]);

   // Example 3 - pass in a DicomCharacterSet and set one string
   ds.Reset();
   element = ds.InsertElement(null, false, DicomTag.PatientName, DicomVRType.PN, false, 0);
   ds.SetStringValue(element, japaneseText1, DicomCharacterSetType.UnicodeInUtf8);
   result = ds.GetStringValue(element, 0);
   Debug.Assert(result == japaneseText1);

   // Example 4 -- pass in a DicomCharacterSet and set two strings
   ds.Reset();
   element = ds.InsertElement(null, false, DicomTag.OtherPatientNames, DicomVRType.PN, false, 0);
   ds.SetStringValue(element, japaneseStrings, DicomCharacterSetType.UnicodeInUtf8);
   Debug.Assert(ds.GetStringValue(element, 0) == japaneseStrings[0]);
   Debug.Assert(ds.GetStringValue(element, 1) == japaneseStrings[1]);

   // Example 5 -- uses Specific Character Set Attribute (0008,0005) to set one string using IntPtr
   ds.Reset();
   GCHandle pinnedArray = GCHandle.Alloc(japaneseText1, GCHandleType.Pinned);
   IntPtr pointer = pinnedArray.AddrOfPinnedObject();
   element = ds.InsertElement(null, false, DicomTag.PatientName, DicomVRType.PN, false, 0);
   ds.InsertElementAndSetValue(DicomTag.SpecificCharacterSet, "ISO_IR 192");     // Unicode in UTF-8
   ds.SetStringValuePtr(element, pointer, 1);
   result = ds.GetStringValue(element, 0);
   Debug.Assert(result == japaneseText1);
   pinnedArray.Free();

   DicomEngine.Shutdown();
}
必要条件

ターゲットプラットホーム

参照

参照

DicomDataSetクラス
DicomDataSetメンバ
オーバーロードリスト
SetValueメソッド
SetStringValue(DicomElement、String、DicomCharacterSetType)メソッド
SetStringValue(DicomElement、String[]、DicomCharacterSetType)メソッド
SetStringValue(DicomElement、String)メソッド
SetStringValue(DicomElement、String[])メソッド
SetStringValuePtr(DicomElement、IntPtr、Int32)メソッド
SetStringValuePtr(DicomElement、IntPtr、UInt32、DicomCharacterSetType)メソッド
SetBinaryValue(DicomElement、Byte[]、Int32)メソッド
SetShortValue(DicomElement、Int16[]、Int32)メソッド
SetIntValue(DicomElement、Int32[]、Int32)メソッド
SetFloatValue(DicomElement、シングル[]、Int32)メソッド
SetDoubleValue(DicomElement、Double[]、Int32)メソッド
SetAgeValueメソッド
SetDateValue(DicomElement、DicomDateValue[])メソッド
SetTimeValue(DicomElement、DicomTimeValue[])メソッド
SetDateTimeValue(DicomElement、DicomDateTimeValue[])メソッド

Leadtools.Dicomは、Medicalツールキットサーバのライセンスと、解除キーが必要です。詳細は、以下を参照してください。Imaging Pro/Document/Medicalの機能