xlfGetDef
S’applique à: Excel 2013 | Office 2013 | Visual Studio
Retourne le nom, sous forme de texte, qui est défini pour une zone, une valeur ou une formule particulière dans un classeur. Dans Excel, cette valeur s’affiche dans la colonne Nom de la boîte de dialogue Gestionnaire de noms, qui s’affiche lorsque vous cliquez sur Gestionnaire de noms dans la section Noms définis sous l’onglet Formules . Utilisez xlfGetDef pour obtenir le nom qui correspond à une définition. Pour obtenir la définition d’un nom, utilisez xlfGetName.
Excel12(xlfGetDef, LPXLOPER12 pxRes, 3, LPXLOPER12 pxDefText, LPXLOPER12 pxDocumentText, LPXLOPER12 pxTypeNum);
Paramètres
pxDefText (xltypeStr)
Il peut s’agir de tout ce à quoi vous pouvez définir un nom auquel faire référence, y compris une référence, une valeur, un objet ou une formule.
Les références doivent être fournies dans le style R1C1, par "R3C5"
exemple . Si pxDefText est une valeur ou une formule, il n’est pas nécessaire d’inclure le signe égal affiché dans la colonne Références à de la boîte de dialogue Gestionnaire de noms. S’il existe plusieurs noms pour pxDefText, xlfGetDef renvoie le prénom. Si aucun nom ne correspond à pxDefText, xlfGetDef renvoie la valeur d’erreur #NAME?
.
pxDocumentText (xltypeStr)
Spécifie la feuille sur laquelle pxDefText se trouve. Si pxDocumentText est omis, il est supposé être la feuille active.
pxTypeNum (xltypeNum)
Nombre compris entre 1 et 3 spécifiant les types de noms retournés.
pxTypeNum | Renvoie |
---|---|
1 ou aucune |
Noms normaux uniquement. |
2 |
Noms masqués uniquement. |
3 |
Tous les noms. |
Valeur de propriété/valeur de renvoi
pxRes (xltypeStr ou xltypeErr)
Retourne le nom associé à la définition spécifiée.
Remarques
Le tableau suivant répertorie quatre exemples de valeurs retournées par un appel à xlfGetDef avec les arguments spécifiés.
Nom défini dans Excel | pxDefText | pxDocumentText | pxTypeNum | Valeur retournée |
---|---|---|---|---|
La plage spécifiée dans Sheet4 est nommée Sales. | « R2C2 :R9C6 » |
« Sheet4 » |
<Omis> |
« Ventes » |
La valeur 100 dans sheet4 est définie comme Constante. | "100" |
« Sheet4 » |
<Omis> |
« Constante » |
La formule spécifiée dans Sheet4 est nommée SumTotal. | « SUM(R1C1 :R10C1) » |
« Sheet4 » |
<Omis> |
« SumTotal » |
3 est défini comme le nom masqué Compteur sur la feuille active. | "3" |
<Omis> |
2 |
« Compteur » |