Partilhar via


Classe CHtmlEditCtrlBase

Observação

A biblioteca Microsoft Foundation Classes (MFC) continua a ser suportada. No entanto, já não estamos a adicionar funcionalidades nem a atualizar a documentação.

Representa um componente de edição HTML.

Sintaxe

template <class T> class CHtmlEditCtrlBase

Membros

Métodos Públicos

Nome Description
CHtmlEditCtrlBase::AddToGlyphTable Adiciona uma entrada à tabela de glifos, que especifica imagens a mostrar para etiquetas específicas no modo de design.
CHtmlEditCtrlBase::Negrito Alterna o estado a negrito do texto selecionado.
CHtmlEditCtrlBase::Button Sobrescreve um controlo de botão na seleção atual.
CHtmlEditCtrlBase::CheckBox Sobrescreve um controlo de caixa de seleção na seleção atual.
CHtmlEditCtrlBase::ClearSelection Elimina a seleção atual.
CHtmlEditCtrlBase::Copiar Copia a seleção atual para a prancheta.
CHtmlEditCtrlBase::Cut Copia a seleção atual para a prancheta e depois apaga-a.
CHtmlEditCtrlBase::D elete Apaga a seleção atual.
CHtmlEditCtrlBase::D ropDownBoxBox Sobrescreve um controlo de seleção suspenso na seleção atual.
CHtmlEditCtrlBase::EmptyGlyphTable Remove todas as entradas da tabela de glifos, que esconde todas as imagens exibidas para etiquetas no modo de design.
CHtmlEditCtrlBase::ExecCommand Executa um comando.
CHtmlEditCtrlBase::Font Abre uma caixa de diálogo de fonte para permitir ao utilizador alterar a cor do texto, a fonte e o tamanho da fonte da seleção atual.
CHtmlEditCtrlBase::GetAbsolutePosition Devolve se a propriedade de posição de um elemento é "absoluta".
CHtmlEditCtrlBase::GetBackColor Recupera a cor de fundo da seleção atual.
CHtmlEditCtrlBase::GetBlockFormat Recupera a etiqueta de formato de bloco atual.
CHtmlEditCtrlBase::GetBlockFormatNames Recupera as cadeias correspondentes às etiquetas de formato de bloco disponíveis.
CHtmlEditCtrlBase::GetBookMark Recupera o nome de um âncora de favoritos.
CHtmlEditCtrlBase::GetDocument Recupera o objeto do documento.
CHtmlEditCtrlBase::GetDocumentHTML Recupera o HTML do documento atual.
CHtmlEditCtrlBase::GetDocumentTitle Recupera o título do documento.
CHtmlEditCtrlBase::GetEvent Recupera um ponteiro de interface para o objeto evento que contém informação relevante para o evento mais recente.
CHtmlEditCtrlBase::GetEventSrcElement Recupera o objeto que disparou o evento.
CHtmlEditCtrlBase::GetFontFace Recupera o nome da fonte para a seleção atual.
CHtmlEditCtrlBase::GetFontSize Recupera o tamanho da fonte para a seleção atual.
CHtmlEditCtrlBase::GetForeColor Recupera a cor do primeiro plano (texto) da seleção atual.
CHtmlEditCtrlBase::GetFrameZone Devolve a zona de segurança da página atual no navegador web.
CHtmlEditCtrlBase::GetIsDirty Indica se o documento HTML mudou.
CHtmlEditCtrlBase::GetShowSiteTags Devolve se um glifo é exibido para todos os elementos que possuem uma styleFloat propriedade.
CHtmlEditCtrlBase::GetShowAllTags Devolve se o Navegador Web apresenta glifos para mostrar a localização de todas as etiquetas num documento.
CHtmlEditCtrlBase::GetShowAreaTags Recupera se o Navegador Web apresenta um glifo para as etiquetas de área.
CHtmlEditCtrlBase::GetShowBRTags Recupera se o WebBrowser apresenta um glifo para etiquetas br.
CHtmlEditCtrlBase::GetShowCommentTags Recupera se o Navegador Web apresenta um glifo para etiquetas de comentário.
CHtmlEditCtrlBase::GetShowMiscTags Recupera se o Navegador Web mostra todas as etiquetas apresentadas no Microsoft Internet Explorer 4.0.
CHtmlEditCtrlBase::GetShowScriptTags Recupera se o WebBrowser apresenta um glifo para todas as etiquetas de script.
CHtmlEditCtrlBase::GetShowStyleTags Recupera se o WebBrowser apresenta um glifo para todas as etiquetas de estilo.
CHtmlEditCtrlBase::GetShowUnknownTags Recupera se o WebBrowser apresenta um glifo para todas as etiquetas desconhecidas.
CHtmlEditCtrlBase::HorizontalLine Sobrescreve uma linha horizontal na seleção atual.
CHtmlEditCtrlBase::HyperLink Insere um hiperlink na seleção atual.
CHtmlEditCtrlBase::IE50Paste Realiza uma operação de colagem compatível com o Microsoft Internet Explorer 5.
CHtmlEditCtrlBase::Iframe Sobrescrive um quadro em linha na seleção atual.
CHtmlEditCtrlBase::Image Sobrescreve uma imagem na seleção atual.
CHtmlEditCtrlBase::Indentação Aumenta a indentação do texto selecionado em um incremento de indentação.
CHtmlEditCtrlBase::InsFieldSet Sobrescreve uma caixa na seleção atual.
CHtmlEditCtrlBase::InsInputButton Sobrescreve um controlo de botão na seleção atual.
CHtmlEditCtrlBase::InsInputHidden Insere um controlo oculto na seleção atual.
CHtmlEditCtrlBase::InsInputImage Sobrescreve um controlo de imagem na seleção atual.
CHtmlEditCtrlBase::InsInputPassword Sobrescreve um controlo de palavra-passe na seleção atual.
CHtmlEditCtrlBase::InsInputReset Sobrescrive um controlo de reset na seleção atual.
CHtmlEditCtrlBase::InsInputSubmit Sobrescreve um controlo de submissão na seleção atual.
CHtmlEditCtrlBase::InsInputUpload Sobrescrive um controlo de upload de ficheiro na seleção atual.
CHtmlEditCtrlBase::Is1DElement Determina se um elemento está posicionado estaticamente.
CHtmlEditCtrlBase::Is2DElement Determina se um elemento está absolutamente posicionado.
CHtmlEditCtrlBase::Itálico Alterna a seleção atual entre itálico e não-itálico.
CHtmlEditCtrlBase::JustifyCenter Centra o bloco de formato onde se encontra a seleção atual.
CHtmlEditCtrlBase::JustifyLeft À esquerda justifica o bloco de formato onde a seleção atual está localizada.
CHtmlEditCtrlBase::JustifyRight Justifica à direita o bloco de formato onde a seleção atual está localizada.
CHtmlEditCtrlBase::ListBox Sobrescreve um controlo de seleção de caixa de lista na seleção atual.
CHtmlEditCtrlBase::Marquee Sobrescreve uma tenda vazia na seleção atual.
CHtmlEditCtrlBase::NewDocument Cria um novo documento.
CHtmlEditCtrlBase::OrderList Alterna a seleção atual entre uma lista ordenada e um bloco de formato normal.
CHtmlEditCtrlBase::Outdent Diminui em um incremento a indentação do bloco de formato onde se encontra a seleção atual.
CHtmlEditCtrlBase::P aragraph Sobrescreve uma quebra de linha na seleção atual.
CHtmlEditCtrlBase::P aste Sobrescrive o conteúdo da prancheta na seleção atual.
CHtmlEditCtrlBase::P rintDocument Imprime o documento atual.
CHtmlEditCtrlBase::P rintPreview Abre a janela de Pré-visualização de Impressão para o documento atual usando o modelo padrão de pré-visualização de impressão ou um modelo personalizado.
CHtmlEditCtrlBase::QueryStatus Chame este método para consultar o estado dos comandos.
CHtmlEditCtrlBase::RadioButton Sobrescreve um controlo de rádio na seleção atual.
CHtmlEditCtrlBase::RefreshDocument Atualiza o documento atual.
CHtmlEditCtrlBase::RemoveFormat Remove as etiquetas de formatação da seleção atual.
CHtmlEditCtrlBase::SaveAs Guarda a página Web atual num ficheiro.
CHtmlEditCtrlBase::SelectAll Seleciona o documento completo.
CHtmlEditCtrlBase::Set2DPosition Permite que elementos absolutamente posicionados sejam movidos arrastando.
CHtmlEditCtrlBase::SetAbsolutePosition Define a propriedade de posição de um elemento para "absoluta" ou "estática".
CHtmlEditCtrlBase::SetAtomicSelection Definir o modo de seleção atómica.
CHtmlEditCtrlBase::SetAutoURLDetectMode Ativa e desativa a deteção automática de URLs.
CHtmlEditCtrlBase::SetBackColor Define a cor de fundo da seleção atual.
CHtmlEditCtrlBase::SetBlockFormat Define a etiqueta de formato do bloco atual.
CHtmlEditCtrlBase::SetBookMark Cria uma âncora de marcador para o ponto atual de seleção ou inserção.
CHtmlEditCtrlBase::SetCSSEditingLevel Seleciona qual o nível de CSS (CSS1 ou CSS2) que o editor suportará, se houver.
CHtmlEditCtrlBase::SetDefaultComposeSettings Chame este método para definir as definições padrão de composição.
CHtmlEditCtrlBase::SetDesignMode Modo de design de cenários.
CHtmlEditCtrlBase::SetDisableEditFocusUI Desativa a borda hachurosa e os handles à volta de um elemento que tem foco de edição.
CHtmlEditCtrlBase::SetDocumentHTML Define o HTML do documento atual.
CHtmlEditCtrlBase::SetFontFace Define a fonte para a seleção atual.
CHtmlEditCtrlBase::SetFontSize Define o tamanho da fonte para a seleção atual.
CHtmlEditCtrlBase::SetForeColor Define a cor em primeiro plano (texto) da seleção atual.
CHtmlEditCtrlBase::SetIE5PasteMode Define a operação de colar para ser compatível com o Microsoft Internet Explorer 5.
CHtmlEditCtrlBase::SetLiveResize Faz com que o navegador atualize continuamente a aparência de um elemento durante uma operação de redimensionamento ou mudança.
CHtmlEditCtrlBase::SetMultiSelect Permite múltiplas seleções.
CHtmlEditCtrlBase::SetOverrideCursor Ordena ao navegador web que nunca mude o ponteiro do rato.
CHtmlEditCtrlBase::SetOverwriteMode Alterna o modo de introdução de texto entre inserir e sobrescrever.
CHtmlEditCtrlBase::SetRespectVisInDesign Esconde elementos invisíveis no modo de design.
CHtmlEditCtrlBase::SetShowAlignedSiteTags Apresenta um glifo para todos os elementos que possuem uma styleFloat propriedade.
CHtmlEditCtrlBase::SetShowAllTags Mostra glifos para mostrar a localização de todas as etiquetas num documento.
CHtmlEditCtrlBase::SetShowAreaTags Mostra um glifo para todas as etiquetas de área.
CHtmlEditCtrlBase::SetShowBRTags Mostra um glifo para todas as etiquetas br.
CHtmlEditCtrlBase::SetShowCommentTags Mostra um glifo para todas as etiquetas de comentário.
CHtmlEditCtrlBase::SetShowMiscTags Mostra todas as etiquetas apresentadas no Microsoft Internet Explorer 4.0.
CHtmlEditCtrlBase::SetShowScriptTags Mostra um glifo para todas as etiquetas de script.
CHtmlEditCtrlBase::SetShowStyleTags Mostra um glifo para todas as etiquetas de estilo.
CHtmlEditCtrlBase::SetShowUnknownTags Mostra um glifo para todas as etiquetas desconhecidas.
CHtmlEditCtrlBase::TextArea Sobrescrive um controlo de entrada de texto multilinha na seleção atual.
CHtmlEditCtrlBase::TextBox Sobrescreve um controlo de texto na seleção atual.
CHtmlEditCtrlBase::DesFavorito Remove qualquer marcador da seleção atual.
CHtmlEditCtrlBase::Sublinhar Alterna a seleção atual entre sublinhado e não sublinhado.
CHtmlEditCtrlBase::Unlink Remove qualquer hiperligação da seleção atual.
CHtmlEditCtrlBase::UnorderList Alterna a seleção atual entre uma lista ordenada e um bloco de formato normal.

