Name
AppActivate Procedure
Class
Microsoft.VisualBasic.Interaction
Syntax
[Interaction.]AppActivate(title
)
-
title
(required; String or Integer) The name of the application as currently shown in the application window title bar. This can also be the task ID returned from the Shell function.
Description
Activates a window based on its caption
Rules at a Glance
AppActivate
performs a case-insensitive search on all top-level windows for a window caption that matchestitle
. If an exact match is found, the window is activated. If no match is found, then the window captions are searched for a prefix match (title
matches the beginning of the window caption). For example, thetitle
"Microsoft
Word"
matches"Microsoft
Word
-
MyDocument.doc"
. If a prefix match is found, the window is activated. Note that if multiple prefix matches are found, there is no way to predict which matching window will be activated.The window state (Maximized, Minimized, or Normal) of the activated application is not affected by
AppActivate
.If a matching application cannot be found, an exception of type System.ArgumentException is raised, and runtime error 5, “Invalid procedure call or argument,” is generated.
Example
Private Sub Button2_Click(ByVal sender As System.Object, _ ByVal e As System.EventArgs) _ Handles Button2.Click Dim bVoid As Boolean bVoid = ActivateAnApp("Microsoft Excel") End Sub Function ActivateAnApp(vAppTitle As String) As Boolean On Error GoTo Activate_Err ActivateAnApp = False AppActivate(vAppTitle) ...
Get VB.NET Language in a Nutshell, Second Edition now with the O’Reilly learning platform.
O’Reilly members experience books, live events, courses curated by job role, and more from O’Reilly and nearly 200 top publishers.