Enumerazione OLEMISC (oleidl.h)

Descrive varie caratteristiche di un oggetto o di una classe di oggetti. Un contenitore può chiamare il metodo IOleObject::GetMiscStatus per determinare i bit OLEMISC impostati per un oggetto. I valori specificati nella voce CLSID\MiscStatus di un server a oggetti nel database di registrazione sono basati sull'enumerazione OLEMISC . Queste costanti vengono usate anche nel membro dwStatus della struttura OBJECTDESCRIPTOR .

Sintassi

typedef enum tagOLEMISC {
  OLEMISC_RECOMPOSEONRESIZE = 0x1,
  OLEMISC_ONLYICONIC = 0x2,
  OLEMISC_INSERTNOTREPLACE = 0x4,
  OLEMISC_STATIC = 0x8,
  OLEMISC_CANTLINKINSIDE = 0x10,
  OLEMISC_CANLINKBYOLE1 = 0x20,
  OLEMISC_ISLINKOBJECT = 0x40,
  OLEMISC_INSIDEOUT = 0x80,
  OLEMISC_ACTIVATEWHENVISIBLE = 0x100,
  OLEMISC_RENDERINGISDEVICEINDEPENDENT = 0x200,
  OLEMISC_INVISIBLEATRUNTIME = 0x400,
  OLEMISC_ALWAYSRUN = 0x800,
  OLEMISC_ACTSLIKEBUTTON = 0x1000,
  OLEMISC_ACTSLIKELABEL = 0x2000,
  OLEMISC_NOUIACTIVATE = 0x4000,
  OLEMISC_ALIGNABLE = 0x8000,
  OLEMISC_SIMPLEFRAME = 0x10000,
  OLEMISC_SETCLIENTSITEFIRST = 0x20000,
  OLEMISC_IMEMODE = 0x40000,
  OLEMISC_IGNOREACTIVATEWHENVISIBLE = 0x80000,
  OLEMISC_WANTSTOMENUMERGE = 0x100000,
  OLEMISC_SUPPORTSMULTILEVELUNDO = 0x200000
} OLEMISC;

Costanti