Parâmetros

T
O nome da classe derivada.

Observações

CHtmlEditCtrlBase fornece funções de membro para os comandos de edição HTML do WebBrowser, como o Negrito. (Alternativamente, pode chamar o ExecCommand para executar o comando IDM_BOLD.)

CHtmlEditCtrlBase não se pretende sustentar por si só. Foi concebida para ser uma classe base para classes derivadas que expõem a funcionalidade de edição HTML do Navegador Web (ver CHtmlEditCtrl e CHtmlEditView).

Hierarquia de herança

CHtmlEditCtrlBase

Requerimentos

Cabeçalho: afxhtml.h

CHtmlEditCtrlBase::AddToGlyphTable

Adiciona uma entrada à tabela de glifos, que especifica imagens a mostrar para etiquetas específicas no modo de design.

HRESULT AddToGlyphTable(
    LPCTSTR szTag,
    LPCTSTR szImgUrl,
    unsigned short nTagType,
    unsigned short nAlignment,
    unsigned short nPosInfo,
    unsigned short nDirection,
    unsigned int nImgWidth,
    unsigned int nImgHeight) const;

Parâmetros

szTag
O nome da etiqueta (por exemplo, "P" ou "table").

szImgUrl
O URL da imagem.

nTagType
Tipo de etiqueta: 0 significa que a imagem é apenas para a etiqueta de abertura. 1 significa que a imagem é apenas para a etiqueta de fecho. 2 significa que a imagem é para as etiquetas de abertura e fecho. Etiquetas individuais como br e comentário devem ser adicionadas com o tipo de etiqueta definido a 0.

