Referência rápida (C++/CX)

  • Artigo

O Windows Runtime dá suporte a aplicativos UWP (Plataforma Universal do Windows). Esses aplicativos são executados apenas em um ambiente de sistema operacional confiável, usam funções, tipos de dados e dispositivos autorizados e são distribuídos por meio da Microsoft Store. O C++/CX simplifica a escrita de aplicativos para o Windows Runtime. Este artigo é uma referência rápida. Para obter uma documentação mais completa, confira Sistema de tipos.

Ao compilar na linha de comando, use a opção de compilador /ZW para compilar um aplicativo UWP ou componente do Windows Runtime. Para acessar as declarações do Windows Runtime, que são definidas nos novos arquivos de metadados (.winmd) do Windows Runtime, especifique a diretiva #using ou a opção de compilador /FU. Quando você cria um projeto para um aplicativo UWP, por padrão, o Visual Studio define essas opções e adiciona referências a todas as bibliotecas do Windows Runtime.

Referência rápida

Conceito C++ Padrão C++/CX Comentários
Tipos fundamentais Tipos fundamentais do C++. Os tipos fundamentais do C++/CX que implementam os tipos fundamentais definidos no Windows Runtime. O namespace default contém tipos fundamentais internos do C++/CX. O compilador mapeia implicitamente tipos fundamentais C++/CX para tipos C++ padrão.

A família de namespaces Platform contém tipos que implementam tipos fundamentais do Windows Runtime.
bool bool Um valor Booliano de 8 bits.
wchar_t, char16_t char16 Um valor não numérico de 16 bits que representa um ponto de código Unicode (UTF-16).
short

unsigned short		 int16

uint16		 Um inteiro de 16 bits com sinal.

Um inteiro sem sinal de 16 bits.
int

unsigned int		 int

uint32		 Um inteiro com sinal de 32 bits.

Um inteiro sem sinal de 32 bits.
long long - ou - __int64

unsigned long long		 int64

uint64		 Um inteiro com sinal de 64 bits.

Um inteiro sem sinal de 64 bits.
float, double float32, float64 Um número de ponto flutuante IEEE 754 de 32 ou 64 bits.
enum enum class

-ou-

enum struct		 Uma enumeração de 32 bits.
(Não se aplica) Platform::Guid Um valor não numérico de 128 bits (uma GUID) no namespace Platform .
std::time_get Windows::Foundation::DateTime Uma estrutura date-time.
(Não se aplica) Windows::Foundation::TimeSpan Uma estrutura timespan.
(Não se aplica) Platform::Object^ O objeto base contado por referência na exibição C++ do sistema de tipos do Windows Runtime.
std::wstring

L"..."		 Platform::String^ Platform::String^ é uma sequência de caracteres Unicode imutável, contada por referência, que representa texto.
Ponteiro Ponteiro para objeto (*):

std::shared_ptr		 Handle-to-object (^ou "hat"):

T^ identifier		 Todas as classes do Windows Runtime são declaradas usando o modificador handle-to-object. Os membros do objeto são acessados usando o operador de acesso ao membro da classe (->) de seta.

O modificador hat significa "ponteiro para um objeto Windows Runtime que é contado automaticamente de referência". Mais precisamente, handle-to-object declara que o compilador deve inserir código para gerenciar automaticamente a contagem de referência de objeto e excluirá o objeto se a contagem de referência chegar a zero
Referência Referência para um objeto (&):

T& identifier		 Referência de rastreamento (%):

T% identifier		 Somente os tipos do Windows Runtime podem ser declarados usando o modificador de referência de rastreamento. Os membros do objeto são acessados usando o operador de acesso ao membro da classe (.) de ponto.

A referência de acompanhamento significa "uma referência a um objeto Windows Runtime que é contado automaticamente". Mais precisamente, uma referência de acompanhamento declara que o compilador deve inserir código para gerenciar a contagem de referência do objeto automaticamente. O código excluirá o objeto se a contagem de referências chegar a zero.
Declaração de tipo dinâmico new ref new Aloca um objeto do Windows Runtime e retorna um identificador para esse objeto.
gerenciamento de vida útil de objeto delete identifier

delete[] identifier		 (Invoca o destruidor.) A vida útil é determinada pela contagem de referência. Uma chamada para delete invoca o destruidor, mas ele próprio não libera memória.
declaração de matriz T identifier[]

std::array identifier		 Array<T^>^ identifier( size )

-ou-

WriteOnlyArray<T^> identifier( size )		 Declara uma matriz unidimensional modificável ou somente gravação do tipo T^. A própria matriz também é um objeto contado por referência que deve ser declarada usando o modificador handle-to-object.

(As declarações de matriz usam uma classe de cabeçalho de modelo que está no namespace Platform )
declaração de classe class identifier {}

struct identifier {}		 ref class identifier {}

ref struct identifier {}		 Declara uma classe de runtime que tem acessibilidade private padrão.

Declara uma classe de runtime que tem acessibilidade public padrão.
declaração de estrutura struct identifier {}

(isto é, uma estrutura POD (Plain Old Data))		 value class identifier {}

value struct identifier {}		 Declara um struct POD que tem acessibilidade private padrão.

Um value class pode ser representado em metadados do Windows, mas um class C++ padrão não pode ser.

Declara um struct POD que tem acessibilidade public padrão.

Um value struct pode ser representado em metadados do Windows, mas um struct C++ padrão não pode ser.
declaração de interface classe abstrata que contém apenas funções virtuais puras. interface class identifier {}

interface struct identifier {}		 Declara uma interface que tem acessibilidade private padrão.

Declara uma interface que tem acessibilidade public padrão.
Delegar std::function public delegate return-type delegate-type-identifier ([ parâmetros ]); Declara um objeto que pode ser chamado como uma chamada de função.
Evento (Não se aplica) event delegate-type-identifier event-identifier;

delegate-type-identifier delegate-identifier = ref new delegate-type-identifier( this[, parâmetros]);

event-identifier += *delegate-identifier;

-ou-

EventRegistrationToken token-identifier = object.event-identifier += delegate-identifier;

-ou-

auto token-identifier = object.event-identifier::add( delegate-identifier );

object.event-identifier -= token-identifier;

-ou-

object.event-identifier::remove( token-identifier );		 Declara um objeto event, que armazena uma coleção de manipuladores de eventos (delegados) que são chamados quando ocorre um evento.

Cria um manipulador de eventos.

Adiciona um manipulador de eventos.

A adição de um manipulador de eventos retorna um token de evento (token-identifier). Se você pretende remover explicitamente o manipulador de eventos, deverá salvar o token de evento para uso posterior.

Remove um manipulador de eventos.

Para remover um manipulador de eventos, você deve especificar o token de evento salvo quando o manipulador de eventos foi adicionado.
Propriedade (Não se aplica) property T identifier;

property T identifier[ index ];

property T default[ index ];		 Declara que uma função de membro de classe ou objeto é acessada usando a mesma sintaxe usada para acessar um membro de dados ou elemento de matriz indexada.

Declara uma propriedade em uma função de membro de classe ou objeto.

Declara uma propriedade indexada em uma função de membro de objeto.

Declara uma propriedade indexada em uma função de membro de classe.
Tipos parametrizados modelos generic <typename T> interface class identifier {}

generic <typename T > delegate[return-type]delegate-identifier() {}		 Declara uma classe com de interface parametrizada.

Declara um delegado parametrizado.
Tipos de valor anuláveis std::optional<T> Platform::IBox <T> Permite que variáveis de tipos escalares e structs value tenham um valor de nullptr.

Confira também

Referência da linguagem C++/CX