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

フレームを表示

UpdateImageBoxメソッド








更新されるimageボックスのSOPインスタンスUID。メソッドは、これが無効な参照(Visual BasicではNothing)であるならば、または、空の文字列が指定されるならば、失敗します。メソッドGetImageBoxInstanceUidは、特定のimageボックスのSOPインスタンスUIDを返します。
指定されたimageボックスで印刷されるimageを格納するDicomDataSetオブジェクト。これが無効な参照(Visual BasicではNothing)に設定されるならば、印刷SCPは指定されたimageボックスでimage(人がいるならば)を消去するように指示されます。
印刷するフレーム番号。
更新されるimageボックスパラメータを指定するDicomImageBoxParametersオブジェクト。メソッドは、このパラメーターが無効な参照(Visual BasicではNothing)に設定されるならば、または、指定されるイメージポジションが1より少ないならば、失敗します。
以前に作成された基本的なプリントイメージのSOPインスタンスUIDは、imageボックスによってリファレンスをつけられるために、ボックスSOPインスタンスの上に横たわりました。参照が更新されないことになっているならば、これは無効な参照(Visual BasicではNothing)に設定されることができます;この場合、対応する属性は、印刷SCPに要求に含まれません。空の文字列が指定される、そして、imageボックスがimageオーバレイボックスをすでに参照文に引用するならば、最新版はその参照を削除します。imageオーバレイボックスを作成するためのメソッドCreateOverlayBoxを参照してください
SOPは、imageボックスによってリファレンスをつけられるために、以前に作成された表現LUT SOPインスタンスのUIDを例証します。参照が更新されないことになっているならば、これは無効な参照(Visual BasicではNothing)に設定されることができます;この場合、対応する属性は、印刷SCPに要求に含まれません。空の文字列が指定される、そして、imageボックスが表現LUTをすでに参照文に引用するならば、最新版はその参照を削除します。グレースケールimageボックスだけが表現LUTを参照文に引用するかもしれないため、メソッドはカラーイメージボックスのためにこのパラメーターを無視します。表現LUTを作成するためのメソッドCreatePresentationLutを参照してください
印刷SCPに指定された基本的なグレースケール/カラーイメージボックスSOPインスタンスを更新することを要求します。
構文
'Declaration
 
Public Sub UpdateImageBox( _
   ByVal imageBoxInstanceUid As String, _
   ByVal image As DicomDataSet, _
   ByVal index As Integer, _
   ByVal parameters As DicomImageBoxParameters, _
   ByVal refImageOverlayBoxInstanceUid As String, _
   ByVal refPresentationLutInstanceUid As String _
) 
'Usage
 
Dim instance As DicomPrintScu
Dim imageBoxInstanceUid As String
Dim image As DicomDataSet
Dim index As Integer
Dim parameters As DicomImageBoxParameters
Dim refImageOverlayBoxInstanceUid As String
Dim refPresentationLutInstanceUid As String
 
instance.UpdateImageBox(imageBoxInstanceUid, image, index, parameters, refImageOverlayBoxInstanceUid, refPresentationLutInstanceUid)
 function Leadtools.Dicom.DicomPrintScu.UpdateImageBox( 
   imageBoxInstanceUid ,
   image ,
   index ,
   parameters ,
   refImageOverlayBoxInstanceUid ,
   refPresentationLutInstanceUid 
)

パラメーター

