תיוג פשוט

התיוג הפשוט מציין כיצד יש לתייג תכונות.

אפשרויות נתמכות הן:

מאפיין	תיאור
LabelAttribute	מציין את שם המאפיין שיש להשתמש בו כמקור לתיוגים.
LabelExpression	מספק דרך להתאים אישית ולעצב את טקסט התווית. עוקף את LabelAttribute
FontFamily	מציין את משפחת הגופנים שיש להשתמש בה כדי לעבד טקסט. ברירת המחדל היא ערך התלוי במערכת.
FontStyle	סגנון ליישום על הטקסט. - FontStyle.Regular - טקסט רגיל. - FontStyle.Bold - טקסט מודגש. - FontStyle.Italic - טקסט נטוי. - FontStyle.Underine - טקסט קו תחתון. - FontStyle.StrikeOut - טקסט עם קו באמצע.
FontSize	מציין את גודל הטקסט.
FontColor	קובע את צבע הטקסט.
HaloSize	קובע גודל הילה (או קו מתאר) סביב הטקסט.
HaloColor	קובע את צבע ההילה סביב הטקסט.
GeometryExpression	ביטוי גיאומטריה שיש להשתמש בו כדי לשנות את הגיאומטריות לפני העברתן למנוע התיוג.
MultipartMode	מציין התנהגות עיבוד עבור גיאומטריות מרובות חלקים. - MultipartMode.All - הצב תווית ליד כל חלק של הגיאומטריה. - MultipartMode.Any - הצב תווית אחת ליד כל חלק של הגיאומטריה. - MultipartMode.Largest - הצב תווית ליד החלק הגדול ביותר של הגיאומטריה.
Placement	מציין כיצד תוויות ממוקמות ביחס לגיאומטריה. - PointLabelPlacement - ממקם תווית ליד מרכז הגיאומטריה. - LineLabelPlacement - ממקם תווית לאורך הגיאומטריה או ההיקף שלה.
Priority	מציין את העדיפות של התווית במקרה שהיא חופפת לתווית אחרת. התווית בעדיפות נמוכה יותר אינה מעובדת. ברירת המחדל היא 1000.

דוגמאות

דוגמאות תיוג נקודות

כברירת מחדל, SimpleLabeling מצייר טקסט על נקודות:

	// For complete examples and data files, please go to https://github.com/aspose-gis/Aspose.GIS-for-.NET
	using (var map = new Map(500, 200))
	{
	var symbol = new SimpleMarker
	{
	FillColor = Color.LightGray,
	StrokeStyle = StrokeStyle.None
	};

	var labeling = new SimpleLabeling(labelAttribute: "name");

	map.Add(VectorLayer.Open(dataDir + "points.geojson", Drivers.GeoJson), symbol, labeling);
	map.Padding = 50;
	map.Render(dataDir + "points_labeling_out.svg", Renderers.Svg);
	}

view raw Examples-CSharp-Rendering-LabelMap-PointsLabeling.cs hosted with ❤ by GitHub

הנה איך לעצב גופן:

	// For complete examples and data files, please go to https://github.com/aspose-gis/Aspose.GIS-for-.NET
	using (var map = new Map(500, 200))
	{
	var symbol = new SimpleMarker
	{
	FillColor = Color.LightGray,
	StrokeStyle = StrokeStyle.None
	};

	var labeling = new SimpleLabeling(labelAttribute: "name")
	{
	HaloSize = 2,
	HaloColor = Color.LightGray,
	FontSize = 15,
	FontStyle = FontStyle.Italic,
	};

	map.Add(VectorLayer.Open(dataDir + "points.geojson", Drivers.GeoJson), symbol, labeling);
	map.Padding = 50;
	map.Render(dataDir + "points_labeling_styled_out.svg", Renderers.Svg);
	}

view raw Examples-CSharp-Rendering-LabelMap-PointsLabelingStyled.cs hosted with ❤ by GitHub