nAlinhamento
Alinhamento (apenas elementos retangulares): Este parâmetro indica que a imagem é para um elemento com um atributo de alinhamento. Esquerda = 0, centro = 1, direita = 2, e indefinido = 3. Atributos à esquerda, direita ou centro devem ser explicitamente definidos no elemento.

nPosInfo
Informação de posicionamento. Determina a que valor de posicionamento das folhas de estilo em cascata (CSS) o glifo se aplica, onde posicionamento estático = 0, posicionamento absoluto = 1, posicionamento relativo = 2, e todos = 3. Este campo permite-lhe especificar um glifo para uma etiqueta quando esta não está posicionada e outro glifo para mostrar um ponto de ancoragem quando a etiqueta está posicionada.

nDireção
A direção. Este parâmetro especifica a imagem para uma etiqueta com base na ordem de leitura da linguagem atual. 0 especifica da esquerda para a direita, 1 especifica da direita para a esquerda, 2 especifica de cima para baixo, 3 especifica de baixo para cima, e 4 especifica todos. Normalmente defines este campo para 4.

nImgWidth
A largura da imagem em pixels.

nImgHeight
A altura da imagem em pixels.

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

Observações

Para mais informações sobre os parâmetros, veja "Glyph Table String Format" em Using Editing Glyphs.

Este método envia o ID do comando IDM_ADDTOGLYPHTABLE para o controlo do Navegador Web.

CHtmlEditCtrlBase::Negrito

Alterna o estado a negrito do texto selecionado.

HRESULT Bold() const;

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

Observações

Este método envia o ID do comando IDM_BOLD para o controlo do Navegador Web.

CHtmlEditCtrlBase::Button

Sobrescreve um controlo de botão na seleção atual.

HRESULT Button(LPCTSTR szId = NULL) const;

Parâmetros

szId
O ID do controlo do botão.

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

Observações

Este método envia o ID do comando IDM_BUTTON para o controlo do Navegador Web.

CHtmlEditCtrlBase::CheckBox

Sobrescreve um controlo de caixa de seleção na seleção atual.

HRESULT CheckBox(LPCTSTR szId = NULL) const;

Parâmetros

szId
O ID do controlo da caixa de seleção.

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

Observações

Este método envia o ID do comando IDM_CHECKBOX para o controlo do Navegador Web.

CHtmlEditCtrlBase::ClearSelection

Elimina a seleção atual.

HRESULT ClearSelection() const;

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

Observações

Este método envia o ID do comando IDM_CLEARSELECTION para o controlo do WebBrowser.

CHtmlEditCtrlBase::Copiar

Copia a seleção atual para a prancheta.

HRESULT Copy() const;

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

Observações

Este método envia o ID do comando IDM_COPY para o controlo do Navegador Web.

CHtmlEditCtrlBase::Cut

Copia a seleção atual para a prancheta e depois apaga-a.

HRESULT Cut() const;

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

Observações

Este método envia o ID do comando IDM_CUT para o controlo do Navegador Web.

CHtmlEditCtrlBase::D elete

Apaga a seleção atual.

HRESULT Delete() const;

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

Observações

Este método envia o ID do comando IDM_DELETE para o controlo WebBrowser.

Sobrescreve um controlo de seleção suspenso na seleção atual.

HRESULT DropDownBox(LPCTSTR szId = NULL) const;

Parâmetros

szId
O ID do controlo de seleção suspenso.

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

Observações

Este método envia o ID do comando IDM_DROPDOWNBOX para o controlo WebBrowser.

CHtmlEditCtrlBase::EmptyGlyphTable

Remove todas as entradas da tabela de glifos, que esconde todas as imagens exibidas para etiquetas no modo de design.

HRESULT EmptyGlyphTable() const;

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

Observações

Este método envia o ID do comando IDM_EMPTYGLYPHTABLE para o controlo do Navegador Web.

CHtmlEditCtrlBase::ExecCommand

Executa um comando.

HRESULT ExecCommand(
    long cmdID,
    long cmdExecOpt,
    VARIANT* pInVar = NULL,
    VARIANT* pOutVar = NULL) const;

HRESULT ExecCommand(
    const GUID* pGuid,
    long cmdID,
    long cmdExecOpt,
    VARIANT* pInVar = NULL,
    VARIANT* pOutVar = NULL) const;

Parâmetros

cmdID
O ID do comando a ser executado. Para uma lista, veja Identificadores de Comandos MSHTML.

cmdExecOpt
Valores retirados da enumeração OLECMDEXECOPT , que descrevem como o objeto deve executar o comando.

pInVar
Os argumentos de entrada.

pOutVar
A saída do comando.

pGuid
O GUID do grupo de comando.

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

Observações

Este método fornece a funcionalidade do IOleCommandTarget::Exec.

CHtmlEditCtrlBase::Font

Abre uma caixa de diálogo de fonte para permitir ao utilizador alterar a cor do texto, a fonte e o tamanho da fonte da seleção atual.

HRESULT Font() const;

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

Observações

Este método envia o ID do comando IDM_FONT para o controlo do Navegador Web.

CHtmlEditCtrlBase::GetAbsolutePosition

Devolve se a propriedade de posição de um elemento é "absoluta".

HRESULT GetAbsolutePosition(bool& bCurValue) const;

Parâmetros

bCurValue
TRUE se a propriedade de posição do elemento estiver definida como "absoluta".

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

Observações

Para mais informações, consulte IDM_ABSOLUTE_POSITION ID de Comando.

CHtmlEditCtrlBase::GetBackColor

Recupera a cor de fundo da seleção atual.

HRESULT GetBackColor(int& nColor) const;

Parâmetros

nColor
A cor de fundo.

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

Observações

Este método envia o ID de comando IDM_BACKCOLOR para o controlo do Navegador Web.

CHtmlEditCtrlBase::GetBlockFormat

Recupera a etiqueta de formato de bloco atual.

HRESULT GetBlockFormat(CString& strFormat) const;

Parâmetros

strFormat
A etiqueta de formato de bloco atual.

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

Observações

Este método envia o ID do comando IDM_BLOCKFMT para o controlo WebBrowser.

CHtmlEditCtrlBase::GetBlockFormatNames

Recupera as cadeias correspondentes às etiquetas de formato de bloco disponíveis.

HRESULT GetBlockFormatNames(CStringArray& sa) const;

Parâmetros

SA
As etiquetas de formato de bloco disponíveis, como uma matriz de cadeias.

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

Observações