imageBoxInstanceUid
更新されるimageボックスのSOPインスタンスUID。メソッドは、これが無効な参照(Visual BasicではNothing)であるならば、または、空の文字列が指定されるならば、失敗します。メソッドGetImageBoxInstanceUidは、特定のimageボックスのSOPインスタンスUIDを返します。
image
指定されたimageボックスで印刷されるimageを格納するDicomDataSetオブジェクト。これが無効な参照(Visual BasicではNothing)に設定されるならば、印刷SCPは指定されたimageボックスでimage(人がいるならば)を消去するように指示されます。
インデックス
印刷するフレーム番号。
パラメータ
更新されるimageボックスパラメータを指定するDicomImageBoxParametersオブジェクト。メソッドは、このパラメーターが無効な参照(Visual BasicではNothing)に設定されるならば、または、指定されるイメージポジションが1より少ないならば、失敗します。
refImageOverlayBoxInstanceUid
以前に作成された基本的なプリントイメージのSOPインスタンスUIDは、imageボックスによってリファレンスをつけられるために、ボックスSOPインスタンスの上に横たわりました。参照が更新されないことになっているならば、これは無効な参照(Visual BasicではNothing)に設定されることができます;この場合、対応する属性は、印刷SCPに要求に含まれません。空の文字列が指定される、そして、imageボックスがimageオーバレイボックスをすでに参照文に引用するならば、最新版はその参照を削除します。imageオーバレイボックスを作成するためのメソッドCreateOverlayBoxを参照してください
refPresentationLutInstanceUid
SOPは、imageボックスによってリファレンスをつけられるために、以前に作成された表現LUT SOPインスタンスのUIDを例証します。参照が更新されないことになっているならば、これは無効な参照(Visual BasicではNothing)に設定されることができます;この場合、対応する属性は、印刷SCPに要求に含まれません。空の文字列が指定される、そして、imageボックスが表現LUTをすでに参照文に引用するならば、最新版はその参照を削除します。グレースケールimageボックスだけが表現LUTを参照文に引用するかもしれないため、メソッドはカラーイメージボックスのためにこのパラメーターを無視します。表現LUTを作成するためのメソッドCreatePresentationLutを参照してください
解説
このメソッドによってスローされることができる例外の2つは、以下の通りです:
例外型。 状態
DicomExceptionCode.PrintSCUFailureStatus 印刷SCPの反応は、失敗ステータスコードを指定します。
DicomExceptionCode.PrintSCUClassNotSupported 基本グレースケールプリント管理機構Meta SOPクラスも基本カラープリント管理機構Meta SOPクラスも、アソシエーションの上でサポートされません。

印刷SCPがフィルムボックスを作成するよう求められるとき、それは一つ以上のimageボックスも作成します。そして、image表示書式に基づきます。このメソッドは、特定のimageボックスを更新します。指定される(SOPインスタンスUIDによって)imageボックスは、現在の(最後に作成された)フィルムボックスが所有していなければなりません。

印刷SCP(グレースケールまたはカラー)によって作成されるimageボックスの型は、最初は作成されるフィルムセッションのMeta SOPクラスに依存します。詳細については、「メソッドCreateFilmSession」を参照してください。

それが印刷SCPの返信を受け取るまで、メソッドは返りません、または、エラーは発生します。メソッドGetLastOperationStatusは、印刷SCPの反応で指定されているステータスコードを得るのに用いられることができます。メソッドUpdateImageBoxが成功しているならば、印刷SCPの反応における成功か警告ステータスコードで、imageボックスは正常に更新されました。

パラメーターパラメータ更新されるimageボックスパラメータを指定します。渡されたオブジェクトに、stringプロパティが無効な参照(Visual BasicではNothing)であるならば、対応する属性は印刷SCPに要求に含まれないで、それゆえに、更新されません。同様に、数字のプロパティが負であるならば、対応する属性は要求に含まれないで、それゆえに、更新されません。属性最低濃度、マックス密度と構成情報がグレースケールimageボックスのためにだけ定義されるため、メソッドがカラーイメージボックスのためにDicomImageBoxParametersクラスの以下のプロパティを無視することがわかります:

MinDensity

MaxDensity

ConfigurationInformation

サンプル
サンプルのために、参照しますAssociate
必要条件

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

参照

参照

DicomPrintScuクラス
DicomPrintScuメンバ
CreateFilmSessionメソッド
CreateFilmBoxメソッド
GetImageBoxesCountメソッド
GetImageBoxInstanceUidメソッド
GetDefaultImageBoxParametersメソッド
FreeImageBoxesInstanceUidsメソッド
GetLastOperationStatusメソッド
CreateOverlayBoxメソッド
CreatePresentationLutメソッド

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