כדי לשלוט במיקום הטקסט ביחס לתכונת הנקודה, יש להגדיר את המאפיין placement:

	// For complete examples and data files, please go to https://github.com/aspose-gis/Aspose.GIS-for-.NET
	using (var map = new Map(500, 200))
	{
	var symbol = new SimpleMarker
	{
	FillColor = Color.LightGray,
	StrokeStyle = StrokeStyle.None
	};

	var labeling = new SimpleLabeling(labelAttribute: "name")
	{
	HaloSize = 1,
	Placement = new PointLabelPlacement
	{
	VerticalAnchorPoint = VerticalAnchor.Bottom,
	HorizontalAnchorPoint = HorizontalAnchor.Left,
	HorizontalOffset = 2,
	VerticalOffset = 2,
	Rotation = 10,
	}
	};

	map.Add(VectorLayer.Open(dataDir + "points.geojson", Drivers.GeoJson), symbol, labeling);
	map.Padding = 50;
	map.Render(dataDir + "points_labeling_placed_out.svg", Renderers.Svg);
	}

view raw Examples-CSharp-Rendering-LabelMap-PointsLabelingPlaced.cs hosted with ❤ by GitHub

לתרחישים מתקדמים יותר, ייתכן שתרצה לבחור תיוגים שונים לתכונות. הנה איך לעשות את זה:

	// For complete examples and data files, please go to https://github.com/aspose-gis/Aspose.GIS-for-.NET
	using (var map = new Map(500, 200))
	{
	var symbolizer = new SimpleMarker {FillColor = Color.LightGray, StrokeStyle = StrokeStyle.None};

	var labeling = new RuleBasedLabeling();
	// Set labeling to be used for small cities.
	labeling.Add(f => f.GetValue<int>("population") <= 2500, new SimpleLabeling("name")
	{
	FontStyle = FontStyle.Italic,
	HaloSize = 1,
	FontSize = 10,
	FontColor = Color.Green,
	Priority = 1,
	Placement = new PointLabelPlacement
	{
	VerticalAnchorPoint = VerticalAnchor.Bottom,
	HorizontalAnchorPoint = HorizontalAnchor.Center,
	}
	});
	// Set labeling to be used for all other cities.
	labeling.AddElseRule(new SimpleLabeling("name")
	{
	HaloSize = 1,
	FontSize = 15,
	FontColor = Color.Red,
	Priority = 2,
	Placement = new PointLabelPlacement
	{
	VerticalAnchorPoint = VerticalAnchor.Bottom,
	HorizontalAnchorPoint = HorizontalAnchor.Center,
	}
	});

	map.Add(VectorLayer.Open(dataDir + "points.geojson", Drivers.GeoJson), symbolizer, labeling);
	map.Padding = 40;
	map.Render(dataDir + "rule_based_labeling_out.svg", Renderers.Svg);
	}

view raw Examples-CSharp-Rendering-LabelMap-RuleBasedLabeling.cs hosted with ❤ by GitHub

דוגמאות תיוג קווים

כברירת מחדל, SimpleLabeling מצייר תווית ליד מרכז הקו:

	// For complete examples and data files, please go to https://github.com/aspose-gis/Aspose.GIS-for-.NET
	using (var map = new Map(1000, 634))
	{
	var symbolizer = new SimpleLine { Width = 1.5, Color = Color.FromArgb(0xAE, 0xD9, 0xFD) };

	var labeling = new SimpleLabeling(labelAttribute: "name");

	map.Add(VectorLayer.Open(dataDir + "lines.geojson", Drivers.GeoJson), symbolizer, labeling);
	map.Padding = 50;
	map.Render(dataDir + "lines_labeling_out.svg", Renderers.Svg);
	}

view raw Examples-CSharp-Rendering-LabelMap-LinesLabeling.cs hosted with ❤ by GitHub

כדי לסובב תוויות כך שהן מקבילות לקווים, ניתן להשתמש ב-LineLabelPlacement עם LineLabelAlignment.Parallel:

	// For complete examples and data files, please go to https://github.com/aspose-gis/Aspose.GIS-for-.NET
	using (var map = new Map(1000, 634))
	{
	var symbolizer = new SimpleLine { Width = 1.5, Color = Color.FromArgb(0xAE, 0xD9, 0xFD) };

	var labeling = new SimpleLabeling(labelAttribute: "name")
	{
	HaloSize = 1,
	Placement = new LineLabelPlacement
	{
	Alignment = LineLabelAlignment.Parallel,
	}
	};

	map.Add(VectorLayer.Open(dataDir + "lines.geojson", Drivers.GeoJson), symbolizer, labeling);
	map.Padding = 50;
	map.Render(dataDir + "lines_labeling_parallel_out.svg", Renderers.Svg);
	}

