Interaction.AppActivate Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Activa una aplicación que ya se está ejecutando.
Sobrecargas
| AppActivate(Int32) |
Activa una aplicación que ya se está ejecutando. |
| AppActivate(String) |
Activa una aplicación que ya se está ejecutando. |
AppActivate(Int32)
- Source:
- Interaction.vb
- Source:
- Interaction.vb
- Source:
- Interaction.vb
Activa una aplicación que ya se está ejecutando.
public:
static void AppActivate(int ProcessId);public static void AppActivate (int ProcessId);static member AppActivate : int -> unitPublic Sub AppActivate (ProcessId As Integer)Parámetros
- ProcessId
- Int32
Integer que especifica el número de identificador de proceso Win32 que se ha asignado a este proceso. Puede utilizar el identificador que devuelve Shell(String, AppWinStyle, Boolean, Int32), siempre que no sea cero.
Ejemplos
En este ejemplo se muestran varios usos de la AppActivate función para activar una ventana de aplicación. Si un proceso del Bloc de notas no se está ejecutando, en el ejemplo se producirá una excepción ArgumentException. El procedimiento Shell supone que las aplicaciones están en las rutas de acceso especificadas.
Dim notepadID As Integer
' Activate a running Notepad process.
AppActivate("Untitled - Notepad")
' AppActivate can also use the return value of the Shell function.
' Shell runs a new instance of Notepad.
notepadID = Shell("C:\WINNT\NOTEPAD.EXE", AppWinStyle.NormalFocus)
' Activate the new instance of Notepad.
AppActivate(notepadID)
Comentarios
Se usa AppActivate para poner la ventana activa de una aplicación en el foco. Es posible que no tenga un identificador o una referencia a la ventana activa, o incluso saber qué ventana está activa en un momento dado. En tal caso, no puede usar el Focus método .
La AppActivate función cambia el foco a la aplicación o ventana con nombre, pero no afecta a si está maximizado o minimizado. El foco se aleja de la ventana de la aplicación activada cuando el usuario realiza alguna acción para cambiar el foco o cerrar la ventana. Puede usar la Shell función para iniciar una aplicación y establecer el estilo de ventana.
Si usa el Title parámetro , AppActivate usa una comparación sin distinción entre mayúsculas y minúsculas, pero de lo contrario requiere una coincidencia exacta con el contenido de la barra de título. Primero examina las ventanas de nivel superior y, a continuación, a través de las ventanas secundarias. Si no encuentra una coincidencia, produce una ArgumentExceptionexcepción .
Solo puede usar AppActivate con procesos que poseen ventanas. La mayoría de las aplicaciones de consola no poseen ventanas, lo que significa que no aparecen en la lista de procesos que AppActivate busca. Cuando se ejecuta desde una aplicación de consola, el sistema crea un proceso independiente para ejecutar la aplicación y devuelve la salida al proceso de consola. Por lo tanto, cuando se solicita el identificador de proceso actual, se obtiene el identificador de proceso de este proceso independiente, en lugar del identificador de proceso de la aplicación de consola.
En tiempo de ejecución, la AppActivate función activa cualquier aplicación en ejecución con un título que coincida Title con o con un identificador de proceso que coincida ProcessIdcon . Si no hay ninguna coincidencia exacta, activa cualquier aplicación cuya cadena de título termine con Title. Si hay más de una aplicación denominada Title, la AppActivate función elige arbitrariamente una para activarla.
Nota
La AppActivate función requiere UIPermission en el SafeTopLevelWindows nivel , que puede afectar a su ejecución en situaciones de confianza parcial. Para obtener más información, consulta UIPermission.
Consulte también
Se aplica a
AppActivate(String)
- Source:
- Interaction.vb
- Source:
- Interaction.vb
- Source:
- Interaction.vb
Activa una aplicación que ya se está ejecutando.
public:
static void AppActivate(System::String ^ Title);public static void AppActivate (string Title);static member AppActivate : string -> unitPublic Sub AppActivate (Title As String)Parámetros
- Title
- String
Expresión de tipo String que especifica el título de la barra de título de la aplicación que se desea activar. Puede utilizar el título asignado a la aplicación al iniciarla.
Ejemplos
En este ejemplo se muestran varios usos de la AppActivate función para activar una ventana de aplicación. Si un proceso del Bloc de notas no se está ejecutando, en el ejemplo se producirá una excepción ArgumentException. El procedimiento Shell supone que las aplicaciones están en las rutas de acceso especificadas.
Dim notepadID As Integer
' Activate a running Notepad process.
AppActivate("Untitled - Notepad")
' AppActivate can also use the return value of the Shell function.
' Shell runs a new instance of Notepad.
notepadID = Shell("C:\WINNT\NOTEPAD.EXE", AppWinStyle.NormalFocus)
' Activate the new instance of Notepad.
AppActivate(notepadID)
Comentarios
Se usa AppActivate para poner la ventana activa de una aplicación en el foco. Es posible que no tenga un identificador o una referencia a la ventana activa, o incluso saber qué ventana está activa en un momento dado. En tal caso, no puede usar el Focus método .
La AppActivate función cambia el foco a la aplicación o ventana con nombre, pero no afecta a si está maximizado o minimizado. El foco se aleja de la ventana de la aplicación activada cuando el usuario realiza alguna acción para cambiar el foco o cerrar la ventana. Puede usar la Shell función para iniciar una aplicación y establecer el estilo de ventana.
Si usa el Title parámetro , AppActivate usa una comparación sin distinción entre mayúsculas y minúsculas, pero de lo contrario requiere una coincidencia exacta con el contenido de la barra de título. Primero examina las ventanas de nivel superior y, a continuación, a través de las ventanas secundarias. Si no encuentra una coincidencia, produce una ArgumentExceptionexcepción .
Solo puede usar AppActivate con procesos que poseen ventanas. La mayoría de las aplicaciones de consola no poseen ventanas, lo que significa que no aparecen en la lista de procesos que AppActivate busca. Cuando se ejecuta desde una aplicación de consola, el sistema crea un proceso independiente para ejecutar la aplicación y devuelve la salida al proceso de consola. Por lo tanto, cuando se solicita el identificador de proceso actual, se obtiene el identificador de proceso de este proceso independiente, en lugar del identificador de proceso de la aplicación de consola.
En tiempo de ejecución, la AppActivate función activa cualquier aplicación en ejecución con un título que coincida Title con o con un identificador de proceso que coincida ProcessIdcon . Si no hay ninguna coincidencia exacta, activa cualquier aplicación cuya cadena de título termine con Title. Si hay más de una aplicación denominada Title, la AppActivate función elige arbitrariamente una para activarla.
Nota
La AppActivate función requiere UIPermission en el SafeTopLevelWindows nivel , que puede afectar a su ejecución en situaciones de confianza parcial. Para obtener más información, consulta UIPermission.
