Condividi tramite


Elemento flag command

Modifica l'elemento padre.

Sintassi

<CommandFlag>DynamicVisibility</CommandFlag>

Attributi ed elementi

Nella sezione seguente vengono descritti i valori validi degli elementi.

Attributi

Nessuno.

Elementi figlio

Valore Descrizione
AllowParams Indica che gli utenti possono immettere i parametri di comando nella finestra di comando quando digitano il nome canonico del comando.

Valido per: Button
AlwaysCreate Il menu viene creato anche se non dispone di gruppi o pulsanti.

Valido per: Menu
CaseSensitive Le voci utente fanno distinzione tra maiuscole e minuscole.

Valido per: Combo
CommandWellOnly Applica questo flag se il comando non viene visualizzato nel menu di primo livello e vuoi renderlo disponibile per una personalizzazione aggiuntiva della shell, ad esempio per associarlo a una scelta rapida da tastiera. Dopo aver installato il pacchetto VSPackage, è possibile personalizzare questi comandi aprendo la finestra di dialogo Opzioni e quindi modificando il posizionamento dei comandi nella categoria Ambiente tastiera . Questo flag non influisce sul posizionamento nei menu di scelta rapida, nelle barre degli strumenti, nei controller di menu o nei sottomenu.

Valido per: Button, Combo
DefaultDisabled Per impostazione predefinita, il comando è disabilitato se il VSPackage che lo implementa non viene caricato o il QueryStatus metodo non è stato chiamato.

Valido per: Button, Combo
DefaultDocked Ancorato per impostazione predefinita. Questa impostazione non si applica più alle barre degli strumenti perché sono sempre ancorate.
DefaultInvisible Per impostazione predefinita, il comando è invisibile se il pacchetto VSPackage che lo implementa non viene caricato o il QueryStatus metodo non è stato chiamato.

È consigliabile combinare questo oggetto con il DynamicVisibility flag .

Valido per: Button, Combo, Menu
DontCache L'ambiente di sviluppo non memorizza nella cache i risultati del QueryStatus metodo per questo comando.

Per un menu, indica a un controller di menu di non memorizzare nella cache il testo delle voci di menu. Usare questo flag quando il menu contiene elementi dinamici o elementi con testo dinamico.

Valido per: Button, Menu
DynamicAutomationName Specifica che il gestore QueryStatus risponderà a OLECMDTEXTFEXT_AUTOMATIONNAME e restituirà una stringa da usare come nome di automazione per il controllo. Se si usa OleMenuCommand, è possibile impostare la proprietà AutomationName nel gestore BeforeQueryStatus se è impostato questo flag.

Se utilizzato in un elemento Menu, questo flag si applica solo ai menu di tipo MenuController o MenuControllerLatched.

Valido per: Button, Combo, Menu
DynamicItemStart Indica l'inizio di un elenco dinamico. In questo modo l'ambiente può compilare un elenco chiamando successivamente il QueryStatus metodo sugli elementi dell'elenco fino a quando non viene restituito il flag OLECMDERR_E_UNSUPPORTED. Questo comportamento funziona bene per gli elementi, ad esempio gli elenchi di finestre usati più di recente.

Valido per: Button
DynamicVisibility La visibilità del comando può essere modificata tramite il QueryStatus metodo o tramite un GUID di contesto incluso nella VisibilityConstraints sezione .

Si applica ai comandi visualizzati nei menu e nelle barre degli strumenti della finestra degli strumenti, ma non nelle barre degli strumenti di primo livello visualizzate nella finestra principale. Gli elementi della barra degli strumenti di primo livello possono essere disabilitati ma non nascosti, quando il flag OLECMDF_INVISIBLE viene restituito dal QueryStatus metodo . I comandi della barra degli strumenti visualizzati nelle barre degli strumenti della finestra degli strumenti possono essere nascosti.

In un menu, questo flag indica anche che deve essere nascosto automaticamente quando tutti i relativi membri sono nascosti. Questo flag viene in genere assegnato a sottomenu perché i menu di primo livello hanno già questo comportamento.

Questo flag deve essere combinato con il DefaultInvisible flag .

Valido per: Button, Combo, Menu
FilterKeys Vedere l'argomento Filtri chiavi in Elemento combinato.