view raw Examples-CSharp-Rendering-LabelMap-LinesLabelingParallel.cs hosted with ❤ by GitHub

אם אתה רוצה שהטקסטים יעקבו אחר הקו במדויק, ניתן להשתמש ב-LineLabelPlacement עם LineLabelAlignment.Curved:

	// For complete examples and data files, please go to https://github.com/aspose-gis/Aspose.GIS-for-.NET
	using (var map = new Map(1000, 634))
	{
	var symbolizer = new SimpleLine { Width = 1.5, Color = Color.FromArgb(0xAE, 0xD9, 0xFD) };

	var labeling = new SimpleLabeling(labelAttribute: "name")
	{
	HaloSize = 1,
	Placement = new LineLabelPlacement
	{
	Alignment = LineLabelAlignment.Curved,
	}
	};

	map.Add(VectorLayer.Open(dataDir + "lines.geojson", Drivers.GeoJson), symbolizer, labeling);
	map.Padding = 50;
	map.Render(dataDir + "lines_labeling_curved_out.svg", Renderers.Svg);
	}

view raw Examples-CSharp-Rendering-LabelMap-LinesLabelingCurved.cs hosted with ❤ by GitHub

אם אינך רוצה שהטקסטים יחפפו עם הקו, השתמש ב-LineLabelPlacement.Offset:

	// For complete examples and data files, please go to https://github.com/aspose-gis/Aspose.GIS-for-.NET
	using (var map = new Map(1000, 634))
	{
	var symbolizer = new SimpleLine { Width = 1.5, Color = Color.FromArgb(0xAE, 0xD9, 0xFD) };

	var labeling = new SimpleLabeling(labelAttribute: "name")
	{
	HaloSize = 1,
	Placement = new LineLabelPlacement
	{
	Alignment = LineLabelAlignment.Curved,
	Offset = 5,
	}
	};

	map.Add(VectorLayer.Open(dataDir + "lines.geojson", Drivers.GeoJson), symbolizer, labeling);
	map.Padding = 50;
	map.Render(dataDir + "lines_labeling_curved_offset_out.svg", Renderers.Svg);
	}

view raw Examples-CSharp-Rendering-LabelMap-LinesLabelingCurvedWithOffset.cs hosted with ❤ by GitHub

לתרחישים מתקדמים יותר, ייתכן שתרצה להתאים את סגנון התוויות באופן דינמי בהתבסס על ערכי המאפיינים של התכונה. הנה איך לעשות את זה:

	// For complete examples and data files, please go to https://github.com/aspose-gis/Aspose.GIS-for-.NET
	using (var map = new Map(1000, 634))
	{
	var lineSymbolizer = new SimpleLine { Width = 1.5, Color = Color.FromArgb(0xae, 0xd9, 0xfd) };
	lineSymbolizer.FeatureBasedConfiguration = (feature, symbolizer) =>
	{
	if (feature.GetValue<string>("NAM") == "UNK")
	{
	symbolizer.Width = 1;
	symbolizer.Style = StrokeStyle.Dash;
	}
	};


	var lineLabeling = new SimpleLabeling(labelAttribute: "name")
	{
	HaloSize = 1,
	Placement = new LineLabelPlacement
	{
	Alignment = LineLabelAlignment.Parallel,
	},
	FontSize = 20,
	FeatureBasedConfiguration = (feature, labeling) =>
	{
	if (feature.GetValue<string>("NAM") == "UNK")
	{
	// change labeling properties for some features.
	labeling.FontStyle = FontStyle.Italic;
	labeling.FontSize = 10;
	labeling.Priority = -1;

	var placement = (LineLabelPlacement) labeling.Placement;
	placement.Alignment = LineLabelAlignment.Curved;
	placement.Offset = 5;
	}
	}
	};

	map.Add(VectorLayer.Open(dataDir + "lines.geojson", Drivers.GeoJson), lineSymbolizer, lineLabeling);
	map.Padding = 50;
	map.Render(dataDir + "lines_labeling_feature_based_out.svg", Renderers.Svg);
	}

view raw Examples-CSharp-Rendering-LabelMap-LinesLabelingFeatureBased.cs hosted with ❤ by GitHub

תיוג מבוסס כללים