Este método envia o ID do comando IDM_GETBLOCKFMTS para o controlo do Navegador Web.

CHtmlEditCtrlBase::GetBookMark

Recupera o nome de um âncora de favoritos.

HRESULT GetBookMark(CString& strAnchor) const;

Parâmetros

strAnchor
O nome de um âncora de marcadores.

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

Observações

Para mais informações, consulte IDM_BOOKMARK ID de Comando.

CHtmlEditCtrlBase::GetDocument

Recupera o objeto do documento.

HRESULT GetDocument(IHTMLDocument2** ppDoc) const;

Parâmetros

ppDoc
O objeto do documento.

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

CHtmlEditCtrlBase::GetDocumentHTML

Recupera o HTML do documento atual.

HRESULT GetDocumentHTML(CString& szHTML) const;

Parâmetros

szHTML
O HTML.

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

CHtmlEditCtrlBase::GetDocumentTitle

Recupera o título do documento.

HRESULT GetDocumentTitle(CString& szTitle) const;

Parâmetros

szTitle
O título do documento.

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

CHtmlEditCtrlBase::GetEvent

Recupera um ponteiro de interface para o objeto evento que contém informação relevante para o evento mais recente.

HRESULT GetEvent(IHTMLEventObj** ppEventObj) const;

Parâmetros

ppEventObj
O objeto do evento.

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

CHtmlEditCtrlBase::GetEventSrcElement

Recupera o objeto que disparou o evento.

HRESULT GetEventSrcElement(IHTMLElement** ppSrcElement) const;

Parâmetros

ppSrcElement
O elemento que desencadeou o evento.

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

CHtmlEditCtrlBase::GetFontFace

Recupera o nome da fonte para a seleção atual.

HRESULT GetFontFace(CString& strFace) const;

Parâmetros

strFace
O nome da fonte.

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

Observações

Se a seleção atual usar mais do que uma fonte, strFace será uma cadeia vazia.

Este método envia o ID do comando IDM_FONTNAME para o controlo WebBrowser.

CHtmlEditCtrlBase::GetFontSize

Recupera o tamanho da fonte para a seleção atual.

HRESULT GetFontSize(short& nSize) const;

Parâmetros

nTamanho
O tamanho da fonte.

Valor de retorno

Devolve o tamanho da fonte HTML (1-7). Retorna 0 se a seleção contiver múltiplos tamanhos de fonte.

Observações

Este método envia o ID do comando IDM_FONTSIZE para o controlo do Navegador Web.

CHtmlEditCtrlBase::GetForeColor

Recupera a cor do primeiro plano (texto) da seleção atual.

HRESULT GetForeColor(int& nColor);

Parâmetros

nColor
A cor do primeiro plano.

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

Observações

Este método envia o ID de comando IDM_FORECOLOR para o controlo do Navegador Web.

CHtmlEditCtrlBase::GetFrameZone

Devolve a zona de segurança da página atual no navegador web.

HRESULT GetFrameZone(short& nZone) const;

Parâmetros

nZone
A zona de segurança.

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

Observações

Este método envia o ID do comando IDM_GETFRAMEZONE para o controlo WebBrowser.

CHtmlEditCtrlBase::GetIsDirty

Indica se o documento HTML mudou.

HRESULT GetIsDirty() const;

Observações

Indica se o documento mudou. GetIsDirty retorna um HRESULT de IPersistStorage::IsDirty.

CHtmlEditCtrlBase::GetShowSiteTags

Devolve se um glifo é exibido para todos os elementos que possuem uma styleFloat propriedade.

HRESULT GetShowAlignedSiteTags(bool& bCurValue) const;

Parâmetros

bCurValue
TRUE se um glifo for exibido para todos os elementos que possuem uma styleFloat propriedade; FALSE se não for exibido nenhum glifo.

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

Observações

Para mais informações, consulte IDM_SHOWALIGNEDSITETAGS ID de Comando.

CHtmlEditCtrlBase::GetShowAllTags

Devolve se o Navegador Web apresenta glifos para mostrar a localização de todas as etiquetas num documento.

HRESULT GetShowAllTags(bool& bCurValue) const;

Parâmetros

bCurValue
TRUE se o Navegador Web mostrar glifos para mostrar a localização de todas as etiquetas num documento; FALSE se não fizer.

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

Observações

Para mais informações, consulte IDM_SHOWALLTAGS ID de Comando.

CHtmlEditCtrlBase::GetShowAreaTags

Recupera se o Navegador Web apresenta um glifo para as etiquetas de área.

HRESULT GetShowAreaTags(bool& bCurValue) const;

Parâmetros

bCurValue
TRUE se o WebBrowser mostrar um glifo para etiquetas de área, FALSE se não mostrar.

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

Observações

Para mais informações, consulte IDM_SHOWAREATAGS ID de Comando.

CHtmlEditCtrlBase::GetShowBRTags

Recupera se o WebBrowser apresenta um glifo para etiquetas br.

HRESULT GetShowBRTags(bool& bCurValue) const;

Parâmetros

bCurValue
TRUE se o WebBrowser mostrar um glifo para etiquetas br, FALSE se não mostrar.

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

Observações

Para mais informações, consulte IDM_SHOWWBRTAGS ID de Comando.

CHtmlEditCtrlBase::GetShowCommentTags

Recupera se o Navegador Web apresenta um glifo para etiquetas de comentário.

HRESULT GetShowCommentTags(bool& bCurValue) const;

Parâmetros

bCurValue
TRUE se o WebBrowser mostrar um glifo para as tags de comentário, FALSE se não mostrar.

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

Observações

Para mais informações, consulte IDM_SHOWCOMMENTTAGS ID de Comando.

CHtmlEditCtrlBase::GetShowMiscTags

Recupera se o Navegador Web mostra todas as etiquetas apresentadas no Microsoft Internet Explorer 4.0.

HRESULT GetShowMiscTags(bool& bCurValue) const;

Parâmetros

bCurValue
TRUE se o Navegador Web mostrar todas as etiquetas mostradas no Microsoft Internet Explorer 4.0, FALSE se não mostrar.

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

Observações

Para mais informações, consulte IDM_SHOWMISCTAGS ID de Comando.

CHtmlEditCtrlBase::GetShowScriptTags

Recupera se o WebBrowser apresenta um glifo para todas as etiquetas de script.

HRESULT GetShowScriptTags(bool& bCurValue) const;

Parâmetros

bCurValue
TRUE se o WebBrowser mostrar um glifo para todas as etiquetas de script, FALSE se não o fizer.

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

Observações

Para mais informações, consulte IDM_SHOWSCRIPTTAGS ID de Comando.

CHtmlEditCtrlBase::GetShowStyleTags

Recupera se o WebBrowser apresenta um glifo para todas as etiquetas de estilo.

HRESULT GetShowStyleTags(bool& bCurValue) const;

Parâmetros

bCurValue
TRUE se o WebBrowser mostrar um glifo para todas as etiquetas de estilo, FALSE se não o fizer

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

