Método LinearGradientBrush::GetRectangle(Rect*) (gdiplusbrush.h)
O método LinearGradientBrush::GetRectangle obtém o retângulo que define os limites do gradiente.
Sintaxe
Status GetRectangle(
[out] Rect *rect
);
Parâmetros
[out] rect
Tipo: Rect*
Ponteiro para um objeto Rect que recebe o retângulo que define os limites do gradiente. Por exemplo, se um pincel de gradiente linear for construído com um ponto de partida em (20, 50) e um ponto final em (60, 110), o retângulo definidor terá seu ponto superior esquerdo em (20, 50), uma largura de 40 e uma altura de 60.
Valor retornado
Tipo: Status
Se o método for bem-sucedido, ele retornará Ok, que é um elemento da enumeração Status .
Se o método falhar, ele retornará um dos outros elementos da enumeração Status .
Comentários
O retângulo define os limites do gradiente das seguintes maneiras: os lados direito e esquerdo do retângulo formam os limites de um gradiente horizontal. Os lados superior e inferior formam os limites de um gradiente vertical. Dois dos cantos diagonalmente opostos estão nos limites de um gradiente diagonal. Em cada um desses casos, ambos os lados/cantos podem estar no limite inicial, dependendo de como os pontos iniciais e finais são passados para o construtor.
Exemplos
O exemplo a seguir cria um pincel de gradiente linear. Em seguida, o código obtém o retângulo do pincel e o desenha.
VOID Example_GetRect(HDC hdc)
{
Graphics myGraphics(hdc);
// Create a linear gradient brush.
LinearGradientBrush linGrBrush(
Point(20, 10),
Point(60, 110),
Color(255, 0, 0, 0), // black
Color(255, 0, 0, 255)); // blue
// Obtain information about the linear gradient brush.
Rect rect;
linGrBrush.GetRectangle(&rect);
// Draw the retrieved rectangle.
Pen myPen(Color(255, 0, 0, 0));
myGraphics.DrawRectangle(&myPen, rect);
}
Requisitos
| Cliente mínimo com suporte | Windows XP, Windows 2000 Professional [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows 2000 Server [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | gdiplusbrush.h (inclua Gdiplus.h) |
| Biblioteca | Gdiplus.lib |
| DLL | Gdiplus.dll |