xlAbort

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

Renvoie le processeur à d’autres tâches du système et vérifie si l’utilisateur a appuyé sur Échap pour annuler une macro. Si l’utilisateur a appuyé sur Échap pendant un recalcul de classeur, il peut également être détecté à partir d’une fonction de feuille de calcul en appelant cette fonction.

Excel12(xlAbort, LPXLOPER12 pxRes, 1, LPXLOPER12 pxRetain);

Paramètres

pxRetain (xltypeBool)

(Facultatif). Si la valeur est FALSE, cette fonction recherche la condition d’arrêt et efface toute interruption en attente. Cela permet à l’utilisateur de continuer malgré la condition d’arrêt. Si cet argument est omis ou a la valeur TRUE, la fonction recherche l’abandon d’un utilisateur sans l’effacer.

Valeur de propriété/valeur de renvoi

Retourne TRUE (xltypeBool) si l’utilisateur a appuyé sur Échap.

Des appels fréquents peuvent être nécessaires

Les fonctions et commandes qui peuvent prendre beaucoup de temps doivent appeler cette fonction fréquemment pour faire passer le processeur à d’autres tâches dans le système.

Éviter le langage sensible

Évitez d’utiliser le terme « Abandonner » dans votre interface utilisateur. Envisagez d’utiliser « Annuler », « Arrêter », « Arrêter » ou « Arrêter » à la place.

Exemple

Le code suivant déplace à plusieurs reprises la cellule active d’une feuille jusqu’à ce qu’une minute soit écoulée ou jusqu’à ce que l’utilisateur appuie sur Échap. Il appelle occasionnellement la fonction xlAbort . Cela produit le processeur, ce qui facilite le multitâche coopératif.

\SAMPLES\GENERIC\GENERIC.C

int WINAPI fDance(void)
{
   DWORD dtickStart;
   XLOPER12 xAbort, xConfirm;
   int boolSheet;
   int col=0;
   XCHAR rgch[32];
//
// Check what kind of sheet is active. If it is a worksheet or macro
// sheet, this function will move the selection in a loop to show
// activity. In any case, it will update the status bar with a countdown.
//
// Call xlSheetId; if that fails the current sheet is not a macro sheet or
// worksheet. Next, get the time at which to start. Then start a while
// loop that will run for one minute. During the while loop, check if the
// user has pressed ESC. If true, confirm the abort. If the abort is
// confirmed, clear the message bar and return; if the abort is not
// confirmed, clear the abort state and continue. After checking for an
// abort, move the active cell if on a worksheet or macro. Then
// update the status bar with the time remaining.
//
// This block uses TempActiveCell12(), which creates a temporary XLOPER12.
// The XLOPER12 contains a reference to a single cell on the active sheet.
// This function is part of the framework library.
//
   boolSheet = (Excel12f(xlSheetId, 0, 0) == xlretSuccess);
   dtickStart = GetTickCount();
   while (GetTickCount() < dtickStart + 60000L)
   {
      Excel12f(xlAbort, &xAbort, 0);
      if (xAbort.val.xbool)
      {
         Excel12f(xlcAlert, &xConfirm, 2,
           TempStr12(L"Are you sure you want to cancel this operation?"),
              TempNum12(1));
         if (xConfirm.val.xbool)
         {
            Excel12f(xlcMessage, 0, 1, TempBool12(0));
            return 1;
         }
         else
         {
            Excel12f(xlAbort, 0, 1, TempBool12(0));
         }
      }
      if (boolSheet)
      {
         Excel12f(xlcSelect, 0, 1,
            TempActiveCell12(0,(BYTE)col));
         col = (col + 1) & 3;
      }
      wsprintfW(rgch,L"0:%lu",
         (60000 + dtickStart - GetTickCount()) / 1000L);
      Excel12f(xlcMessage, 0, 2, TempBool12(1), TempStr12(rgch));
   }
   Excel12f(xlcMessage, 0, 1, TempBool12(0));
   return 1;
}

Voir aussi

Fonctions de l’API C à appeler à partir d’un fichier DLL ou XLL