Observações

Para mais informações, consulte IDM_SHOWSTYLETAGS ID de Comando.

CHtmlEditCtrlBase::GetShowUnknownTags

Recupera se o WebBrowser apresenta um glifo para todas as etiquetas desconhecidas.

HRESULT GetShowUnknownTags(bool& bCurValue) const;

Parâmetros

bCurValue
TRUE se o WebBrowser mostrar um glifo para todas as etiquetas desconhecidas, FALSE se não o fizer.

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

Observações

Para mais informações, consulte IDM_SHOWUNKNOWNTAGS ID de Comando.

CHtmlEditCtrlBase::HorizontalLine

Sobrescreve uma linha horizontal na seleção atual.

HRESULT HorizontalLine(LPCTSTR szId = NULL) const;

Parâmetros

szID
O ID para a linha horizontal.

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

Observações

Este método envia o ID do comando IDM_HORIZONTALLINE para o controlo do Navegador Web.

Insere um hiperlink na seleção atual.

HRESULT HyperLink(LPCTSTR szUrl = NULL) const;

Parâmetros

szUrl
O URL do hiperligação.

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

Observações

Este método envia o ID do comando IDM_HYPERLINK para o controlo WebBrowser.

CHtmlEditCtrlBase::IE50Paste

Realiza uma operação de colagem compatível com o Internet Explorer 5.

HRESULT IE50Paste(LPCTSTR szData) const;

Parâmetros

szData
O fio para colar.

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

Observações

Este método envia o ID do comando IDM_IE50_PASTE para o controlo WebBrowser.

CHtmlEditCtrlBase::Iframe

Sobrescrive um quadro em linha na seleção atual.

HRESULT Iframe(LPCTSTR szId = NULL) const;

Parâmetros

szId
O ID para a estrutura em linha.

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

Observações

Este método envia o ID do comando IDM_IFRAME para o controlo do Navegador Web.

CHtmlEditCtrlBase::Image

Sobrescreve uma imagem na seleção atual.

HRESULT Image(LPCTSTR szUrl = NULL) const;

Parâmetros

szUrl
O caminho e o nome do ficheiro da imagem a inserir.

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

Observações

Este método envia o ID do comando IDM_IMAGE para o controlo do WebBrowser.

CHtmlEditCtrlBase::Indentação

Aumenta a indentação do texto selecionado em um incremento de indentação.

HRESULT Indent() const;

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

Observações

Este método envia o ID do comando IDM_INDENT para o controlo do Navegador Web.

CHtmlEditCtrlBase::InsFieldSet

Sobrescreve uma caixa na seleção atual.

HRESULT InsFieldSet(LPCTSTR szId = NULL) const;

Parâmetros

szId
O cartão de identificação da caixa.

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

Observações

Este método envia o ID do comando IDM_INSFIELDSET para o controlo WebBrowser.

CHtmlEditCtrlBase::InsInputButton

Sobrescreve um controlo de botão na seleção atual.

HRESULT InsInputButton(LPCTSTR szId = NULL) const;

Parâmetros

szId
O ID para o controlo do botão.

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

Observações

Este método envia o ID do comando IDM_INSINPUTBUTTON para o controlo do Navegador Web.

CHtmlEditCtrlBase::InsInputHidden

Insere um controlo oculto na seleção atual.

HRESULT InsInputHidden(LPCTSTR szId = NULL) const;

Parâmetros

szId
O ID do controlo oculto.

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

Observações

Este método envia o ID do comando IDM_INSINPUTHIDDEN para o controlo WebBrowser.

CHtmlEditCtrlBase::InsInputImage

Sobrescreve um controlo de imagem na seleção atual.

HRESULT InsInputImage(LPCTSTR szId = NULL) const;

Parâmetros

szId
O ID para o controlo de imagem.

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

Observações

Este método envia o ID do comando IDM_INSINPUTIMAGE para o controlo WebBrowser.

CHtmlEditCtrlBase::InsInputPassword

Sobrescreve um controlo de palavra-passe na seleção atual.

HRESULT InsInputPassword(LPCTSTR szId = NULL) const;

Parâmetros

szId
O ID para o controlo por palavra-passe.

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

Observações

Este método envia o ID do comando IDM_INSINPUTPASSWORD para o controlo do WebBrowser.

CHtmlEditCtrlBase::InsInputReset

Sobrescrive um controlo de reset na seleção atual.

HRESULT InsInputReset(LPCTSTR szId = NULL) const;

Parâmetros

szId
O ID do controlo de reset.

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

Observações

Este método envia o ID do comando IDM_INSINPUTRESET para o controlo do Navegador Web.

CHtmlEditCtrlBase::InsInputSubmit

Sobrescreve um controlo de submissão na seleção atual.

HRESULT InsInputSubmit(LPCTSTR szId = NULL) const;

Parâmetros

szId
O ID do controlo de submissão.

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

Observações

Este método envia o ID do comando IDM_INSINPUTSUBMIT para o controlo do Navegador Web.

CHtmlEditCtrlBase::InsInputUpload

Sobrescrive um controlo de upload de ficheiro na seleção atual.

HRESULT InsInputUpload(LPCTSTR szId = NULL) const;

Parâmetros

szId
O ID do controlo de upload de ficheiros.

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

Observações

Este método envia o ID do comando IDM_INSINPUTUPLOAD para o controlo do Navegador Web.

CHtmlEditCtrlBase::Is1DElement

Determina se um elemento está posicionado estaticamente.

HRESULT Is1DElement(bool& bValue) const;

Parâmetros

bValor
TRUE se o elemento estiver posicionado estaticamente, FALSE caso contrário.

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

Observações

Este método envia o ID do comando IDM_1D_ELEMENT para o controlo do Navegador Web.

CHtmlEditCtrlBase::Is2DElement

Determina se um elemento está absolutamente posicionado.

HRESULT Is2DElement(bool& bValue) const;

Parâmetros

bValor
VERDADEIRO se o elemento estiver absolutamente posicionado, FALSO caso contrário.

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

Observações

Este método envia o ID do comando IDM_2D_ELEMENT para o controlo WebBrowser.

CHtmlEditCtrlBase::Itálico

Alterna a seleção atual entre itálico e não-itálico.

HRESULT Italic() const;

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

Observações

Este método envia o ID do comando IDM_ITALIC para o controlo do Navegador Web.

CHtmlEditCtrlBase::JustifyCenter

Centra o bloco de formato onde se encontra a seleção atual.

HRESULT JustifyCenter() const;

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

Observações

Este método envia o ID do comando IDM_JUSTIFYCENTER para o controlo do WebBrowser.

CHtmlEditCtrlBase::JustifyLeft

À esquerda justifica o bloco de formato onde a seleção atual está localizada.

HRESULT JustifyLeft() const;

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

Observações

