Función OpenClipboard (winuser.h)

Abre el Portapapeles para su examen e impide que otras aplicaciones modifiquen el contenido del Portapapeles.

Sintaxis

BOOL OpenClipboard(
  [in, optional] HWND hWndNewOwner
);

Parámetros

[in, optional] hWndNewOwner

Tipo: HWND

Identificador de la ventana que se va a asociar al Portapapeles abierto. Si este parámetro es NULL, el Portapapeles abierto está asociado a la tarea actual.

Valor devuelto

Tipo: BOOL

Si la función se realiza correctamente, el valor devuelto es distinto de cero.

Si la función no se realiza correctamente, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError.

Comentarios

Se produce un error en OpenClipboard si otra ventana tiene abierto el Portapapeles.

Una aplicación debe llamar a la función CloseClipboard después de cada llamada correcta a OpenClipboard.

La ventana identificada por el parámetro hWndNewOwner no se convierte en el propietario del Portapapeles a menos que se llame a la función EmptyClipboard .

Si una aplicación llama a OpenClipboard con hwnd establecido en NULL, EmptyClipboard establece el propietario del Portapapeles en NULL; Esto hace que SetClipboardData produzca un error.

Ejemplos

Para obtener un ejemplo, vea Copiar información en el Portapapeles.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado winuser.h (incluir Windows.h)
Library User32.lib
Archivo DLL User32.dll
Conjunto de API ext-ms-win-ntuser-misc-l1-2-0 (introducido en Windows 8.1)

Consulte también

Portapapeles

CloseClipboard

Conceptual

EmptyClipboard

Referencia