Propriedades padrão
OLE define um conjunto de DISPIDs padrão para todos os três tipos de propriedades: controle, ambiente e estendido. As tabelas a seguir listam esses padrões para propriedades de controle, propriedades de ambiente e propriedades estendidas.
| Propriedade Control | Tipo | Descrição |
|---|---|---|
| BackColor, ForeColor, FillColor, BorderColor |
OLE_COLOR |
O esquema de cores do controle |
| BackStyle, FillStyle, BorderStyle, BorderWidth, BorderVisible, DrawStyle, DrawWidth |
curto ou longo |
Bits que definem o comportamento visual de um controle, como ser sólido ou transparente, ter bordas grossas ou finas, estilos de linha e assim por diante. |
| Fonte |
IDispatch * |
A fonte usada no controle, que é um ponteiro IDispatch para um objeto de fonte padrão. Consulte Objeto de fonte padrão para obter mais informações. |
| Legenda, Texto |
BSTR |
Cadeias de caracteres que contêm o rótulo do controle (a legenda) ou seu conteúdo textual (o texto). Observe que a legenda não nomeia necessariamente o controle no contêiner. Consulte a propriedade Name estendida na tabela a seguir. |
| Enabled |
BOOL |
Determina se o controle está habilitado ou desabilitado. Se desabilitado, o controle provavelmente estará acinzentado. |
| Janela |
HWND |
A alça da janela do controle, se tiver uma. |
| TabStop |
BOOL |
Determina se esse controle é uma parada de tabulação. |
| Propriedade do ambiente | Tipo | Descrição |
|---|---|---|
| BackColor, ForeColor |
OLE_COLOR |
Fornece controles com as cores padrão de plano de fundo e primeiro plano. O uso por um controle é opcional. |
| Fonte |
IDispatch * |
Um ponteiro para um objeto de fonte padrão que define a fonte padrão para o formulário. O uso por um controle é opcional. Consulte Objeto de fonte padrão para obter mais informações. |
| LocaleID |
LCID |
O idioma usado no contêiner. Recomenda-se o uso por um controle. |
| Modo de usuário |
BOOL |
Descreve se o contêiner está em um modo de design (FALSE) ou modo de execução (TRUE), que um controle deve usar para alterar sua funcionalidade disponível conforme necessário. |
| UIDead |
BOOL |
Descreve se o contêiner está em um modo em que os controles devem ignorar a entrada do usuário. Isso se aplica independentemente do UserMode. Um contêiner sempre pode definir UIDead como TRUE no modo de design e pode defini-lo como TRUE quando tiver atingido um ponto de interrupção ou tal durante o modo de execução. Um controle deve prestar atenção a essa propriedade. |
| MessageReflect |
BOOL |
Especifica se o contêiner gostaria de receber mensagens do Windows, como WM_CTLCOLOR, WM_DRAWITEM, WM_PARENTNOTIFY e assim por diante como eventos. |
| SuportesMnemônicos |
BOOL |
Descreve se o contêiner processa mnemônicos ou não. Um controle pode fazer o que quiser com essas informações, como não sublinhar caracteres que normalmente usaria como mnemônico. |
| ShowGrabHandles, ShowHatching |
BOOL |
Descreve se um controle deve mostrar uma borda de hachura ou alças de agarra (na borda de hachura) quando ativo no local. Os controles devem obedecer a essas propriedades, dando ao contêiner o controle final sobre quem realmente desenha esses bits da interface do usuário. Um contêiner de controle pode querer desenhar seu próprio em vez de confiar em cada controle, caso em que esses ambientes sempre serão FALSE. |
| DisplayAsDefault |
BOOL |
O contêiner irá expor um TRUE para essa propriedade por meio de qualquer site que contenha o que está marcado como o botão padrão quando o controle de botão deve desenhar-se com um quadro padrão mais grosso. |
| Propriedade estendida | Tipo | Descrição |
|---|---|---|
| Nome |
BSTR |
O nome do contêiner para o controle. |
| Visível |
BOOL |
A visibilidade do controle. |
| Pai |
IDispatch * |
A dispinterface do formulário que contém o controle. |
| Padrão, Cancelar |
BOOL |
Indica se esse controle é o botão padrão ou cancelar. |
Todas essas propriedades padrão têm valores DISPID negativos, indicando seu status padrão.
Observe que, para evitar conflitos nos símbolos programáticos para esses DISPIDs, todas as propriedades de ambiente recebem símbolos na forma DISPID_AMBIENT_propriedade , como em DISPID_AMBIENT_FORECOLOR. Todos os outros símbolos usam DISPID_propriedade como de costume.
Algumas propriedades de ambiente, bem como propriedades de controle, envolvem cores. O tipo OLE_COLOR mencionado nas tabelas anteriores pode se referir a um tipo COLORREF padrão, um índice para uma paleta, um índice relativo à paleta ou um índice de cores do sistema usado com a função GetSysColor. A função OleTranslateColor converte um tipo OLE_COLOR em um tipo COLORREF dada uma paleta.