Clase de CUserToolsManager

Artículo
04/10/2013

mantiene la colección de objetos de Clase de CUserTool en una aplicación.Una herramienta de usuario es un elemento de menú que ejecuta una aplicación externa.El objeto de CUserToolsManager permite al usuario o el programador para agregar nuevas herramientas de usuario a la aplicación.Admite la ejecución de los comandos asociados con las herramientas de usuario, y también guarda información sobre las herramientas de usuario en el Registro de Windows.

class CUserToolsManager : public CObject

Miembros

Constructores públicos

Name	Descripción
CUserToolsManager::CUserToolsManager	Construye un CUserToolsManager.

Métodos públicos

Name	Descripción
CUserToolsManager::CreateNewTool	Crea una nueva herramienta de usuario.
CUserToolsManager::FindTool	Devuelve el puntero al objeto de CMFCUserTool que está asociado a un identificador especificada de comando
CUserToolsManager::GetArgumentsMenuID	Devuelve el Id. de recurso que está asociado al menú de Argumentos en la pestaña de Herramientas del cuadro de diálogo de Personalizar .
CUserToolsManager::GetDefExt	Devuelve la extensión predeterminada que el cuadro de diálogo de Abrir archivo (CFileDialog::CFileDialog) utiliza en el campo del comando en la ficha de Herramientas del cuadro de diálogo de Personalizar .
CUserToolsManager::GetFilter	Devuelve el filtro de archivos que el cuadro de diálogo de Abrir archivo (Clase CFileDialog) utiliza en el campo del comando en la ficha de Herramientas del cuadro de diálogo de Personalizar .
CUserToolsManager::GetInitialDirMenuID	Devuelve el Id. de recurso que está asociado al menú de Directorio inicial en la pestaña de Herramientas del cuadro de diálogo de Personalizar .
CUserToolsManager::GetMaxTools	Devuelve el número máximo de herramientas del usuario que se pueden asignar en la aplicación.
CUserToolsManager::GetToolsEntryCmd	Devuelve el identificador del marcador del elemento de menú para las herramientas de usuario.
CUserToolsManager::GetUserTools	Devuelve una referencia a la lista de herramientas del usuario.
CUserToolsManager::InvokeTool	Ejecuta una aplicación asociado al usuario que tiene un identificador especificada de comando
CUserToolsManager::IsUserToolCmd	Determina si un identificador de comando es asociado con una herramienta de usuario.
CUserToolsManager::LoadState	Carga información sobre las herramientas de usuario del Registro de Windows.
CUserToolsManager::MoveToolDown	Mueve la herramienta especificada de usuario en la lista de herramientas del usuario.
CUserToolsManager::MoveToolUp	Mueve la herramienta especificada del usuario en la lista de herramientas del usuario.
CUserToolsManager::RemoveTool	Quita la herramienta especificada del usuario de la aplicación.
CUserToolsManager::SaveState	Almacena información sobre las herramientas de usuario en el Registro de Windows.
CUserToolsManager::SetDefExt	Especifica la extensión predeterminada que el cuadro de diálogo de Abrir archivo (Clase CFileDialog) utiliza en el campo del comando en la ficha de Herramientas del cuadro de diálogo de Personalizar .
CUserToolsManager::SetFilter	Especifica el filtro de archivos que el cuadro de diálogo de Abrir archivo (Clase CFileDialog) utiliza en el campo del comando en la ficha de Herramientas del cuadro de diálogo de Personalizar .

Comentarios

Para escribir las herramientas de usuario en la aplicación, debe:

1.Reserva un elemento de menú y un identificador asociado de comando para una entrada de menú del usuario.

2.Reserva un identificador secuencial command para cada herramienta de usuario que un usuario puede definir en la aplicación.

3.Llame al método de CWinAppEx::EnableUserTools y proporcione los parámetros siguientes: identificador de comando de menú, primer identificador de comando de herramienta de usuario, e identificador del último comando de herramienta de usuario

Debe haber un objeto de CUserToolsManager por la aplicación.

Para obtener un ejemplo de las herramientas de usuario, vea el proyecto de ejemplo de VisualStudioDemo.

Ejemplo

El ejemplo siguiente muestra cómo recuperar una referencia a un objeto de CUserToolsManager y cómo crear nuevas herramientas de usuario.Este fragmento de código es parte de Ejemplo de demostración de Visual Studio.

    CUserToolsManager* pUserToolsManager = theApp.GetUserToolsManager();
    if (pUserToolsManager != NULL && pUserToolsManager->GetUserTools().IsEmpty())
    {
        // CUserToolsManager* pUserToolsManager
        CUserTool* pTool1 = pUserToolsManager->CreateNewTool();
        pTool1->m_strLabel = _T("&Notepad");
        pTool1->SetCommand(_T("notepad.exe"));

        CUserTool* pTool2 = pUserToolsManager->CreateNewTool();
        pTool2->m_strLabel = _T("Paint &Brush");
        pTool2->SetCommand(_T("mspaint.exe"));

        CUserTool* pTool3 = pUserToolsManager->CreateNewTool();
        pTool3->m_strLabel = _T("&Windows Explorer");
        pTool3->SetCommand(_T("explorer.exe"));

        CUserTool* pTool4 = pUserToolsManager->CreateNewTool();
        pTool4->m_strLabel = _T("Microsoft On-&Line");
        pTool4->SetCommand(_T("https://www.microsoft.com"));
    }