Valido per: Combo
FixMenuController Se questo comando è posizionato su un controller di menu, il comando è sempre l'impostazione predefinita; ovvero, il comando viene selezionato ogni volta che viene selezionato il pulsante del controller di menu stesso. Se il controller di menu ha il TextIsAnchorCommand flag impostato, il controller di menu accetta anche il testo dal comando con il FixMenuController flag .

Un solo comando in un controller di menu deve avere il FixMenuController flag . Se sono contrassegnati più comandi, l'ultimo comando nel menu diventa il comando predefinito.

Valido per: Button
IconAndText Mostra un'icona e un testo nel menu e nella barra degli strumenti.

Valido per: Button, Combo, Menu
NoAutoComplete La funzionalità di completamento automatico è disabilitata.

Valido per: Combo
NoButtonCustomize Non consentire all'utente di personalizzare questo pulsante.

Valido per: Button, Combo
NoKeyCustomize Non abilitare la personalizzazione della tastiera.

Valido per: Button, Combo
NoShowOnMenuController Se questo comando è posizionato in un controller di menu, il comando non viene visualizzato nell'elenco a discesa.

Valido per: Button
NotInTBList Non viene visualizzato nell'elenco delle barre degli strumenti disponibili. Questa opzione è valida solo per i tipi di menu Barra degli strumenti.

Valido per: Menu
NoToolbarClose L'utente non può chiudere la barra degli strumenti. Questa opzione è valida solo per i tipi di menu Barra degli strumenti.

Valido per: Menu
Pict Mostra solo un'icona su una barra degli strumenti, ma solo il testo di un menu. Se non viene specificata alcuna icona, viene visualizzato uno spazio vuoto selezionabile su una barra degli strumenti.

Valido per: Button
PostExec Rende il comando non bloccando. L'ambiente di sviluppo impedisce l'esecuzione fino al completamento di tutte le query di pre-elaborazione.

Valido per: Button
RouteToDocs Il comando viene indirizzato al documento attivo.

Valido per: Button
StretchHorizontally Quando questo flag è impostato, la larghezza diventa la larghezza minima per la casella combinata e, se c'è spazio sulla barra degli strumenti, la casella combinata si estende per riempire lo spazio disponibile. Ciò si verifica solo se la barra degli strumenti è ancorata orizzontalmente e solo una casella combinata sulla barra degli strumenti può usare il flag (il flag viene ignorato su tutti tranne la prima casella combinata).

Valido per: Combo
TextChanges Il comando o il testo del menu può essere modificato in fase di esecuzione, in genere tramite il QueryStatus metodo .

Valido per: Button, Menu
TextChangesButton Valido per: Button
TextIsAnchorCommand Per un controller di menu, il testo del menu viene tratto dal comando predefinito (ancoraggio). Un comando di ancoraggio è l'ultimo comando selezionato o latch. Se questo flag non è impostato, il controller di menu usa il proprio MenuText campo. Tuttavia, facendo clic sul controller di menu viene ancora abilitato l'ultimo comando selezionato da tale controller.

È consigliabile combinare questo flag con il TextChanges flag .

Questo flag si applica solo ai menu di tipo MenuController o MenuControllerLatched.

Valido per: Menu
TextMenuCtrlUseMenu Usare il MenuText campo nei controller di menu. Il campo predefinito è ButtonText.

Valido per: Button
TextMenuUseButton Usare il ButtonText campo per i menu. Il campo predefinito è MenuText se è specificato.

Valido per: Button
TextOnly Mostra solo testo su una barra degli strumenti o su un menu, ma nessuna icona anche se l'icona è specificata.

Valido per: Button
TogglePatternAvailable Indica che il pulsante supporta l'archiviazione o il latch, ovvero può restituire OLEMCDF_LATCHED o impostare la proprietà Checked in OleMenuCommand. In questo modo il livello di automazione può esporre il modello di attivazione/disattivazione, in modo che le utilità per la lettura dello schermo leggano lo stato selezionato/deselezionato insieme al testo del pulsante.

Valido per: Button

Elementi padre

Elemento Descrizione
Elemento Buttons Fornisce un gruppo per gli elementi elemento Button.
Elemento Menus Definisce tutti i menu implementati da un VSPackage.

Vedi anche