Este método envia o ID do comando IDM_JUSTIFYLEFT para o controlo do Navegador Web.

CHtmlEditCtrlBase::JustifyRight

Justifica à direita o bloco de formato onde a seleção atual está localizada.

HRESULT JustifyRight() const;

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

Observações

Este método envia o ID do comando IDM_JUSTIFYRIGHT para o controlo do Navegador Web.

CHtmlEditCtrlBase::ListBox

Sobrescreve um controlo de seleção de caixa de lista na seleção atual.

HRESULT ListBox(LPCTSTR szId = NULL) const;

Parâmetros

szId
O ID para o controlo da caixa de lista.

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

Observações

Este método envia o ID do comando IDM_LISTBOX para o controlo do WebBrowser.

CHtmlEditCtrlBase::Marquee

Sobrescreve uma tenda vazia na seleção atual.

HRESULT Marquee(LPCTSTR szId = NULL) const;

Parâmetros

szId
O cartão de identificação para o letreiro.

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

Observações

Este método envia o ID do comando IDM_MARQUEE para o controlo WebBrowser.

CHtmlEditCtrlBase::NewDocument

Cria um novo documento.

HRESULT NewDocument() const;

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

CHtmlEditCtrlBase::OrderList

Alterna a seleção atual entre uma lista ordenada e um bloco de formato normal.

HRESULT OrderList(LPCTSTR szId = NULL) const;

Parâmetros

szId
O ID da lista encomendada.

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

Observações

Este método envia o ID do comando IDM_ORDERLIST para o controlo WebBrowser.

CHtmlEditCtrlBase::Outdent

Diminui em um incremento a indentação do bloco de formato onde se encontra a seleção atual.

HRESULT Outdent() const;

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

Observações

Este método envia o ID do comando IDM_OUTDENT para o controlo do WebBrowser.

CHtmlEditCtrlBase::P aragraph

Sobrescreve uma quebra de linha na seleção atual.

HRESULT Paragraph(LPCTSTR szId = NULL) const;

Parâmetros

szId
O ID para o parágrafo.

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

Observações

Este método envia o ID do comando IDM_PARAGRAPH para o controlo do WebBrowser.

CHtmlEditCtrlBase::P aste

Sobrescrive o conteúdo da prancheta na seleção atual.

HRESULT Paste() const;

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

Observações

Este método envia o ID do comando IDM_PASTE para o controlo WebBrowser.

CHtmlEditCtrlBase::P rintDocument

Imprime o documento atual.

HRESULT PrintDocument() const;
HRESULT PrintDocument(LPCTSTR szPrintTemplate) const;
HRESULT PrintDocument(bool bShowPrintDialog) const;

Parâmetros

szPrintTemplate
Caminho para um modelo de impressão; se não for especificado nenhum, utiliza-se o modelo de impressão predefinido.

bShowPrintDialog
Se TRUE, mostra o diálogo Imprimir.

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

Observações

Este método envia o ID do comando IDM_PRINT para o controlo do Navegador Web.

CHtmlEditCtrlBase::P rintPreview

Abre a janela de Pré-visualização de Impressão para o documento atual usando o modelo padrão de pré-visualização de impressão ou um modelo personalizado.

HRESULT PrintPreview() const;
HRESULT PrintPreview(LPCTSTR szPrintTemplate) const;

Parâmetros

szPrintTemplate
Caminho para um modelo de impressão.

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

Observações

Este método envia o ID do comando IDM_PRINTPREVIEW para o controlo do Navegador Web.

CHtmlEditCtrlBase::QueryStatus

Chame este método para consultar o estado dos comandos.

long QueryStatus(long cmdID) const;

Parâmetros

cmdID
O ID do comando. Os identificadores de comando são retirados do grupo de comando CGID_MSHTML. Estes comandos estão definidos em Mshtmcid.h. Também pode encontrar a lista online em MSHTML Command Identifiers.

Valor de retorno

Devolve um OLECMDF indicando o estado do cmdID, ou 0 em caso de falha.

CHtmlEditCtrlBase::RadioButton

Sobrescreve um controlo de rádio na seleção atual.

HRESULT RadioButton(LPCTSTR szId = NULL) const;

Parâmetros

szId
O ID do botão de rádio.

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

Observações

Este método envia o ID do comando IDM_RADIOBUTTON para o controlo do Navegador Web.

CHtmlEditCtrlBase::RefreshDocument

Atualiza o documento atual.

HRESULT RefreshDocument() const;

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

Observações

Este método envia o ID de comando IDM_REFRESH para o controlo do Navegador Web.

CHtmlEditCtrlBase::RemoveFormat

Remove as etiquetas de formatação da seleção atual.

HRESULT RemoveFormat() const;

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

Observações

Este método envia o ID do comando IDM_REMOVEFORMAT para o controlo WebBrowser.

CHtmlEditCtrlBase::SaveAs

Guarda a página Web atual num ficheiro.

HRESULT SaveAs(LPCTSTR szPath = NULL) const;

Parâmetros

szPath
O caminho e o nome do ficheiro para o qual guardar a página Web.

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

Observações

Este método envia o ID do comando IDM_SAVEAS para o controlo do Navegador Web.

CHtmlEditCtrlBase::SelectAll

Seleciona o documento completo.

HRESULT SelectAll() const;

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

Observações

Este método envia o ID do comando IDM_SELECTALL para o controlo WebBrowser.

CHtmlEditCtrlBase::Set2DPosition

Permite que elementos absolutamente posicionados sejam movidos arrastando.

HRESULT Set2DPosition(bool bNewValue) const;

Parâmetros

bNewValue
Se TRUE, elementos absolutamente posicionados podem ser movidos arrastando.

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

Observações

Este método envia o ID do comando IDM_2D_POSITION para o controlo do Navegador Web.

CHtmlEditCtrlBase::SetAbsolutePosition

Define a propriedade de posição de um elemento para "absoluta" ou "estática".

HRESULT SetAbsolutePosition(bool bNewValue) const;

Parâmetros

bNewValue
Se TRUE, a propriedade de posição do elemento é "absoluta"; se FALSO, é "estático."

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

Observações

Este método envia o ID do comando IDM_ABSOLUTE_POSITION para o controlo do Navegador Web.

CHtmlEditCtrlBase::SetAtomicSelection

Definir o modo de seleção atómica.

HRESULT SetAtomicSelection(bool bNewValue) const;

Parâmetros

bNewValue
Se TRUE, qualquer elemento que tenha um atributo ATOMICSELECTION definido para TRUE será selecionável apenas como uma unidade.

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

Observações

Este método envia o ID do comando IDM_ATOMICSELECTION para o controlo do WebBrowser.

CHtmlEditCtrlBase::SetAutoURLDetectMode

Ativa e desativa a deteção automática de URLs.

HRESULT SetAutoURLDetectMode(bool bNewValue) const;

Parâmetros

bNewValue
Se for TRUE, a deteção automática de URL está ativada.

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

