I Visual Components sono implementati in FRE per Windows.
Questo oggetto fornisce l’accesso ai comandi di un Visual Component. Questi comandi possono comparire nel menu contestuale di un componente e nella relativa barra degli strumenti (se presente). È possibile abilitare o disabilitare i comandi e aggiungere comandi personalizzati per i Visual Components. Per ulteriori dettagli, vedere Customizing the Context Menu and Toolbar of a Visual Component.
I seguenti Visual Components consentono di gestirne i comandi: ImageViewer, ZoomViewer, DocumentViewer, TextEditor. Di seguito sono riportati l’elenco dei comandi disponibili e le modalità di utilizzo di tali comandi in ciascun componente:
Le informazioni sull’esecuzione dei comandi vengono trasmesse tramite speciali interfacce di output. Queste interfacce sono ICommandEvents (per C++) e la dispinterface DICommandEvents (per Visual Basic).
È importante notare che gli utenti di Visual Basic non devono preoccuparsi dei dettagli di implementazione delle interfacce evento, poiché questa piattaforma di sviluppo fornisce semplici strumenti per gestirle. Questo oggetto può essere dichiarato con WithEvents in Visual Basic.
Per gli utenti C++, questo significa che supporta l’interfaccia IConnectionPointContainer. Per ricevere le notifiche degli eventi, un utente C++ deve creare un oggetto derivato dall’interfaccia ICommandEvents, quindi configurare la connessione tra esso e l’origine eventi implementata nell’oggetto Commands tramite i meccanismi COM standard.
| Nome | Tipo | Descrizione |
|---|
| Count | int, di sola lettura | Restituisce il numero di comandi disponibili nel Visual Component. |
| Element | MenuItemEnum, di sola lettura | Restituisce l’identificatore del comando all’indice specificato. |
| Nome | Descrizione |
|---|
| DisableCommand | Disabilita il comando specificato. |
| DoCommand | Esegue il comando specificato in modalità sincrona o asincrona. |
| EnableCommand | Abilita il comando specificato. |
| HasHotKey | Specifica se il tasto di scelta rapida è utilizzato da un comando. |
| IsUserCommandRegistered | Specifica se il comando definito dall’utente specificato è registrato. |
| RegisterUserCommand | Registra un comando definito dall’utente. |
| UnregisterUserCommand | Annulla la registrazione del comando definito dall’utente specificato. |
Questo oggetto viene utilizzato nei seguenti esempi di codice: VisualComponents.
IImageViewer::Commands
IZoomViewer::Commands
IDocumentViewer::Commands
ITextEditor::Commands
ICommandEvents
Personalizzazione del menu contestuale e della barra degli strumenti di un Visual Component