WindowsFormsApplicationBase Classe
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
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
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:
ApplicationBase Fornece membros disponíveis em todos os projetos.
WindowsFormsApplicationBase fornece membros disponíveis em Windows Forms candidaturas.
ConsoleApplicationBase fornece membros disponíveis em aplicações de consola.
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 |
| 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. |