Observações

Este método envia o ID do comando IDM_AUTOURLDETECT_MODE para o controlo WebBrowser.

CHtmlEditCtrlBase::SetBackColor

Define a cor de fundo da seleção atual.

HRESULT SetBackColor(int nColor) const;
HRESULT SetBackColor(LPCTSTR szColor) const;

Parâmetros

nColor
A cor. Ver pvaIn no IDM_BACKCOLOR ID de Comando.

szColor
A cor. Ver pvaIn no IDM_BACKCOLOR ID de Comando.

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

Observações

Este método envia o ID do comando IDM_BACKCOLOR_ para o controlo do Navegador Web.

CHtmlEditCtrlBase::SetBlockFormat

Define a etiqueta de formato do bloco atual.

HRESULT SetBlockFormat(LPCTSTR szFormat) const;

Parâmetros

szFormat
A etiqueta de formato.

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

Observações

Este método envia o ID de IDM_BLOCKFMT_command para o controlo do Navegador Web.

CHtmlEditCtrlBase::SetBookMark

Cria uma âncora de marcador para o ponto atual de seleção ou inserção.

HRESULT SetBookMark(LPCTSTR szAnchorName) const;

Parâmetros

szAnchorName
O nome da âncora.

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

Observações

Este método envia o ID do comando IDM_BOOKMARK para o controlo do Navegador Web.

CHtmlEditCtrlBase::SetCSSEditingLevel

Seleciona qual o nível de CSS (CSS1 ou CSS2) que o editor suportará, se houver.

HRESULT SetCSSEditingLevel(short nLevel) const;

Parâmetros

nLevel
O nível CSS. Passe 0 se não quiser suporte CSS.

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

Observações

Este método envia o ID do comando IDM_CSSEDITING_LEVEL para o controlo do Navegador Web.

CHtmlEditCtrlBase::SetDefaultComposeSettings

Chame este método para definir as definições padrão de composição.

HRESULT SetDefaultComposeSettings(
    LPCSTR szFontName = NULL,
    unsigned short nFontSize = 3,
    COLORREF crFontColor = 0xFF000000,
    COLORREF crFontBgColor = 0xFF000000,
    bool bBold = false,
    bool bItalic = false,
    bool bUnderline = false) const;

Parâmetros

szFontName
O nome da fonte.

nFontSize
O tamanho da fonte.

crFontColor
A cor da fonte.

crFontBgColor
A cor de fundo da fonte.

BBbold
Passe VERDADEIRO para texto a negrito.

Bitálico
Passe VERDADEIRO para texto em itálico.

bSublinhado
Passe VERDADEIRO para texto sublinhado.

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

Observações

Este método envia o ID do comando IDM_COMPOSESETTINGS para o controlo do Navegador Web.

CHtmlEditCtrlBase::SetDesignMode

Modo de design de cenários.

BOOL SetDesignMode(BOOL bMode) const;

Parâmetros

bMode
Se for VERDADEIRO, ativa o modo design.

Valor de retorno

Retorna VERDADEIRO em caso de sucesso, FALSO em caso de falha.

CHtmlEditCtrlBase::SetDisableEditFocusUI

Desativa a borda hachurosa e os handles à volta de um elemento que tem foco de edição.

HRESULT SetDisableEditFocusUI(bool bNewValue) const;

Parâmetros

bNewValue
Se TRUE, desativa a borda com hachuras e os handles à volta de um elemento selecionável no site quando o elemento tem "editar foco" no modo de design; isto é, quando o texto ou o conteúdo do elemento podem ser editados.

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

Observações

Este método envia o ID do comando IDM_DISABLE_EDITFOCUS_UI para o controlo do Navegador Web.

CHtmlEditCtrlBase::SetDocumentHTML

Define o HTML do documento atual.

HRESULT SetDocumentHTML(LPCTSTR szHTML) const;

Parâmetros

szHTML
O HTML.

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

CHtmlEditCtrlBase::SetFontFace

Define a fonte para a seleção atual.

HRESULT SetFontFace(LPCTSTR szFace) const;

Parâmetros

szFace
O nome da fonte.

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

Observações

Este método envia o ID de comando IDM_FONTNAME para o controlo do Navegador Web.

CHtmlEditCtrlBase::SetFontSize

Define o tamanho da fonte para a seleção atual.

HRESULT SetFontSize(unsigned short size) const;

Parâmetros

tamanho
O tamanho da fonte HTML (1-7). Um valor 0 define o tamanho da fonte para 1.

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

Observações

Este método envia o ID do comando IDM_FONTSIZE para o controlo do Navegador Web.

CHtmlEditCtrlBase::SetForeColor

Define a cor em primeiro plano (texto) da seleção atual.

HRESULT SetForeColor(LPCTSTR szColor) const;
HRESULT SetForeColor(int nColor) const;

Parâmetros

szColor
A cor.

nColor
A cor.

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

Observações

Este método envia o ID do comando IDM_FORECOLOR para o controlo WebBrowser.

CHtmlEditCtrlBase::SetIE5PasteMode

Define a operação de colar para ser compatível com o Microsoft Internet Explorer 5.

HRESULT SetIE5PasteMode(bool bNewValue) const;

Parâmetros

bNewValue
Se TRUE, todas as operações de colagem são compatíveis com o Internet Explorer 5; se for FALSE, as operações de colagem são compatíveis com o Internet Explorer 5.5.

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

Observações

Este método envia o ID do comando IDM_IE50_PASTE_MODE para o controlo do Navegador Web.

CHtmlEditCtrlBase::SetLiveResize

Faz com que o Navegador Web atualize continuamente a aparência de um elemento durante uma operação de redimensionamento ou mudança, em vez de ser atualizado apenas ao final da mudança ou redimensionamento.

HRESULT SetLiveResize(bool bNewValue) const;

Parâmetros

bNewValue
Se TRUE, faz com que o Navegador atualize continuamente a aparência de um elemento durante uma operação de redimensionamento ou mudança; se FALSE, só atualiza após a conclusão do movimento ou redimensionamento.

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

Observações

Este método envia o ID do comando IDM_LIVERESIZE para o controlo WebBrowser.

CHtmlEditCtrlBase::SetMultiSelect

Permite múltiplas seleções.

HRESULT SetMultiSelect(bool bNewValue) const;

Parâmetros

bNewValue
Se TRUE, permite a seleção de mais do que um elemento selecionável pelo site ao mesmo tempo quando o utilizador mantém pressionadas as teclas SHIFT ou CTRL.

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

Observações

Este método envia o ID do comando IDM_MULTIPLESELECTION para o controlo do Navegador Web.

CHtmlEditCtrlBase::SetOverrideCursor

Ordena ao navegador web que nunca mude o ponteiro do rato.

HRESULT SetOverrideCursor(bool bNewValue) const;

Parâmetros

bNewValue
Se for VERDADEIRO, o Navegador Web não alterará o ponteiro do rato.

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

