Strumenti definiti dall'utente
Strumenti definiti dall'utente di MFC supporta. Uno strumento definito dall'utente è un comando speciale che esegue un programma esterno, definito dall'utente. È possibile utilizzare il processo di personalizzazione per gestire gli strumenti definiti dall'utente. Tuttavia, non è possibile utilizzare questo processo se l'oggetto applicazione non deriva da Classe CWinAppEx. Per ulteriori informazioni sulla personalizzazione, vedere Personalizzazione per MFC.
Se supporto definite dall'attivazione degli strumenti, la finestra di dialogo per la personalizzazione automaticamente include la scheda di Strumenti. Di seguito viene illustrata la pagina di Strumenti.
Scheda strumenti della finestra di dialogo per la personalizzazione
.png "Scheda Strumenti nella finestra di dialogo Personalizza")
Abilitare il supporto definito dall'utente degli strumenti
Per abilitare gli strumenti definiti dall'utente in un'applicazione, chiamare CWinAppEx::EnableUserTools. Tuttavia, è innanzitutto necessario definire più costanti nei file di risorse dell'applicazione utilizzare come parametri per la chiamata.
Nell'editor risorse creare un comando fittizi che utilizza un ID corretta del comando Nell'esempio, è possibile utilizzare ID_TOOLS_ENTRY l'ID di comando Questo ID comando contrassegna una posizione in uno o più menu in cui il framework genera gli strumenti definiti dall'utente.
È necessario eseguire lo shelving alcuni ID consecutivi nella tabella di stringhe per rappresentare gli strumenti definiti dall'utente. Il numero di stringhe che a shelving è uguale al numero massimo degli strumenti dell'utente che gli utenti possono definire. Nell'esempio seguente, questi vengono denominati ID_USER_TOOL1 con ID_USER_TOOL10.
È possibile fornire suggerimenti agli utenti per aiutarli per selezionare le directory e argomenti per i programmi esterni che verranno chiamati come strumenti. A tale scopo, creare due menu di scelta rapida nell'editor risorse. Nell'esempio seguente vengono denominati IDR_MENU_ARGS e IDR_MENU_DIRS. Per ogni comando nei menu, definire una stringa nella tabella di stringhe di applicazione. ID di risorsa della stringa deve essere uguale all'ID di comando
È inoltre possibile creare una classe derivata da Classe CUserTool per sostituire l'implementazione predefinita. A tale scopo, comunicare le informazioni di runtime per la classe derivata come il quarto parametro in CWinAppEx::EnableUserTools, anziché RUNTIME_CLASS (Classe CUserTool).
Dopo avere definito le costanti appropriate, chiamata CWinAppEx::EnableUserTools per abilitare gli strumenti definiti dall'utente.
Illustrato nella chiamata al metodo come utilizzare queste costanti:
EnableUserTools(ID_TOOLS_ENTRY, ID_USER_TOOL1, ID_USER_TOOL10, RUNTIME_CLASS(CUserTool), IDR_MENU_ARGS, IDR_MENU_DIRS);
In questo esempio, la scheda strumenti verrà inclusa nella finestra di dialogo Personalizzazione. Il framework sostituirà eventuale comando corrispondente l'id di comando ID_TOOLS_ENTRY in qualsiasi menu con il set di strumenti attualmente definiti dall'utente ogni volta che un utente apre il menu. ID di comandi ID_USER_TOOL1 con ID_USER_TOOL10 sono riservati per l'utilizzo degli strumenti definiti dall'utente. La classe Classe CUserTool gestisce le chiamate agli strumenti dell'utente. La scheda dello strumento della finestra di dialogo Personalizzazione fornisce pulsanti a destra di immissione della directory e dell'argomento per accedere ai menu IDR_MENU_ARGS e IDR_MENU_DIRS.quando un utente seleziona un comando da uno di questi menu, il framework aggiunge alla casella di testo appropriata la stringa contenente l'id della risorsa uguale all'ID di comando
Inclusi gli strumenti predefiniti
Se si desidera predefinire alcuni strumenti all'avvio dell'applicazione, è necessario eseguire l'override del metodo di CFrameWnd::LoadFrame della finestra principale dell'applicazione. In questo metodo, è necessario eseguire i passaggi seguenti.
Per aggiungere nuovi strumenti in LoadFrame
Ottenere un puntatore all'oggetto di Classe CUserToolsManager chiamando CWinAppEx::GetUserToolsManager.
Per ogni strumento che si desidera creare, chiamata CUserToolsManager::CreateNewTool. Questo metodo restituisce un puntatore a un oggetto di Classe CUserTool e aggiunge lo strumento appena creato utente alla raccolta interna di strumenti. Se si fornisce informazioni di runtime per una classe derivata di Classe CUserTool come il quarto parametro di CWinAppEx::EnableUserTools, CUserToolsManager::CreateNewTool creata un'istanza e restituirà un'istanza della classe.
Per ogni strumento, impostare la proprietà etichetta di testo impostando CUserTool::m_strLabel e il comando chiamando CUserTool::SetCommand. L'implementazione predefinita di Classe CUserTool recupera automaticamente le icone disponibili nel programma specificato nella chiamata a SetCommand.