Get Top Control from Canvas

in GuiCanvas.h, add the following declaration after the declaration for getContentControl:

// Gets the dialog at the top of the stack.
   virtual GuiControl *getTopControl();

in GuiCanvas.cpp, add the following two functions:

GuiControl *GuiCanvas::getTopControl()
{
   if (size() < 1)
      return NULL;

   GuiControl *ctrl = NULL;

   ctrl = static_cast<GuiControl*>(last());

   return ctrl;
}

ConsoleMethod( GuiCanvas, getTopControl, S32, 2, 2, "Get the GuiControl (dialog) which is on top.")
{
   GuiControl *ctrl = object->getTopControl();
   if(ctrl)
      return ctrl->getId();
   return -1;
}

Here is an example of use. When you press "escape" while playing a mission, a dialog is displayed asking if you wish to exit. But pressing escape again does not dismiss it. while there are many ways to change this behavior, it is quite easy by modifying the EscapeFromGame to use the new function as follows. In defaults.bind.cs, change the EscapeFromGame function as follows:

function escapeFromGame()
{
   if (Canvas.getContent() == Canvas.getTopControl())
   {
      if ( $Server::ServerType $= "SinglePlayer" )
         MessageBoxYesNo( "Quit Mission", "Exit from this Mission?", "disconnect();", "");
      else
         MessageBoxYesNo( "Disconnect", "Disconnect from the server?", "disconnect();", "");
   }
   else
   {
      Canvas.popDialog( Canvas.getTopControl());
   }
}

Now, any dialog that you pop up that is not the playgui can be dismissed with escape.