Propriedades (Visual Basic Add-In Model)
ActiveCodePane
Devolve o objeto CodePane ativo ou último ativo ou define o objeto CodePane ativo. Leitura/gravação.
Comentários
Pode definir a propriedade ActiveCodePane para qualquer objeto CodePane válido, conforme mostrado no exemplo seguinte:
Set MyApp.VBE. ActiveCodePane = MyApp.VBE.CodePanes(1)
O exemplo anterior define o primeiro painel de código numa coleção de painéis de código para ser o painel de código ativo. Também pode ativar um painel de código com o método SetSelection .
ActiveVBProject
Devolve o projeto ativo na janela Projeto. Somente leitura.
Comentários
A propriedade ActiveVBProject devolve o projeto que está selecionado na janela Projeto ou o projeto no qual os componentes estão selecionados. Neste último caso, o projeto em si não está necessariamente selecionado. Quer o projeto esteja ou não selecionado explicitamente, existe sempre um projeto ativo.
ActiveWindow
Devolve a janela ativa no ambiente de desenvolvimento. Somente leitura.
Comentários
Quando existe mais do que uma janela aberta no ambiente de desenvolvimento, a definição da propriedade ActiveWindow é a janela com o foco. Se a janela main tiver o foco, ActiveWindow devolve Nada.
AddIns
Devolve uma coleção que os suplementos podem utilizar para registar os componentes de automatização no modelo de objeto de extensibilidade.
Sintaxe
objeto. AddIns
O marcador de posição de objeto representa uma expressão de objeto que é avaliada como um objeto na lista Aplica-se a .
BuildFileName
Define ou devolve o nome DLL que será utilizado quando o projeto for criado.
Sintaxe
objeto. BuildFileName
O marcador de posição de objeto representa uma expressão de objeto que é avaliada como um objeto na lista Aplica-se a .
BuiltIn
Devolve um valor Booleano que indica se o objeto Referência é uma referência predefinida que não pode ser removida. Somente leitura.
A propriedade BuiltIn devolve estes valores:
| Valor | Descrição |
|---|---|
| Verdadeiro | A referência é uma referência predefinida que não pode ser removida. |
| Falso | A referência não é uma referência predefinida; pode ser removido. |
Legenda
Devolve uma Cadeia que contém o título da Janela ativa. Somente leitura.
Comentários
O título da janela ativa é o texto apresentado na barra de título da janela.
CodeModule
Devolve um objeto que representa o código por trás do componente. Somente leitura.
Comentários
A propriedade CodeModule devolve Nada se o componente não tiver um módulo de código associado ao mesmo.
Observação
O objeto CodePane representa uma janela de código visível. Um determinado componente pode ter vários objetos CodePane .
O objeto CodeModule representa o código dentro de um componente. Um componente só pode ter um objeto CodeModule .
Painel de Código
Devolve um objeto CodePane . Somente leitura.
Comentários
Se existir um painel de código , torna-se o painel de código ativo e a janela que o contém torna-se a janela ativa. Se não existir um painel de código para o módulo, a propriedade CodePane cria um.
CodePanes
Devolve a coleção de objetos CodePane ativos. Somente leitura.
CodePaneView
Devolve um valor que indica se o CodePane está na vista Procedimento ou na vista Módulo Completo. Somente leitura.
A propriedade CodePaneView devolve estes valores:
| Constante | Descrição |
|---|---|
| vbext_cv_ProcedureView | O painel de código especificado encontra-se na vista Procedimento. |
| vbext_cv_FullModuleView | O projeto especificado está na vista Módulo Completo. |
Coleção
Devolve a coleção que contém o objeto com o qual está a trabalhar. Somente leitura.
Comentários
A maioria dos objetos neste modelo de objeto tem uma propriedade Principal ou uma propriedade Coleção que aponta para o objeto principal do objeto.
Utilize a propriedade Coleção para aceder às propriedades, métodos e controlos da coleção à qual o objeto pertence.
CommandBarEvents
Devolve o objeto CommandBarEvents . Somente leitura.
Configurações
A definição do argumento que transmite para a propriedade CommandBarEvents é:
| Argumento | Descrição |
|---|---|
| vbcontrol | Tem de ser um objeto do tipo CommandBarControl. |
Comentários
Utilize a propriedade CommandBarEvents para devolver um objeto de origem de evento que aciona um evento quando é clicado um botão da barra de comandos.
O argumento transmitido para a propriedade CommandBarEvents é o controlo da barra de comandos para o qual o evento Click será acionado.
CommandBars
Contém todas as barras de comandos num projeto, incluindo barras de comandos que suportam menus de atalho.
Consulte tambémMenus e comandos e Barras de Ferramentas.
Conectar
Devolve ou define o estado ligado de um suplemento.
Comentários
Devolve Verdadeiro se o suplemento estiver registado e estiver atualmente ligado (ativo).
Devolve Falso se o suplemento estiver registado, mas não estiver ligado (inativo).
Contar
Devolve um Valor Longo contendo o número de itens numa coleção. Somente leitura.
CountOfDeclarationLines
Devolve um Valor Longo contendo o número de linhas de código na secção Declarações de um módulo de código. Somente leitura.
CountOfLines
Devolve um Valor Longo contendo o número de linhas de código num módulo de código. Somente leitura.
CountOfVisibleLines
Devolve um Valor Longo contendo o número de linhas visíveis num painel de código. Somente leitura.
Descrição
Devolve ou define uma expressão de cadeia que contém uma cadeia descritiva associada a um objeto. Para o objeto VBProject , leia/escreva; para o objeto Referência , só de leitura.
Comentários
Para o objeto VBProject , a propriedade Descrição devolve ou define uma cadeia descritiva associada ao projeto ativo.
Para o objeto Referência , a propriedade Descrição devolve o nome descritivo da referência.
Designer
Devolve o objeto que lhe permite aceder às características de estrutura de um componente.
Comentários
Se o objeto tiver um estruturador aberto, a propriedade Designer devolve o estruturador aberto; caso contrário, é criado um novo estruturador.
O estruturador é uma característica de determinados objetos VBComponent . Por exemplo, quando cria determinados tipos de objetos VBComponent , é criado um estruturador juntamente com o objeto . Um componente só pode ter um estruturador e é sempre o mesmo estruturador.
A propriedade Designer permite-lhe aceder a um objeto específico do componente. Em alguns casos, como em módulos padrão e módulos de classe, não é criado um estruturador porque esse tipo de objeto VBComponent não suporta um estruturador.
A propriedade Designernão devolve Nada se o objeto VBComponent não tiver um estruturador.
DesignerID
Propriedade só de leitura que devolve o ProgID de um estruturador ActiveX.
Eventos
Fornece propriedades que permitem que os suplementos se liguem a todos os eventos no Visual Basic for Applications.
Sintaxe
objeto. Eventos
O marcador de posição de objeto representa uma expressão de objeto que é avaliada como um objeto na lista Aplica-se a .
FileName
Devolve o nome completo do caminho do ficheiro do projeto ou do documento anfitrião.
Sintaxe
objeto. Nome do ficheiro
O marcador de posição de objeto representa uma expressão de objeto que é avaliada como um objeto na lista Aplica-se a .
Comentários
Os projetos não têm outro nome que não seja o nome do ficheiro. O nome do caminho devolvido é sempre fornecido como um caminho absoluto (por exemplo, "c:\projects\myproject.vba"), mesmo que seja apresentado como um caminho relativo (como ".. \projects\myproject.vba").
FullPath
Devolve uma Cadeia que contém o caminho e o nome de ficheiro da biblioteca de tipos referenciados. Somente leitura.
GUID
Devolve uma Cadeia que contém o identificador de classe de um objeto. Somente leitura.
HasOpenDesigner
Devolve um valor Booleano que indica se o objeto VBComponent tem um estruturador aberto. Somente leitura.
A propriedade HasOpenDesigner devolve estes valores:
| Valor | Descrição |
|---|---|
| Verdadeiro | O objeto VBComponent tem uma janela Estrutura aberta. |
| Falso | O objeto VBComponent não tem uma janela estrutura aberta. |
Altura
Devolve ou define um Único que contém a altura da janela em twips. Leitura/gravação.
Comentários
Alterar a definição da propriedade Altura de uma janela ligada ou janela ancorada não tem efeito, desde que a janela permaneça ligada ou ancorada.
Importante
Objetos, propriedades e métodos para controlar janelas ligadas, molduras de janelas ligadas e janelas ancoradas estão incluídos no Macintosh para compatibilidade com código escrito no Windows. No entanto, estes elementos de linguagem irão gerar erros de tempo de execução quando executados no Macintosh.
HelpContextID
Devolve ou define uma Cadeia que contém o ID de contexto de um tópico num ficheiro de Ajuda do Microsoft Windows. Leitura/gravação.
HelpFile
Devolve ou define uma Cadeia especificando o ficheiro de Ajuda do Microsoft Windows para um projeto. Leitura/gravação.
IndexedValue
Devolve ou define um valor para um membro de uma propriedade que é uma lista indexada ou uma matriz.
Comentários
O valor devolvido ou definido pela propriedade IndexedValue é uma expressão que é avaliada como um tipo que é aceite pelo objeto. Para uma propriedade que seja uma lista ou matriz indexada, tem de utilizar a propriedade IndexedValue em vez da propriedade Valor . Uma lista indexada é uma expressão numérica que especifica a posição do índice. Os valores nas listas indexadas são definidos ou devolvidos com um único índice.
IndexedValue aceita até 4 índices. O número de índices aceites por IndexedValue é o valor devolvido pela propriedade NumIndices . A propriedade IndexedValue só é utilizada se o valor da propriedade NumIndices for superior a zero.
IsBroken
Devolve um valor Booleano que indica se o objeto Reference aponta para uma referência válida no registo. Somente leitura.
A propriedade IsBroken devolve estes valores:
| Valor | Descrição |
|---|---|
| Verdadeiro | O objeto Referência já não aponta para uma referência válida no registo. |
| Falso | O objeto Referência aponta para uma referência válida no registo. |
Esquerda
Devolve ou define um Único que contém a localização do limite esquerdo da janela no ecrã em twips. Leitura/gravação.
Comentários
O valor devolvido pela propriedade Esquerda depende se a janela está ligada ou ancorada.
Observação
Alterar a definição da propriedade Esquerda de uma janela ligada ou ancorada não tem efeito, desde que a janela permaneça ligada ou ancorada.
Importante
Objetos, propriedades e métodos para controlar janelas ligadas, molduras de janelas ligadas e janelas ancoradas estão incluídos no Macintosh para compatibilidade com código escrito no Windows. No entanto, estes elementos de linguagem irão gerar erros de tempo de execução quando executados no Macintosh.
Linhas
Devolve uma cadeia que contém o número especificado de linhas de código.
Sintaxe
objeto. Linhas (linha inicial, contagem) Como Cadeia
A sintaxe Linhas tem as seguintes partes:
| Sair | Descrição |
|---|---|
| objeto | Obrigatório. Uma expressão do objeto que é avaliada como um objeto na lista Aplica-se a. |
| linha de início | Obrigatório. Um Longo especificando o número de linha no qual começar. |
| Count | Obrigatório. Um Longo a especificar o número de linhas que pretende devolver. |
Comentários
Os números de linha num módulo de código começam em 1.
LinkedWindowFrame
Devolve o objeto Janela que representa a moldura que contém a janela. Somente leitura.
Comentários
A propriedade LinkedWindowFrame permite-lhe aceder ao objeto que representa a moldura da janela ligada, que tem propriedades distintas da janela ou janelas que contém. Se a janela não estiver ligada, a propriedade LinkedWindowFrame devolve Nada.
Importante
Objetos, propriedades e métodos para controlar janelas ligadas, molduras de janelas ligadas e janelas ancoradas estão incluídos no Macintosh para compatibilidade com código escrito no Windows. No entanto, estes elementos de linguagem irão gerar erros de tempo de execução quando executados no Macintosh.
LinkedWindows
Devolve a coleção de todas as janelas ligadas contidas numa moldura de janela ligada. Somente leitura.
Comentários
A propriedade LinkedWindows é uma propriedade de acessório (ou seja, uma propriedade que devolve um objeto do mesmo tipo que o nome da propriedade).
MainWindow
Devolve um objeto Janela que representa a janela main do ambiente de desenvolvimento do Visual Basic. Somente leitura.
Comentários
Utilize o objeto Janela devolvido pela propriedade MainWindow para adicionar ou remover janelas ancoradas e para maximizar, minimizar, ocultar ou restaurar a janela de main do ambiente de desenvolvimento do Visual Basic.
Importante
Objetos, propriedades e métodos para controlar janelas ligadas, molduras de janelas ligadas e janelas ancoradas estão incluídos no Macintosh para compatibilidade com código escrito no Windows. No entanto, estes elementos de linguagem irão gerar erros de tempo de execução quando executados no Macintosh.
Principal
Devolve um Valor Longo contendo o número da versão principal da biblioteca de tipos referenciado. Somente leitura.
Comentários
O número devolvido pela propriedade Major corresponde ao número da versão principal armazenado na biblioteca de tipos para a qual definiu a referência.
Secundária
Devolve um Valor Longo que indica o número de versão secundária da biblioteca de tipos referenciado. Somente leitura.
Comentários
O número devolvido pela propriedade Menor corresponde ao número de versão secundária armazenado na biblioteca de tipos para a qual definiu a referência.
Modo
Devolve um valor que contém o modo do projeto especificado. Somente leitura.
A propriedade Modo devolve estes valores:
| Constante | Descrição |
|---|---|
| vbext_vm_Run | O projeto especificado está no modo de execução. |
| vbext_vm_Break | O projeto especificado está no modo de interrupção. |
| vbext_vm_Design | O projeto especificado está no modo de estrutura. |
Nome
Devolve ou define uma Cadeia que contém o nome utilizado no código para identificar um objeto. Para o objeto VBProject e o objeto VBComponent , leia/escreva. Para o objeto Propriedade e o objeto Referência , só de leitura.
Comentários
A tabela seguinte descreve como a definição da propriedade Nome se aplica a objetos diferentes.
| Objeto | Resultado da utilização da definição da propriedade Nome |
|---|---|
| VBProject | Devolve ou define o nome do projeto ativo. |
| VBComponent | Devolve ou define o nome do componente. Ocorre um erro se tentar definir a propriedade Nome para um nome que já está a ser utilizado ou um nome inválido. |
| Propriedade | Devolve o nome da propriedade tal como aparece no Browser de Propriedades. Este é o valor utilizado para indexar a coleção Propriedades . Não é possível definir o nome. |
| Reference | Devolve o nome da referência no código. Não é possível definir o nome. |
O nome predefinido para novos objetos é o tipo de objeto e um número inteiro exclusivo. Por exemplo, o primeiro novo objeto Formulário é Form1, um novo objeto Formulário é Form1 e o terceiro controlo de Caixa de Texto que criar num formulário é TextBox3.
A propriedade Nome de um objeto tem de começar com uma letra e pode ter um máximo de 40 carateres. Pode incluir números e carateres de sublinhado (_), mas não pode incluir pontuação ou espaços.
Forms e módulos não podem ter o mesmo nome que outro objeto público, como Área de Transferência, Ecrã ou Aplicação. Embora a definição da propriedade Nome possa ser um palavra-chave, o nome da propriedade ou o nome de outro objeto, isto pode criar conflitos no seu código.
NumIndices
Devolve o número de índices na propriedade devolvida pelo objeto Propriedade .
Comentários
O valor da propriedade NumIndices pode ser um número inteiro de 0 a 4. Para a maioria das propriedades, NumIndices devolve 0. As propriedades indexadas convencionalmente devolvem 1. As matrizes de propriedades podem devolver 2.
Objeto
Devolve ou define o valor de um objeto devolvido por uma propriedade. Leitura/gravação.
Comentários
Se um objeto propriedade devolver um objeto, tem de utilizar a propriedade Objeto para devolver ou definir o valor desse objeto.
Pai
Devolve o objeto ou coleção que contém outro objeto ou coleção. Somente leitura.
Comentários
A maioria dos objetos tem uma propriedade Principal ou uma propriedade Coleção que aponta para o objeto principal do objeto neste modelo de objeto. A propriedade Coleção é utilizada se o objeto principal for uma coleção.
Utilize a propriedade Principal para aceder às propriedades, métodos e controlos do objeto principal de um objeto.
Veja também o objeto CodeModule
ProcBodyLine
Devolve a primeira linha de um procedimento.
Sintaxe
objeto. ProcBodyLine (procname, prockind) As Long
A sintaxe ProcBodyLine tem as seguintes partes:
| Sair | Descrição |
|---|---|
| objeto | Obrigatório. Uma expressão do objeto que é avaliada como um objeto na lista Aplica-se a. |
| procname | Obrigatório. Uma Cadeia que contém o nome do procedimento. |
| prockind | Obrigatório. Especifica o tipo de procedimento a localizar. Uma vez que os procedimentos de propriedade podem ter múltiplas representações no módulo, tem de especificar o tipo de procedimento que pretende localizar. Todos os procedimentos que não os procedimentos de propriedade (ou seja, procedimentos de Sub e Função ) utilizam vbext_pk_Proc. |
Utilize uma das seguintes constantes para o argumentoprockind.
| Constante | Descrição |
|---|---|
| vbext_pk_Get | Especifica um procedimento que devolve o valor de uma propriedade. |
| vbext_pk_Let | Especifica um procedimento que atribui um valor a uma propriedade. |
| vbext_pk_Set | Especifica um procedimento que define uma referência a um objeto. |
| vbext_pk_Proc | Especifica todos os procedimentos que não os procedimentos de propriedade. |
Comentários
A primeira linha de um procedimento é a linha na qual é apresentada a instrução Sub, Função ou Propriedade .
ProcCountLines
Devolve o número de linhas no procedimento especificado.
Sintaxe
objeto. ProcCountLines (procname, prockind) As Long
A sintaxe ProcCountLines tem as seguintes partes:
| Sair | Descrição |
|---|---|
| objeto | Obrigatório. Uma expressão do objeto que é avaliada como um objeto na lista Aplica-se a. |
| procname | Obrigatório. Uma Cadeia que contém o nome do procedimento. |
| prockind | Obrigatório. Especifica o tipo de procedimento a localizar. Uma vez que os procedimentos de propriedade podem ter múltiplas representações no módulo, tem de especificar o tipo de procedimento que pretende localizar. Todos os procedimentos que não os procedimentos de propriedade (ou seja, procedimentos de Sub e Função ) utilizam vbext_pk_Proc. |
Utilize uma das seguintes constantes para o argumentoprockind.
| Constante | Descrição |
|---|---|
| vbext_pk_Get | Especifica um procedimento que devolve o valor de uma propriedade. |
| vbext_pk_Let | Especifica um procedimento que atribui um valor a uma propriedade. |
| vbext_pk_Set | Especifica um procedimento que define uma referência a um objeto. |
| vbext_pk_Proc | Especifica todos os procedimentos que não os procedimentos de propriedade. |
Comentários
A propriedade ProcCountLines devolve a contagem de todas as linhas em branco ou de comentários anteriores à declaração do procedimento e, se o procedimento for o último procedimento num módulo de código, quaisquer linhas em branco que sigam o procedimento.
ProcOfLine
Devolve o nome do procedimento em que se encontra a linha especificada.
Sintaxe
objeto. ProcOfLine (linha, prockind) Como Cadeia
A sintaxe ProcOfLine tem as seguintes partes:
| Sair | Descrição |
|---|---|
| objeto | Obrigatório. Uma expressão do objeto que é avaliada como um objeto na lista Aplica-se a. |
| line | Obrigatório. Um Longo especificando a linha a marcar. |
| prockind | Obrigatório. Especifica o tipo de procedimento a localizar. Uma vez que os procedimentos de propriedade podem ter múltiplas representações no módulo, tem de especificar o tipo de procedimento que pretende localizar. Todos os procedimentos que não os procedimentos de propriedade (ou seja, procedimentos de Sub e Função ) utilizam vbext_pk_Proc. |
Utilize uma das seguintes constantes para o argumentoprockind.
| Constante | Descrição |
|---|---|
| vbext_pk_Get | Especifica um procedimento que devolve o valor de uma propriedade. |
| vbext_pk_Let | Especifica um procedimento que atribui um valor a uma propriedade. |
| vbext_pk_Set | Especifica um procedimento que define uma referência a um objeto. |
| vbext_pk_Proc | Especifica todos os procedimentos que não os procedimentos de propriedade. |
Comentários
Uma linha está dentro de um procedimento se for uma linha em branco ou uma linha de comentário antes da declaração do procedimento e, se o procedimento for o último procedimento num módulo de código, uma linha em branco ou linhas que sigam o procedimento.
ProcStartLine
Devolve a linha na qual o procedimento especificado começa.
Sintaxe
objeto. ProcStartLine (procname, prockind) As Long
A sintaxe ProcStartLine tem as seguintes partes:
| Sair | Descrição |
|---|---|
| objeto | Obrigatório. Uma expressão do objeto que é avaliada como um objeto na lista Aplica-se a. |
| procname | Obrigatório. Uma Cadeia que contém o nome do procedimento. |
| prockind | Obrigatório. Especifica o tipo de procedimento a localizar. Uma vez que os procedimentos de propriedade podem ter múltiplas representações no módulo, tem de especificar o tipo de procedimento que pretende localizar. Todos os procedimentos que não os procedimentos de propriedade (ou seja, procedimentos de Sub e Função ) utilizam vbext_pk_Proc. |
Utilize uma das seguintes constantes para o argumentoprockind.
| Constante | Descrição |
|---|---|
| vbext_pk_Get | Especifica um procedimento que devolve o valor de uma propriedade. |
| vbext_pk_Let | Especifica um procedimento que atribui um valor a uma propriedade. |
| vbext_pk_Set | Especifica um procedimento que define uma referência a um objeto. |
| vbext_pk_Proc | Especifica todos os procedimentos que não os procedimentos de propriedade. |
Comentários
Um procedimento começa na primeira linha abaixo da instrução End Sub do procedimento anterior. Se o procedimento for o primeiro procedimento, começa no final da secção Declarações gerais.
ProgID
Devolve o ProgID (ID programático) do controlo representado pelo objeto VBControl .
Sintaxe
objeto. ProgID
O marcador de posição de objeto representa uma expressão de objeto que é avaliada como um objeto na lista Aplica-se a .
Propriedades
Devolve as propriedades de um objeto. Somente leitura.
Comentários
A propriedade Propriedades é uma propriedade de acessório (ou seja, uma propriedade que devolve um objeto do mesmo tipo que o nome da propriedade).
Proteção
Devolve um valor que indica o estado de proteção de um projeto. Somente leitura.
A propriedade Proteção devolve estes valores:
| Constante | Descrição |
|---|---|
| vbext_pp_locked | O projeto especificado está bloqueado. |
| vbext_pp_none | O projeto especificado não está protegido. |
Referências
Devolve o conjunto de referências num projeto. Somente leitura.
Comentários
A propriedade Referências é uma propriedade de acessório (ou seja, uma propriedade que devolve um objeto do mesmo tipo que o nome da propriedade).
ReferencesEvents
Devolve o objeto ReferencesEvents . Somente leitura.
Configurações
A definição do argumento que transmite à propriedade ReferencesEvents é:
| Argumento | Descrição |
|---|---|
| vbproject | Se o vbproject apontar para Nada, o objeto devolvido fornecerá eventos para as coleções de Referências de todos os objetos VBProject na coleção VBProjects . Se o vbproject apontar para um objeto VBProject válido, o objeto devolvido fornecerá eventos apenas para a coleção Referências desse projeto. |
Comentários
A propriedade ReferencesEvents utiliza um argumento e devolve um objeto de origem de evento. O objeto ReferencesEvents é a origem dos eventos que são acionados quando as referências são adicionadas ou removidas.
Salvo
Devolve um valor Booleano que indica se o objeto foi editado desde a última vez que foi guardado. Leitura/gravação.
A propriedade Guardado devolve estes valores:
| Valor | Descrição |
|---|---|
| Verdadeiro | O objeto não foi editado desde a última vez que foi guardado. |
| Falso | O objeto foi editado desde a última vez que foi guardado. |
Comentários
O método SaveAs define a propriedade Guardado como Verdadeiro.
Observação
Se definir a propriedade Guardado como Falso no código, devolve Falso e o objeto é marcado como se tivesse sido editado desde a última vez que foi guardado.
SelectedVBComponent
Devolve o componente selecionado. Somente leitura.
Comentários
A propriedade SelectedVBComponent devolve o componente selecionado na janela Projeto. Se o item selecionado na janela Projeto não for um componente, SelectedVBComponent devolve Nada.
Veja também o objeto VBE .
Início
Devolve ou define um Único especificando a localização da parte superior da janela no ecrã em twips. Leitura/gravação.
Comentários
O valor devolvido pela propriedade Superior depende se a janela está ancorada, ligada ou na vista de ancoragem.
Observação
Alterar a definição da propriedade Superior de uma janela ligada ou ancorada não tem efeito, desde que a janela permaneça ligada ou ancorada.
Importante
Objetos, propriedades e métodos para controlar janelas ligadas, molduras de janelas ligadas e janelas ancoradas estão incluídos no Macintosh para compatibilidade com código escrito no Windows. No entanto, estes elementos de linguagem irão gerar erros de tempo de execução quando executados no Macintosh.
Linha Superior
Devolve um Valor Longo especificando o número de linha da linha na parte superior do painel de código ou define a linha apresentada na parte superior do painel de código. Leitura/gravação.
Comentários
Utilize a propriedade TopLine para devolver ou definir a linha apresentada na parte superior do painel de código. Por exemplo, se quiser que a linha 25 seja a primeira linha apresentada num painel de código, defina a propriedade TopLine como 25.
A definição da propriedade TopLine tem de ser um número positivo. Se a definição da propriedade TopLine for maior do que o número real de linhas no painel de código, a definição será a última linha no painel de código.
Tipo
Devolve um valor numérico ou de cadeia que contém o tipo de objeto. Somente leitura.
As definições da propriedade Tipo para o objeto Janela estão descritas na tabela seguinte.
| Constant | Valor | Descrição |
|---|---|---|
| vbext_wt_CodeWindow | 0 | Janela de código |
| vbext_wt_Designer | 1 | Designer |
| vbext_wt_Browser | 2 | Pesquisador de Objetos |
| vbext_wt_Immediate | 5 | Janela imediata |
| vbext_wt_ProjectWindow | 6 | Janela de projeto |
| vbext_wt_PropertyWindow | 7 | Janela Propriedades |
| vbext_wt_Find | 8 | Caixa de diálogo Localizar |
| vbext_wt_FindReplace | 9 | Caixa de diálogo Procurar e Substituir |
| vbext_wt_LinkedWindowFrame | 11 | Moldura de janela ligada |
| vbext_wt_MainWindow | 12 | Janela principal |
| vbext_wt_Watch | 3 | Janela Inspeção |
| vbext_wt_Locals | 4 | Janela Locais |
| vbext_wt_Toolbox | 10 | Caixa de Ferramentas |
| vbext_wt_ToolWindow | 15 | Janela da ferramenta |
Importante
Objetos, propriedades e métodos para controlar janelas ligadas, molduras de janelas ligadas e janelas ancoradas estão incluídos no Macintosh para compatibilidade com código escrito no Windows. No entanto, estes elementos de linguagem irão gerar erros de tempo de execução quando executados no Macintosh.
As definições da propriedade Tipo para o objeto VBComponent estão descritas na tabela seguinte.
| Constant | Valor | Descrição |
|---|---|---|
| vbext_ct_StdModule | 1 | Módulo padrão |
| vbext_ct_ClassModule | 2 | Módulo de classe |
| vbext_ct_MSForm | 3 | Microsoft Form |
| vbext_ct_ActiveXDesigner | 11 | ActiveX Designer |
| vbext_ct_Document | 100 | Módulo de Documento |
As definições da propriedade Tipo para o objeto Referência estão descritas na tabela seguinte.
| Constant | Valor | Descrição |
|---|---|---|
| vbext_rk_TypeLib | 0 | Biblioteca de tipos |
| vbext_rk_Project | 1 | Project |
As definições de propriedade Tipo para o objeto VBProject estão descritas na tabela seguinte.
| Constant | Valor | Descrição |
|---|---|---|
| vbext_pt_HostProject | 100 | Projeto anfitrião |
| vbext_pt_StandAlone | 101 | Projeto Autónomo |
Valor
Devolve ou define uma Variante especificando o valor da propriedade. Leitura/gravação.
Comentários
Uma vez que a propriedade Valor devolve uma Variante, pode aceder a qualquer propriedade. Para aceder a uma lista, utilize a propriedade IndexedValue .
Se a propriedade que o objeto Propriedade representa for de leitura/escrita, a propriedade Valor é de leitura/escrita. Se a propriedade for só de leitura, tentar definir a propriedade Valor causa um erro. Se a propriedade for só de escrita, tentar devolver a propriedade Valor causa um erro.
A propriedade Valor é a propriedade predefinida para o objeto Propriedade .
VBComponents
Devolve uma coleção dos componentes contidos num projeto.
Comentários
Utilize a coleção VBComponents para aceder, adicionar ou remover componentes num projeto. Um componente pode ser um formulário, módulo ou classe. A coleção VBComponents é uma coleção padrão que pode ser utilizada num Para... Cada bloco.
Utilize a propriedade Parent para devolver o projeto em que se encontra a coleção VBComponents .
No Visual Basic for Applications, pode utilizar o método Importar para adicionar um componente a um projeto a partir de um ficheiro.
Para obter mais informações, veja Objeto VBComponent e Propriedade SelectedVBComponent .
VBE
Devolve a raiz do objeto VBE . Somente leitura.
Comentários
Todos os objetos têm uma propriedade VBE que aponta para a raiz do objeto VBE .
VBProjects
Devolve a coleção VBProjects , que representa todos os projetos atualmente abertos no IDE do Visual Basic.
Sintaxe
objeto. VBProjects
O marcador de posição de objeto representa uma expressão de objeto que é avaliada como um objeto na lista Aplica-se a .
Versão
Devolve uma Cadeia que contém a versão do Visual Basic for Applications que a aplicação está a utilizar. Somente leitura.
Comentários
O valor da propriedade Versão é uma cadeia que começa com um ou dois dígitos, um ponto final e dois dígitos; o resto da cadeia é indefinida e pode conter texto ou números.
Visible
Para o objeto Janela , devolve ou define um valor booleano que especifica a visibilidade de uma janela. Leitura/gravação.
Para o objeto CodePane , devolve um valor Booleano que indica se o painel de código está visível na janela. Somente leitura.
A propriedade Visible devolve estes valores:
| Valor | Descrição |
|---|---|
| Verdadeiro | (Predefinição) O objeto está visível. |
| Falso | O objeto está oculto. |
Width
Devolve ou define um Único que contém a largura da janela em twips. Leitura/gravação.
Comentários
Alterar a definição da propriedade Largura de uma janela ligada ou janela ancorada não tem efeito, desde que a janela permaneça ligada ou ancorada.
Importante
Objetos, propriedades e métodos para controlar janelas ligadas, molduras de janelas ligadas e janelas ancoradas estão incluídos no Macintosh para compatibilidade com código escrito no Windows. No entanto, estes elementos de linguagem irão gerar erros de tempo de execução quando executados no Macintosh.
Janela
Devolve a janela na qual o painel de código é apresentado. Somente leitura.
Windows
Devolve o objeto Janela , que representa uma janela no IDE do Visual Basic.
Sintaxe
objeto. Janela
O marcador de posição de objeto representa uma expressão de objeto que é avaliada como um objeto na lista Aplica-se a .
WindowState
Devolve ou define um valor numérico que especifica o estado visual da Janela. Leitura/gravação.
Configurações
A propriedade WindowState devolve ou define os seguintes valores:
| Constant | Valor | Descrição |
|---|---|---|
| vbext_ws_Normal | 0 | (Padrão) Normal |
| vbext_ws_Minimize | 1 | Minimizado (minimizado para um ícone) |
| vbext_ws_Maximize | 2 | Maximizado (aumentado para o tamanho máximo) |
Confira também
- Propriedades (Microsoft Forms)
- Objetos, métodos e propriedades (Visual Basic for Applications)
- Referência do Modelo de Suplemento do Visual Basic
- Referência de linguagem do Visual Basic
- Referência de desenvolvimento do cliente do Office
Suporte e comentários
Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.