WindowsFormsApplicationBase Classe

Definição

Fornece propriedades, métodos e eventos relacionados com a aplicação atual.

public ref class WindowsFormsApplicationBase : Microsoft::VisualBasic::ApplicationServices::ConsoleApplicationBase
public class WindowsFormsApplicationBase : Microsoft.VisualBasic.ApplicationServices.ConsoleApplicationBase
type WindowsFormsApplicationBase = class
    inherit ConsoleApplicationBase
Public Class WindowsFormsApplicationBase
Inherits ConsoleApplicationBase
Herança
WindowsFormsApplicationBase

Exemplos

Este exemplo utiliza um ciclo para iterar pelos formulários abertos da aplicação, seleciona os formulários que podem ser acedidos diretamente pelo thread atual e exibe os seus títulos num ListBox controlo. Para informações sobre como aceder aos formulários abertos, consulte OpenForms.

Private Sub GetOpenFormTitles()
    Dim formTitles As New Collection

    Try
        For Each f As Form In My.Application.OpenForms
            If Not f.InvokeRequired Then
                ' Can access the form directly.
                formTitles.Add(f.Text)
            End If
        Next
    Catch ex As Exception
        formTitles.Add("Error: " & ex.Message)
    End Try

    Form1.ListBox1.DataSource = formTitles
End Sub

Este exemplo exige que a sua candidatura de Windows Forms tenha um formulário chamado Form1 que contenha uma caixa de lista chamada ListBox1.

Observações

As propriedades expostas pelo My.Application objeto retornam dados associados apenas à aplicação ou DLL atual. Nenhuma informação ao nível do sistema pode ser alterada com My.Application.

O My.Application objeto é composto pelas seguintes classes:

Construtores

Name Description
WindowsFormsApplicationBase()

Inicializa uma nova instância da WindowsFormsApplicationBase classe.

WindowsFormsApplicationBase(AuthenticationMode)

Inicializa uma nova instância da WindowsFormsApplicationBase classe com o modo de autenticação especificado.

Propriedades

Name Description
ApplicationContext

Obtém o objeto ApplicationContext para o thread atual de uma aplicação Windows Forms.

CommandLineArgs

Obtém uma coleção contendo os argumentos da linha de comandos como strings para a aplicação atual.

(Herdado de ConsoleApplicationBase)
Culture

Obtém a cultura que a thread atual usa para manipulação e formatação de strings.

(Herdado de ApplicationBase)
Deployment

Obtém o objeto de implementação ClickOnce da aplicação atual, que oferece suporte para atualizar programaticamente a implementação atual e suporte para download on-demand de ficheiros.

(Herdado de ConsoleApplicationBase)
EnableVisualStyles

Determina se esta aplicação usará os estilos do Windows XP para janelas, controlos, e assim por diante.

Info

Obtém um objeto que fornece propriedades para obter informações sobre a montagem da aplicação, como o número de versão, descrição, e assim por diante.

(Herdado de ApplicationBase)
InternalCommandLine

Define os valores a usar como argumentos de linha de comandos da aplicação atual.

(Herdado de ConsoleApplicationBase)
IsNetworkDeployed

Obtém um Boolean que representa se a aplicação foi implementada a partir de uma rede usando o ClickOnce.

(Herdado de ConsoleApplicationBase)
IsSingleInstance

Recebe ou define um valor que indica se esta aplicação é uma aplicação de instância única.

Log

Obtém um objeto que fornece propriedades e métodos para escrever informações de eventos e exceções aos ouvintes de registo da aplicação.

(Herdado de ApplicationBase)
MainForm

Obtém ou define a forma principal para esta candidatura.

MinimumSplashScreenDisplayTime

Obtém ou define o tempo mínimo, em milissegundos, durante o qual o ecrã inicial é exibido.

OpenForms

Recebe uma coleção de todos os formulários abertos da candidatura.

SaveMySettingsOnExit

Determina se a aplicação guarda as definições do utilizador ao sair.

ShutdownStyle

Determina o que acontece quando o formulário principal da candidatura fecha.

SplashScreen

Recebe ou define o ecrã inicial desta aplicação.

UICulture

Obtém a cultura que o tópico atual usa para recuperar recursos específicos da cultura.

(Herdado de ApplicationBase)
UseCompatibleTextRendering

Quando sobreposta numa classe derivada, esta propriedade permite que um designer especifique o motor de renderização de texto predefinido para os formulários da aplicação.

Métodos

Name Description
ChangeCulture(String)

Altera a cultura usada pelo thread atual para manipulação e formatação de strings.

(Herdado de ApplicationBase)
ChangeUICulture(String)

Altera a cultura que o tópico atual usa para recuperar recursos específicos da cultura.

(Herdado de ApplicationBase)
DoEvents()

Processa todas as mensagens do Windows atualmente na fila de mensagens.

Equals(Object)

Determina se o objeto especificado é igual ao objeto atual.

(Herdado de Object)
GetEnvironmentVariable(String)

Devolve o valor da variável de ambiente especificada.

(Herdado de ApplicationBase)
GetHashCode()

Serve como função de hash predefinida.

(Herdado de Object)
GetType()

Obtém o Type da instância atual.

(Herdado de Object)
HideSplashScreen()

Esconde o ecrã inicial da aplicação.

MemberwiseClone()

Cria uma cópia superficial do atual Object.

(Herdado de Object)
OnCreateMainForm()

Quando sobrescrito numa classe derivada, permite ao designer emitir código que configura o ecrã de arranque e a forma principal.

OnCreateSplashScreen()

Quando sobrescrito numa classe derivada, permite ao designer emitir código que inicializa o ecrã inicial.

OnInitialize(ReadOnlyCollection<String>)

Define os estilos visuais, estilos de exibição de texto e o princípio atual para a thread principal da aplicação (se a aplicação usar Windows authentication), e inicializa o ecrã inicial, se estiver definido.

OnRun()

Fornece o ponto de partida para quando o aplicativo principal estiver pronto para começar a ser executado, após a inicialização ser concluída.

OnShutdown()

Quando é sobreposto numa classe derivada, permite que o código seja executado quando a aplicação desliga.

OnStartup(StartupEventArgs)

Quando sobreposto numa classe derivada, permite que o código seja executado quando a aplicação inicia.

OnStartupNextInstance(StartupNextInstanceEventArgs)

Quando sobrescrito numa classe derivada, permite que o código seja executado quando uma instância subsequente de uma aplicação de instância única é iniciada.

OnUnhandledException(UnhandledExceptionEventArgs)

Quando é sobreposto numa classe derivada, permite que o código seja executado quando ocorre uma exceção não tratada na aplicação.

Run(String[])

Configura e inicia o modelo de aplicação Visual Basic.

ShowSplashScreen()

Determina se a aplicação tem um ecrã inicial definido e, se tiver, mostra-o.

ToString()

Devolve uma cadeia que representa o objeto atual.

(Herdado de Object)

evento

Name Description
NetworkAvailabilityChanged

Ocorre quando a disponibilidade da rede muda.

Shutdown

Acontece quando a aplicação é encerrada.

Startup

Ocorre quando a aplicação começa.

StartupNextInstance

Ocorre ao tentar iniciar uma aplicação de instância única e esta já está ativa.

UnhandledException

Ocorre quando a aplicação encontra uma exceção não tratada.

Aplica-se a

Ver também