ResourceReadImage

A função lê os dados do recurso gráfico criado pela função ResourceCreate() ou salvo como arquivo EX5 durante a compilação.

bool  ResourceReadImage(
   const string      resource_name,       // nome do recurso gráfico para leitura
   uint&             data[],              // array recebendo dados a partir do recurso
   uint&             width,               // para receber a largura da imagem no recurso
   uint&             height,              // para receber a altura da imagem no recurso
   );

Parâmetros

resource_name

[in]  Nome do recurso gráfico contendo uma imagem. Para acessar novamente seus próprios recursos, o nome é usado em formato abreviado "::resourcename". Se baixamos um recurso a partir de uma compilação de arquivo EX5, o nome completo seria usado com o caminho relativo do diretório MQL5, nomes do arquivo e recurso - "path\\filename.ex5::resourcename".

data[][]

[in]  Array uni- ou bi-dimensional para recebimento de dados do recurso gráfico.

img_width

[out]  Recurso gráfico da largura da imagem em pixels.

img_height

[out]  Recurso gráfico da altura da imagem em pixels.

Valor de retorno

true se bem sucedido, caso contrário false. Para obter informações sobre o erro, chamar a função GetLastError().

Observação

Se é array data[], então será usado para criar um recurso gráfico, formatos de cor COLOR_FORMAT_ARGB_NORMALIZE ou COLOR_FORMAT_XRGB_NOALPHA devem ser utilizados.

Se é array data[] bidimensional e sua segunda dimensão é menor do que X (largura) tamanho do recurso gráfico,a função ResourceReadImage() retorna falso e a leitura não é executada. Mas se o recurso existe, o tamanho da imagem real é retornada pelos parâmetros de largura e altura. Isto permitirá fazer outra tentativa para receber dados a partir do recurso.

Também Veja

Recursos, ObjectCreate(), ObjectSetString(), OBJPROP_BMPFILE