Observações

Este método envia o ID do comando IDM_OVERRIDE_CURSOR para o controlo do Navegador Web.

CHtmlEditCtrlBase::SetOverwriteMode

Alterna o modo de introdução de texto entre inserir e sobrescrever.

HRESULT SetOverwriteMode(bool bMode) const;

Parâmetros

bMode
Se TRUE, o modo de introdução de texto é sobrescrito; se FALSE, o modo de introdução de texto é inserido.

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

Observações

Este método envia o ID do comando IDM_OVERWRITE para o controlo WebBrowser.

CHtmlEditCtrlBase::SetRespectVisInDesign

Esconde elementos invisíveis no modo de design.

HRESULT SetRespectVisInDesign(bool bNewValue) const;

Parâmetros

bNewValue
Se TRUE, quaisquer elementos que tenham visibilidade definida como "oculta" ou propriedade de exibição definida como "nenhuma" não serão mostrados nem no modo de design nem no modo de navegação; se FALSE, esses elementos serão exibidos apenas no modo de navegação.

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

Observações

Este método envia o ID do comando IDM_RESPECTVISIBILITY_INDESIGN para o controlo WebBrowser.

CHtmlEditCtrlBase::SetShowAlignedSiteTags

Apresenta um glifo para todos os elementos que possuem uma styleFloat propriedade.

HRESULT SetShowAlignedSiteTags(bool bNewValue) const;

Parâmetros

bNewValue
Se TRUE, apresenta um glifo para todos os elementos que possuem uma styleFloat propriedade.

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

Observações

Este método envia o ID do comando IDM_SHOWALIGNEDSITETAGS para o controlo do Navegador Web.

CHtmlEditCtrlBase::SetShowAllTags

Mostra glifos para mostrar a localização de todas as etiquetas num documento.

HRESULT SetShowAllTags(bool bNewValue) const;

Parâmetros

bNewValue
Se TRUE, apresenta glifos para mostrar a localização de todas as etiquetas num documento.

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

Observações

Este método envia o ID do comando IDM_SHOWALLTAGS para o controlo do WebBrowser.

CHtmlEditCtrlBase::SetShowAreaTags

Mostra um glifo para todas as etiquetas de área.

HRESULT SetShowAreaTags(bool bNewValue) const;

Parâmetros

bNewValue
Se TRUE, mostra um glifo para todas as etiquetas de área.

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

Observações

Este método envia o ID do comando IDM_SHOWAREATAGS para o controlo do Navegador Web.

CHtmlEditCtrlBase::SetShowBRTags

Mostra um glifo para todas as etiquetas br.

HRESULT SetShowBRTags(bool bNewValue) const;

Parâmetros

bNewValue
Se for TRUE, mostra um glifo para todas as etiquetas br.

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

Observações

Este método envia o ID do comando IDM_SHOWWBRTAGS para o controlo WebBrowser.

CHtmlEditCtrlBase::SetShowCommentTags

Mostra um glifo para todas as etiquetas de comentário.

HRESULT SetShowCommentTags(bool bNewValue) const;

Parâmetros

bNewValue
Se TRUE, mostra um glifo para todas as etiquetas de comentário.

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

Observações

Este método envia o ID do comando IDM_SHOWCOMMENTTAGS para o controlo do Navegador Web.

CHtmlEditCtrlBase::SetShowMiscTags

Mostra todas as etiquetas apresentadas no Microsoft Internet Explorer 4.0.

HRESULT SetShowMiscTags(bool bNewValue) const;

Parâmetros

bNewValue
Se TRUE, mostra todas as etiquetas apresentadas no Microsoft Internet Explorer 4.0.

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

Observações

Este método envia o ID do comando IDM_SHOWMISCTAGS para o controlo do Navegador Web.

CHtmlEditCtrlBase::SetShowScriptTags

Mostra um glifo para todas as etiquetas de script.

HRESULT SetShowScriptTags(bool bNewValue) const;

Parâmetros

bNewValue
Se TRUE, mostra um glifo para todas as etiquetas de script.

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

Observações

Este método envia o ID do comando IDM_SHOWSCRIPTTAGS para o controlo do Navegador Web.

CHtmlEditCtrlBase::SetShowStyleTags

Mostra um glifo para todas as etiquetas de estilo.

HRESULT SetShowStyleTags(bool bNewValue) const;

Parâmetros

bNewValue
Se TRUE, mostra um glifo para todas as etiquetas de estilo.

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

Observações

Este método envia o ID do comando IDM_SHOWSTYLETAGS para o controlo do Navegador Web.

CHtmlEditCtrlBase::SetShowUnknownTags

Mostra um glifo para todas as etiquetas desconhecidas.

HRESULT SetShowUnknownTags(bool bNewValue) const;

Parâmetros

bNewValue
Se TRUE, mostra um glifo para todas as etiquetas desconhecidas.

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

Observações

Este método envia o ID do comando IDM_SHOWUNKNOWNTAGS para o controlo do Navegador Web.

CHtmlEditCtrlBase::TextArea

Sobrescrive um controlo de entrada de texto multilinha na seleção atual.

HRESULT TextArea(LPCTSTR szId = NULL) const;

Parâmetros

szId
O ID do controlo de entrada de texto multilinha.

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

Observações

Este método envia o ID do comando IDM_TEXTAREA para o controlo do WebBrowser.

CHtmlEditCtrlBase::TextBox

Sobrescreve um controlo de texto na seleção atual.

HRESULT TextBox(LPCTSTR szId = NULL) const;

Parâmetros

szId
O ID do controlo de texto.

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

Observações

Este método envia o ID do comando IDM_TEXTBOX para o controlo do Navegador Web.

CHtmlEditCtrlBase::DesFavorito

Remove qualquer marcador da seleção atual.

HRESULT UnBookmark() const;

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

Observações

Este método envia o ID do comando IDM_UNBOOKMARK para o controlo do Navegador Web.

CHtmlEditCtrlBase::Sublinhar

Alterna a seleção atual entre sublinhado e não sublinhado.

HRESULT Underline() const;

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

Observações

Este método envia o ID do comando IDM_UNDERLINE para o controlo WebBrowser.

Remove qualquer hiperligação da seleção atual.

HRESULT Unlink() const;

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

Observações

Este método envia o ID do comando IDM_UNLINK para o controlo do Navegador Web.

CHtmlEditCtrlBase::UnorderList

Alterna a seleção atual entre uma lista ordenada e um bloco de formato normal.

HRESULT UnorderList(LPCTSTR szId = NULL) const;

Parâmetros

szId
O ID da lista não ordenada.

Valor de retorno

Devolve S_OK em caso de sucesso, ou um erro HRESULT em caso de falha.

Observações

Este método envia o ID do comando IDM_UNORDERLIST para o controlo do WebBrowser.

Consulte também

Gráfico de Hierarquia
Exemplo HTMLEdit