OLEMISC_RECOMPOSEONRESIZE Valore: 0x1 Quando il contenitore ridimensiona lo spazio allocato per la visualizzazione di una delle presentazioni dell'oggetto, l'oggetto desidera ricomporre la presentazione. Ciò significa che durante il ridimensionamento, l'oggetto non si limiterà a ridurre la propria immagine. Se questo bit è impostato, il contenitore deve forzare l'oggetto allo stato in esecuzione e chiamare IOleObject::SetExtent con le nuove dimensioni.
OLEMISC_ONLYICONIC Valore: 0x2 L'oggetto non dispone di una visualizzazione del contenuto utente diversa dalla relativa icona. Dal punto di vista dell'utente, la casella di controllo Visualizza come icona (nella finestra di dialogo Incolla speciale ) per questo oggetto deve essere sempre selezionata e non deve essere deselezionata. Si noti che l'aspetto di un oggetto di questo tipo deve ancora essere di contenuto disegnabile; sarà uguale alla relativa visualizzazione a icone.
OLEMISC_INSERTNOTREPLACE Valore: 0x4 L'oggetto viene inizializzato dai dati nella selezione corrente del contenitore. I contenitori devono esaminare questo bit dopo aver chiamato IOleObject::InitFromData per inizializzare un oggetto dalla selezione corrente. Se impostato, il contenitore deve inserire l'oggetto accanto alla selezione corrente anziché sostituire quest'ultima. Se questo bit non è impostato, l'oggetto che viene inserito sostituisce la selezione corrente.
OLEMISC_STATIC Valore: 0x8 Questo oggetto è un oggetto statico, quindi contiene solo una presentazione e non contiene dati nativi. Vedere OleCreateStaticFromData.
OLEMISC_CANTLINKINSIDE Valore: 0x10 Questo oggetto non può essere l'origine del collegamento che una volta associato attiva o esegue l'oggetto. Se l'oggetto viene selezionato e copiato negli Appunti, il contenitore dell'oggetto può offrire un collegamento in un trasferimento di dati degli Appunti che, una volta associato, deve connettersi all'esterno dell'oggetto. L'utente vede l'oggetto selezionato nel contenitore, non aperto per la modifica. Anziché eseguire questa operazione, il contenitore può semplicemente rifiutare di offrire un'origine di collegamento durante il trasferimento di oggetti con questo set di bit. Esempi di oggetti nei quali questo bit è impostato includono oggetti OLE1, oggetti statici e collegamenti.
OLEMISC_CANLINKBYOLE1 Valore: 0x20 Questo oggetto può essere collegato da contenitori OLE 1. Questo bit viene usato nel membro dwStatus della struttura OBJECTDESCRIPTOR trasferito con i formati di descrittore origine oggetto e collegamento. Un oggetto può essere collegato da contenitori OLE 1 se è un documento senza titolo, un file o una selezione di dati in un file. Gli oggetti incorporati o gli pseudo-oggetti contenuti all'interno di un oggetto incorporato non possono essere collegati da contenitori OLE 1( ad esempio, i contenitori OLE 1 non possono collegarsi a origini di collegamento che, se associate, richiedono l'esecuzione di più di un server a oggetti.
OLEMISC_ISLINKOBJECT Valore: 0x40 QUesto oggetto è un oggetto collegamento. Questo bit è significativo per OLE 1 e viene impostato dall'oggetto collegamento OLE 2. Per le applicazioni dell'oggetto non è necessario impostarlo.
OLEMISC_INSIDEOUT Valore: 0x80 Questo oggetto è in grado di eseguire l'attivazione sul posto, senza la necessità di installare menu e barre degli strumenti da eseguire. Molti di questi oggetti possono essere attivi contemporaneamente. Per alcuni contenitori, quali i form, tali oggetti possono essere attivati automaticamente.
OLEMISC_ACTIVATEWHENVISIBLE Valore: 0x100 Questo bit viene impostato solo se è impostato OLEMISC_INSIDEOUT e indica che l'oggetto preferisce essere attivato ogni volta che è visibile. Alcuni contenitori possono ignorare sempre questo suggerimento.
OLEMISC_RENDERINGISDEVICEINDEPENDENT Valore: 0x200 Questo oggetto non tiene in considerazione i dispositivi di destinazione. I dati della presentazione saranno uguali in tutti i casi.
OLEMISC_INVISIBLEATRUNTIME Valore: 0x400 Questo valore viene utilizzato con controlli. Indica che il controllo non dispone di un'interfaccia utente in fase di esecuzione, ma che deve essere visibile in fase di progettazione. Ad esempio, un controllo timer che genera periodicamente un evento specifico non viene visualizzato in fase di esecuzione, ma necessita di un'interfaccia utente della fase di progettazione in modo che una finestra di progettazione form possa impostare il periodo dell'evento e altre proprietà.
OLEMISC_ALWAYSRUN Valore: 0x800 Questo valore viene utilizzato con controlli. Indica al contenitore che questo controllo desidera sempre essere in esecuzione. Di conseguenza, il contenitore deve chiamare OleRun durante il caricamento o la creazione dell'oggetto.
OLEMISC_ACTSLIKEBUTTON Valore: 0x1000 Questo valore viene utilizzato con controlli. Indica che il controllo ha la funzione di un pulsante in quanto conforme alla proprietà di ambiente DisplayAsDefault del contenitore.
OLEMISC_ACTSLIKELABEL Valore: 0x2000 Questo valore viene utilizzato con controlli. Contrassegna il controllo come etichetta del controllo successivo nell'ordinamento del form. Premendo il tasto di scelta rapida relativo al controllo etichetta, verrà attivato il controllo successivo.
OLEMISC_NOUIACTIVATE Valore: 0x4000 Questo valore viene utilizzato con controlli. Indica che nessuna interfaccia utente del controllo ha lo stato attivo, pertanto non richiede strumenti sul posto, menu condivisi e tasti di scelta rapida. Significa inoltre che il controllo non richiede mai lo stato attivo.
OLEMISC_ALIGNABLE Valore: 0x8000 Questo valore viene utilizzato con controlli. Indica che il controllo comprende come allinearsi all'interno del rettangolo di visualizzazione, in base alle proprietà di allineamento come a sinistra, al centro e a destra.
OLEMISC_SIMPLEFRAME Valore: 0x10000 Questo valore viene utilizzato con controlli. Indica che il controllo è un semplice raggruppamento di altri controlli ed effettua poche altre operazioni oltre al passaggio dei messaggi di Windows al contenitore di controlli che gestisce il form. I controlli di questo ordinamento richiedono l'implementazione di ISimpleFrameSite nel sito del contenitore.
OLEMISC_SETCLIENTSITEFIRST Valore: 0x20000 Questo valore viene utilizzato con controlli. Indica che il controllo vuole usare IOleObject::SetClientSite come funzione di inizializzazione, anche prima di una chiamata, ad esempio IPersistStreamInit::InitNew o IPersistStorage::InitNew. Ciò consente il controllo dell'accesso alle proprietà di ambiente di un contenitore prima di caricare le informazioni dall'archivio permanente. Si noti che le implementazioni correnti di OleCreate, OleCreateFromData, OleCreateFromFile, OleLoad e il gestore predefinito non comprendono questo valore. I contenitori dei controlli che vogliono rispettare questo valore devono attualmente implementare le rispettive versioni di queste funzioni per definire la sequenza corretta di inizializzazione per il controllo.
OLEMISC_IMEMODE Valore: 0x40000 Obsoleta. Un controllo che funziona con un componente di sistema IME (Input Method Editor) può controllare lo stato dell'IME tramite la proprietà IMEMode anziché usare questo valore nell'enumerazione OLEMISC. È possibile utilizzare un componente IME per inserire informazioni nel set di caratteri asiatici con una tastiera standard. Un IME giapponese, ad esempio, consente di digitare una parola come "sushi" su una tastiera standard; quando si preme la barra spaziatrice, il componente IME converte tale parola nei caratteri kanji equivalenti o propone le scelte possibili. Il valore OLEMISC_IMEMODE è stato precedentemente utilizzato per contrassegnare un controllo come in grado di controllare un componente di sistema della modalità IME.
OLEMISC_IGNOREACTIVATEWHENVISIBLE Valore: 0x80000 Perché i nuovi controlli ActiveX funzionino in un contenitore precedente, può essere necessario impostare il valore OLEMISC_ACTIVATEWHENVISIBLE nel controllo. Tuttavia, in un contenitore più recente che riconosce e utilizza IPointerInactive, il controllo non deve essere attivato sul posto quando diventa visibile. Per consentire al controllo di funzionare in entrambi i tipi di contenitori, il controllo può impostare questo valore. Il contenitore ignora quindi OLEMISC_ACTIVATEWHENVISIBLE e non attiva il controllo sul posto quando diventa visibile.
OLEMISC_WANTSTOMENUMERGE Valore: 0x100000 Un controllo che può eseguire il merge del relativo menu con il contenitore imposta questo valore.
OLEMISC_SUPPORTSMULTILEVELUNDO Valore: 0x200000 Un controllo che supporta l'annullamento a più livelli imposta questo valore.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Intestazione	oleidl.h

Vedi anche

IOleObject::GetMiscStatus

OBJECTDESCRIPTOR