Stroke.SetPacketValuesByProperty, méthode (Guid, array<Int32[])
Mise à jour : November 2007
Définit les données pour une propriété de paquet spécifiée pour tous les paquets dans l'objet Stroke.
Espace de noms : Microsoft.Ink
Assembly : Microsoft.Ink (dans Microsoft.Ink.dll)
Syntaxe
'Déclaration
Public Function SetPacketValuesByProperty ( _
id As Guid, _
packetValues As Integer() _
) As Integer
'Utilisation
Dim instance As Stroke
Dim id As Guid
Dim packetValues As Integer()
Dim returnValue As Integer
returnValue = instance.SetPacketValuesByProperty(id, _
packetValues)
public int SetPacketValuesByProperty(
Guid id,
int[] packetValues
)
public:
int SetPacketValuesByProperty(
Guid id,
array<int>^ packetValues
)
public int SetPacketValuesByProperty(
Guid id,
int[] packetValues
)
public function SetPacketValuesByProperty(
id : Guid,
packetValues : int[]
) : int
Paramètres
- id
Type : System.Guid
Identificateur Guid(page pouvant être en anglais) de l'objet PacketProperty utilisé pour sélectionner les données de paquet à définir. Utilisez la propriété PacketDescription pour déterminer les propriétés définies pour cet objet Stroke.
- packetValues
Type : array<System.Int32[]
Tableau des valeurs de données de paquet. La méthode échoue si l'une des valeurs du tableau dépasse la valeur minimale ou maximale de la propriété. Pour déterminer la plage de valeurs de la propriété, appelez la méthode GetPacketDescriptionPropertyMetrics.
Valeur de retour
Type : System.Int32
Retourne le nombre réel de paquets définis.
Notes
Tous les paquets sont modifiés.
Cette méthode lève une exception si la longueur du tableau packetValues est incorrecte.
Exemples
Dans cet exemple, chaque objet Stroke sélectionné d'un objet InkOverlay est modifié de sorte que le paquet NormalPressure augmente toujours ou reste constant pour tous les points du trait.
Les valeurs de paquet NormalPressure pour l'objet Stroke sont obtenues et triées dans l'ordre croissant à l'aide de la méthode GetPacketValuesByProperty. Les valeurs triées sont de nouveau appliquées au trait à l'aide de la méthode 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
}
Plateformes
Windows Vista
Le .NET Framework et le .NET Compact Framework ne prennent pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.
Informations de version
.NET Framework
Pris en charge dans : 3.0