xlSheetNm

  • Article

S’applique à: Excel 2013 | Office 2013 | Visual Studio

Retourne le nom d’une feuille de calcul ou de macro à partir de son ID de feuille interne contenu dans une référence externe, ou le nom de la feuille active en cas de transmission d’une référence interne.

Excel12(xlSheetNm, LPXLOPER12 pxRes, 1, LPXLOPER12 pxExtref);

Paramètres

pxExtref (xltypeRef ou xltypeSRef)

Référence à la feuille dont vous souhaitez le nom.

Si vous passez une référence externe (xltypeRef), elle doit uniquement contenir l’ID de la feuille. Les structures de données qui décrivent les cellules de la feuille de calcul sont ignorées et n’ont pas besoin d’être fournies. Si l’ID est défini sur zéro, xlSheetNm renvoie le nom de la feuille active.

Si vous transmettez une référence interne (xltypeSef), xlSheetNm renvoie le nom de la feuille active.

Valeur de propriété/valeur de renvoi

Retourne le nom de la feuille (xltypeStr) au format [Book1]Sheet1.

Exemple

L’exemple suivant affiche le nom de la feuille à partir de laquelle la fonction a été appelée. La fonction fonctionne correctement uniquement si elle est appelée à partir d’une feuille de macro lors de l’exécution d’une macro de commande XLM. Cela est dû au fait qu’il appelle xlcAlert, ce que seules les commandes peuvent faire, et qu’il doit être appelé à partir d’une feuille plutôt que d’une boîte de dialogue, d’un menu ou d’une barre de commandes pour que xlfCaller retourne une référence.

\SAMPLES\EXAMPLE\EXAMPLE.C

short WINAPI xlSheetNmExample(void)
{
   XLOPER12 xRes, xSheetName;
   Excel12(xlfCaller, &xRes, 0);
   Excel12(xlSheetNm, &xSheetName, 1, (LPXLOPER12)&xRes);
   Excel12(xlcAlert, 0, 1, (LPXLOPER12)&xSheetName);
   Excel12(xlFree, 0, 1, (LPXLOPER12)&xSheetName);
   return 1;
}

Voir aussi