IPropertySetter :: GetProps, méthode
Notes
[Déconseillé. Cette API peut être supprimée des futures versions de Windows.]
La GetProps méthode récupère les propriétés définies sur cet objet, avec leurs valeurs correspondantes.
Syntaxe
HRESULT GetProps(
[out] LONG *pcParams,
[out] DEXTER_PARAM **paParam,
[out] DEXTER_VALUE **paValue
);
Paramètres
-
pcParams [ à]
-
Reçoit le nombre de structures retournées dans paParam.
-
paParam [ à]
-
Adresse d’un pointeur vers un tableau de structures de _ paramètres Dexter .
-
paValue [ à]
-
Adresse d’un pointeur vers un tableau de structures de _ valeur Dexterity .
Valeur retournée
Si cette méthode est réussie, elle retourne la valeur _ OK. Sinon, elle retourne un code d’erreur HRESULT .
Remarques
Pour chaque propriété retournée dans paParam, le membre nvaleurs indique le nombre de structures de _ valeur dexterisation associées à la propriété. Les paires sont retournées dans l’ordre chronologique croissant de chaque propriété.
Lorsque vous avez terminé d’utiliser les structures retournées, appelez IPropertySetter :: FreeProps pour libérer les ressources allouées par cette méthode.
Notes
Le fichier d’en-tête qedit. h n’est pas compatible avec les en-têtes Direct3D ultérieurs à la version 7.
Notes
pour obtenir Qedit. h, téléchargez la mise à jour Microsoft Windows SDK pour Windows Vista et .NET Framework 3,0. Qedit. h n’est pas disponible dans le Microsoft Windows SDK pour Windows 7 et .NET Framework 3,5 Service Pack 1.
Exemples
L’exemple de code suivant montre comment itérer au sein de toutes les valeurs sur une instance de l’accesseur Set de propriété :
IPropertySetter *pSetter = NULL;
// Get a valid IPropertySetter pointer (not shown).
DEXTER_PARAM *pParam;
DEXTER_VALUE *pValue;
LONG count;
hr = pSetter->GetProps(&count, &pParam, &pValue);
LONG num = 0;
for (LONG i = 0; i < count; i++)
{
for (LONG j = 0; j < pParam[i].nValues; j++)
{
// pValue[num] is the next value in the sequence for pParam[i]
}
num += pParam[i].nValues;
}
Configuration requise
| Condition requise | Valeur |
|---|---|
| En-tête |
|
| Bibliothèque |
|