BluePlant - Como adicionar e utilizar o componente TCefBrowser

Neste tutorial estão descritas orientações e procedimentos para capacitar o usuário a utilizar o componente TCefBrowser no software BluePlant.

Componentes

Software: BluePlant – 9.1.40.

Seções do Tutorial

1.  INTRODUÇÃO

2.  DESENVOLVIMENTO

   2.1. Preparando o ambiente

   2.2. Configurando o ambiente

   2.3. Métodos e Propriedades

   2.4. Funcionamento

1. INTRODUÇÃO

O TCefBrowser é um navegador web leve baseado em Chromium, integrado num controle de utilizador Windows Presentation Foundation. 

2. DESENVOLVIMENTO

2.1. Preparando o ambiente

1. Baixe arquivo .rar da DLL;
2. Desbloqueie o zip antes de extrair (Botão direito no zip folder > Propriedades > desbloquear > aplicar);
3. Depois de extrair vá até o arquivo TCefBrowserWPF.dll e desbloqueie como no passo acima (Botão direito no zip folder > Propriedades > desbloquear > aplicar).
    

2.2. Configurando o ambiente

Nesta etapa iremos realizar as configurações necessárias para utilizarmos o componente TCefBRowser no software BluePlant.

1. Com o projeto já criado no software BluePlant, vá em Draw e clique em Insert Component:
   

    

2. Selecione Browse Dlls:
   
    
3. Selecione o arquivo TCefBrowserWPF.dll e clique em OK.
   
    
4. Clique em qualquer lugar da tela e redimensione o objeto, no exemplo, vamos ajustar para que ocupe toda a tela (abaixo deixamos um espaço sobrando para que o usuário consiga ver o objeto inserido). Para conseguir ajustar o tamanho da tela, no rodopé vá na flecha ao lado do Zoom e sete Fit to Screen.
   

Depois que o componente é inserido, o seu namespace fica disponível para ser acessado através do CodeBehind. O código a seguir mostra o uso dos seus métodos.

Criamos o código C# (somente na licença Enterprise): 

using TCefBrowserWPF;
TBrowser tl;

public void DisplayOpening()
{	
	tl = CurrentDisplay.GetFormControl("TBrowser1")as TCefBrowserWPF.TBrowser;
	tl.Url = "www.altus.com.br";
}

public void DisplayIsOpen()
{
	// Add your code here
}

public void DisplayClosing()
{
	// Add your code here
}

//This method is only called on Dialog displays
public bool DialogOnOK()
{
	// Add your code here
	return true;
}

public void Forward (object sender, System.Windows.Input.InputEventArgs e)
{
	tl.Forward();
}

public void Back (object sender, System.Windows.Input.InputEventArgs e)
{
	tl.Back();
}

Abaixo o código em VB.Net (Versão Express e Lite):

Imports TCefBrowserWPF

Private tl As TBrowser

Public Sub DisplayOpening()
   	tl = TryCast(CurrentDisplay.GetFormControl("TBrowser1"), TCefBrowserWPF.TBrowser)
	tl.Url = "www.altus.com.br"
End Sub

Public Sub DisplayIsOpen()
    ' Add your code here

End Sub

Public Sub DisplayClosing()
	' Add your code here

End Sub

'This method is only called on Dialog displays
Public Function DialogOnOK() As Boolean
    ' Add your code here
	Return True

End Function

Public Sub Forward(ByVal sender As Object, ByVal e As System.Windows.Input.InputEventArgs)
	tl.Forward()

End Sub

Public Sub Back(ByVal sender As Object, ByVal e As System.Windows.Input.InputEventArgs)
    tl.Back()

End Sub

2.3. Métodos e propriedades

O TCefBrowser possui os seguintes métodos:

•           Back: Se possível, volta para a página anterior;

•           Close: Chama o método de encerramento do núcleo CEF, fechando as ligações e liberando os recursos;

•           Forward: Se possível, avança;

•           Reload: Recarrega a página atual, se possível usando dados do cache e

•           Url: String - Disponível para ser definido usando tags ou CodeBehind. Quando definido, carrega a página web correspondente ao endereço passado através de uma tag do tipo Text ou via CodeBehind.

2.4. Funcionamento

1. Depois vá em RUN -> Startup: configure como a imagem abaixo e clique em RUN Startup. Como não iremos utilizar os módulos, desativei todos eles.
   

    

2. Abaixo a imagem do projeto rodando: