Stroke.GetPacketValuesByProperty メソッド (Guid)
Stroke オブジェクト内のすべてのパケットの指定されたパケット プロパティのデータを返します。
名前空間 : Microsoft.Ink
アセンブリ : Microsoft.Ink (Microsoft.Ink.dll 内)
構文
'宣言
Public Function GetPacketValuesByProperty ( _
id As Guid _
) As Integer()
'使用
Dim instance As Stroke
Dim id As Guid
Dim returnValue As Integer()
returnValue = instance.GetPacketValuesByProperty(id)
public int[] GetPacketValuesByProperty(
Guid id
)
public:
array<int>^ GetPacketValuesByProperty(
Guid id
)
public int[] GetPacketValuesByProperty(
Guid id
)
public function GetPacketValuesByProperty(
id : Guid
) : int[]
パラメータ
- id
型 : System.Guid
取得するパケット データの選択に使用される PacketProperty オブジェクトの Guid 識別子。
戻り値
型 : array<System.Int32[]
Stroke オブジェクト内から要求された各ポイントの、要求された PacketProperty オブジェクトの値を指定する 32 ビット符号付き整数配列を返します。
解説
特定のパケット プロパティは、特定の Stroke オブジェクトでは使用できない場合があります。Tablet PC には、ユーザー入力用のタブレットが複数存在する場合があります。Tablets コレクションには、Tablet PC に取り付けられているすべてのタブレットの一覧が含まれています。特定のパケット プロパティが特定の Tablet オブジェクトまたは使用可能なすべてのタブレットによりサポートされているかどうかを確認するには、IsPacketPropertySupported メソッドを使用します。さらに、新しいストロークで収集するパケット プロパティを制御するには、InkCollector.DesiredPacketDescription、InkOverlay.DesiredPacketDescription または InkPicture.DesiredPacketDescription プロパティを使用します。
例
この例では、InkOverlay オブジェクトで選択された各 Stroke オブジェクトは、NormalPressure パケットがストロークのすべてのポイントで常に増加する、または一定値を保つように変更されます。
GetPacketValuesByProperty メソッドを使用して、Stroke オブジェクトの NormalPressure パケット値が取得され昇順に格納されます。格納された値は、次に SetPacketValuesByProperty メソッドを使用してストロークに再適用されます。
Try
For Each S As Stroke In mInkOverlay.Selection
' get the NormalPressure values
Dim npValues() As Integer = S.GetPacketValuesByProperty(PacketProperty.NormalPressure)
' sort them
Array.Sort(npValues)
' set the NormalPressure values
S.SetPacketValuesByProperty(PacketProperty.NormalPressure, npValues)
Next
Catch ex As ArgumentException
' This exception will be raised if PacketProperty.NormalPressure is not supported
' This will be the case if creating strokes with a mouse
End Try
try
{
foreach (Stroke S in mInkOverlay.Selection)
{
// get the NormalPressure values
int[] npValues = S.GetPacketValuesByProperty(PacketProperty.NormalPressure);
// sort them
Array.Sort(npValues);
// set the NormalPressure values
S.SetPacketValuesByProperty(PacketProperty.NormalPressure, npValues);
}
}
catch (ArgumentException)
{
// This exception will be raised if PacketProperty.NormalPressure is not supported
// This will be the case if creating strokes with a mouse
}
プラットフォーム
Windows Vista
.NET Framework および .NET Compact Framework では、各プラットフォームのすべてのバージョンはサポートしていません。サポートされているバージョンについては、「.NET Framework システム要件」を参照してください。
バージョン情報
.NET Framework
サポート対象 : 3.0
参照
参照
GetPacketValuesByProperty オーバーロード
InkCollector.DesiredPacketDescription
InkOverlay.DesiredPacketDescription
InkPicture.DesiredPacketDescription