既知の PacketProperty オブジェクトのメトリックス データを返します。
名前空間 : Microsoft.Ink
アセンブリ : Microsoft.Ink (Microsoft.Ink.dll 内)
構文
'宣言
Public Function GetPropertyMetrics ( _
id As Guid _
) As TabletPropertyMetrics
'使用
Dim instance As Tablet
Dim id As Guid
Dim returnValue As TabletPropertyMetrics
returnValue = instance.GetPropertyMetrics(id)
public TabletPropertyMetrics GetPropertyMetrics(
Guid id
)
public:
TabletPropertyMetrics GetPropertyMetrics(
Guid id
)
public TabletPropertyMetrics GetPropertyMetrics(
Guid id
)
public function GetPropertyMetrics(
id : Guid
) : TabletPropertyMetrics
パラメータ
- id
型 : System.Guid
要求している PacketProperty の Guid 識別子。
戻り値
型 : Microsoft.Ink.TabletPropertyMetrics
このメソッドは、タブレットによりサポートされる、要求されたプロパティの TabletPropertyMetrics オブジェクトを返します。
解説
メトリックスを受け取るプロパティには、パケットが生成された時間や、タブレットの表面におけるペン先の下方向の圧力が含まれます。
.gif "メモ") メモ : |
|---|
この関数は、特定のメッセージ ハンドラ内で呼び出された場合に再入力されることがあり、予期しない結果が生じる可能性があります。WM_ACTIVATE、WM_ACTIVATEAPP、WM_NCACTIVATE、WM_PAINT、wParam が SC_HOTKEY または SC_TASKLIST に設定されている場合のWM_SYSCOMMAND および WM_SYSKEYDOWN (Alt-Tab キーまたは Alt-Esc キーの組み合わせで処理される場合) のいずれかのメッセージを処理するときは、再入呼び出しを回避するように注意してください。これはシングル スレッド アパートメント モデル アプリケーションに関する問題です。 |
例
この例では、Tablets コレクションの既定の Tablet オブジェクトの、サポートされている各プロパティのプロパティ メトリックスについて報告します。
Public Function Report_PropertyMetrics_DefaultTablet() As String
Dim SB As StringBuilder = New StringBuilder(1024)
Dim defTablet As Tablet = New Tablets().DefaultTablet
' Report on each of the property metrics for the default tablet
SB.AppendLine("Propert metrics of the default tablet: " + defTablet.Name)
SB.Append(GetPropertyMetrics(defTablet, PacketProperty.AltitudeOrientation, "AltitudeOrientation"))
SB.Append(GetPropertyMetrics(defTablet, PacketProperty.AzimuthOrientation, "AzimuthOrientation"))
SB.Append(GetPropertyMetrics(defTablet, PacketProperty.ButtonPressure, "ButtonPressure"))
SB.Append(GetPropertyMetrics(defTablet, PacketProperty.NormalPressure, "NormalPressure"))
SB.Append(GetPropertyMetrics(defTablet, PacketProperty.PacketStatus, "PacketStatus"))
SB.Append(GetPropertyMetrics(defTablet, PacketProperty.PitchRotation, "PitchRotation"))
SB.Append(GetPropertyMetrics(defTablet, PacketProperty.RollRotation, "RollRotation"))
SB.Append(GetPropertyMetrics(defTablet, PacketProperty.SerialNumber, "SerialNumber"))
SB.Append(GetPropertyMetrics(defTablet, PacketProperty.TangentPressure, "TangentPressure"))
SB.Append(GetPropertyMetrics(defTablet, PacketProperty.TimerTick, "TimerTick"))
SB.Append(GetPropertyMetrics(defTablet, PacketProperty.TwistOrientation, "TwistOrientation"))
SB.Append(GetPropertyMetrics(defTablet, PacketProperty.X, "X"))
SB.Append(GetPropertyMetrics(defTablet, PacketProperty.XTiltOrientation, "XTiltOrientation"))
SB.Append(GetPropertyMetrics(defTablet, PacketProperty.Y, "Y"))
SB.Append(GetPropertyMetrics(defTablet, PacketProperty.YawRotation, "YawRotation"))
SB.Append(GetPropertyMetrics(defTablet, PacketProperty.YTiltOrientation, "YTiltOrientation"))
SB.Append(GetPropertyMetrics(defTablet, PacketProperty.Z, "Z"))
Return SB.ToString()
End Function
Public Function GetPropertyMetrics( _
ByVal theTablet As Tablet, _
ByVal PropertyID As Guid, _
ByVal PropertyName As String) As String
Dim SB As StringBuilder = New StringBuilder(1024)
' If this particular property is supported,
' report the name and property metrics information.
If theTablet.IsPacketPropertySupported(PropertyID) Then
SB.AppendLine(PropertyName)
Dim theMetrics As TabletPropertyMetrics = theTablet.GetPropertyMetrics(PropertyID)
SB.AppendLine(" Max: " + theMetrics.Maximum.ToString())
SB.AppendLine(" Min: " + theMetrics.Minimum.ToString())
SB.AppendLine(" Resolution: " + theMetrics.Resolution.ToString())
SB.AppendLine(" Units: " + theMetrics.Units.ToString())
Else
SB.AppendLine(PropertyName + " [not supported]")
End If
Return SB.ToString()
End Function
public string Report_PropertyMetrics_DefaultTablet()
{
StringBuilder SB = new StringBuilder(1024);
Tablet defTablet = new Tablets().DefaultTablet;
// Report on each of the property metrics for the default tablet
SB.AppendLine("Propert metrics of the default tablet: " + defTablet.Name);
SB.Append( GetPropertyMetrics(defTablet, PacketProperty.AltitudeOrientation, "AltitudeOrientation"));
SB.Append( GetPropertyMetrics(defTablet, PacketProperty.AzimuthOrientation, "AzimuthOrientation"));
SB.Append( GetPropertyMetrics(defTablet, PacketProperty.ButtonPressure, "ButtonPressure"));
SB.Append( GetPropertyMetrics(defTablet, PacketProperty.NormalPressure, "NormalPressure"));
SB.Append( GetPropertyMetrics(defTablet, PacketProperty.PacketStatus, "PacketStatus"));
SB.Append( GetPropertyMetrics(defTablet, PacketProperty.PitchRotation, "PitchRotation"));
SB.Append( GetPropertyMetrics(defTablet, PacketProperty.RollRotation, "RollRotation"));
SB.Append( GetPropertyMetrics(defTablet, PacketProperty.SerialNumber, "SerialNumber"));
SB.Append( GetPropertyMetrics(defTablet, PacketProperty.TangentPressure, "TangentPressure"));
SB.Append( GetPropertyMetrics(defTablet, PacketProperty.TimerTick, "TimerTick"));
SB.Append( GetPropertyMetrics(defTablet, PacketProperty.TwistOrientation, "TwistOrientation"));
SB.Append( GetPropertyMetrics(defTablet, PacketProperty.X, "X"));
SB.Append( GetPropertyMetrics(defTablet, PacketProperty.XTiltOrientation, "XTiltOrientation"));
SB.Append( GetPropertyMetrics(defTablet, PacketProperty.Y, "Y"));
SB.Append( GetPropertyMetrics(defTablet, PacketProperty.YawRotation, "YawRotation"));
SB.Append( GetPropertyMetrics(defTablet, PacketProperty.YTiltOrientation, "YTiltOrientation"));
SB.Append( GetPropertyMetrics(defTablet, PacketProperty.Z, "Z"));
return SB.ToString();
}
public string GetPropertyMetrics(Tablet theTablet, Guid PropertyID, string PropertyName)
{
StringBuilder SB = new StringBuilder(1024);
// If this particular property is supported,
// report the name and property metrics information.
if (theTablet.IsPacketPropertySupported(PropertyID))
{
SB.AppendLine(PropertyName);
TabletPropertyMetrics theMetrics = theTablet.GetPropertyMetrics(PropertyID);
SB.AppendLine(" Max: " + theMetrics.Maximum.ToString());
SB.AppendLine(" Min: " + theMetrics.Minimum.ToString());
SB.AppendLine(" Resolution: " + theMetrics.Resolution.ToString());
SB.AppendLine(" Units: " + theMetrics.Units.ToString());
}
else
{
SB.AppendLine(PropertyName + " [not supported]");
}
return SB.ToString();
}
プラットフォーム
Windows Vista
.NET Framework および .NET Compact Framework では、各プラットフォームのすべてのバージョンはサポートしていません。サポートされているバージョンについては、「.NET Framework システム要件」を参照してください。
バージョン情報
.NET Framework
サポート対象 : 3.0
参照
参照
Stroke.GetPacketValuesByProperty